@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner.xcscheme

@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1310"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "EEF988291C486603005CA669"
+               BuildableName = "WebDriverAgentRunner.xctest"
+               BlueprintName = "WebDriverAgentRunner"
+               ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = ""
+      selectedLauncherIdentifier = "Xcode.IDEFoundation.Launcher.PosixSpawn"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      systemAttachmentLifetime = "keepNever">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "EEF988291C486603005CA669"
+               BuildableName = "WebDriverAgentRunner.xctest"
+               BlueprintName = "WebDriverAgentRunner"
+               ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+            </BuildableReference>
+         </TestableReference>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "EEF988291C486603005CA669"
+            BuildableName = "WebDriverAgentRunner.xctest"
+            BlueprintName = "WebDriverAgentRunner"
+            ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <EnvironmentVariables>
+         <EnvironmentVariable
+            key = "USE_PORT"
+            value = "$(USE_PORT)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "USE_IP"
+            value = "$(USE_IP)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "UPGRADE_TIMESTAMP"
+            value = "$(UPGRADE_TIMESTAMP)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "MJPEG_SERVER_PORT"
+            value = "$(MJPEG_SERVER_PORT)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "WDA_PRODUCT_BUNDLE_IDENTIFIER"
+            value = "$(WDA_PRODUCT_BUNDLE_IDENTIFIER)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+      </EnvironmentVariables>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "EEF988291C486603005CA669"
+            BuildableName = "WebDriverAgentRunner.xctest"
+            BlueprintName = "WebDriverAgentRunner"
+            ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/drivers/ios/WebDriverAgent/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner_tvOS.xcscheme

@@ -0,0 +1,123 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1310"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "641EE2D92240BBE300173FCB"
+               BuildableName = "WebDriverAgentRunner_tvOS.xctest"
+               BlueprintName = "WebDriverAgentRunner_tvOS"
+               ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = ""
+      selectedLauncherIdentifier = "Xcode.IDEFoundation.Launcher.PosixSpawn"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      systemAttachmentLifetime = "keepNever">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "641EE2D92240BBE300173FCB"
+            BuildableName = "WebDriverAgentRunner_tvOS.xctest"
+            BlueprintName = "WebDriverAgentRunner_tvOS"
+            ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "641EE2D92240BBE300173FCB"
+               BuildableName = "WebDriverAgentRunner_tvOS.xctest"
+               BlueprintName = "WebDriverAgentRunner_tvOS"
+               ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+            </BuildableReference>
+         </TestableReference>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "641EE2D92240BBE300173FCB"
+            BuildableName = "WebDriverAgentRunner_tvOS.xctest"
+            BlueprintName = "WebDriverAgentRunner_tvOS"
+            ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <EnvironmentVariables>
+         <EnvironmentVariable
+            key = "USE_PORT"
+            value = "$(USE_PORT)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "USE_IP"
+            value = "$(USE_IP)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "UPGRADE_TIMESTAMP"
+            value = "$(UPGRADE_TIMESTAMP)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "MJPEG_SERVER_PORT"
+            value = "$(MJPEG_SERVER_PORT)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "WDA_PRODUCT_BUNDLE_IDENTIFIER"
+            value = "$(WDA_PRODUCT_BUNDLE_IDENTIFIER)"
+            isEnabled = "YES">
+         </EnvironmentVariable>
+      </EnvironmentVariables>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "641EE2D92240BBE300173FCB"
+            BuildableName = "WebDriverAgentRunner_tvOS.xctest"
+            BlueprintName = "WebDriverAgentRunner_tvOS"
+            ReferencedContainer = "container:WebDriverAgent.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/FBXCElementSnapshotWrapper+Helpers.h

