appium-webdriveragent 16.2.2 → 16.4.0

package/WebDriverAgentLib/Routing/WatchOS/RouteResponse.m

@@ -0,0 +1,54 @@
+/**
+ * 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 "RouteResponse.h"
+
+@interface RouteResponse ()
+@property (nonatomic, copy) NSMutableDictionary<NSString *, NSString *> *mutableHeaders;
+@end
+
+@implementation RouteResponse
+
+- (instancetype)init
+{
+  if ((self = [super init])) {
+    _statusCode = kHTTPStatusCodeOK;
+    _mutableHeaders = [NSMutableDictionary dictionary];
+  }
+  return self;
+}
+
+- (NSDictionary<NSString *, NSString *> *)headers
+{
+  return self.mutableHeaders.copy;
+}
+
+- (void)setHeader:(NSString *)field value:(NSString *)value
+{
+  self.mutableHeaders[field] = value;
+}
+
+- (void)respondWithData:(NSData *)data
+{
+  _responseData = data.copy;
+  if (nil == self.mutableHeaders[@"Content-Length"]) {
+    self.mutableHeaders[@"Content-Length"] = [NSString stringWithFormat:@"%lu", (unsigned long)data.length];
+  }
+}
+
+- (void)respondWithString:(NSString *)string
+{
+  [self respondWithString:string encoding:NSUTF8StringEncoding];
+}
+
+- (void)respondWithString:(NSString *)string encoding:(NSStringEncoding)encoding
+{
+  [self respondWithData:[string dataUsingEncoding:encoding] ?: [NSData data]];
+}
+
+@end

package/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.m

@@ -8,6 +8,10 @@
 
 #import "FBActiveAppDetectionPoint.h"
 
+#if TARGET_OS_WATCH
+@import WatchKit;
+#endif
+
 #import "FBErrorBuilder.h"
 #import "FBLogger.h"
 #import "FBXCTestDaemonsProxy.h"
@@ -17,7 +21,11 @@
 
 - (instancetype)init {
   if ((self = [super init])) {
+#if TARGET_OS_WATCH
+    CGSize screenSize = WKInterfaceDevice.currentDevice.screenBounds.size;
+#else
     CGSize screenSize = [UIScreen mainScreen].bounds.size;
+#endif
     // Consider the element, which is located close to the top left corner of the screen the on-screen one.
     CGFloat pointDistance = MIN(screenSize.width, screenSize.height) * (CGFloat) 0.2;
     _coordinates = CGPointMake(pointDistance, pointDistance);

package/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.h

@@ -14,7 +14,7 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 @interface FBBaseActionItem : NSObject
 
 /*! Raw JSON representation of the corresponding action item */

package/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.m

@@ -21,7 +21,7 @@
 #import "XCSynthesizedEventRecord.h"
 #import "XCUIElement+FBUtilities.h"
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 @implementation FBBaseActionItem
 
 + (NSString *)actionName

package/WebDriverAgentLib/Utilities/FBConfiguration.h

