@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBWebDriverAttributes.h

@@ -0,0 +1,32 @@
+/**
+ * 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 <WebDriverAgentLib/FBElement.h>
+#import <WebDriverAgentLib/XCUIElement.h>
+#import <WebDriverAgentLib/FBXCElementSnapshotWrapper.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface XCUIElement (WebDriverAttributes) <FBElement>
+
+@end
+
+
+@interface FBXCElementSnapshotWrapper (WebDriverAttributes) <FBElement>
+
+/**
+ Fetches wdName attribute value for the given snapshot instance
+
+ @param snapshot snapshot instance
+ @return wdName attribute value or nil
+ */
++ (nullable NSString *)wdNameWithSnapshot:(id<FBXCElementSnapshot>)snapshot;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBWebDriverAttributes.m

@@ -0,0 +1,294 @@
+/**
+ * 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 "XCUIElement+FBWebDriverAttributes.h"
+
+#import "FBConfiguration.h"
+#import "FBElementTypeTransformer.h"
+#import "FBElementHelpers.h"
+#import "FBLogger.h"
+#import "FBMacros.h"
+#import "FBXCElementSnapshotWrapper.h"
+#import "XCUIElement+FBAccessibility.h"
+#import "XCUIElement+FBIsVisible.h"
+#import "XCUIElement+FBUID.h"
+#import "XCUIElement.h"
+#import "XCUIElement+FBUtilities.h"
+#import "FBElementUtils.h"
+#import "XCTestPrivateSymbols.h"
+#import "XCUIHitPointResult.h"
+#import "FBAccessibilityTraits.h"
+#import "XCUIElement+FBMinMax.h"
+#import "XCUIElement+FBCustomActions.h"
+
+#define BROKEN_RECT CGRectMake(-1, -1, 0, 0)
+
+@implementation XCUIElement (WebDriverAttributesForwarding)
+
+- (id<FBXCElementSnapshot>)fb_snapshotForAttributeName:(NSString *)name
+{
+  // https://github.com/appium/appium-xcuitest-driver/pull/2565
+  if ([name isEqualToString:FBStringify(XCUIElement, isWDHittable)]) {
+    return [self fb_nativeSnapshot];
+  }
+  // https://github.com/appium/WebDriverAgent/issues/1085
+  if (FBConfiguration.enforceCustomSnapshots) {
+    return [self fb_customSnapshot];
+  }
+  // https://github.com/appium/appium-xcuitest-driver/issues/2552
+  BOOL isValueRequest = [name isEqualToString:FBStringify(XCUIElement, wdValue)];
+  if ([self isKindOfClass:XCUIApplication.class] && !isValueRequest) {
+    return [self fb_standardSnapshot];
+  }
+  BOOL isCustomSnapshot = [name isEqualToString:FBStringify(XCUIElement, isWDAccessible)]
+    || [name isEqualToString:FBStringify(XCUIElement, isWDAccessibilityContainer)]
+    || [name isEqualToString:FBStringify(XCUIElement, wdIndex)]
+    || isValueRequest;
+  return isCustomSnapshot ? [self fb_customSnapshot] : [self fb_standardSnapshot];
+}
+
+- (id)fb_valueForWDAttributeName:(NSString *)name
+{
+  NSString *wdAttributeName = [FBElementUtils wdAttributeNameForAttributeName:name];
+  id<FBXCElementSnapshot> snapshot = [self fb_snapshotForAttributeName:wdAttributeName];
+  return [[FBXCElementSnapshotWrapper ensureWrapped:snapshot] fb_valueForWDAttributeName:name];
+}
+
+- (id)forwardingTargetForSelector:(SEL)aSelector
+{
+  static dispatch_once_t onceToken;
+  static NSSet<NSString *> *fbElementAttributeNames;
+  dispatch_once(&onceToken, ^{
+    fbElementAttributeNames = [FBElementUtils selectorNamesWithProtocol:@protocol(FBElement)];
+  });
+  NSString* attributeName = NSStringFromSelector(aSelector);
+  return [fbElementAttributeNames containsObject:attributeName]
+    ? [FBXCElementSnapshotWrapper ensureWrapped:[self fb_snapshotForAttributeName:attributeName]]
+    : nil;
+}
+
+@end
+
+
+@implementation FBXCElementSnapshotWrapper (WebDriverAttributes)
+
+- (id)fb_valueForWDAttributeName:(NSString *)name
+{
+  return [self valueForKey:[FBElementUtils wdAttributeNameForAttributeName:name]];
+}
+
+- (NSNumber *)wdMinValue
+{
+  return self.fb_minValue;
+}
+
+- (NSNumber *)wdMaxValue
+{
+  return self.fb_maxValue;
+}
+
+- (NSString *)wdValue
+{
+  id value = self.value;
+  XCUIElementType elementType = self.elementType;
+  if (elementType == XCUIElementTypeStaticText) {
+    NSString *label = self.label;
+    value = FBFirstNonEmptyValue(value, label);
+  } else if (elementType == XCUIElementTypeButton) {
+    NSNumber *isSelected = self.isSelected ? @YES : nil;
+    value = FBFirstNonEmptyValue(value, isSelected);
+  } else if (elementType == XCUIElementTypeSwitch) {
+    value = @([value boolValue]);
+  } else if (FBDoesElementSupportInnerText(elementType)) {
+    NSString *placeholderValue = self.placeholderValue;
+    value = FBFirstNonEmptyValue(value, placeholderValue);
+  }
+  value = FBTransferEmptyStringToNil(value);
+  if (value) {
+    value = [NSString stringWithFormat:@"%@", value];
+  }
+  return value;
+}
+
++ (NSString *)wdNameWithSnapshot:(id<FBXCElementSnapshot>)snapshot
+{
+  NSString *identifier = snapshot.identifier;
+  if (nil != identifier && identifier.length != 0) {
+    return identifier;
+  }
+  NSString *label = snapshot.label;
+  return FBTransferEmptyStringToNil(label);
+}
+
+- (NSString *)wdName
+{
+  return [self.class wdNameWithSnapshot:self.snapshot];
+}
+
+- (NSString *)wdLabel
+{
+  XCUIElementType elementType = self.elementType;
+  return (elementType == XCUIElementTypeTextField
+          || elementType == XCUIElementTypeSecureTextField)
+    ? self.label
+    : FBTransferEmptyStringToNil(self.label);
+}
+
+- (NSString *)wdPlaceholderValue
+{
+  return FBDoesElementSupportInnerText(self.elementType)
+    ? self.placeholderValue
+    : FBTransferEmptyStringToNil(self.placeholderValue);
+}
+
+- (NSString *)wdType
+{
+  return [FBElementTypeTransformer stringWithElementType:self.elementType];
+}
+
+- (NSString *)wdUID
+{
+  return self.fb_uid;
+}
+
+- (CGRect)wdFrame
+{
+  CGRect frame = self.frame;
+  // It is mandatory to replace all Infinity values with numbers to avoid JSON parsing
+  // exceptions like https://github.com/facebook/WebDriverAgent/issues/639#issuecomment-314421206
+  // caused by broken element dimensions returned by XCTest
+  return (isinf(frame.size.width) || isinf(frame.size.height)
+          || isinf(frame.origin.x) || isinf(frame.origin.y))
+    ? CGRectIntegral(BROKEN_RECT)
+    : CGRectIntegral(frame);
+}
+
+- (CGRect)wdNativeFrame
+{
+  // To avoid confusion regarding the frame returned by `wdFrame`,
+  // the current property is provided to represent the element's
+  // actual rendered frame.
+  return self.frame;
+}
+
+/**
+ Returns a comma-separated string of accessibility traits for the element.
+ This method converts the element's accessibility traits bitmask into human-readable strings
+ using FBAccessibilityTraitsToStringsArray. The traits represent various accessibility
+ characteristics of the element such as Button, Link, Image, etc.
+ You can find the list of possible traits in the Apple documentation:
+ https://developer.apple.com/documentation/uikit/uiaccessibilitytraits?language=objc
+
+ @return A comma-separated string of accessibility traits, or an empty string if no traits are set
+ */
+- (NSString *)wdTraits
+{
+  NSArray<NSString *> *traits = FBAccessibilityTraitsToStringsArray(self.snapshot.traits);
+  return [traits componentsJoinedByString:@", "];
+}
+
+- (BOOL)isWDVisible
+{
+  return self.fb_isVisible;
+}
+
+- (BOOL)isWDFocused
+{
+  return self.hasFocus;
+}
+
+- (BOOL)isWDAccessible
+{
+  XCUIElementType elementType = self.elementType;
+  // Special cases:
+  // Table view cell: we consider it accessible if it's container is accessible
+  // Text fields: actual accessible element isn't text field itself, but nested element
+  if (elementType == XCUIElementTypeCell) {
+    if (!self.fb_isAccessibilityElement) {
+      id<FBXCElementSnapshot> containerView = [[self children] firstObject];
+      if (![FBXCElementSnapshotWrapper ensureWrapped:containerView].fb_isAccessibilityElement) {
+        return NO;
+      }
+    }
+  } else if (elementType != XCUIElementTypeTextField && elementType != XCUIElementTypeSecureTextField) {
+    if (!self.fb_isAccessibilityElement) {
+      return NO;
+    }
+  }
+  id<FBXCElementSnapshot> parentSnapshot = self.parent;
+  while (parentSnapshot) {
+    // In the scenario when table provides Search results controller, table could be marked as accessible element, even though it isn't
+    // As it is highly unlikely that table view should ever be an accessibility element itself,
+    // for now we work around that by skipping Table View in container checks
+    if (parentSnapshot.elementType != XCUIElementTypeTable
+        && [FBXCElementSnapshotWrapper ensureWrapped:parentSnapshot].fb_isAccessibilityElement) {
+      return NO;
+    }
+    parentSnapshot = parentSnapshot.parent;
+  }
+  return YES;
+}
+
+- (BOOL)isWDAccessibilityContainer
+{
+  NSArray<id<FBXCElementSnapshot>> *children = self.children;
+  for (id<FBXCElementSnapshot> child in children) {
+    FBXCElementSnapshotWrapper *wrappedChild = [FBXCElementSnapshotWrapper ensureWrapped:child];
+    if (wrappedChild.isWDAccessibilityContainer || wrappedChild.fb_isAccessibilityElement) {
+      return YES;
+    }
+  }
+  return NO;
+}
+
+- (BOOL)isWDEnabled
+{
+  return self.isEnabled;
+}
+
+- (BOOL)isWDSelected
+{
+  return self.isSelected;
+}
+
+- (NSUInteger)wdIndex
+{
+  if (nil != self.parent) {
+    for (NSUInteger index = 0; index < self.parent.children.count; ++index) {
+      if ([self.parent.children objectAtIndex:index] == self.snapshot) {
+        return index;
+      }
+    }
+  }
+
+  return 0;
+}
+
+- (BOOL)isWDHittable
+{
+  XCUIHitPointResult *result = [self hitPoint:nil];
+  return nil == result ? NO : result.hittable;
+}
+
+- (NSDictionary *)wdRect
+{
+  CGRect frame = self.wdFrame;
+  return @{
+    @"x": @(CGRectGetMinX(frame)),
+    @"y": @(CGRectGetMinY(frame)),
+    @"width": @(CGRectGetWidth(frame)),
+    @"height": @(CGRectGetHeight(frame)),
+  };
+ }
+
+- (NSString *)wdCustomActions
+{
+    return self.fb_customActions;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElementQuery+FBHelpers.h

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2018-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/XCTest.h>
+#import "FBXCElementSnapshot.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface XCUIElementQuery (FBHelpers)
+
+/**
+ Extracts the cached element snapshot from its query.
+ No requests to the accessiblity framework is made.
+ It is only safe to use this call right after element lookup query
+ has been executed.
+
+ @return Either the cached snapshot or nil
+ */
+- (nullable id<FBXCElementSnapshot>)fb_cachedSnapshot;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElementQuery+FBHelpers.m

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2018-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 "XCUIElementQuery+FBHelpers.h"
+
+#import "FBXCodeCompatibility.h"
+#import "XCUIElementQuery.h"
+#import "FBXCElementSnapshot.h"
+
+@implementation XCUIElementQuery (FBHelpers)
+
+- (nullable id<FBXCElementSnapshot>)fb_cachedSnapshot
+{
+  id<FBXCElementSnapshot> rootElementSnapshot = self.rootElementSnapshot;
+  if (nil == rootElementSnapshot) {
+    return nil;
+  }
+
+  XCUIElementQuery *inputQuery = self;
+  NSMutableArray<id<XCTElementSetTransformer>> *transformersChain = [NSMutableArray array];
+  while (nil != inputQuery && nil != inputQuery.transformer) {
+    [transformersChain insertObject:inputQuery.transformer atIndex:0];
+    inputQuery = inputQuery.inputQuery;
+  }
+
+  NSMutableArray *snapshots = [NSMutableArray arrayWithObject:rootElementSnapshot];
+  [snapshots addObjectsFromArray:rootElementSnapshot._allDescendants];
+  NSOrderedSet *matchingSnapshots = [NSOrderedSet orderedSetWithArray:snapshots];
+  @try {
+    for (id<XCTElementSetTransformer> transformer in transformersChain) {
+      matchingSnapshots = (NSOrderedSet *)[transformer transform:matchingSnapshots
+                                                 relatedElements:nil];
+    }
+    return matchingSnapshots.count == 1 ? matchingSnapshots.firstObject : nil;
+  } @catch (NSException *e) {
+    [FBLogger logFmt:@"Got an unexpected error while retriveing the cached snapshot: %@", e.reason];
+  }
+  return nil;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBAlertViewCommands.h

@@ -0,0 +1,19 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+#import <WebDriverAgentLib/FBCommandHandler.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBAlertViewCommands : NSObject <FBCommandHandler>
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBAlertViewCommands.m

@@ -0,0 +1,130 @@
+/**
+ * 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 "FBAlertViewCommands.h"
+
+#import "FBAlert.h"
+#import "FBRouteRequest.h"
+#import "FBSession.h"
+#import "XCUIApplication+FBHelpers.h"
+
+@implementation FBAlertViewCommands
+
+#pragma mark - <FBCommandHandler>
+
++ (NSArray *)routes
+{
+  return
+  @[
+    [[FBRoute GET:@"/alert/text"] respondWithTarget:self action:@selector(handleAlertGetTextCommand:)],
+    [[FBRoute GET:@"/alert/text"].withoutSession respondWithTarget:self action:@selector(handleAlertGetTextCommand:)],
+    [[FBRoute POST:@"/alert/text"] respondWithTarget:self action:@selector(handleAlertSetTextCommand:)],
+    [[FBRoute POST:@"/alert/accept"] respondWithTarget:self action:@selector(handleAlertAcceptCommand:)],
+    [[FBRoute POST:@"/alert/accept"].withoutSession respondWithTarget:self action:@selector(handleAlertAcceptCommand:)],
+    [[FBRoute POST:@"/alert/dismiss"] respondWithTarget:self action:@selector(handleAlertDismissCommand:)],
+    [[FBRoute POST:@"/alert/dismiss"].withoutSession respondWithTarget:self action:@selector(handleAlertDismissCommand:)],
+    [[FBRoute GET:@"/wda/alert/buttons"] respondWithTarget:self action:@selector(handleGetAlertButtonsCommand:)],
+  ];
+}
+
+
+#pragma mark - Commands
+
++ (id<FBResponsePayload>)handleAlertGetTextCommand:(FBRouteRequest *)request
+{
+  XCUIApplication *application = request.session.activeApplication ?: XCUIApplication.fb_activeApplication;
+  NSString *alertText = [FBAlert alertWithApplication:application].text;
+  if (!alertText) {
+    return FBResponseWithStatus([FBCommandStatus noAlertOpenErrorWithMessage:nil
+                                                                   traceback:nil]);
+  }
+  return FBResponseWithObject(alertText);
+}
+
++ (id<FBResponsePayload>)handleAlertSetTextCommand:(FBRouteRequest *)request
+{
+  FBSession *session = request.session;
+  id value = request.arguments[@"value"];
+  if (!value) {
+    return FBResponseWithStatus([FBCommandStatus invalidArgumentErrorWithMessage:@"Missing 'value' parameter" traceback:nil]);
+  }
+  FBAlert *alert = [FBAlert alertWithApplication:session.activeApplication];
+  if (!alert.isPresent) {
+    return FBResponseWithStatus([FBCommandStatus noAlertOpenErrorWithMessage:nil
+                                                                   traceback:nil]);
+  }
+  NSString *textToType = value;
+  if ([value isKindOfClass:[NSArray class]]) {
+    textToType = [value componentsJoinedByString:@""];
+  }
+  NSError *error;
+  if (![alert typeText:textToType error:&error]) {
+    return FBResponseWithStatus([FBCommandStatus unsupportedOperationErrorWithMessage:error.description
+                                                                            traceback:[NSString stringWithFormat:@"%@", NSThread.callStackSymbols]]);
+  }
+  return FBResponseWithOK();
+}
+
++ (id<FBResponsePayload>)handleAlertAcceptCommand:(FBRouteRequest *)request
+{
+  XCUIApplication *application = request.session.activeApplication ?: XCUIApplication.fb_activeApplication;
+  NSString *name = request.arguments[@"name"];
+  FBAlert *alert = [FBAlert alertWithApplication:application];
+  NSError *error;
+
+  if (!alert.isPresent) {
+    return FBResponseWithStatus([FBCommandStatus noAlertOpenErrorWithMessage:nil
+                                                                   traceback:nil]);
+  }
+  if (name) {
+    if (![alert clickAlertButton:name error:&error]) {
+      return FBResponseWithStatus([FBCommandStatus invalidElementStateErrorWithMessage:error.description
+                                                                             traceback:[NSString stringWithFormat:@"%@", NSThread.callStackSymbols]]);
+    }
+  } else if (![alert acceptWithError:&error]) {
+    return FBResponseWithStatus([FBCommandStatus invalidElementStateErrorWithMessage:error.description
+                                                                            traceback:[NSString stringWithFormat:@"%@", NSThread.callStackSymbols]]);
+  }
+  return FBResponseWithOK();
+}
+
++ (id<FBResponsePayload>)handleAlertDismissCommand:(FBRouteRequest *)request
+{
+  XCUIApplication *application = request.session.activeApplication ?: XCUIApplication.fb_activeApplication;
+  NSString *name = request.arguments[@"name"];
+  FBAlert *alert = [FBAlert alertWithApplication:application];
+  NSError *error;
+    
+  if (!alert.isPresent) {
+    return FBResponseWithStatus([FBCommandStatus noAlertOpenErrorWithMessage:nil
+                                                                   traceback:nil]);
+  }
+  if (name) {
+    if (![alert clickAlertButton:name error:&error]) {
+      return FBResponseWithStatus([FBCommandStatus invalidElementStateErrorWithMessage:error.description
+                                                                            traceback:[NSString stringWithFormat:@"%@", NSThread.callStackSymbols]]);
+    }
+  } else if (![alert dismissWithError:&error]) {
+    return FBResponseWithStatus([FBCommandStatus invalidElementStateErrorWithMessage:error.description
+                                                                            traceback:[NSString stringWithFormat:@"%@", NSThread.callStackSymbols]]);
+  }
+  return FBResponseWithOK();
+}
+
++ (id<FBResponsePayload>)handleGetAlertButtonsCommand:(FBRouteRequest *)request {
+  FBSession *session = request.session;
+  FBAlert *alert = [FBAlert alertWithApplication:session.activeApplication];
+
+  if (!alert.isPresent) {
+    return FBResponseWithStatus([FBCommandStatus noAlertOpenErrorWithMessage:nil
+                                                                   traceback:nil]);
+  }
+  NSArray *labels = alert.buttonLabels;
+  return FBResponseWithObject(labels);
+}
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Commands/FBCustomCommands.h

@@ -0,0 +1,19 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+#import <WebDriverAgentLib/FBCommandHandler.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBCustomCommands : NSObject <FBCommandHandler>
+
+@end
+
+NS_ASSUME_NONNULL_END