@@ -0,0 +1,100 @@
+/**
+ * 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 "FBXCElementSnapshotWrapper.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBXCElementSnapshotWrapper (Helpers)
+
+/**
+ Returns an array of descendants matching given type
+
+ @param type requested descendant type
+ @return an array of descendants matching given type
+ */
+- (NSArray<id<FBXCElementSnapshot>> *)fb_descendantsMatchingType:(XCUIElementType)type;
+
+/**
+ Returns first (going up element tree) parent that matches given type. If non found returns nil.
+
+ @param type requested parent type
+ @return parent element matching given type
+ */
+- (nullable id<FBXCElementSnapshot>)fb_parentMatchingType:(XCUIElementType)type;
+
+/**
+ Returns first (going up element tree) parent that matches one of given types. If non found returns nil.
+ 
+ @param types possible parent types
+ @return parent element matching one of given types
+ */
+- (nullable id<FBXCElementSnapshot>)fb_parentMatchingOneOfTypes:(NSArray<NSNumber *> *)types;
+
+/**
+ Returns first (going up element tree) visible parent that matches one of given types and has more than one child. If non found returns nil.
+ 
+ @param types possible parent types
+ @param filter will filter results even further after matching one of given types
+ @return parent element matching one of given types and satisfying filter condition
+ */
+- (nullable id<FBXCElementSnapshot>)fb_parentMatchingOneOfTypes:(NSArray<NSNumber *> *)types filter:(BOOL(^)(id<FBXCElementSnapshot> snapshot))filter;
+
+/**
+ Retrieves the list of all element ancestors in the snapshot hierarchy.
+ 
+ @return the list of element ancestors or an empty list if the snapshot has no parent.
+ */
+- (NSArray<id<FBXCElementSnapshot>> *)fb_ancestors;
+
+/**
+ Returns value for given accessibility property identifier.
+
+ @param attribute attribute's accessibility identifier. Can be one of
+ `XC_kAXXCAttribute`-prefixed attribute names.
+ @param error Error instance in case of a failure
+ @return value for given accessibility property identifier or nil in case of failure
+ */
+- (nullable id)fb_attributeValue:(NSString *)attribute
+                           error:(NSError **)error;
+
+/**
+ Method used to determine whether given element matches receiver by comparing it's parameters except frame.
+
+ @param snapshot element's snapshot to compare against
+ @return YES, if they match otherwise NO
+ */
+- (BOOL)fb_framelessFuzzyMatchesElement:(id<FBXCElementSnapshot>)snapshot;
+
+/**
+ Returns an array of descendants cell snapshots
+ 
+ @return an array of descendants cell snapshots
+ */
+- (NSArray<id<FBXCElementSnapshot>> *)fb_descendantsCellSnapshots;
+
+/**
+ Returns itself if it is either XCUIElementTypeIcon or XCUIElementTypeCell. Otherwise, returns first (going up element tree) parent that matches cell (XCUIElementTypeCell or  XCUIElementTypeIcon). If non found returns nil.
+ 
+ @return parent element matching either XCUIElementTypeIcon or XCUIElementTypeCell.
+ */
+- (nullable id<FBXCElementSnapshot>)fb_parentCellSnapshot;
+
+/**! Human-readable snapshot description */
+- (NSString *)fb_description;
+
+/**
+ Wrapper for Apple's hitpoint, thats resolves few known issues
+
+ @return Element's hitpoint if exists nil otherwise
+ */
+- (nullable NSValue *)fb_hitPoint;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/FBXCElementSnapshotWrapper+Helpers.m