@@ -262,7 +262,7 @@ typedef NS_ENUM(NSInteger, FBConfigurationKeyboardPreference) {
  */
 @property (atomic, assign) BOOL useClearTextShortcut;
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 /**
  Set the screenshot orientation for iOS
 

package/WebDriverAgentLib/Utilities/FBConfiguration.m

@@ -37,7 +37,7 @@ static NSString *const axSettingsClassName = @"AXSettings";
 @interface FBConfiguration ()
 
 @property (atomic, strong) NSNumber *maxTypingFrequencyOverride;
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 @property (atomic, assign) UIInterfaceOrientation screenshotOrientationStorage;
 #endif
 
@@ -292,7 +292,7 @@ static NSString *const axSettingsClassName = @"AXSettings";
   return [FBGetCustomParameterForElementSnapshot(FBSnapshotMaxChildrenKey) intValue];
 }
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 - (BOOL)setScreenshotOrientation:(NSString *)orientation error:(NSError **)error
 {
   // Only UIInterfaceOrientationUnknown is over iOS 8. Others are over iOS 2.
@@ -359,7 +359,7 @@ static NSString *const axSettingsClassName = @"AXSettings";
   FBSetCustomParameterForElementSnapshot(FBSnapshotMaxChildrenKey, @INT_MAX);
   self.useClearTextShortcut = YES;
   self.limitXpathContextScope = YES;
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
   self.screenshotOrientationStorage = UIInterfaceOrientationUnknown;
 #endif
 }

package/WebDriverAgentLib/Utilities/FBImageProcessor.m

@@ -109,8 +109,12 @@ const CGFloat FBMaxCompressionQuality = 1.0f;
                               desiredOrientation:(nullable NSNumber *)orientation
 {
   scalingFactor = MAX(FBMinScalingFactor, MIN(FBMaxScalingFactor, scalingFactor));
-  BOOL usesScaling = scalingFactor > 0.0 && scalingFactor < FBMaxScalingFactor;
   @autoreleasepool {
+#if TARGET_OS_WATCH
+    // UIGraphicsImageRenderer is unavailable and the watch screen doesn't rotate, so skip both.
+    return [uti conformsToType:UTTypePNG] ? FBToPngData(imageData) : FBToJpegData(imageData, compressionQuality);
+#else
+    BOOL usesScaling = scalingFactor > 0.0 && scalingFactor < FBMaxScalingFactor;
     if (!usesScaling && !fixOrientation) {
       return [uti conformsToType:UTTypePNG] ? FBToPngData(imageData) : FBToJpegData(imageData, compressionQuality);
     }
@@ -157,6 +161,7 @@ const CGFloat FBMaxCompressionQuality = 1.0f;
                                          actions:^(UIGraphicsImageRendererContext * _Nonnull rendererContext) {
         [uiImage drawInRect:CGRectMake(0, 0, scaledSize.width, scaledSize.height)];
       }];
+#endif
   }
 }
 
@@ -167,7 +172,7 @@ const CGFloat FBMaxCompressionQuality = 1.0f;
                                    error:(NSError **)error
 {
   NSNumber *orientation = nil;
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
   if (FBConfiguration.sharedInstance.screenshotOrientation == UIInterfaceOrientationPortrait) {
     orientation = @(UIImageOrientationUp);
   } else if (FBConfiguration.sharedInstance.screenshotOrientation == UIInterfaceOrientationPortraitUpsideDown) {

package/WebDriverAgentLib/Utilities/FBMacros.h

@@ -42,12 +42,21 @@
   typeof(arg) arg = wda_weak_##arg \
   _Pragma("clang diagnostic pop")
 
+/*! Current OS version as a dotted string, e.g. "17.4". UIDevice.systemVersion is unavailable on
+    watchOS, so this is sourced from NSProcessInfo, which works identically on every platform. */
+NS_INLINE NSString *FBSystemVersion(void) {
+  NSOperatingSystemVersion v = NSProcessInfo.processInfo.operatingSystemVersion;
+  return 0 == v.patchVersion
+    ? [NSString stringWithFormat:@"%ld.%ld", (long)v.majorVersion, (long)v.minorVersion]
+    : [NSString stringWithFormat:@"%ld.%ld.%ld", (long)v.majorVersion, (long)v.minorVersion, (long)v.patchVersion];
+}
+
 /*! Returns YES if current system version satisfies the given codition */
-#define SYSTEM_VERSION_EQUAL_TO(v)                  ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedSame)
-#define SYSTEM_VERSION_GREATER_THAN(v)              ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedDescending)
-#define SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(v)  ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] != NSOrderedAscending)
-#define SYSTEM_VERSION_LESS_THAN(v)                 ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] == NSOrderedAscending)
-#define SYSTEM_VERSION_LESS_THAN_OR_EQUAL_TO(v)     ([[[UIDevice currentDevice] systemVersion] compare:v options:NSNumericSearch] != NSOrderedDescending)
+#define SYSTEM_VERSION_EQUAL_TO(v)                  ([FBSystemVersion() compare:v options:NSNumericSearch] == NSOrderedSame)
+#define SYSTEM_VERSION_GREATER_THAN(v)              ([FBSystemVersion() compare:v options:NSNumericSearch] == NSOrderedDescending)
+#define SYSTEM_VERSION_GREATER_THAN_OR_EQUAL_TO(v)  ([FBSystemVersion() compare:v options:NSNumericSearch] != NSOrderedAscending)
+#define SYSTEM_VERSION_LESS_THAN(v)                 ([FBSystemVersion() compare:v options:NSNumericSearch] == NSOrderedAscending)
+#define SYSTEM_VERSION_LESS_THAN_OR_EQUAL_TO(v)     ([FBSystemVersion() compare:v options:NSNumericSearch] != NSOrderedDescending)
 
 /*! Converts the given number of milliseconds into seconds */
 #define FBMillisToSeconds(ms) ((ms) / 1000.0)

package/WebDriverAgentLib/Utilities/FBMathUtils.h

@@ -30,7 +30,7 @@ BOOL FBSizeFuzzyEqualToSize(CGSize size1, CGSize size2, CGFloat threshold);
 /*! Returns whether rect are equal within given threshold */
 BOOL FBRectFuzzyEqualToRect(CGRect rect1, CGRect rect2, CGFloat threshold);
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 /*! Inverts size if necessary to match current screen orientation */
 CGSize FBAdjustDimensionsForApplication(CGSize actualSize, UIInterfaceOrientation orientation);
 #endif

package/WebDriverAgentLib/Utilities/FBMathUtils.m

@@ -44,7 +44,7 @@ BOOL FBRectFuzzyEqualToRect(CGRect rect1, CGRect rect2, CGFloat threshold)
   FBSizeFuzzyEqualToSize(rect1.size, rect2.size, threshold);
 }
 
