@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBElementUtils.m

@@ -0,0 +1,153 @@
+/**
+ * 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 <objc/runtime.h>
+
+#import "FBXCAccessibilityElement.h"
+#import "FBElementUtils.h"
+#import "FBElementTypeTransformer.h"
+
+NSString *const FBUnknownAttributeException = @"FBUnknownAttributeException";
+static NSString *const WD_PREFIX = @"wd";
+static NSString *const OBJC_PROP_GETTER_PREFIX = @"G";
+static NSString *const OBJC_PROP_ATTRIBS_SEPARATOR = @",";
+
+@implementation FBElementUtils
+
++ (NSSet<NSString *> *)selectorNamesWithProtocol:(Protocol *)protocol
+{
+  unsigned int count;
+  struct objc_method_description *methods = protocol_copyMethodDescriptionList(protocol, YES, YES, &count);
+  NSMutableSet<NSString *> *result = [NSMutableSet set];
+  for (unsigned int i = 0; i < count; i++) {
+    SEL sel = methods[i].name;
+    if (nil != sel) {
+      [result addObject:NSStringFromSelector(sel)];
+    }
+  }
+  free(methods);
+  return result.copy;
+}
+
++ (NSString *)wdAttributeNameForAttributeName:(NSString *)name
+{
+  NSAssert(name.length > 0, @"Attribute name cannot be empty", nil);
+  NSDictionary *attributeNamesMapping = [self.class wdAttributeNamesMapping];
+  NSString *result = attributeNamesMapping[name];
+  if (nil == result) {
+    NSString *description = [NSString stringWithFormat:@"The attribute '%@' is unknown. Valid attribute names are: %@", name, [attributeNamesMapping.allKeys sortedArrayUsingSelector:@selector(compare:)]];
+    @throw [NSException exceptionWithName:FBUnknownAttributeException reason:description userInfo:@{}];
+    return nil;
+  }
+  return result;
+}
+
++ (NSSet<NSNumber *> *)uniqueElementTypesWithElements:(NSArray<id<FBElement>> *)elements
+{
+  NSMutableSet *matchingTypes = [NSMutableSet set];
+  [elements enumerateObjectsUsingBlock:^(id<FBElement> element, NSUInteger elementIdx, BOOL *stopElementsEnum) {
+    [matchingTypes addObject: @([FBElementTypeTransformer elementTypeWithTypeName:element.wdType])];
+  }];
+  return matchingTypes.copy;
+}
+
++ (NSDictionary<NSString *, NSString *> *)wdAttributeNamesMapping
+{
+  static NSDictionary *attributeNamesMapping;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    NSMutableDictionary *wdPropertyGettersMapping = [NSMutableDictionary new];
+    unsigned int propsCount = 0;
+    Protocol * aProtocol = objc_getProtocol(protocol_getName(@protocol(FBElement)));
+    objc_property_t *properties = protocol_copyPropertyList(aProtocol, &propsCount);
+    for (unsigned int i = 0; i < propsCount; ++i) {
+      objc_property_t property = properties[i];
+      const char *name = property_getName(property);
+      NSString *nsName = [NSString stringWithUTF8String:name];
+      if (nil == nsName || ![nsName hasPrefix:WD_PREFIX]) {
+        continue;
+      }
+      [wdPropertyGettersMapping setObject:[NSNull null] forKey:nsName];
+      const char *c_attributes = property_getAttributes(property);
+      NSString *attributes = [NSString stringWithUTF8String:c_attributes];
+      if (nil == attributes) {
+        continue;
+      }
+      // https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ObjCRuntimeGuide/Articles/ocrtPropertyIntrospection.html
+      NSArray *splitAttrs = [attributes componentsSeparatedByString:OBJC_PROP_ATTRIBS_SEPARATOR];
+      for (NSString *part in splitAttrs) {
+        if ([part hasPrefix:OBJC_PROP_GETTER_PREFIX]) {
+          [wdPropertyGettersMapping setObject:[part substringFromIndex:1] forKey:nsName];
+          break;
+        }
+      }
+    }
+    free(properties);
+
+    NSMutableDictionary *resultCache = [NSMutableDictionary new];
+    for (NSString *propName in wdPropertyGettersMapping) {
+      if ([[wdPropertyGettersMapping valueForKey:propName] isKindOfClass:NSNull.class]) {
+        // no getter
+        [resultCache setValue:propName forKey:propName];
+      } else {
+        // has getter method
+        [resultCache setValue:[wdPropertyGettersMapping objectForKey:propName] forKey:propName];
+      }
+      NSString *aliasName;
+      if (propName.length <= WD_PREFIX.length + 1) {
+        aliasName = [NSString stringWithFormat:@"%@",
+                        [propName substringWithRange:NSMakeRange(WD_PREFIX.length, 1)].lowercaseString];
+      } else {
+        NSString *propNameWithoutPrefix = [propName substringFromIndex:WD_PREFIX.length];
+        NSString *firstPropNameCharacter = [propNameWithoutPrefix substringWithRange:NSMakeRange(0, 1)];
+        if (![propNameWithoutPrefix isEqualToString:[propNameWithoutPrefix uppercaseString]]) {
+          // Lowercase the first character for the alias if the property name is not an uppercase abbreviation
+          firstPropNameCharacter = firstPropNameCharacter.lowercaseString;
+        }
+        aliasName = [NSString stringWithFormat:@"%@%@", firstPropNameCharacter, [propNameWithoutPrefix substringFromIndex:1]];
+      }
+      if ([[wdPropertyGettersMapping valueForKey:propName] isKindOfClass:NSNull.class]) {
+        // no getter
+        [resultCache setValue:propName forKey:aliasName];
+      } else {
+        // has getter method
+        [resultCache setValue:[wdPropertyGettersMapping objectForKey:propName] forKey:aliasName];
+      }
+    }
+    attributeNamesMapping = resultCache.copy;
+  });
+  return attributeNamesMapping;
+}
+
++ (NSString *)uidWithAccessibilityElement:(id<FBXCAccessibilityElement>)element
+{
+  unsigned long long elementId = [self.class idWithAccessibilityElement:element];
+  int processId = element.processIdentifier;
+  if (elementId < 1 || processId < 1) {
+    return nil;
+  }
+  uint8_t b[16] = {0};
+  memcpy(b, &elementId, sizeof(long long));
+  memcpy(b + sizeof(long long), &processId, sizeof(int));
+  NSUUID *uuidValue = [[NSUUID alloc] initWithUUIDBytes:b];
+  return uuidValue.UUIDString;
+}
+
+static BOOL FBShouldUsePayloadForUIDExtraction = YES;
+static dispatch_once_t oncePayloadToken;
++ (unsigned long long)idWithAccessibilityElement:(id<FBXCAccessibilityElement>)element
+{
+  dispatch_once(&oncePayloadToken, ^{
+    FBShouldUsePayloadForUIDExtraction = [(NSObject *)element respondsToSelector:@selector(payload)];
+  });
+  return FBShouldUsePayloadForUIDExtraction
+    ? [[element.payload objectForKey:@"uid.elementID"] longLongValue]
+    : [[(NSObject *)element valueForKey:@"_elementID"] longLongValue];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBExceptionHandler.h

@@ -0,0 +1,29 @@
+/**
+ * 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/FBWebServer.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Class used to handle exceptions raised by command handlers
+ */
+@interface FBExceptionHandler : NSObject
+
+/**
+ Handles 'exception' for 'webServer' raised while handling 'response'
+
+ @param exception exception that needs handling
+ @param response response related to that exception
+ */
+- (void)handleException:(NSException *)exception forResponse:(RouteResponse *)response;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBExceptionHandler.m

