Add tap(withNormalizedOffset:) and CGVector extensions

Author: Tunous

README.md

@@ -27,6 +27,7 @@ Utilities for easier interaction with XCUITest methods.
         - `tapWhenReady()`
         - `waitForInteractivity()`
         - `slowTypeText("text")`
+        - `tap(withNormalizedOffset: .center)`
 
 - `XCUIApplication` extensions:
     - Accessing other apps:
@@ -42,7 +43,13 @@ Utilities for easier interaction with XCUITest methods.
         - `assertHasCount(2)`
         - `assertNotExists()`
 
-All of the above have optional message as last parameter that can be used to configure what is displayed if assertion fails. For example: `element.assertExists("My element should be visible")`.
+- `CGVector` extensions:
+    - Normalized offsets:
+        - `topLeft`, `top`, `topRight`
+        - `left`, `center`, `right`
+        - `bottomLeft`, `bottom`, `bottomRight`
+
+All of the above assertion functions have optional message as last parameter that can be used to configure what is displayed if assertion fails. For example: `element.assertExists("My element should be visible")`.
 
 ## Example
 
@@ -52,7 +59,7 @@ Note that some of the buttons are identified by enum case instead of raw string.
 
 ```swift
 func testOpenClosePremiumScreen() throws {
-    try launch(configuration: .init(premiumUnlocked: false)) // TODO: Add tip about helper launch configurations
+    try launch(configuration: .init(premiumUnlocked: false))
 
     app.buttons[.toggleBottomSheetButton].tap()
     app.buttons["Unlock Premium"].tapWhenReady()

Sources/XCAppTest/CGVector+NormalizedOffset.swift

@@ -0,0 +1,30 @@
+import Foundation
+
+extension CGVector {
+    /// Normalized offset to view's top left coordinate.
+    public static let topLeft: CGVector = CGVector(dx: 0, dy: 0)
+
+    /// Normalized offset to view's top center coordinate.
+    public static let top: CGVector = CGVector(dx: 0.5, dy: 0)
+
+    /// Normalized offset to view's top right coordinate.
+    public static let topRight: CGVector = CGVector(dx: 1, dy: 0)
+
+    /// Normalized offset to view's center left coordinate.
+    public static let left: CGVector = CGVector(dx: 0, dy: 0.5)
+
+    /// Normalized offset to view's center coordinate.
+    public static let center: CGVector = CGVector(dx: 0.5, dy: 0.5)
+
+    /// Normalized offset to view's center right coordinate.
+    public static let right: CGVector = CGVector(dx: 1, dy: 0.5)
+
+    /// Normalized offset to view's bottom left coordinate.
+    public static let bottomLeft: CGVector = CGVector(dx: 0, dy: 1)
+
+    /// Normalized offset to view's bottom center coordinate.
+    public static let bottom: CGVector = CGVector(dx: 0.5, dy: 1)
+
+    /// Normalized offset to view's bottom right coordinate.
+    public static let bottomRight: CGVector = CGVector(dx: 1, dy: 1)
+}

Sources/XCAppTest/XCUIElement+Actions.swift

@@ -60,4 +60,14 @@ extension XCUIElement {
         }
         return self
     }
+
+    /// Taps the element at normalized offset from its origin.
+    ///
+    /// - Parameter normalizedOffset: The normalized offset.
+    /// - Returns: Unmodified UI element.
+    @discardableResult
+    public func tap(withNormalizedOffset normalizedOffset: CGVector) -> Self {
+        self.coordinate(withNormalizedOffset: normalizedOffset).tap()
+        return self
+    }
 }