appium-webdriveragent 16.2.2 → 16.3.0

package/WebDriverAgentLib/Utilities/FBPasteboard.h

@@ -10,7 +10,7 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 @interface FBPasteboard : NSObject
 
 /**

package/WebDriverAgentLib/Utilities/FBPasteboard.m

@@ -20,7 +20,7 @@
 // Must not be less than FB_MONTORING_INTERVAL in FBAlertsMonitor
 #define ALERT_CHECK_INTERVAL_SEC 2
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 @implementation FBPasteboard
 
 + (BOOL)setData:(NSData *)data forType:(NSString *)type error:(NSError **)error

package/WebDriverAgentLib/Utilities/FBSettingsHandler.m

@@ -186,7 +186,7 @@ static NSSet<NSString *> *FBNilClearableSettingKeys(void)
       FBConfiguration.sharedInstance.limitXpathContextScope = [value boolValue];
       return nil;
     };
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
     map[FB_SETTING_SCREENSHOT_ORIENTATION] = ^FBCommandStatus *(FBSession *session, id value) {
       NSError *error;
       if (![FBConfiguration.sharedInstance setScreenshotOrientation:(NSString *)value error:&error]) {
@@ -303,7 +303,7 @@ static NSSet<NSString *> *FBNilClearableSettingKeys(void)
     map[FB_SETTING_LIMIT_XPATH_CONTEXT_SCOPE] = ^id(FBSession *session) {
       return @(FBConfiguration.sharedInstance.limitXpathContextScope);
     };
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
     map[FB_SETTING_SCREENSHOT_ORIENTATION] = ^id(FBSession *session) {
       return FBConfiguration.sharedInstance.humanReadableScreenshotOrientation;
     };

package/WebDriverAgentLib/Utilities/FBW3CActionsSynthesizer.h

@@ -10,7 +10,7 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 @interface FBW3CActionsSynthesizer : FBBaseActionsSynthesizer
 
 @end

package/WebDriverAgentLib/Utilities/FBW3CActionsSynthesizer.m

@@ -63,7 +63,7 @@ static NSString *const FB_KEY_PARAMETERS = @"parameters";
 static NSString *const FB_KEY_ACTIONS = @"actions";
 
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 @interface FBW3CGestureItem : FBBaseGestureItem
 
 @property (nullable, readonly, nonatomic) FBBaseGestureItem *previousItem;

package/WebDriverAgentTests/IntegrationApp_watchOS/ContentView.swift

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import SwiftUI
+
+struct ContentView: View {
+  @State private var resultText = "Idle"
+  @State private var typedText = ""
+
+  var body: some View {
+    // ScrollView keeps content reachable - WDA's test-launch path shifts the scene down
+    // vs. a plain launch, which can push a plain VStack off-screen.
+    ScrollView {
+      VStack(spacing: 8) {
+        Text(resultText)
+          .accessibilityIdentifier("resultLabel")
+        Button("Tap Me") {
+          resultText = "Tapped"
+        }
+        .accessibilityIdentifier("tapMeButton")
+        TextField("Type here", text: $typedText)
+          .accessibilityIdentifier("typingField")
+      }
+    }
+  }
+}

package/WebDriverAgentTests/IntegrationApp_watchOS/WatchSpikeApp.swift

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import SwiftUI
+
+@main
+struct WatchSpikeApp: App {
+  var body: some Scene {
+    WindowGroup {
+      ContentView()
+    }
+  }
+}

package/WebDriverAgentTests/IntegrationTests/FBForceTouchTests.m

@@ -57,6 +57,9 @@
 
 - (void)testForceTap
 {
+  XCTSkipIf(SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(@"27.0"),
+            @"FIXME: Unstable on platform version 27.");
+
   if (![XCUIDevice sharedDevice].supportsPressureInteraction) {
     return;
   }

package/WebDriverAgentTests/IntegrationTests/FBPasteboardTests.m

@@ -51,6 +51,9 @@
 
 - (void)testGetPasteboard
 {
+  XCTSkipIf(SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(@"27.0"),
+            @"FIXME: Pasteboard retrieval has opposite button behavior on platform version 27.");
+
   NSString *text = @"Happy copying";
   XCUIElement *textField = self.testedApplication.textFields[@"aIdentifier"];
   NSError *error;
@@ -87,5 +90,3 @@
 }
 
 @end
-
-

package/WebDriverAgentTests/IntegrationTests_watchOS/WDAAlertIntegrationTests.swift

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers FBAlertViewCommands' error path - IntegrationApp_watchOS never presents a real alert,
+/// so this only exercises the "no alert open" error, not the success path.
+final class WDAAlertIntegrationTests: WDAWatchIntegrationTestCase {
+  func testAlertTextWithNoAlertPresentReturnsAnError() throws {
+    let response = try client.get("/session/\(sessionId!)/alert/text")
+    XCTAssertNotEqual(response.statusCode, 200)
+  }
+
+  func testAlertButtonsWithNoAlertPresentReturnsAnError() throws {
+    let response = try client.get("/session/\(sessionId!)/wda/alert/buttons")
+    XCTAssertNotEqual(response.statusCode, 200)
+  }
+}

package/WebDriverAgentTests/IntegrationTests_watchOS/WDAAppLifecycleIntegrationTests.swift

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers the app lifecycle routes (launch/activate/terminate/state/list). Unlike
+/// /wda/homescreen or /wda/lock, these only ever target IntegrationApp_watchOS, so they're
+/// safe to run repeatedly without disrupting shared simulator state.
+final class WDAAppLifecycleIntegrationTests: WDAWatchIntegrationTestCase {
+  // XCUIApplicationState raw values: NotRunning = 1, RunningForeground = 4.
+  private static let notRunningState = 1
+  private static let runningForegroundState = 4
+
+  func testAppsListIncludesTheAppUnderTest() throws {
+    let response = try client.get("/session/\(sessionId!)/wda/apps/list")
+    XCTAssertEqual(response.statusCode, 200)
+    guard let apps = response.value as? [[String: Any]] else {
+      return XCTFail("Expected an array of active apps: \(String(describing: response.json))")
+    }
+    XCTAssertTrue(apps.contains { $0["bundleId"] as? String == Self.integrationAppBundleId })
+  }
+
+  func testTerminateThenRelaunchLifecycle() throws {
+    let bundleId = Self.integrationAppBundleId
+
+    let terminateResponse = try client.post("/session/\(sessionId!)/wda/apps/terminate", body: ["bundleId": bundleId])
+    XCTAssertEqual(terminateResponse.statusCode, 200)
+    XCTAssertEqual(terminateResponse.value as? Bool, true)
+
+    let stateAfterTerminate = try client.post("/session/\(sessionId!)/wda/apps/state", body: ["bundleId": bundleId])
+    XCTAssertEqual(stateAfterTerminate.value as? Int, Self.notRunningState)
+
+    let launchResponse = try client.post("/session/\(sessionId!)/wda/apps/launch", body: ["bundleId": bundleId])
+    XCTAssertEqual(launchResponse.statusCode, 200)
+    Thread.sleep(forTimeInterval: 1)
+
+    let stateAfterLaunch = try client.post("/session/\(sessionId!)/wda/apps/state", body: ["bundleId": bundleId])
+    XCTAssertEqual(stateAfterLaunch.value as? Int, Self.runningForegroundState)
+
+    // The app relaunched fresh, so its accessibility tree should be back too.
+    XCTAssertNoThrow(try findElement(byAccessibilityId: "tapMeButton"))
+  }
+
+  func testActivateBringsTheAppToTheForeground() throws {
+    let bundleId = Self.integrationAppBundleId
+    let activateResponse = try client.post("/session/\(sessionId!)/wda/apps/activate", body: ["bundleId": bundleId])
+    XCTAssertEqual(activateResponse.statusCode, 200)
+
+    let stateResponse = try client.post("/session/\(sessionId!)/wda/apps/state", body: ["bundleId": bundleId])
+    XCTAssertEqual(stateResponse.value as? Int, Self.runningForegroundState)
+  }
+}

package/WebDriverAgentTests/IntegrationTests_watchOS/WDAClickIntegrationTests.swift

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers /element/:uuid/click - the only tap-like interaction registered on watchOS
+/// (gesture synthesis routes aren't).
+final class WDAClickIntegrationTests: WDAWatchIntegrationTestCase {
+  func testClickingButtonUpdatesTheResultLabel() throws {
+    let labelId = try findElement(byAccessibilityId: "resultLabel")
+    XCTAssertEqual(try attributeValue(labelId, "label"), "Idle")
+
+    let buttonId = try findElement(byAccessibilityId: "tapMeButton")
+    let clickResponse = try client.post("/session/\(sessionId!)/element/\(buttonId)/click")
+    XCTAssertEqual(clickResponse.statusCode, 200)
+
+    // Re-find: element UUIDs aren't stable across snapshots, and the label just changed.
+    let updatedLabelId = try findElement(byAccessibilityId: "resultLabel")
+    XCTAssertEqual(try attributeValue(updatedLabelId, "label"), "Tapped")
+  }
+
+  func testClickingAnElementThatDoesNotExistReturnsAnError() throws {
+    let response = try client.post("/session/\(sessionId!)/element/00000000-0000-0000-0000-000000000000/click")
+    XCTAssertNotEqual(response.statusCode, 200)
+  }
+}

package/WebDriverAgentTests/IntegrationTests_watchOS/WDADeviceIntegrationTests.swift

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers device-info and location routes. These only read device state or set a simulated
+/// GPS fix, so unlike /wda/lock or /wda/voiceOver/enable, they won't disrupt later tests.
+final class WDADeviceIntegrationTests: WDAWatchIntegrationTestCase {
+  func testDeviceInfo() throws {
+    let response = try client.get("/session/\(sessionId!)/wda/device/info")
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertFalse((response.valueDict?["name"] as? String ?? "").isEmpty)
+    XCTAssertFalse((response.valueDict?["model"] as? String ?? "").isEmpty)
+  }
+
+  func testActiveAppInfo() throws {
+    let response = try client.get("/session/\(sessionId!)/wda/activeAppInfo")
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertEqual(response.valueDict?["bundleId"] as? String, Self.integrationAppBundleId)
+    XCTAssertGreaterThan(response.valueDict?["pid"] as? Int ?? 0, 0)
+  }
+
+  func testDeviceLocation() throws {
+    let response = try client.get("/session/\(sessionId!)/wda/device/location")
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertNotNil(response.valueDict?["latitude"])
+    XCTAssertNotNil(response.valueDict?["authorizationStatus"])
+  }
+
+  func testSimulatedLocationRoundTrip() throws {
+    let setResponse = try client.post("/session/\(sessionId!)/wda/simulatedLocation", body: [
+      "latitude": 37.3230,
+      "longitude": -122.0322,
+    ])
+    XCTAssertEqual(setResponse.statusCode, 200)
+
+    let getResponse = try client.get("/session/\(sessionId!)/wda/simulatedLocation")
+    XCTAssertEqual(getResponse.statusCode, 200)
+    XCTAssertEqual(getResponse.valueDict?["latitude"] as? Double ?? 0, 37.3230, accuracy: 0.001)
+    XCTAssertEqual(getResponse.valueDict?["longitude"] as? Double ?? 0, -122.0322, accuracy: 0.001)
+
+    let clearResponse = try client.delete("/session/\(sessionId!)/wda/simulatedLocation")
+    XCTAssertEqual(clearResponse.statusCode, 200)
+  }
+}

package/WebDriverAgentTests/IntegrationTests_watchOS/WDAElementAttributeIntegrationTests.swift

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers FBElementCommands' read-only element/window attribute routes.
+final class WDAElementAttributeIntegrationTests: WDAWatchIntegrationTestCase {
+  func testWindowSizeAndRect() throws {
+    let sizeResponse = try client.get("/session/\(sessionId!)/window/size")
+    XCTAssertEqual(sizeResponse.statusCode, 200)
+    XCTAssertGreaterThan(sizeResponse.valueDict?["width"] as? Double ?? 0, 0)
+    XCTAssertGreaterThan(sizeResponse.valueDict?["height"] as? Double ?? 0, 0)
+
+    let rectResponse = try client.get("/session/\(sessionId!)/window/rect")
+    XCTAssertEqual(rectResponse.statusCode, 200)
+    XCTAssertGreaterThan(rectResponse.valueDict?["width"] as? Double ?? 0, 0)
+  }
+
+  func testButtonAttributes() throws {
+    let buttonId = try findElement(byAccessibilityId: "tapMeButton")
+
+    let enabledResponse = try client.get("/session/\(sessionId!)/element/\(buttonId)/enabled")
+    XCTAssertEqual(enabledResponse.value as? Bool, true)
+
+    let displayedResponse = try client.get("/session/\(sessionId!)/element/\(buttonId)/displayed")
+    XCTAssertEqual(displayedResponse.value as? Bool, true)
+
+    let rectResponse = try client.get("/session/\(sessionId!)/element/\(buttonId)/rect")
+    XCTAssertEqual(rectResponse.statusCode, 200)
+    XCTAssertGreaterThan(rectResponse.valueDict?["width"] as? Double ?? 0, 0)
+
+    let nameResponse = try client.get("/session/\(sessionId!)/element/\(buttonId)/name")
+    XCTAssertEqual(nameResponse.valueString, "XCUIElementTypeButton")
+
+    let labelResponse = try client.get("/session/\(sessionId!)/element/\(buttonId)/attribute/label")
+    XCTAssertEqual(labelResponse.valueString, "Tap Me")
+
+    let accessibleResponse = try client.get("/session/\(sessionId!)/wda/element/\(buttonId)/accessible")
+    XCTAssertEqual(accessibleResponse.statusCode, 200)
+  }
+
+  func testResultLabelTextAndSelectedState() throws {
+    let labelId = try findElement(byAccessibilityId: "resultLabel")
+
+    let textResponse = try client.get("/session/\(sessionId!)/element/\(labelId)/text")
+    XCTAssertEqual(textResponse.valueString, "Idle")
+
+    let selectedResponse = try client.get("/session/\(sessionId!)/element/\(labelId)/selected")
+    XCTAssertEqual(selectedResponse.statusCode, 200)
+    XCTAssertEqual(selectedResponse.value as? Bool, false)
+  }
+}

package/WebDriverAgentTests/IntegrationTests_watchOS/WDAFindIntegrationTests.swift

@@ -0,0 +1,126 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers FBFindElementCommands: find/sub-find/active-element, not-found errors, and every
+/// locator strategy (accessibility id/name/id, class name, class chain, xpath, predicate
+/// string, link text). getVisibleCells is skipped - no table/collection view to test it against.
+final class WDAFindIntegrationTests: WDAWatchIntegrationTestCase {
+  func testFindElementByAccessibilityId() throws {
+    let elementId = try findElement(byAccessibilityId: "tapMeButton")
+    XCTAssertFalse(elementId.isEmpty)
+  }
+
+  func testFindElementByNameAndIdAliases() throws {
+    // "name" and "id" are aliases for "accessibility id".
+    for using in ["name", "id"] {
+      let response = try client.post("/session/\(sessionId!)/element", body: [
+        "using": using,
+        "value": "tapMeButton",
+      ])
+      XCTAssertEqual(response.statusCode, 200, "using: \(using)")
+      XCTAssertNotNil(response.valueDict?["ELEMENT"], "using: \(using)")
+    }
+  }
+
+  func testFindElementByPredicateString() throws {
+    let response = try client.post("/session/\(sessionId!)/element", body: [
+      "using": "predicate string",
+      "value": "label == \"Tap Me\"",
+    ])
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertNotNil(response.valueDict?["ELEMENT"])
+  }
+
+  func testFindElementsByClassChain() throws {
+    let response = try client.post("/session/\(sessionId!)/elements", body: [
+      "using": "class chain",
+      "value": "**/XCUIElementTypeButton",
+    ])
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertGreaterThanOrEqual((response.value as? [[String: Any]])?.count ?? 0, 1)
+  }
+
+  func testFindElementByXPath() throws {
+    let response = try client.post("/session/\(sessionId!)/element", body: [
+      "using": "xpath",
+      "value": "//XCUIElementTypeButton[@name=\"tapMeButton\"]",
+    ])
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertNotNil(response.valueDict?["ELEMENT"])
+  }
+
+  func testFindElementByLinkTextAndPartialLinkText() throws {
+    // WDA matches (partial) link text against `name`, not an actual hyperlink search.
+    for using in ["link text", "partial link text"] {
+      let value = using == "link text" ? "tapMeButton" : "tapMe"
+      let response = try client.post("/session/\(sessionId!)/element", body: [
+        "using": using,
+        "value": value,
+      ])
+      XCTAssertEqual(response.statusCode, 200, "using: \(using)")
+      XCTAssertNotNil(response.valueDict?["ELEMENT"], "using: \(using)")
+    }
+  }
+
+  func testFindElementThatDoesNotExistReturnsAnError() throws {
+    let response = try client.post("/session/\(sessionId!)/element", body: [
+      "using": "accessibility id",
+      "value": "thisElementDoesNotExist",
+    ])
+    XCTAssertNotEqual(response.statusCode, 200)
+  }
+
+  func testFindElements() throws {
+    let response = try client.post("/session/\(sessionId!)/elements", body: [
+      "using": "class name",
+      "value": "XCUIElementTypeButton",
+    ])
+    XCTAssertEqual(response.statusCode, 200)
+    guard let elements = response.value as? [[String: Any]] else {
+      return XCTFail("Expected an array of elements: \(String(describing: response.json))")
+    }
+    XCTAssertGreaterThanOrEqual(elements.count, 1)
+  }
+
+  func testFindSubElementAndSubElements() throws {
+    let windowResponse = try client.post("/session/\(sessionId!)/element", body: [
+      "using": "class name",
+      "value": "XCUIElementTypeWindow",
+    ])
+    guard let windowId = windowResponse.valueDict?["ELEMENT"] as? String else {
+      return XCTFail("Could not find the root window element")
+    }
+
+    let subElementResponse = try client.post("/session/\(sessionId!)/element/\(windowId)/element", body: [
+      "using": "accessibility id",
+      "value": "tapMeButton",
+    ])
+    XCTAssertEqual(subElementResponse.statusCode, 200)
+    XCTAssertNotNil(subElementResponse.valueDict?["ELEMENT"])
+
+    let subElementsResponse = try client.post("/session/\(sessionId!)/element/\(windowId)/elements", body: [
+      "using": "class name",
+      "value": "XCUIElementTypeButton",
+    ])
+    XCTAssertEqual(subElementsResponse.statusCode, 200)
+    XCTAssertGreaterThanOrEqual((subElementsResponse.value as? [[String: Any]])?.count ?? 0, 1)
+  }
+
+  func testActiveElementResolvesToTheFocusedTextField() throws {
+    let fieldId = try findElement(byAccessibilityId: "typingField")
+    try client.post("/session/\(sessionId!)/element/\(fieldId)/click")
+    // Give the keyboard-sheet transition a moment to finish before checking focus.
+    Thread.sleep(forTimeInterval: 1)
+
+    let response = try client.get("/session/\(sessionId!)/element/active")
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertNotNil(response.valueDict?["ELEMENT"])
+  }
+}

