@devicelab/maestro-runner-darwin-arm64 1.1.25 → 1.1.28

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/FBW3CTouchActionsIntegrationTests.m

@@ -17,6 +17,10 @@
 #import "XCUIDevice+FBRotation.h"
 #import "FBRunLoopSpinner.h"
 #import "FBXCodeCompatibility.h"
+#import "FBW3CActionsSynthesizer.h"
+#import "XCSynthesizedEventRecord.h"
+#import "XCPointerEventPath.h"
+#import "XCPointerEvent.h"
 
 @interface FBW3CTouchActionsIntegrationTestsPart1 : FBIntegrationTestCase
 @end
@@ -185,14 +189,13 @@
         },
       ],
     
-    // Chain element where action items start with an incorrect item
+    // Chain element where pointerMove action item does not contain coordinates
     @[@{
         @"type": @"pointer",
         @"id": @"finger1",
         @"parameters": @{@"pointerType": @"touch"},
         @"actions": @[
-            @{@"type": @"pause", @"duration": @100},
-            @{@"type": @"pointerMove", @"duration": @0, @"x": @1, @"y": @1},
+            @{@"type": @"pointerMove", @"duration": @0},
             @{@"type": @"pointerDown"},
             @{@"type": @"pause", @"duration": @100},
             @{@"type": @"pointerUp"},
@@ -200,13 +203,13 @@
         },
       ],
     
-    // Chain element where pointerMove action item does not contain coordinates
+    // Chain element where pointerMove action item cannot use coordinates of the previous item
     @[@{
         @"type": @"pointer",
         @"id": @"finger1",
         @"parameters": @{@"pointerType": @"touch"},
         @"actions": @[
-            @{@"type": @"pointerMove", @"duration": @0},
+            @{@"type": @"pointerMove", @"duration": @0, @"origin": @"pointer"},
             @{@"type": @"pointerDown"},
             @{@"type": @"pause", @"duration": @100},
             @{@"type": @"pointerUp"},
@@ -214,34 +217,51 @@
         },
       ],
     
-    // Chain element where pointerMove action item cannot use coordinates of the previous item
+    // Chain element where action items contains negative duration
     @[@{
         @"type": @"pointer",
         @"id": @"finger1",
         @"parameters": @{@"pointerType": @"touch"},
         @"actions": @[
-            @{@"type": @"pointerMove", @"duration": @0, @"origin": @"pointer"},
+            @{@"type": @"pointerMove", @"duration": @0, @"x": @1, @"y": @1},
             @{@"type": @"pointerDown"},
-            @{@"type": @"pause", @"duration": @100},
+            @{@"type": @"pause", @"duration": @-100},
             @{@"type": @"pointerUp"},
             ],
         },
       ],
     
-    // Chain element where action items contains negative duration
+    // Chain element where a leading pause is followed directly by pointerDown,
+    // with no real pointerMove ever establishing a position
     @[@{
         @"type": @"pointer",
         @"id": @"finger1",
         @"parameters": @{@"pointerType": @"touch"},
         @"actions": @[
-            @{@"type": @"pointerMove", @"duration": @0, @"x": @1, @"y": @1},
+            @{@"type": @"pause", @"duration": @0},
             @{@"type": @"pointerDown"},
-            @{@"type": @"pause", @"duration": @-100},
+            @{@"type": @"pause", @"duration": @100},
             @{@"type": @"pointerUp"},
             ],
         },
       ],
-    
+
+    // Chain element where a leading pause is followed directly by a relative
+    // pointerMove, with no real preceding position to be relative to
+    @[@{
+        @"type": @"pointer",
+        @"id": @"finger1",
+        @"parameters": @{@"pointerType": @"touch"},
+        @"actions": @[
+            @{@"type": @"pause", @"duration": @0},
+            @{@"type": @"pointerMove", @"duration": @0, @"origin": @"pointer"},
+            @{@"type": @"pointerDown"},
+            @{@"type": @"pause", @"duration": @100},
+            @{@"type": @"pointerUp"},
+            ],
+        },
+      ],
+
     // Chain element where action items start with an incorrect one, because the correct one is canceled
     @[@{
         @"type": @"pointer",
@@ -299,6 +319,69 @@
   [self verifyGesture:gesture orientation:UIDeviceOrientationPortrait];
 }
 
+- (void)testLeadingZeroDurationPauseDoesNotAddExtraTouch
+{
+  // A leading pause must not defeat the down-after-move dedup logic in
+  // FBPointerDownItem and make WDA synthesize a second, separate touch-down
+  // for the same finger. Inspect the actual synthesized XCTest event stream
+  // (without dispatching it) rather than only checking the gesture's visible
+  // side effect, since a duplicate touch at the same point may still produce
+  // the same visible outcome.
+  XCUIElement *element = self.testedApplication.buttons[FBShowAlertButtonName];
+  NSDictionary<NSString *, id> *(^sequenceWithLeadingPause)(BOOL) = ^NSDictionary<NSString *, id> *(BOOL withLeadingPause) {
+    NSMutableArray<NSDictionary<NSString *, id> *> *actions = [NSMutableArray array];
+    if (withLeadingPause) {
+      [actions addObject:@{@"type": @"pause", @"duration": @0}];
+    }
+    [actions addObjectsFromArray:@[
+      @{@"type": @"pointerMove", @"duration": @0, @"origin": element, @"x": @0, @"y": @0},
+      @{@"type": @"pointerDown"},
+      @{@"type": @"pause", @"duration": @100},
+      @{@"type": @"pointerUp"},
+      ]];
+    return @{
+      @"type": @"pointer",
+      @"id": @"finger1",
+      @"parameters": @{@"pointerType": @"touch"},
+      @"actions": actions.copy,
+      };
+  };
+
+  NSError *error;
+  FBW3CActionsSynthesizer *baselineSynthesizer =
+  [[FBW3CActionsSynthesizer alloc] initWithActions:@[sequenceWithLeadingPause(NO)]
+                                     forApplication:self.testedApplication
+                                       elementCache:nil
+                                              error:&error];
+  XCTAssertNotNil(baselineSynthesizer);
+  XCSynthesizedEventRecord *baselineRecord = [baselineSynthesizer synthesizeWithError:&error];
+  XCTAssertNotNil(baselineRecord, @"%@", error);
+
+  FBW3CActionsSynthesizer *pausedSynthesizer =
+  [[FBW3CActionsSynthesizer alloc] initWithActions:@[sequenceWithLeadingPause(YES)]
+                                     forApplication:self.testedApplication
+                                       elementCache:nil
+                                              error:&error];
+  XCTAssertNotNil(pausedSynthesizer);
+  XCSynthesizedEventRecord *pausedRecord = [pausedSynthesizer synthesizeWithError:&error];
+  XCTAssertNotNil(pausedRecord, @"%@", error);
+
+  XCTAssertEqual(baselineRecord.eventPaths.count, (NSUInteger)1);
+  XCTAssertEqual(pausedRecord.eventPaths.count, baselineRecord.eventPaths.count);
+
+  XCPointerEventPath *baselinePath = baselineRecord.eventPaths.firstObject;
+  XCPointerEventPath *pausedPath = pausedRecord.eventPaths.firstObject;
+  XCTAssertEqual(pausedPath.pointerEvents.count, baselinePath.pointerEvents.count);
+  for (NSUInteger i = 0; i < baselinePath.pointerEvents.count; i++) {
+    XCPointerEvent *baselineEvent = baselinePath.pointerEvents[i];
+    XCPointerEvent *pausedEvent = pausedPath.pointerEvents[i];
+    XCTAssertEqual(pausedEvent.eventType, baselineEvent.eventType);
+    XCTAssertEqualWithAccuracy(pausedEvent.offset, baselineEvent.offset, 0.001);
+    XCTAssertEqualWithAccuracy(pausedEvent.coordinate.x, baselineEvent.coordinate.x, 0.001);
+    XCTAssertEqualWithAccuracy(pausedEvent.coordinate.y, baselineEvent.coordinate.y, 0.001);
+  }
+}
+
 - (void)testDoubleTap
 {
   NSArray<NSDictionary<NSString *, id> *> *gesture =
@@ -368,7 +451,7 @@
 - (void)testForceTap
 {
   if (![XCUIDevice.sharedDevice supportsPressureInteraction]) {
-    return;
+    XCTSkip(@"Device does not support pressure interaction");
   }
 
   NSArray<NSDictionary<NSString *, id> *> *gesture =

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/FBW3CTypeActionsTests.m

@@ -32,7 +32,7 @@
 - (void)testErroneousGestures
 {
   if (![XCPointerEvent.class fb_areKeyEventsSupported]) {
-    return;
+    XCTSkip(@"Key events are not supported on this platform");
   }
 
   NSArray<NSArray<NSDictionary<NSString *, id> *> *> *invalidGestures =
@@ -121,7 +121,7 @@
 - (void)testTextTyping
 {
   if (![XCPointerEvent.class fb_areKeyEventsSupported]) {
-    return;
+    XCTSkip(@"Key events are not supported on this platform");
   }
 
   XCUIElement *textField = self.testedApplication.textFields[@"aIdentifier"];
@@ -160,7 +160,7 @@
 - (void)testTextTypingWithEmptyActions
 {
   if (![XCPointerEvent.class fb_areKeyEventsSupported]) {
-    return;
+    XCTSkip(@"Key events are not supported on this platform");
   }
 
   XCUIElement *textField = self.testedApplication.textFields[@"aIdentifier"];

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/FBXPathIntegrationTests.m

@@ -9,6 +9,7 @@
 #import <XCTest/XCTest.h>
 
 #import "FBIntegrationTestCase.h"
+#import "FBExceptions.h"
 #import "FBMacros.h"
 #import "FBTestMacros.h"
 #import "FBXPath.h"
@@ -51,6 +52,31 @@
   return snapshot;
 }
 
+- (NSSet<NSString *> *)labelsForMatchingSnapshots:(NSArray<id<FBXCElementSnapshot>> *)matchingSnapshots
+{
+  NSMutableSet<NSString *> *labels = [NSMutableSet set];
+  for (id<FBXCElementSnapshot> snapshot in matchingSnapshots) {
+    NSString *label = [FBXCElementSnapshotWrapper ensureWrapped:snapshot].wdLabel;
+    if (nil != label) {
+      [labels addObject:label];
+    }
+  }
+  return labels.copy;
+}
+
+- (void)assertXPathQuery:(NSString *)query findsButtonLabels:(NSArray<NSString *> *)expectedLabels
+{
+  NSArray<id<FBXCElementSnapshot>> *matchingSnapshots = [FBXPath matchesWithRootElement:self.testedApplication
+                                                                               forQuery:query];
+  NSSet<NSString *> *foundLabels = [self labelsForMatchingSnapshots:matchingSnapshots];
+  NSSet<NSString *> *expectedLabelSet = [NSSet setWithArray:expectedLabels];
+  XCTAssertEqual(foundLabels.count, expectedLabelSet.count);
+  XCTAssertEqualObjects(foundLabels, expectedLabelSet);
+  for (id<FBXCElementSnapshot> snapshot in matchingSnapshots) {
+    XCTAssertEqualObjects([FBXCElementSnapshotWrapper ensureWrapped:snapshot].wdType, @"XCUIElementTypeButton");
+  }
+}
+
 - (void)testApplicationNodeXMLRepresentation
 {
   id<FBXCElementSnapshot> snapshot = [self.testedApplication fb_customSnapshot];
@@ -104,7 +130,7 @@
 - (void)testFindMatchesInElement
 {
   NSArray<id<FBXCElementSnapshot>> *matchingSnapshots = [FBXPath matchesWithRootElement:self.testedApplication forQuery:@"//XCUIElementTypeButton"];
-  XCTAssertEqual([matchingSnapshots count], 5);
+  XCTAssertEqual([matchingSnapshots count], FBMainViewButtonLabels.count);
   for (id<FBXCElementSnapshot> element in matchingSnapshots) {
     XCTAssertTrue([[FBXCElementSnapshotWrapper ensureWrapped:element].wdType isEqualToString:@"XCUIElementTypeButton"]);
   }
@@ -113,8 +139,8 @@
 - (void)testFindMatchesWithoutContextScopeLimit
 {
   XCUIElement *button = self.testedApplication.buttons.firstMatch;
-  BOOL previousValue = FBConfiguration.limitXpathContextScope;
-  FBConfiguration.limitXpathContextScope = NO;
+  BOOL previousValue = FBConfiguration.sharedInstance.limitXpathContextScope;
+  FBConfiguration.sharedInstance.limitXpathContextScope = NO;
   @try {
     NSArray *parentSnapshots = [FBXPath matchesWithRootElement:button forQuery:@".."];
     XCTAssertEqual(parentSnapshots.count, 1);
@@ -141,17 +167,94 @@
                           @"XCUIElementTypeButton"
                           );
   } @finally {
-    FBConfiguration.limitXpathContextScope = previousValue;
+    FBConfiguration.sharedInstance.limitXpathContextScope = previousValue;
   }
 }
 
 - (void)testFindMatchesInElementWithDotNotation
 {
   NSArray<id<FBXCElementSnapshot>> *matchingSnapshots = [FBXPath matchesWithRootElement:self.testedApplication forQuery:@".//XCUIElementTypeButton"];
-  XCTAssertEqual([matchingSnapshots count], 5);
+  XCTAssertEqual([matchingSnapshots count], FBMainViewButtonLabels.count);
   for (id<FBXCElementSnapshot> element in matchingSnapshots) {
     XCTAssertTrue([[FBXCElementSnapshotWrapper ensureWrapped:element].wdType isEqualToString:@"XCUIElementTypeButton"]);
   }
 }
 
+- (void)testFindMatchesWithMatchesFunction
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[matches(@label, '^Alerts$')]"
+       findsButtonLabels:@[@"Alerts"]];
+}
+
+- (void)testFindMatchesWithMatchesFunctionCaseInsensitive
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[matches(@label, '^alerts$', 'i')]"
+       findsButtonLabels:@[@"Alerts"]];
+}
+
+- (void)testFindMatchesWithEndsWithFunction
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[ends-with(@label, 'ing')]"
+       findsButtonLabels:@[@"Scrolling"]];
+}
+
+- (void)testFindMatchesWithLowerCaseFunction
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[lower-case(@label)='alerts']"
+       findsButtonLabels:@[@"Alerts"]];
+}
+
+- (void)testFindMatchesWithUpperCaseFunction
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[upper-case(@label)='TOUCH']"
+       findsButtonLabels:@[@"Touch"]];
+}
+
+- (void)testFindMatchesWithReplaceFunction
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[replace(@label, ' ', '')='Deadlockapp']"
+       findsButtonLabels:@[@"Deadlock app"]];
+}
+
+- (void)testFindMatchesWithTokenizeAndStringJoinFunctions
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[string-join(tokenize(@label, ' '), '-')='Deadlock-app']"
+       findsButtonLabels:@[@"Deadlock app"]];
+}
+
+- (void)testFindMatchesWithExtensionFunctionsNoMatches
+{
+  NSArray<id<FBXCElementSnapshot>> *matchingSnapshots = [FBXPath matchesWithRootElement:self.testedApplication
+                                                                               forQuery:@"//XCUIElementTypeButton[matches(@label, '^NoSuchButton$')]"];
+  XCTAssertEqual(matchingSnapshots.count, 0);
+}
+
+- (void)testFindMultipleMatchesWithMatchesFunction
+{
+  [self assertXPathQuery:@"//XCUIElementTypeButton[matches(@label, '.*')]"
+       findsButtonLabels:FBMainViewButtonLabels];
+}
+
+- (void)testInvalidXPathExtensionFunctionViaElementLookup
+{
+  XCTAssertThrowsSpecificNamed([self.testedView fb_descendantsMatchingXPathQuery:@"//XCUIElementTypeButton[matches(@label)]"
+                                                      shouldReturnAfterFirstMatch:NO],
+                               NSException,
+                               FBInvalidXPathException);
+}
+
+- (void)testInvalidXPathExtensionRegexpViaElementLookup
+{
+  NSException *exception = nil;
+  @try {
+    [self.testedView fb_descendantsMatchingXPathQuery:@"//XCUIElementTypeButton[matches(@label, '[')]"
+                             shouldReturnAfterFirstMatch:NO];
+  } @catch (NSException *caughtException) {
+    exception = caughtException;
+  }
+  XCTAssertEqualObjects(exception.name, FBInvalidXPathException);
+  XCTAssertTrue([exception.reason containsString:@"Cannot evaluate results for XPath expression"]);
+  XCTAssertTrue([exception.reason rangeOfString:@"invalid" options:NSCaseInsensitiveSearch].location != NSNotFound);
+}
+
 @end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/XCElementSnapshotHelperTests.m

