@devicelab/maestro-runner-darwin-x64 1.1.25

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

@@ -0,0 +1,80 @@
+/**
+ * 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/FBHTTPStatusCodes.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBCommandStatus : NSObject
+
+@property (nonatomic, nullable, readonly) id value;
+@property (nonatomic, nullable, readonly) NSString* error;
+@property (nonatomic, nullable, readonly) NSString* message;
+@property (nonatomic, nullable, readonly) NSString* traceback;
+@property (nonatomic, readonly) HTTPStatusCode statusCode;
+@property (nonatomic, readonly) BOOL hasError;
+
++ (instancetype)ok;
+
++ (instancetype)okWithValue:(nullable id)value;
+
++ (instancetype)unknownErrorWithMessage:(nullable NSString *)message
+                              traceback:(nullable NSString *)traceback;
+
++ (instancetype)unsupportedOperationErrorWithMessage:(nullable NSString *)message
+                                           traceback:(nullable NSString *)traceback;
+
++ (instancetype)unableToCaptureScreenErrorWithMessage:(nullable NSString *)message
+                                            traceback:(nullable NSString *)traceback;
+
++ (instancetype)noSuchElementErrorWithMessage:(nullable NSString *)message
+                                    traceback:(nullable NSString *)traceback;
+
++ (instancetype)invalidElementStateErrorWithMessage:(nullable NSString *)message
+                                          traceback:(nullable NSString *)traceback;
+
++ (instancetype)invalidArgumentErrorWithMessage:(nullable NSString *)message
+                                      traceback:(nullable NSString *)traceback;
+
++ (instancetype)staleElementReferenceErrorWithMessage:(nullable NSString *)message
+                                            traceback:(nullable NSString *)traceback;
+
++ (instancetype)invalidSelectorErrorWithMessage:(nullable NSString *)message
+                                      traceback:(nullable NSString *)traceback;
+
++ (instancetype)noAlertOpenErrorWithMessage:(nullable NSString *)message
+                                  traceback:(nullable NSString *)traceback;
+
++ (instancetype)unexpectedAlertOpenErrorWithMessage:(nullable NSString *)message
+                                          traceback:(nullable NSString *)traceback;
+
++ (instancetype)notImplementedErrorWithMessage:(nullable NSString *)message
+                                     traceback:(nullable NSString *)traceback;
+
++ (instancetype)sessionNotCreatedError:(nullable NSString *)message
+                             traceback:(nullable NSString *)traceback;
+
++ (instancetype)invalidCoordinatesErrorWithMessage:(nullable NSString *)message
+                                         traceback:(nullable NSString *)traceback;
+
++ (instancetype)unknownCommandErrorWithMessage:(nullable NSString *)message
+                                     traceback:(nullable NSString *)traceback;
+
++ (instancetype)timeoutErrorWithMessage:(nullable NSString *)message
+                              traceback:(nullable NSString *)traceback;
+
++ (instancetype)elementNotVisibleErrorWithMessage:(nullable NSString *)message
+                                   traceback:(nullable NSString *)traceback;
+
++ (instancetype)noSuchDriverErrorWithMessage:(nullable NSString *)message
+                                   traceback:(nullable NSString *)traceback;
+
+@end
+
+NS_ASSUME_NONNULL_END

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

@@ -0,0 +1,279 @@
+/**
+ * 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 "FBCommandStatus.h"
+
+static NSString *const FB_UNKNOWN_ERROR = @"unknown error";
+static const HTTPStatusCode FB_UNKNOWN_ERROR_CODE = kHTTPStatusCodeInternalServerError;
+static NSString *const FB_UNKNOWN_ERROR_MSG = @"An unknown server-side error occurred while processing the command";
+
+static NSString *const FB_UNABLE_TO_CAPTURE_ERROR = @"unable to capture screen";
+static const HTTPStatusCode FB_UNABLE_TO_CAPTURE_ERROR_CODE = kHTTPStatusCodeInternalServerError;
+static NSString *const FB_UNABLE_TO_CAPTURE_MSG = @"A screen capture was made impossible";
+
+static NSString *const FB_NO_SUCH_ELEMENT_ERROR = @"no such element";
+static const HTTPStatusCode FB_NO_SUCH_ELEMENT_ERROR_CODE = kHTTPStatusCodeNotFound;
+static NSString *const FB_NO_SUCH_ELEMENT_MSG = @"An element could not be located on the page using the given search parameters";
+
+static NSString *const FB_INVALID_ELEMENT_STATE_ERROR = @"invalid element state";
+static const HTTPStatusCode FB_INVALID_ELEMENT_STATE_ERROR_CODE = kHTTPStatusCodeBadRequest;
+static NSString *const FB_INVALID_ELEMENT_STATE_MSG = @"An element command could not be completed because the element is in an invalid state (e.g. attempting to click a disabled element)";
+
+static NSString *const FB_INVALID_ARGUMENT_ERROR = @"invalid argument";
+static const HTTPStatusCode FB_INVALID_ARGUMENT_ERROR_CODE = kHTTPStatusCodeBadRequest;
+static NSString *const FB_INVALID_ARGUMENT_MSG = @"The arguments passed to the command are either invalid or malformed";
+
+static NSString *const FB_STALE_ELEMENT_REF_ERROR = @"stale element reference";
+static const HTTPStatusCode FB_STALE_ELEMENT_REF_ERROR_CODE = kHTTPStatusCodeNotFound;
+static NSString *const FB_STALE_ELEMENT_REF_MSG = @"An element command failed because the referenced element is no longer attached to the DOM";
+
+static NSString *const FB_INVALID_SELECTOR_ERROR = @"invalid selector";
+static const HTTPStatusCode FB_INVALID_SELECTOR_ERROR_CODE = kHTTPStatusCodeBadRequest;
+static NSString *const FB_INVALID_SELECTOR_MSG = @"Argument was an invalid selector (e.g. XPath/Class Chain)";
+
+static NSString *const FB_NO_ALERT_OPEN_ERROR = @"no such alert";
+static const HTTPStatusCode FB_NO_ALERT_OPEN_ERROR_CODE = kHTTPStatusCodeNotFound;
+static NSString *const FB_NO_ALERT_OPEN_MSG = @"An attempt was made to operate on a modal dialog when one was not open";
+
+static NSString *const FB_UNEXPECTED_ALERT_OPEN_ERROR = @"unexpected alert open";
+static const HTTPStatusCode FB_UNEXPECTED_ALERT_OPEN_ERROR_CODE = kHTTPStatusCodeInternalServerError;
+static NSString *const FB_UNEXPECTED_ALERT_OPEN_MSG = @"A modal dialog was open, blocking this operation";
+
+static NSString *const FB_NOT_IMPLEMENTED_ERROR = @"unknown method";
+static const HTTPStatusCode FB_NOT_IMPLEMENTED_ERROR_CODE = kHTTPStatusCodeMethodNotAllowed;
+static NSString *const FB_NOT_IMPLEMENTED_MSG = @"Method is not implemented";
+
+static NSString *const FB_SESSION_NOT_CREATED_ERROR = @"session not created";
+static const HTTPStatusCode FB_SESSION_NOT_CREATED_ERROR_CODE = kHTTPStatusCodeInternalServerError;
+static NSString *const FB_SESSION_NOT_CREATED_MSG = @"A new session could not be created";
+
+static NSString *const FB_INVALID_COORDINATES_ERROR = @"invalid coordinates";
+static const HTTPStatusCode FB_INVALID_COORDINATES_ERROR_CODE = kHTTPStatusCodeBadRequest;
+static NSString *const FB_INVALID_COORDINATES_MSG = @"The coordinates provided to an interactions operation are invalid";
+
+static NSString *const FB_UNSUPPORTED_OPERATION_ERROR = @"unsupported operation";
+static const HTTPStatusCode FB_UNSUPPORTED_OPERATION_ERROR_CODE = kHTTPStatusCodeInternalServerError;
+static NSString *const FB_UNSUPPORTED_OPERATION_ERROR_MSG = @"The requested operation is not supported";
+
+static NSString *const FB_UNKNOWN_COMMAND_ERROR = @"unknown command";
+static const HTTPStatusCode FB_UNKNOWN_COMMAND_ERROR_CODE = kHTTPStatusCodeNotFound;
+static NSString *const FB_UNKNOWN_COMMAND_MSG = @"The requested resource could not be found, or a request was received using an HTTP method that is not supported by the mapped resource";
+
+static NSString *const FB_TIMEOUT_ERROR = @"timeout";
+static const HTTPStatusCode FB_TIMEOUT_ERROR_CODE = kHTTPStatusCodeRequestTimeout;
+static NSString *const FB_TIMEOUT_MSG = @"An operation did not complete before its timeout expired";
+
+static NSString *const FB_ELEMENT_NOT_VISIBLE_ERROR = @"element not visible";
+static const HTTPStatusCode FB_ELEMENT_NOT_VISIBLE_ERROR_CODE = kHTTPStatusCodeBadRequest;
+static NSString *const FB_ELEMENT_NOT_VISIBLE_MSG = @"An element command could not be completed because the element is not visible on the page";
+
+static NSString *const FB_NO_SUCH_DRIVER_ERROR = @"invalid session id";
+static const HTTPStatusCode FB_NO_SUCH_DRIVER_ERROR_CODE = kHTTPStatusCodeNotFound;
+static NSString *const FB_NO_SUCH_DRIVER_MSG = @"A session is either terminated or not started";
+
+
+@implementation FBCommandStatus
+
+- (instancetype)initWithValue:(nullable id)value
+{
+  self = [super init];
+  if (self) {
+    _value = value;
+    _message = nil;
+    _error = nil;
+    _traceback = nil;
+    _statusCode = kHTTPStatusCodeOK;
+  }
+  return self;
+}
+
+- (instancetype)initWithError:(NSString *)error
+                   statusCode:(HTTPStatusCode)statusCode
+                      message:(NSString *)message
+                    traceback:(nullable NSString *)traceback
+{
+  self = [super init];
+  if (self) {
+    _error = error;
+    _statusCode = statusCode;
+    _message = message;
+    _traceback = traceback;
+    _value = nil;
+  }
+  return self;
+}
+
+- (BOOL)hasError
+{
+  return self.statusCode != kHTTPStatusCodeOK;
+}
+
++ (instancetype)ok
+{
+  return [[FBCommandStatus alloc] initWithValue:nil];
+}
+
++ (instancetype)okWithValue:(id)value
+{
+  return [[FBCommandStatus alloc] initWithValue:value];
+}
+
++ (instancetype)unknownErrorWithMessage:(NSString *)message
+                              traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_UNKNOWN_ERROR
+                                     statusCode:FB_UNKNOWN_ERROR_CODE
+                                        message:message ?: FB_UNKNOWN_ERROR_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)unsupportedOperationErrorWithMessage:(NSString *)message
+                                           traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_UNSUPPORTED_OPERATION_ERROR
+                                     statusCode:FB_UNSUPPORTED_OPERATION_ERROR_CODE
+                                        message:message ?: FB_UNSUPPORTED_OPERATION_ERROR_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)unableToCaptureScreenErrorWithMessage:(NSString *)message
+                                            traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_UNABLE_TO_CAPTURE_ERROR
+                                     statusCode:FB_UNABLE_TO_CAPTURE_ERROR_CODE
+                                        message:message ?: FB_UNABLE_TO_CAPTURE_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)noSuchElementErrorWithMessage:(NSString *)message
+                                    traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_NO_SUCH_ELEMENT_ERROR
+                                     statusCode:FB_NO_SUCH_ELEMENT_ERROR_CODE
+                                        message:message ?: FB_NO_SUCH_ELEMENT_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)invalidElementStateErrorWithMessage:(NSString *)message
+                                          traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_INVALID_ELEMENT_STATE_ERROR
+                                     statusCode:FB_INVALID_ELEMENT_STATE_ERROR_CODE
+                                        message:message ?: FB_INVALID_ELEMENT_STATE_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)invalidArgumentErrorWithMessage:(NSString *)message
+                                      traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_INVALID_ARGUMENT_ERROR
+                                     statusCode:FB_INVALID_ARGUMENT_ERROR_CODE
+                                        message:message ?: FB_INVALID_ARGUMENT_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)staleElementReferenceErrorWithMessage:(NSString *)message
+                                            traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_STALE_ELEMENT_REF_ERROR
+                                     statusCode:FB_STALE_ELEMENT_REF_ERROR_CODE
+                                        message:message ?: FB_STALE_ELEMENT_REF_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)invalidSelectorErrorWithMessage:(NSString *)message
+                                      traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_INVALID_SELECTOR_ERROR
+                                     statusCode:FB_INVALID_SELECTOR_ERROR_CODE
+                                        message:message ?: FB_INVALID_SELECTOR_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)noAlertOpenErrorWithMessage:(NSString *)message
+                                  traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_NO_ALERT_OPEN_ERROR
+                                     statusCode:FB_NO_ALERT_OPEN_ERROR_CODE
+                                        message:message ?: FB_NO_ALERT_OPEN_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)unexpectedAlertOpenErrorWithMessage:(NSString *)message
+                                          traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_UNEXPECTED_ALERT_OPEN_ERROR
+                                     statusCode:FB_UNEXPECTED_ALERT_OPEN_ERROR_CODE
+                                        message:message ?: FB_UNEXPECTED_ALERT_OPEN_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)notImplementedErrorWithMessage:(NSString *)message
+                                     traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_NOT_IMPLEMENTED_ERROR
+                                     statusCode:FB_NOT_IMPLEMENTED_ERROR_CODE
+                                        message:message ?: FB_NOT_IMPLEMENTED_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)sessionNotCreatedError:(NSString *)message
+                             traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_SESSION_NOT_CREATED_ERROR
+                                     statusCode:FB_SESSION_NOT_CREATED_ERROR_CODE
+                                        message:message ?: FB_SESSION_NOT_CREATED_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)invalidCoordinatesErrorWithMessage:(NSString *)message
+                                         traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_INVALID_COORDINATES_ERROR
+                                     statusCode:FB_INVALID_COORDINATES_ERROR_CODE
+                                        message:message ?: FB_INVALID_COORDINATES_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)unknownCommandErrorWithMessage:(NSString *)message
+                                     traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_UNKNOWN_COMMAND_ERROR
+                                     statusCode:FB_UNKNOWN_COMMAND_ERROR_CODE
+                                        message:message ?: FB_UNKNOWN_COMMAND_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)timeoutErrorWithMessage:(NSString *)message
+                              traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_TIMEOUT_ERROR
+                                     statusCode:FB_TIMEOUT_ERROR_CODE
+                                        message:message ?: FB_TIMEOUT_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)elementNotVisibleErrorWithMessage:(NSString *)message
+                                        traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_ELEMENT_NOT_VISIBLE_ERROR
+                                     statusCode:FB_ELEMENT_NOT_VISIBLE_ERROR_CODE
+                                        message:message ?: FB_ELEMENT_NOT_VISIBLE_MSG
+                                      traceback:traceback];
+}
+
++ (instancetype)noSuchDriverErrorWithMessage:(NSString *)message
+                                   traceback:(NSString *)traceback
+{
+  return [[FBCommandStatus alloc] initWithError:FB_NO_SUCH_DRIVER_ERROR
+                                     statusCode:FB_NO_SUCH_DRIVER_ERROR_CODE
+                                        message:message ?: FB_NO_SUCH_DRIVER_MSG
+                                      traceback:traceback];
+}
+
+@end

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

@@ -0,0 +1,95 @@
+/**
+ * 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 <CoreGraphics/CoreGraphics.h>
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Protocol that should be implemented by class that can return element properties defined in WebDriver Spec
+ */
+@protocol FBElement <NSObject>
+
+/*! Element's frame in normalized (rounded dimensions without Infinity values) CGRect format */
+@property (nonatomic, readonly, assign) CGRect wdFrame;
+
+/*! Represents the element's frame as a CGRect, preserving the actual values. */
+@property (nonatomic, readonly, assign) CGRect wdNativeFrame;
+
+/*! Element's wsFrame in NSDictionary format */
+@property (nonatomic, readonly, copy) NSDictionary *wdRect;
+
+/*! Element's name */
+@property (nonatomic, readonly, copy, nullable) NSString *wdName;
+
+/*! Element's label */
+@property (nonatomic, readonly, copy, nullable) NSString *wdLabel;
+
+/*! Element's selected state */
+@property (nonatomic, readonly, getter = isWDSelected) BOOL wdSelected;
+
+/*! Element's type */
+@property (nonatomic, readonly, copy) NSString *wdType;
+
+/*! Element's accessibility traits as a comma-separated string */
+@property (nonatomic, readonly, copy) NSString *wdTraits;
+
+/*! Element's value */
+@property (nonatomic, readonly, strong, nullable) NSString *wdValue;
+
+/*! Element's unique identifier */
+@property (nonatomic, readonly, copy, nullable) NSString *wdUID;
+
+/*! Whether element is enabled */
+@property (nonatomic, readonly, getter = isWDEnabled) BOOL wdEnabled;
+
+/*! Whether element is visible */
+@property (nonatomic, readonly, getter = isWDVisible) BOOL wdVisible;
+
+/*! Whether element is accessible */
+@property (nonatomic, readonly, getter = isWDAccessible) BOOL wdAccessible;
+
+/*! Whether element is an accessibility container (contains children of any depth that are accessible) */
+@property (nonatomic, readonly, getter = isWDAccessibilityContainer) BOOL wdAccessibilityContainer;
+
+/*! Whether element is focused */
+@property (nonatomic, readonly, getter = isWDFocused) BOOL wdFocused;
+
+/*! Whether element is hittable */
+@property (nonatomic, readonly, getter = isWDHittable) BOOL wdHittable;
+
+/*! Element's index relatively to its parent. Starts from zero */
+@property (nonatomic, readonly) NSUInteger wdIndex;
+
+/*! Element's placeholder value */
+@property (nonatomic, readonly, copy, nullable) NSString *wdPlaceholderValue;
+
+/*! Element's minimum value */
+@property (nonatomic, readonly, strong, nullable) NSNumber *wdMinValue;
+
+/*! Element's maximum value */
+@property (nonatomic, readonly, strong, nullable) NSNumber *wdMaxValue;
+
+/*! Element's custom actions */
+@property (nonatomic, readonly, strong, nullable) NSString *wdCustomActions;
+
+/**
+ Returns value of given property specified in WebDriver Spec
+ Check the FBElement protocol to get list of supported attributes.
+ This method also supports shortcuts, like wdName == name, wdValue == value.
+ 
+ @param name WebDriver Spec property name
+ @return the corresponding property value
+ @throws FBUnknownAttributeException if there is no matching attribute defined in FBElement protocol
+ */
+- (nullable id)fb_valueForWDAttributeName:(NSString *__nullable)name;
+
+@end
+
+NS_ASSUME_NONNULL_END

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