package/WebDriverAgentTests/IntegrationTests_watchOS/WDAScreenshotAndSourceIntegrationTests.swift

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers device/element screenshots and /source, /wda/accessibleSource.
+final class WDAScreenshotAndSourceIntegrationTests: WDAWatchIntegrationTestCase {
+  private static let pngMagicBytes: [UInt8] = [0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A]
+
+  private func assertLooksLikeAPNG(_ base64String: String?, file: StaticString = #filePath, line: UInt = #line) {
+    guard let base64String = base64String, let data = Data(base64Encoded: base64String) else {
+      return XCTFail("Response value was not base64 data", file: file, line: line)
+    }
+    XCTAssertGreaterThan(data.count, Self.pngMagicBytes.count, file: file, line: line)
+    XCTAssertEqual(Array(data.prefix(Self.pngMagicBytes.count)), Self.pngMagicBytes, "response was not a PNG", file: file, line: line)
+  }
+
+  func testDeviceScreenshot() throws {
+    let response = try client.get("/session/\(sessionId!)/screenshot")
+    XCTAssertEqual(response.statusCode, 200)
+    assertLooksLikeAPNG(response.valueString)
+  }
+
+  func testElementScreenshot() throws {
+    let buttonId = try findElement(byAccessibilityId: "tapMeButton")
+    let response = try client.get("/session/\(sessionId!)/element/\(buttonId)/screenshot")
+    XCTAssertEqual(response.statusCode, 200)
+    assertLooksLikeAPNG(response.valueString)
+  }
+
+  func testPageSourceContainsTheKnownElements() throws {
+    let response = try client.get("/session/\(sessionId!)/source?format=xml")
+    XCTAssertEqual(response.statusCode, 200)
+    guard let xml = response.valueString else {
+      return XCTFail("No XML source returned")
+    }
+    XCTAssertTrue(xml.contains("tapMeButton"))
+    XCTAssertTrue(xml.contains("resultLabel"))
+    XCTAssertTrue(xml.contains("typingField"))
+  }
+
+  func testAccessibleSource() throws {
+    let response = try client.get("/session/\(sessionId!)/wda/accessibleSource")
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertNotNil(response.value)
+  }
+}