@@ -0,0 +1,192 @@
+/**
+ * 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 "FBXCElementSnapshotWrapper+Helpers.h"
+
+#import "FBFindElementCommands.h"
+#import "FBErrorBuilder.h"
+#import "FBRunLoopSpinner.h"
+#import "FBLogger.h"
+#import "FBXCElementSnapshot.h"
+#import "FBXCTestDaemonsProxy.h"
+#import "FBXCAXClientProxy.h"
+#import "XCTestDriver.h"
+#import "XCTestPrivateSymbols.h"
+#import "XCUIElement.h"
+#import "XCUIElement+FBWebDriverAttributes.h"
+#import "XCUIHitPointResult.h"
+
+#define ATTRIBUTE_FETCH_WARN_TIME_LIMIT 0.05
+
+inline static BOOL isSnapshotTypeAmongstGivenTypes(id<FBXCElementSnapshot> snapshot,
+                                                   NSArray<NSNumber *> *types);
+
+@implementation FBXCElementSnapshotWrapper (Helpers)
+
+- (NSString *)fb_description
+{
+  NSString *result = [NSString stringWithFormat:@"%@", self.wdType];
+  if (nil != self.wdName) {
+    result = [NSString stringWithFormat:@"%@ (%@)", result, self.wdName];
+  }
+  return result;
+}
+
+- (NSArray<id<FBXCElementSnapshot>> *)fb_descendantsMatchingType:(XCUIElementType)type
+{
+  return [self descendantsByFilteringWithBlock:^BOOL(id<FBXCElementSnapshot> snapshot) {
+    return snapshot.elementType == type;
+  }];
+}
+
+- (id<FBXCElementSnapshot>)fb_parentMatchingType:(XCUIElementType)type
+{
+  NSArray *acceptedParents = @[@(type)];
+  return [self fb_parentMatchingOneOfTypes:acceptedParents];
+}
+
+- (id<FBXCElementSnapshot>)fb_parentMatchingOneOfTypes:(NSArray<NSNumber *> *)types
+{
+  return [self fb_parentMatchingOneOfTypes:types filter:^(id<FBXCElementSnapshot> snapshot) {
+    return YES;
+  }];
+}
+
+- (id<FBXCElementSnapshot>)fb_parentMatchingOneOfTypes:(NSArray<NSNumber *> *)types
+                                              filter:(BOOL(^)(id<FBXCElementSnapshot> snapshot))filter
+{
+  id<FBXCElementSnapshot> snapshot = self.parent;
+  while (snapshot && !(isSnapshotTypeAmongstGivenTypes(snapshot, types) && filter(snapshot))) {
+    snapshot = snapshot.parent;
+  }
+  return snapshot;
+}
+
+- (id)fb_attributeValue:(NSString *)attribute
+                  error:(NSError **)error
+{
+  NSDate *start = [NSDate date];
+  NSDictionary *result = [FBXCAXClientProxy.sharedClient attributesForElement:[self accessibilityElement]
+                                                                   attributes:@[attribute]
+                                                                        error:error];
+  NSTimeInterval elapsed = ABS([start timeIntervalSinceNow]);
+  if (elapsed > ATTRIBUTE_FETCH_WARN_TIME_LIMIT) {
+    NSLog(@"! Fetching of %@ value for %@ took %@s", attribute, self.fb_description, @(elapsed));
+  }
+  return [result objectForKey:attribute];
+}
+
+inline static BOOL areValuesEqual(id value1, id value2);
+
+inline static BOOL areValuesEqualOrBlank(id value1, id value2);
+
+inline static BOOL isNilOrEmpty(id value);
+
+- (BOOL)fb_framelessFuzzyMatchesElement:(id<FBXCElementSnapshot>)snapshot
+{
+    // Pure payload-based comparison sometimes yield false negatives, therefore relying on it only if all of the identifying properties are blank
+  if (isNilOrEmpty(self.identifier)
+      && isNilOrEmpty(self.title)
+      && isNilOrEmpty(self.label)
+      && isNilOrEmpty(self.value)
+      && isNilOrEmpty(self.placeholderValue)) {
+    return [self.wdUID isEqualToString:([FBXCElementSnapshotWrapper ensureWrapped:snapshot].wdUID ?: @"")];
+  }
+  
+  // Sometimes value and placeholderValue of a correct match from different snapshots are not the same (one is nil and one is a blank string)
+  // Therefore taking it into account when comparing
+  return self.elementType == snapshot.elementType &&
+    areValuesEqual(self.identifier, snapshot.identifier) &&
+    areValuesEqual(self.title, snapshot.title) &&
+    areValuesEqual(self.label, snapshot.label) &&
+    areValuesEqualOrBlank(self.value, snapshot.value) &&
+    areValuesEqualOrBlank(self.placeholderValue, snapshot.placeholderValue);
+}
+
+- (NSArray<id<FBXCElementSnapshot>> *)fb_descendantsCellSnapshots
+{
+  NSArray<id<FBXCElementSnapshot>> *cellSnapshots = [self fb_descendantsMatchingType:XCUIElementTypeCell];
+  
+  if (cellSnapshots.count == 0) {
+    // For the home screen, cells are actually of type XCUIElementTypeIcon
+    cellSnapshots = [self fb_descendantsMatchingType:XCUIElementTypeIcon];
+  }
+  
+  if (cellSnapshots.count == 0) {
+    // In some cases XCTest will not report Cell Views. In that case grab all descendants and try to figure out scroll directon from them.
+    cellSnapshots = self._allDescendants;
+  }
+  
+  return cellSnapshots;
+}
+
+- (NSArray<id<FBXCElementSnapshot>> *)fb_ancestors
+{
+  NSMutableArray<id<FBXCElementSnapshot>> *ancestors = [NSMutableArray array];
+  id<FBXCElementSnapshot> parent = self.parent;
+  while (parent) {
+    [ancestors addObject:parent];
+    parent = parent.parent;
+  }
+  return ancestors.copy;
+}
+
+- (id<FBXCElementSnapshot>)fb_parentCellSnapshot
+{
+  id<FBXCElementSnapshot> targetCellSnapshot = self.snapshot;
+  // XCUIElementTypeIcon is the cell type for homescreen icons
+  NSArray<NSNumber *> *acceptableElementTypes = @[
+                                                  @(XCUIElementTypeCell),
+                                                  @(XCUIElementTypeIcon),
+                                                  ];
+  if (self.elementType != XCUIElementTypeCell && self.elementType != XCUIElementTypeIcon) {
+      targetCellSnapshot = [self fb_parentMatchingOneOfTypes:acceptableElementTypes];
+  }
+  return targetCellSnapshot;
+}
+
+- (NSValue *)fb_hitPoint
+{
+  NSError *error;
+  XCUIHitPointResult *result = [self hitPoint:&error];
+  if (nil != error) {
+    [FBLogger logFmt:@"Failed to fetch hit point for %@ - %@", self.fb_description, error.localizedDescription];
+    return nil;
+  }
+  return [NSValue valueWithCGPoint:result.hitPoint];
+}
+
+@end
+
+inline static BOOL isSnapshotTypeAmongstGivenTypes(id<FBXCElementSnapshot> snapshot, NSArray<NSNumber *> *types)
+{
+  for (NSUInteger i = 0; i < types.count; i++) {
+   if([@(snapshot.elementType) isEqual: types[i]] || [types[i] isEqual: @(XCUIElementTypeAny)]){
+       return YES;
+   }
+  }
+  return NO;
+}
+
+inline static BOOL areValuesEqual(id value1, id value2)
+{
+  return value1 == value2 || [value1 isEqual:value2];
+}
+
+inline static BOOL areValuesEqualOrBlank(id value1, id value2)
+{
+  return areValuesEqual(value1, value2) || (isNilOrEmpty(value1) && isNilOrEmpty(value2));
+}
+
+inline static BOOL isNilOrEmpty(id value)
+{
+  if ([value isKindOfClass:NSString.class]) {
+    return [(NSString*)value length] == 0;
+  }
+  return value == nil;
+}

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/NSDictionary+FBUtf8SafeDictionary.h

@@ -0,0 +1,39 @@
+/**
+ * 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>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface NSString (FBUtf8SafeString)
+
+/**
+ Converts the string, so it could be properly represented in UTF-8 encoding. All non-encodable characters are replaced with
+ the given `replacement`
+
+ @param replacement The character to use a a replacement for the lossy encoding
+ @returns Either the same string or a string with non-encodable chars replaced
+ */
+- (instancetype)fb_utf8SafeStringWithReplacement:(unichar)replacement;
+
+@end
+
+@interface NSDictionary (FBUtf8SafeDictionary)
+
+/**
+ Converts the dictionary, so it could be properly represented in UTF-8 encoding. All non-encodable characters
+ in string values are replaced with the Unocde question mark characters. Nested dictionaries and arrays are
+ processed recursively.
+
+ @returns Either the same dictionary or a dictionary with non-encodable chars in string values replaced
+ */
+- (instancetype)fb_utf8SafeDictionary;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/NSDictionary+FBUtf8SafeDictionary.m