@@ -0,0 +1,61 @@
+/**
+ * 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>
+
+@class XCUIElement;
+
+NS_ASSUME_NONNULL_BEGIN
+
+// This constant defines the size of the element cache, which puts an upper limit
+// on the amount of elements which can be stored in the cache.
+// Based on the data in https://github.com/facebook/WebDriverAgent/pull/896, each
+// element consumes about 100KB of memory; so 1024 elements would consume 100 MB of
+// memory.
+extern const int ELEMENT_CACHE_SIZE;
+
+@interface FBElementCache : NSObject
+
+/**
+ Stores element in cache
+
+ @param element element to store
+ @return element's uuid or nil in case the element uid cannnot be extracted
+ */
+- (nullable NSString *)storeElement:(XCUIElement *)element;
+
+/**
+ Returns cached element resolved with default snapshot attributes
+
+ @param uuid uuid of element to fetch
+ @return element
+ @throws FBInvalidArgumentException if uuid is nil
+ */
+- (XCUIElement *)elementForUUID:(NSString *)uuid;
+
+/**
+ Returns cached element resolved with default snapshot attributes
+
+ @param uuid uuid of element to fetch
+ @param checkStaleness Whether to throw FBStaleElementException if the found element is not present in DOM anymore
+ @return element
+ @throws FBStaleElementException if `checkStaleness` is enabled
+ @throws FBInvalidArgumentException if uuid is nil
+ */
+- (XCUIElement *)elementForUUID:(NSString *)uuid checkStaleness:(BOOL)checkStaleness;
+
+/**
+ Checks element existence in the cache
+
+ @returns YES if the element with the given UUID is present in cache
+ */
+- (BOOL)hasElementWithUUID:(nullable NSString *)uuid;
+
+@end
+
+NS_ASSUME_NONNULL_END

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