package/WebDriverAgentTests/IntegrationTests_watchOS/WDASessionIntegrationTests.swift

@@ -0,0 +1,72 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import XCTest
+
+/// Covers FBSessionCommands. Manages its own session lifecycle per test, since that's what's
+/// under test here, rather than using WDAWatchIntegrationTestCase.
+final class WDASessionIntegrationTests: XCTestCase {
+  let client = WDAWatchHTTPClient()
+
+  override func setUp() {
+    super.setUp()
+    continueAfterFailure = false
+  }
+
+  func testStatusIsReadyWithoutASession() throws {
+    let response = try client.get("/status")
+    XCTAssertEqual(response.statusCode, 200)
+    XCTAssertEqual(response.valueDict?["ready"] as? Bool, true)
+    XCTAssertEqual(response.valueDict?["state"] as? String, "success")
+  }
+
+  func testHealthCheck() throws {
+    let response = try client.get("/wda/healthcheck")
+    XCTAssertEqual(response.statusCode, 200)
+  }
+
+  func testCreateGetActiveAndDeleteSessionLifecycle() throws {
+    let createResponse = try client.post("/session", body: [
+      "capabilities": ["alwaysMatch": ["bundleId": WDAWatchIntegrationTestCase.integrationAppBundleId]]
+    ])
+    XCTAssertEqual(createResponse.statusCode, 200)
+    guard let sessionId = createResponse.valueDict?["sessionId"] as? String else {
+      return XCTFail("No sessionId in create-session response: \(String(describing: createResponse.json))")
+    }
+    XCTAssertFalse(sessionId.isEmpty)
+
+    let activeResponse = try client.get("/session/\(sessionId)")
+    XCTAssertEqual(activeResponse.statusCode, 200)
+    XCTAssertEqual(activeResponse.valueDict?["sessionId"] as? String, sessionId)
+
+    let deleteResponse = try client.delete("/session/\(sessionId)")
+    XCTAssertEqual(deleteResponse.statusCode, 200)
+  }
+
+  func testTimeoutsAndAppiumSettingsRoundTrip() throws {
+    let createResponse = try client.post("/session", body: [
+      "capabilities": ["alwaysMatch": ["bundleId": WDAWatchIntegrationTestCase.integrationAppBundleId]]
+    ])
+    guard let sessionId = createResponse.valueDict?["sessionId"] as? String else {
+      return XCTFail("No sessionId in create-session response")
+    }
+    defer { _ = try? client.delete("/session/\(sessionId)") }
+
+    let timeoutsResponse = try client.post("/session/\(sessionId)/timeouts", body: ["implicit": 500])
+    XCTAssertEqual(timeoutsResponse.statusCode, 200)
+
+    let getSettingsResponse = try client.get("/session/\(sessionId)/appium/settings")
+    XCTAssertEqual(getSettingsResponse.statusCode, 200)
+    XCTAssertNotNil(getSettingsResponse.valueDict)
+
+    let setSettingsResponse = try client.post("/session/\(sessionId)/appium/settings", body: [
+      "settings": ["shouldUseCompactResponses": false]
+    ])
+    XCTAssertEqual(setSettingsResponse.statusCode, 200)
+  }
+}