@@ -36,13 +36,7 @@
 
 - (void)testDescendantsMatchingType
 {
-  NSSet<NSString *> *expectedLabels = [NSSet setWithArray:@[
-    @"Alerts",
-    @"Attributes",
-    @"Scrolling",
-    @"Deadlock app",
-    @"Touch",
-  ]];
+  NSSet<NSString *> *expectedLabels = [NSSet setWithArray:FBMainViewButtonLabels];
   NSArray<id<FBXCElementSnapshot>> *matchingSnapshots = [[FBXCElementSnapshotWrapper ensureWrapped:
                                                           [self.testedView fb_customSnapshot]]
                                                          fb_descendantsMatchingType:XCUIElementTypeButton];

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/XCUIApplicationHelperTests.m

@@ -124,7 +124,7 @@ void calculateMaxTreeDepth(NSDictionary *tree, NSNumber *currentDepth, NSNumber*
 - (void)testAccessbilityAudit
 {
   if (SYSTEM_VERSION_LESS_THAN(@"17.0")) {
-    return;
+    XCTSkip(@"Requires iOS 17.0+");
   }
 
   NSError *error;

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/XCUIDeviceHelperTests.m

@@ -90,7 +90,7 @@
 {
   NSString *adderss = [XCUIDevice sharedDevice].fb_wifiIPAddress;
   if (!adderss) {
-    return;
+    XCTSkip(@"No WiFi IP address available on this device");
   }
   NSRange range = [adderss rangeOfString:@"^([0-9]{1,3})\\.([0-9]{1,3})\\.([0-9]{1,3})\\.([0-9]{1,3})" options:NSRegularExpressionSearch];
   XCTAssertTrue(range.location != NSNotFound);
@@ -119,7 +119,7 @@
 - (void)testUrlSchemeActivation
 {
   if (SYSTEM_VERSION_LESS_THAN(@"16.4")) {
-    return;
+    XCTSkip(@"Requires iOS 16.4+");
   }
 
   NSError *error;
@@ -131,7 +131,7 @@
 - (void)testUrlSchemeActivationWithApp
 {
   if (SYSTEM_VERSION_LESS_THAN(@"16.4")) {
-    return;
+    XCTSkip(@"Requires iOS 16.4+");
   }
 
   NSError *error;
@@ -146,7 +146,7 @@
 - (void)testSimulatedLocationSetup
 {
   if (SYSTEM_VERSION_LESS_THAN(@"16.4")) {
-    return;
+    XCTSkip(@"Requires iOS 16.4+");
   }
 
   CLLocation *simulatedLocation = [[CLLocation alloc] initWithLatitude:50 longitude:50];
@@ -186,6 +186,22 @@
   XCTAssertNil(error);
 }
 
+- (void)testPressingDeviceSpecificButton
+{
+  NSError *error;
+  BOOL hasActionButton = [XCUIDevice.sharedDevice fb_hasButton:@"action"];
+  BOOL didPressButton = [XCUIDevice.sharedDevice fb_pressButton:@"action"
+                                                     forDuration:nil
+                                                           error:&error];
+  if (hasActionButton) {
+    XCTAssertTrue(didPressButton);
+    XCTAssertNil(error);
+  } else {
+    XCTAssertFalse(didPressButton);
+    XCTAssertNotNil(error);
+  }
+}
+
 - (void)testPressingSupportedButtonNumber
 {
   NSError *error;
@@ -210,7 +226,7 @@
 - (void)testAppearance
 {
   if (SYSTEM_VERSION_LESS_THAN(@"15.0")) {
-    return;
+    XCTSkip(@"Requires iOS 15.0+");
   }
   NSError *error;
   XCTAssertTrue([XCUIDevice.sharedDevice fb_setAppearance:FBUIInterfaceAppearanceDark error:&error]);

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/XCUIDeviceRotationTests.m

@@ -69,6 +69,27 @@
   XCTAssertTrue(self.testedApplication.staticTexts[@"LandscapeRight"].exists);
 }
 
+- (void)testGetDeviceOrientationInPortrait
+{
+  BOOL success = [[XCUIDevice sharedDevice] fb_setDeviceInterfaceOrientation:UIDeviceOrientationPortrait];
+  XCTAssertTrue(success, @"Device should support Portrait");
+  XCTAssertEqualObjects([XCUIDevice sharedDevice].fb_deviceOrientation, @"UIDeviceOrientationPortrait");
+}
+
+- (void)testGetDeviceOrientationInLandscapeLeft
+{
+  BOOL success = [[XCUIDevice sharedDevice] fb_setDeviceInterfaceOrientation:UIDeviceOrientationLandscapeLeft];
+  XCTAssertTrue(success, @"Device should support LandscapeLeft");
+  XCTAssertEqualObjects([XCUIDevice sharedDevice].fb_deviceOrientation, @"UIDeviceOrientationLandscapeLeft");
+}
+
+- (void)testGetDeviceOrientationInLandscapeRight
+{
+  BOOL success = [[XCUIDevice sharedDevice] fb_setDeviceInterfaceOrientation:UIDeviceOrientationLandscapeRight];
+  XCTAssertTrue(success, @"Device should support LandscapeRight");
+  XCTAssertEqualObjects([XCUIDevice sharedDevice].fb_deviceOrientation, @"UIDeviceOrientationLandscapeRight");
+}
+
 - (void)testRotationTiltRotation
 {
   UIDeviceOrientation currentRotation = [XCUIDevice sharedDevice].orientation;

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/XCUIElementAttributesTests.m

@@ -176,7 +176,7 @@
 
 - (void)testCompactResponseYesWithResponseAttributesSet
 {
-  [FBConfiguration setElementResponseAttributes:@"name,text,enabled"];
+  FBConfiguration.sharedInstance.elementResponseAttributes = @"name,text,enabled";
   XCUIElement *alertsButton = self.testedApplication.buttons[@"Alerts"];
   NSDictionary *fields = FBDictionaryResponseWithElement(alertsButton, YES);
   XCTAssertNotNil(fields[@"ELEMENT"]);
@@ -186,7 +186,7 @@
 
 - (void)testCompactResponseNoWithResponseAttributesSet
 {
-  [FBConfiguration setElementResponseAttributes:@"name,text,enabled"];
+  FBConfiguration.sharedInstance.elementResponseAttributes = @"name,text,enabled";
   XCUIElement *alertsButton = self.testedApplication.buttons[@"Alerts"];
   NSDictionary *fields = FBDictionaryResponseWithElement(alertsButton, NO);
   XCTAssertNotNil(fields[@"ELEMENT"]);
@@ -199,7 +199,7 @@
 
 - (void)testInvalidAttribute
 {
-  [FBConfiguration setElementResponseAttributes:@"invalid_field,name"];
+  FBConfiguration.sharedInstance.elementResponseAttributes = @"invalid_field,name";
   XCUIElement *alertsButton = self.testedApplication.buttons[@"Alerts"];
   NSDictionary *fields = FBDictionaryResponseWithElement(alertsButton, NO);
   XCTAssertNotNil(fields[@"ELEMENT"]);
@@ -210,7 +210,7 @@
 
 - (void)testKnownAttributes
 {
-  [FBConfiguration setElementResponseAttributes:@"name,type,label,text,rect,enabled,displayed,selected"];
+  FBConfiguration.sharedInstance.elementResponseAttributes = @"name,type,label,text,rect,enabled,displayed,selected";
   XCUIElement *alertsButton = self.testedApplication.buttons[@"Alerts"];
   NSDictionary *fields = FBDictionaryResponseWithElement(alertsButton, NO);
   XCTAssertNotNil(fields[@"ELEMENT"]);
@@ -228,7 +228,7 @@
 
 - (void)testArbitraryAttributes
 {
-  [FBConfiguration setElementResponseAttributes:@"attribute/name,attribute/value"];
+  FBConfiguration.sharedInstance.elementResponseAttributes = @"attribute/name,attribute/value";
   XCUIElement *alertsButton = self.testedApplication.buttons[@"Alerts"];
   NSDictionary *fields = FBDictionaryResponseWithElement(alertsButton, NO);
   XCTAssertNotNil(fields[@"ELEMENT"]);

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/IntegrationTests/XCUIElementFBFindTests.m

@@ -21,6 +21,7 @@
 #import "XCUIElement+FBResolve.h"
 #import "FBXPath.h"
 #import "FBXCodeCompatibility.h"
+#import "XCUIElement+FBUtilities.h"
 
 @interface XCUIElementFBFindTests : FBIntegrationTestCase
 @property (nonatomic, strong) XCUIElement *testedView;
@@ -41,13 +42,7 @@
 
 - (void)testDescendantsWithClassName
 {
-  NSSet<NSString *> *expectedLabels = [NSSet setWithArray:@[
-    @"Alerts",
-    @"Attributes",
-    @"Scrolling",
-    @"Deadlock app",
-    @"Touch",
-  ]];
+  NSSet<NSString *> *expectedLabels = [NSSet setWithArray:FBMainViewButtonLabels];
   NSArray<XCUIElement *> *matchingSnapshots = [self.testedView fb_descendantsMatchingClassName:@"XCUIElementTypeButton"
                                                                    shouldReturnAfterFirstMatch:NO];
   XCTAssertEqual(matchingSnapshots.count, expectedLabels.count);
@@ -273,7 +268,7 @@
   NSString *queryString =@"XCUIElementTypeWindow/XCUIElementTypeOther/**/XCUIElementTypeButton";
   matchingSnapshots = [self.testedApplication fb_descendantsMatchingClassChain:queryString
                                                    shouldReturnAfterFirstMatch:NO];
-  XCTAssertEqual(matchingSnapshots.count, 5); // /XCUIElementTypeButton
+  XCTAssertEqual(matchingSnapshots.count, FBMainViewButtonLabels.count); // /XCUIElementTypeButton
   for (XCUIElement *matchingSnapshot in matchingSnapshots) {
     XCTAssertEqual(matchingSnapshot.elementType, XCUIElementTypeButton);
   }
@@ -292,7 +287,7 @@
     matchingSnapshots = [self.testedApplication fb_descendantsMatchingClassChain:queryString
                                                      shouldReturnAfterFirstMatch:NO];
   }
-  XCTAssertEqual(matchingSnapshots.count, 5); // /XCUIElementTypeButton
+  XCTAssertEqual(matchingSnapshots.count, FBMainViewButtonLabels.count); // /XCUIElementTypeButton
   for (XCUIElement *matchingSnapshot in matchingSnapshots) {
     XCTAssertEqual(matchingSnapshot.elementType, XCUIElementTypeButton);
   }
@@ -376,7 +371,7 @@
   
   XCTAssertEqual(matchingSnapshots.count, 1);
   XCTAssertEqual(matchingSnapshots.lastObject.elementType, XCUIElementTypeButton);
-  XCTAssertTrue([matchingSnapshots.lastObject.label isEqualToString:@"Touch"]);
+  XCTAssertEqualObjects(matchingSnapshots.lastObject.label, FBMainViewButtonLabels.lastObject);
   
   matchingSnapshots = [self.testedView fb_descendantsMatchingClassChain:@"XCUIElementTypeButton[-10]"
                                             shouldReturnAfterFirstMatch:YES];
@@ -470,3 +465,96 @@
 }
 
 @end
+
+@interface XCUIElementFBFindTests_DeepHierarchyPage : FBIntegrationTestCase
+@end
+@implementation XCUIElementFBFindTests_DeepHierarchyPage
+
+- (void)setUp
+{
+  [super setUp];
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    [self launchApplication];
+    [self goToDeepHierarchyPage];
+  });
+}
+
+// No intermediate segment has a position here (only the final one does), so
+// this exercises the query-based class chain strategy - the fast path for
+// the common case. See fb_hasIntermediatePosition: in XCUIElement+FBClassChain.m.
+- (void)testClassChainWithoutIntermediatePositionOnDeepHierarchy
+{
+  NSString *query = @"**/XCUIElementTypeOther[`label BEGINSWITH \"View 19\"`]/XCUIElementTypeOther[1]";
+  NSArray<XCUIElement *> *matches = [self.testedApplication fb_descendantsMatchingClassChain:query
+                                                                   shouldReturnAfterFirstMatch:NO];
+  XCTAssertEqual(matches.count, 1);
+  XCTAssertEqualObjects(matches.firstObject.label, @"View 20");
+}
+
+// The first segment here has an explicit position and is not the last
+// segment in the chain, so this exercises the snapshot-walk class chain
+// strategy - the one that avoids paying an extra accessibility round trip
+// per intermediate indexed segment.
+- (void)testClassChainWithIntermediatePositionOnDeepHierarchy
+{
+  NSString *query = @"**/XCUIElementTypeOther[`label == \"View 10\"`][1]/**/XCUIElementTypeOther[`label BEGINSWITH \"View 19\"`]";
+  NSArray<XCUIElement *> *matches = [self.testedApplication fb_descendantsMatchingClassChain:query
+                                                                   shouldReturnAfterFirstMatch:NO];
+  XCTAssertEqual(matches.count, 1);
+  XCTAssertEqualObjects(matches.firstObject.label, @"View 19");
+}
+
+// Exercises the snapshot-walk strategy with several intermediate positions
+// (the shape it exists for), as opposed to testPerformanceOfClassChainLookupOnDeepHierarchy
+// above, which only has a position on the final segment and stays on the
+// query-based strategy. Kept within the default snapshotMaxDepth (50)
+// combined with the app's own chrome depth above this fixture's root -
+// going deeper hit a native kAXErrorIllegalArgument even after raising
+// snapshotMaxDepth, which looks like a platform-level limitation
+// independent of this lookup, not something to route around here.
+- (void)testPerformanceOfMultiCheckpointClassChainLookupOnDeepHierarchy
+{
+  NSString *query = @"**/XCUIElementTypeOther[`label == \"View 5\"`][1]/**/XCUIElementTypeOther[`label == \"View 15\"`][1]/**/XCUIElementTypeOther[`label == \"View 25\"`][1]/**/XCUIElementTypeOther[`label BEGINSWITH \"View 30\"`]";
+  [self measureBlock:^{
+    NSArray<XCUIElement *> *matches = [self.testedApplication fb_descendantsMatchingClassChain:query
+                                                                     shouldReturnAfterFirstMatch:NO];
+    XCTAssertEqual(matches.count, 1);
+  }];
+}
+
+// Not a strict pass/fail assertion (timings vary across machines/CI) - this
+// records a measurement baseline so future regressions on this lookup show
+// up in Xcode's test reports.
+- (void)testPerformanceOfClassChainLookupOnDeepHierarchy
+{
+  NSString *query = @"**/XCUIElementTypeOther[`label BEGINSWITH \"View 19\"`]/XCUIElementTypeOther[1]";
+  [self measureBlock:^{
+    NSArray<XCUIElement *> *matches = [self.testedApplication fb_descendantsMatchingClassChain:query
+                                                                     shouldReturnAfterFirstMatch:NO];
+    XCTAssertEqual(matches.count, 1);
+  }];
+}
+
+@end
+
+@interface XCUIElementFBFindTests_StaleAppSnapshot : FBIntegrationTestCase
+@end
+@implementation XCUIElementFBFindTests_StaleAppSnapshot
+
+// Regression test for https://github.com/appium/appium/issues/22672.
+- (void)testClassChainWithIntermediatePositionAfterStaleAppSnapshot
+{
+  [self launchApplication];
+  // Simulates a stale snapshot cached by an earlier, unrelated command (e.g. GET /source).
+  [self.testedApplication fb_customSnapshot];
+  [self goToDeepHierarchyPage];
+
+  NSString *query = @"**/XCUIElementTypeOther[`label == \"View 10\"`][1]/**/XCUIElementTypeOther[`label BEGINSWITH \"View 19\"`]";
+  NSArray<XCUIElement *> *matches = [self.testedApplication fb_descendantsMatchingClassChain:query
+                                                                   shouldReturnAfterFirstMatch:NO];
+  XCTAssertEqual(matches.count, 1);
+  XCTAssertEqualObjects(matches.firstObject.label, @"View 19");
+}
+
+@end