@@ -0,0 +1,87 @@
+/**
+ * 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 "NSDictionary+FBUtf8SafeDictionary.h"
+
+const unichar REPLACER = 0xfffd;
+
+@implementation NSString (FBUtf8SafeString)
+
+- (instancetype)fb_utf8SafeStringWithReplacement:(unichar)replacement
+{
+  if ([self canBeConvertedToEncoding:NSUTF8StringEncoding]) {
+    return self;
+  }
+
+  NSData *data = [self dataUsingEncoding:NSUTF8StringEncoding allowLossyConversion:YES];
+  NSString *convertedString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+  NSMutableString *result = [NSMutableString string];
+  NSString *replacementStr = [NSString stringWithCharacters:&replacement length:1];
+  NSUInteger originalIdx = 0;
+  NSUInteger convertedIdx = 0;
+  while (originalIdx < [self length] && convertedIdx < [convertedString length]) {
+    unichar originalChar = [self characterAtIndex:originalIdx];
+    unichar convertedChar = [convertedString characterAtIndex:convertedIdx];
+
+    if (originalChar == convertedChar) {
+      [result appendString:[NSString stringWithCharacters:&originalChar length:1]];
+      originalIdx++;
+      convertedIdx++;
+      continue;
+    }
+
+    while (originalChar != convertedChar && originalIdx < [self length]) {
+      [result appendString:replacementStr];
+      originalChar = [self characterAtIndex:++originalIdx];
+    }
+  }
+  return result.copy;
+}
+
+@end
+
+@implementation NSArray (FBUtf8SafeArray)
+
+- (instancetype)fb_utf8SafeArray
+{
+  NSMutableArray *result = [NSMutableArray array];
+  for (id item in self) {
+    if ([item isKindOfClass:NSString.class]) {
+      [result addObject:[(NSString *)item fb_utf8SafeStringWithReplacement:REPLACER]];
+    } else if ([item isKindOfClass:NSDictionary.class]) {
+      [result addObject:[(NSDictionary *)item fb_utf8SafeDictionary]];
+    } else if ([item isKindOfClass:NSArray.class]) {
+      [result addObject:[(NSArray *)item fb_utf8SafeArray]];
+    } else {
+      [result addObject:item];
+    }
+  }
+  return result.copy;
+}
+
+@end
+
+@implementation NSDictionary (FBUtf8SafeDictionary)
+
+- (instancetype)fb_utf8SafeDictionary
+{
+  NSMutableDictionary *result = [self mutableCopy];
+  for (id key in self) {
+    id value = result[key];
+    if ([value isKindOfClass:NSString.class]) {
+      result[key] = [(NSString *)value fb_utf8SafeStringWithReplacement:REPLACER];
+    } else if ([value isKindOfClass:NSArray.class]) {
+      result[key] = [(NSArray *)value fb_utf8SafeArray];
+    } else if ([value isKindOfClass:NSDictionary.class]) {
+      result[key] = [(NSDictionary *)value fb_utf8SafeDictionary];
+    }
+  }
+  return result.copy;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/NSExpression+FBFormat.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>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface NSExpression (FBFormat)
+
+/**
+ Method used to normalize/verify NSExpression expressions before passing them to WDA.
+ Only expressions of NSKeyPathExpressionType are going to be verified.
+ Allowed property names are only these declared in FBElement protocol (property names are received in runtime)
+ and their shortcuts (without 'wd' prefix). All other property names are considered as unknown.
+ 
+ @param input expression object received from user input
+ @return formatted expression
+ @throw FBUnknownPredicateKeyException in case the given property name is not declared in FBElement protocol
+ */
++ (instancetype)fb_wdExpressionWithExpression:(NSExpression *)input;
+
+@end
+
+NS_ASSUME_NONNULL_END