@@ -0,0 +1,100 @@
+/**
+ * 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 "FBElementCache.h"
+
+#import "LRUCache.h"
+#import "FBAlert.h"
+#import "FBExceptions.h"
+#import "FBXCodeCompatibility.h"
+#import "XCTestPrivateSymbols.h"
+#import "XCUIElement.h"
+#import "XCUIElement+FBCaching.h"
+#import "XCUIElement+FBUtilities.h"
+#import "XCUIElement+FBWebDriverAttributes.h"
+#import "XCUIElement+FBUID.h"
+#import "XCUIElement+FBResolve.h"
+#import "XCUIElementQuery.h"
+
+const int ELEMENT_CACHE_SIZE = 1024;
+
+@interface FBElementCache ()
+@property (nonatomic, strong) LRUCache *elementCache;
+@end
+
+@implementation FBElementCache
+
+- (instancetype)init
+{
+  self = [super init];
+  if (!self) {
+    return nil;
+  }
+  _elementCache = [[LRUCache alloc] initWithCapacity:ELEMENT_CACHE_SIZE];
+  return self;
+}
+
+- (NSString *)storeElement:(XCUIElement *)element
+{
+  NSString *uuid = element.fb_cacheId;
+  if (nil == uuid) {
+    return nil;
+  }
+  @synchronized (self.elementCache) {
+    [self.elementCache setObject:element forKey:uuid];
+  }
+  return uuid;
+}
+
+- (XCUIElement *)elementForUUID:(NSString *)uuid
+{
+  return [self elementForUUID:uuid checkStaleness:NO];
+}
+
+- (XCUIElement *)elementForUUID:(NSString *)uuid checkStaleness:(BOOL)checkStaleness
+{
+  if (!uuid) {
+    NSString *reason = [NSString stringWithFormat:@"Cannot extract cached element for UUID: %@", uuid];
+    @throw [NSException exceptionWithName:FBInvalidArgumentException reason:reason userInfo:@{}];
+  }
+
+  XCUIElement *element;
+  @synchronized (self.elementCache) {
+    element = [self.elementCache objectForKey:uuid];
+  }
+  if (nil == element) {
+    NSString *reason = [NSString stringWithFormat:@"The element identified by \"%@\" is either not present or it has expired from the internal cache. Try to find it again", uuid];
+    @throw [NSException exceptionWithName:FBStaleElementException reason:reason userInfo:@{}];
+  }
+  if (checkStaleness) {
+    @try {
+      [element fb_standardSnapshot];
+    } @catch (NSException *exception) {
+      //  if the snapshot method threw FBStaleElementException (implying the element is stale) we need to explicitly remove it from the cache, PR: https://github.com/appium/WebDriverAgent/pull/985
+      if ([exception.name isEqualToString:FBStaleElementException]) {
+        @synchronized (self.elementCache) {
+          [self.elementCache removeObjectForKey:uuid];
+        }
+      }
+      @throw exception;
+    }
+  }
+  return element;
+}
+
+- (BOOL)hasElementWithUUID:(NSString *)uuid
+{
+  if (nil == uuid) {
+    return NO;
+  }
+  @synchronized (self.elementCache) {
+    return nil != [self.elementCache objectForKey:(NSString *)uuid];
+  }
+}
+
+@end

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

@@ -0,0 +1,76 @@
+/**
+ * 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/FBElement.h>
+
+@protocol FBXCAccessibilityElement;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*! Notification used to notify about unknown attribute name */
+extern NSString *const FBUnknownAttributeException;
+
+@interface FBElementUtils : NSObject
+
+/**
+ Returns property name defined by FBElement protocol for the given WebDriver Spec property name.
+ Check the FBElement protocol to get list of supported attributes.
+ This method also supports shortcuts, like wdName == name, wdValue == value.
+ In case the corresponding attribute has a getter defined then the name of the getter witll be returned instead,
+ which makes this method compatible with KVO lookup
+ 
+ @param name WebDriver Spec property name
+ @return the corresponding property name
+ @throws FBUnknownAttributeException if there is no matching attribute defined in FBElement protocol
+ */
++ (NSString *)wdAttributeNameForAttributeName:(NSString *)name;
+
+/**
+ Collects all the unique element types from an array of elements.
+ 
+ @param elements array of elements
+ @return set of unique element types (XCUIElementType items) or an empty set in case the input is empty
+ */
++ (NSSet<NSNumber *> *)uniqueElementTypesWithElements:(NSArray<id<FBElement>> *)elements;
+
+/**
+ Returns mapping of all possible FBElement protocol properties aliases
+ 
+ @return dictionary of matching property aliases with their real names as values or getter method names if exist
+ for KVO lookup
+ */
++ (NSDictionary<NSString *, NSString *> *)wdAttributeNamesMapping;
+
+/**
+ Gets the unique identifier of the particular XCAccessibilityElement instance in form of UUIDv4.
+ 
+ @param element accessiblity element instance
+ @return the unique element identifier or nil if it cannot be retrieved
+ */
++ (nullable NSString *)uidWithAccessibilityElement:(id<FBXCAccessibilityElement>)element;
+
+/**
+ Gets the unique identifier of the particular XCAccessibilityElement instance.
+ 
+ @param element accessiblity element instance
+ @return the unique element identifier or nil if it cannot be retrieved
+ */
++ (unsigned long long)idWithAccessibilityElement:(id<FBXCAccessibilityElement>)element;
+
+/**
+ Retrieves the list of required instance methods of the given protocol
+
+ @param protocol target protocol reference
+ @return set of selector names
+ */
++ (NSSet<NSString *> *)selectorNamesWithProtocol:(Protocol *)protocol;
+
+@end
+
+NS_ASSUME_NONNULL_END