-#if !TARGET_OS_TV
+#if !TARGET_OS_TV && !TARGET_OS_WATCH
 
 CGSize FBAdjustDimensionsForApplication(CGSize actualSize, UIInterfaceOrientation orientation)
 {

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,113 @@
+/**
+ * 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)
+  }
+
+  /// rotateDigitalCrownByDelta:/performHandGesture: were only added to the SDK in Xcode 16.3 - WDA calls
+  /// them dynamically (NSInvocation) so it keeps building on older Xcode too, but they only actually work
+  /// when the toolchain that built this very test bundle (same build as the runner) is new enough. Checked
+  /// the same way WDA itself does, via responds(to:), rather than hardcoding an Xcode/OS version number here.
+  private var supportsDigitalCrownAndHandGesture: Bool {
+    XCUIDevice.shared.responds(to: Selector(("rotateDigitalCrownByDelta:")))
+  }
+
+  func testRotateDigitalCrown() throws {
+    let response = try client.post("/session/\(sessionId!)/wda/rotateDigitalCrown", body: [
+      "delta": 0.2,
+      "velocity": 1.0,
+    ])
+    XCTAssertEqual(response.statusCode, supportsDigitalCrownAndHandGesture ? 200 : 500)
+  }
+
+  func testRotateDigitalCrownDefaultVelocity() throws {
+    let response = try client.post("/session/\(sessionId!)/wda/rotateDigitalCrown", body: [
+      "delta": -0.2,
+    ])
+    XCTAssertEqual(response.statusCode, supportsDigitalCrownAndHandGesture ? 200 : 500)
+  }
+
+  func testRotateDigitalCrownMissingDelta() throws {
+    // Argument validation happens before the dynamic dispatch check, so this is always a 400.
+    let response = try client.post("/session/\(sessionId!)/wda/rotateDigitalCrown")
+    XCTAssertEqual(response.statusCode, 400)
+  }
+
+  func testPerformHandGestureDoubleTap() throws {
+    let response = try client.post("/session/\(sessionId!)/wda/performHandGesture", body: [
+      "name": "doubleTap",
+    ])
+    XCTAssertEqual(response.statusCode, supportsDigitalCrownAndHandGesture ? 200 : 500)
+  }
+
+  func testPerformHandGestureFlick() throws {
+    let response = try client.post("/session/\(sessionId!)/wda/performHandGesture", body: [
+      "name": "flick",
+    ])
+    // flick additionally needs watchOS 26+ (still internally versioned 12.0 pre-rename) on top of the
+    // Xcode 16.3+ toolchain floor - below that OS version it isn't even advertised as a supported name,
+    // so the server rejects it the same way it would reject any other unknown gesture name.
+    if #available(watchOS 12.0, *), supportsDigitalCrownAndHandGesture {
+      XCTAssertEqual(response.statusCode, 200)
+    } else {
+      XCTAssertEqual(response.statusCode, 500)
+    }
+  }
+
+  func testPerformHandGestureUnsupportedName() throws {
+    // Not a real gesture name in any environment, so always rejected regardless of toolchain/OS version.
+    let response = try client.post("/session/\(sessionId!)/wda/performHandGesture", body: [
+      "name": "clench",
+    ])
+    XCTAssertEqual(response.statusCode, 500)
+  }
+
+  func testPerformHandGestureMissingName() throws {
+    let response = try client.post("/session/\(sessionId!)/wda/performHandGesture")
+    XCTAssertEqual(response.statusCode, 400)
+  }
+}

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)
+  }
+}