Helper functions examples

XCUIElement+Helpers.swift

extension XCUIElement {
  
  @discardableResult
  func waitForExistence(timeout: Timeouts = .medium, hardAssertion: Bool = true, description: String? = nil) -> Bool {
    return XCUIElement.wait(for: { self.exists }, timeout: timeout, hardAssertion: hardAssertion, description: description ?? "Waiting for existence")
  }
  
  @discardableResult
  func waitForNonExistence(timeout: Timeouts = .medium, hardAssertion: Bool = true, description: String? = nil) -> Bool {
    return XCUIElement.wait(for: { !self.exists }, timeout: timeout, hardAssertion: hardAssertion, description: description ?? "Waiting for non-existence")
  }
  
  @discardableResult
  func waitForHittable(timeout: Timeouts = .medium, hardAssertion: Bool = true, description: String? = nil) -> Bool {
    return XCUIElement.wait(for: { self.exists && self.isHittable }, timeout: timeout, hardAssertion: hardAssertion, description: description ?? "Waiting for hittability")
  }
  
  @discardableResult
  func waitForVisible(timeout: Timeouts = .medium, hardAssertion: Bool = true, description: String? = nil) -> Bool {
    return XCUIElement.wait(for: { self.exists && self.isVisible }, timeout: timeout, hardAssertion: hardAssertion, description: description ?? "Waiting for visibility")
  }
    
  @discardableResult
  func waitForNotVisible(timeout: Timeouts = .medium, hardAssertion: Bool = true, description: String? = nil) -> Bool {
    return XCUIElement.wait(for: { !self.isVisible }, timeout: timeout, hardAssertion: hardAssertion, description: description ?? "Waiting for invisibility")
  }
    
  @discardableResult
  func waitForEnabled(timeout: Timeouts = .medium, hardAssertion: Bool = true, description: String? = nil) -> Bool {
    return XCUIElement.wait(for: { self.isEnabled }, timeout: timeout, hardAssertion: hardAssertion, description: description ?? "Waiting for enabled state")
  }
    
  func tapWhenHittable(timeout: Timeouts = .medium,
                       file: StaticString = #file,
                       line: UInt = #line,
                       hardAssertion: Bool = true,
                       description: String? = nil) {
    let failMessage = "Element was not hittable within \(timeout.rawValue)s: \(self)"
    if self.waitForHittable(timeout: timeout, hardAssertion: hardAssertion, description: description) {
      self.tap()
    } else if hardAssertion {
      XCTFail(failMessage)
    }
  }
    
}
// Example usage:
self.testApp.textFields["Email"].waitForExistence()
self.testApp.textFields["Email"].typeText("...")
self.testApp.textFields["Password"].waitForExistence()
self.testApp.textFields["Password"].waitForEnabled()
self.testApp.textFields["Password"].typeText("...")
self.testApp.buttons["Login"].tapWhenHittable()