@@ -0,0 +1,58 @@
+/**
+ * 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 "FBExceptionHandler.h"
+
+#import "RouteResponse.h"
+
+#import "FBResponsePayload.h"
+#import "FBExceptions.h"
+
+@implementation FBExceptionHandler
+
+- (void)handleException:(NSException *)exception forResponse:(RouteResponse *)response
+{
+  FBCommandStatus *commandStatus;
+  NSString *traceback = [NSString stringWithFormat:@"%@", exception.callStackSymbols];
+  if ([exception.name isEqualToString:FBSessionDoesNotExistException]) {
+    commandStatus = [FBCommandStatus noSuchDriverErrorWithMessage:exception.reason
+                                                        traceback:traceback];
+  } else if ([exception.name isEqualToString:FBInvalidArgumentException]
+             || [exception.name isEqualToString:FBElementAttributeUnknownException]
+             || [exception.name isEqualToString:FBApplicationMissingException]) {
+    commandStatus = [FBCommandStatus invalidArgumentErrorWithMessage:exception.reason
+                                                           traceback:traceback];
+  } else if ([exception.name isEqualToString:FBApplicationCrashedException]
+             || [exception.name isEqualToString:FBApplicationDeadlockDetectedException]) {
+    commandStatus = [FBCommandStatus invalidElementStateErrorWithMessage:exception.reason
+                                                               traceback:traceback];
+  } else if ([exception.name isEqualToString:FBInvalidXPathException]
+             || [exception.name isEqualToString:FBClassChainQueryParseException]) {
+    commandStatus = [FBCommandStatus invalidSelectorErrorWithMessage:exception.reason
+                                                           traceback:traceback];
+  } else if ([exception.name isEqualToString:FBElementNotVisibleException]) {
+    commandStatus = [FBCommandStatus elementNotVisibleErrorWithMessage:exception.reason
+                                                             traceback:traceback];
+  } else if ([exception.name isEqualToString:FBStaleElementException]) {
+    commandStatus = [FBCommandStatus staleElementReferenceErrorWithMessage:exception.reason
+                                                                 traceback:traceback];
+  } else if ([exception.name isEqualToString:FBTimeoutException]) {
+    commandStatus = [FBCommandStatus timeoutErrorWithMessage:exception.reason
+                                                   traceback:traceback];
+  } else if ([exception.name isEqualToString:FBSessionCreationException]) {
+    commandStatus = [FBCommandStatus sessionNotCreatedError:exception.reason
+                                                  traceback:traceback];
+  } else {
+    commandStatus = [FBCommandStatus unknownErrorWithMessage:exception.reason
+                                                   traceback:traceback];
+  }
+  id<FBResponsePayload> payload = FBResponseWithStatus(commandStatus);
+  [payload dispatchWithResponse:response];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBExceptions.h

@@ -0,0 +1,60 @@
+/**
+ * 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/XCTest.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*! Exception used to notify about missing session */
+extern NSString *const FBSessionDoesNotExistException;
+
+/*! Exception used to notify about session creation issues */
+extern NSString *const FBSessionCreationException;
+
+/*! Exception used to notify about application deadlock */
+extern NSString *const FBApplicationDeadlockDetectedException;
+
+/*! Exception used to notify about unknown attribute */
+extern NSString *const FBElementAttributeUnknownException;
+
+/*! Exception used to notify about invalid argument */
+extern NSString *const FBInvalidArgumentException;
+
+/*! Exception used to notify about invisibility of an element while trying to interact with it */
+extern NSString *const FBElementNotVisibleException;
+
+/*! Exception used to notify about a timeout */
+extern NSString *const FBTimeoutException;
+
+/**
+ The exception happends if the cached element does not exist in DOM anymore
+ */
+extern NSString *const FBStaleElementException;
+
+/**
+ The exception happends if the provided XPath expession cannot be compiled because of a syntax error
+ */
+extern NSString *const FBInvalidXPathException;
+/**
+ The exception happends if any internal error is triggered during XPath matching procedure
+ */
+extern NSString *const FBXPathQueryEvaluationException;
+
+/*! Exception used to notify about invalid class chain query */
+extern NSString *const FBClassChainQueryParseException;
+
+/*! Exception used to notify about application crash */
+extern NSString *const FBApplicationCrashedException;
+
+/*! Exception used to notify about the application is not installed  */
+extern NSString *const FBApplicationMissingException;
+
+/*! Exception used to notify about WDA incompatibility with the current platform version */
+extern NSString *const FBIncompatibleWdaException;
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBExceptions.m

@@ -0,0 +1,24 @@
+/**
+ * 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 "FBExceptions.h"
+
+NSString *const FBInvalidArgumentException = @"FBInvalidArgumentException";
+NSString *const FBSessionCreationException = @"FBSessionCreationException";
+NSString *const FBSessionDoesNotExistException = @"FBSessionDoesNotExistException";
+NSString *const FBApplicationDeadlockDetectedException = @"FBApplicationDeadlockDetectedException";
+NSString *const FBElementAttributeUnknownException = @"FBElementAttributeUnknownException";
+NSString *const FBElementNotVisibleException = @"FBElementNotVisibleException";
+NSString *const FBTimeoutException = @"FBTimeoutException";
+NSString *const FBStaleElementException = @"FBStaleElementException";
+NSString *const FBInvalidXPathException = @"FBInvalidXPathException";
+NSString *const FBXPathQueryEvaluationException = @"FBXPathQueryEvaluationException";
+NSString *const FBClassChainQueryParseException = @"FBClassChainQueryParseException";
+NSString *const FBApplicationCrashedException = @"FBApplicationCrashedException";
+NSString *const FBApplicationMissingException = @"FBApplicationMissingException";
+NSString *const FBIncompatibleWdaException = @"FBIncompatibleWdaException";