@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/FBRouteTests.m

@@ -0,0 +1,129 @@
+/**
+ * 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>
+
+#import "FBRoute.h"
+
+@class RouteResponse;
+
+@interface FBHandlerMock : NSObject
+@property (nonatomic, assign) BOOL didCallSomeSelector;
+@end
+
+@implementation FBHandlerMock
+- (id)someSelector:(id)arg
+{
+  self.didCallSomeSelector = YES;
+  return nil;
+};
+
+@end
+
+@interface FBRouteTests : XCTestCase
+@end
+
+@implementation FBRouteTests
+
+- (void)testGetRoute
+{
+  FBRoute *route = [FBRoute GET:@"/"];
+  XCTAssertEqualObjects(route.verb, @"GET");
+}
+
+- (void)testPostRoute
+{
+  FBRoute *route = [FBRoute POST:@"/"];
+  XCTAssertEqualObjects(route.verb, @"POST");
+}
+
+- (void)testPutRoute
+{
+  FBRoute *route = [FBRoute PUT:@"/"];
+  XCTAssertEqualObjects(route.verb, @"PUT");
+}
+
+- (void)testDeleteRoute
+{
+  FBRoute *route = [FBRoute DELETE:@"/"];
+  XCTAssertEqualObjects(route.verb, @"DELETE");
+}
+
+- (void)testTargetAction
+{
+  FBHandlerMock *mock = [FBHandlerMock new];
+  FBRoute *route = [[FBRoute new] respondWithTarget:mock action:@selector(someSelector:)];
+  [route mountRequest:(id)NSObject.new intoResponse:(id)NSObject.new];
+  XCTAssertTrue(mock.didCallSomeSelector);
+}
+
+- (void)testRespond
+{
+  XCTestExpectation *expectation = [self expectationWithDescription:@"Calling respond block works!"];
+  FBRoute *route = [[FBRoute new] respondWithBlock:^id<FBResponsePayload>(FBRouteRequest *request) {
+    [expectation fulfill];
+    return nil;
+  }];
+  [route mountRequest:(id)NSObject.new intoResponse:(id)NSObject.new];
+  [self waitForExpectationsWithTimeout:0.0 handler:nil];
+}
+
+- (void)testRouteWithSessionWithSlash
+{
+  FBRoute *route = [[FBRoute POST:@"/deactivateApp"] respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/session/:sessionID/deactivateApp");
+}
+
+- (void)testRouteWithSession
+{
+  FBRoute *route = [[FBRoute POST:@"deactivateApp"] respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/session/:sessionID/deactivateApp");
+}
+
+- (void)testRouteWithoutSessionWithSlash
+{
+  FBRoute *route = [[FBRoute POST:@"/deactivateApp"].withoutSession respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/deactivateApp");
+}
+
+- (void)testRouteWithoutSession
+{
+  FBRoute *route = [[FBRoute POST:@"deactivateApp"].withoutSession respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/deactivateApp");
+}
+
+- (void)testEmptyRouteWithSession
+{
+  FBRoute *route = [[FBRoute POST:@""] respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/session/:sessionID");
+}
+
+- (void)testEmptyRouteWithoutSession
+{
+  FBRoute *route = [[FBRoute POST:@""].withoutSession respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/");
+}
+
+- (void)testEmptyRouteWithSessionWithSlash
+{
+  FBRoute *route = [[FBRoute POST:@"/"] respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/session/:sessionID");
+}
+
+- (void)testEmptyRouteWithoutSessionWithSlash
+{
+  FBRoute *route = [[FBRoute POST:@"/"].withoutSession respondWithTarget:self action:@selector(dummyHandler:)];
+  XCTAssertEqualObjects(route.path, @"/");
+}
+
++ (id<FBResponsePayload>)dummyHandler:(FBRouteRequest *)request
+{
+  return nil;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/FBRunLoopSpinnerTests.m

@@ -0,0 +1,98 @@
+/**
+ * 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>
+
+#import "FBRunLoopSpinner.h"
+
+@interface FBRunLoopSpinnerTests : XCTestCase
+@property (nonatomic, strong) FBRunLoopSpinner *spinner;
+@end
+
+/**
+ Non of the test methods should block testing thread.
+ If they do, that means they are broken
+ */
+@implementation FBRunLoopSpinnerTests
+
+- (void)setUp
+{
+  [super setUp];
+  self.spinner = [[FBRunLoopSpinner new] timeout:0.1];
+}
+
+- (void)testSpinUntilCompletion
+{
+  __block BOOL _didExecuteBlock = NO;
+  [FBRunLoopSpinner spinUntilCompletion:^(void (^completion)(void)) {
+    _didExecuteBlock = YES;
+    completion();
+  }];
+  XCTAssertTrue(_didExecuteBlock);
+}
+
+- (void)testSpinUntilTrue
+{
+  __block BOOL _didExecuteBlock = NO;
+  BOOL didSucceed =
+  [self.spinner spinUntilTrue:^BOOL{
+    _didExecuteBlock = YES;
+    return YES;
+  }];
+  XCTAssertTrue(didSucceed);
+  XCTAssertTrue(_didExecuteBlock);
+}
+
+- (void)testSpinUntilTrueTimeout
+{
+  NSError *error;
+  BOOL didSucceed =
+  [self.spinner spinUntilTrue:^BOOL{
+    return NO;
+  } error:&error];
+  XCTAssertFalse(didSucceed);
+  XCTAssertNotNil(error);
+}
+
+- (void)testSpinUntilTrueTimeoutMessage
+{
+  NSString *expectedMessage = @"Magic message";
+  NSError *error;
+  BOOL didSucceed =
+  [[self.spinner timeoutErrorMessage:expectedMessage]
+   spinUntilTrue:^BOOL{
+     return NO;
+   } error:&error];
+  XCTAssertFalse(didSucceed);
+  XCTAssertEqual(error.localizedDescription, expectedMessage);
+}
+
+- (void)testSpinUntilNotNil
+{
+  __block id expectedObject = NSObject.new;
+  NSError *error;
+  id returnedObject =
+  [self.spinner spinUntilNotNil:^id{
+    return expectedObject;
+  } error:&error];
+  XCTAssertNil(error);
+  XCTAssertEqual(returnedObject, expectedObject);
+}
+
+- (void)testSpinUntilNotNilTimeout
+{
+  NSError *error;
+  id element =
+  [self.spinner spinUntilNotNil:^id{
+    return nil;
+  } error:&error];
+  XCTAssertNil(element);
+  XCTAssertNotNil(error);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/FBRuntimeUtilsTests.m

@@ -0,0 +1,45 @@
+/**
+ * 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>
+
+#import "FBRuntimeUtils.h"
+#import "XCTestPrivateSymbols.h"
+
+@protocol FBMagicProtocol <NSObject>
+@end
+
+const NSString *FBRuntimeUtilsTestsConstString = @"FBRuntimeUtilsTestsConstString";
+
+@interface FBRuntimeUtilsTests : XCTestCase <FBMagicProtocol>
+@end
+
+@implementation FBRuntimeUtilsTests
+
+- (void)testClassesThatConformsToProtocol
+{
+  XCTAssertEqualObjects(@[self.class], FBClassesThatConformsToProtocol(@protocol(FBMagicProtocol)));
+}
+
+- (void)testRetrievingFrameworkSymbols
+{
+  NSString *binaryPath = [NSBundle bundleForClass:self.class].executablePath;
+  NSString *symbolPointer = *(NSString*__autoreleasing*)FBRetrieveSymbolFromBinary(binaryPath.UTF8String, "FBRuntimeUtilsTestsConstString");
+  XCTAssertNotNil(symbolPointer);
+  XCTAssertEqualObjects(symbolPointer, FBRuntimeUtilsTestsConstString);
+}
+
+- (void)testXCTestSymbols
+{
+  XCTAssertTrue(XCDebugLogger != NULL);
+  XCTAssertTrue(XCSetDebugLogger != NULL);
+  XCTAssertNotNil(FB_XCAXAIsVisibleAttribute);
+  XCTAssertNotNil(FB_XCAXAIsElementAttribute);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/FBSDKVersionTests.m

@@ -0,0 +1,66 @@
+/**
+ * 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>
+
+#import "FBRuntimeUtils.h"
+
+@interface FBSDKVersionTests : XCTestCase
+@property (nonatomic, readonly) NSString *currentSDKVersion;
+@property (nonatomic, readonly) NSString *lowerSDKVersion;
+@property (nonatomic, readonly) NSString *higherSDKVersion;
+@end
+
+@implementation FBSDKVersionTests
+
+- (void)setUp
+{
+  [super setUp];
+  NSDictionary *bundleDict = [[NSBundle mainBundle] infoDictionary];
+  [bundleDict setValue:@"11.0" forKey:@"DTSDKName"];
+  _currentSDKVersion = FBSDKVersion();
+  _lowerSDKVersion = [NSString stringWithFormat:@"%@", @((int)[self.currentSDKVersion doubleValue] - 1)];
+  _higherSDKVersion = [NSString stringWithFormat:@"%@", @((int)[self.currentSDKVersion doubleValue] + 1)];
+}
+
+- (void)testIsSDKVersionLessThanOrEqualTo
+{
+  XCTAssertTrue(isSDKVersionLessThanOrEqualTo(self.higherSDKVersion));
+  XCTAssertFalse(isSDKVersionLessThanOrEqualTo(self.lowerSDKVersion));
+  XCTAssertTrue(isSDKVersionLessThanOrEqualTo(self.currentSDKVersion));
+}
+
+- (void)testIsSDKVersionLessThan
+{
+  XCTAssertTrue(isSDKVersionLessThan(self.higherSDKVersion));
+  XCTAssertFalse(isSDKVersionLessThan(self.lowerSDKVersion));
+  XCTAssertFalse(isSDKVersionLessThan(self.currentSDKVersion));
+}
+
+- (void)testIsSDKVersionEqualTo
+{
+  XCTAssertFalse(isSDKVersionEqualTo(self.higherSDKVersion));
+  XCTAssertFalse(isSDKVersionEqualTo(self.lowerSDKVersion));
+  XCTAssertTrue(isSDKVersionEqualTo(self.currentSDKVersion));
+}
+
+- (void)testIsSDKVersionGreaterThanOrEqualTo
+{
+  XCTAssertFalse(isSDKVersionGreaterThanOrEqualTo(self.higherSDKVersion));
+  XCTAssertTrue(isSDKVersionGreaterThanOrEqualTo(self.lowerSDKVersion));
+  XCTAssertTrue(isSDKVersionGreaterThanOrEqualTo(self.currentSDKVersion));
+}
+
+- (void)testIsSDKVersionGreaterThan
+{
+  XCTAssertFalse(isSDKVersionGreaterThan(self.higherSDKVersion));
+  XCTAssertTrue(isSDKVersionGreaterThan(self.lowerSDKVersion));
+  XCTAssertFalse(isSDKVersionGreaterThan(self.currentSDKVersion));
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/FBSessionTests.m

@@ -0,0 +1,67 @@
+/**
+ * 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>
+
+#import "FBSession.h"
+#import "FBConfiguration.h"
+#import "XCUIApplicationDouble.h"
+
+@interface FBSessionTests : XCTestCase
+@property (nonatomic, strong) FBSession *session;
+@property (nonatomic, strong) XCUIApplication *testedApplication;
+@property (nonatomic) BOOL shouldTerminateAppValue;
+@end
+
+@implementation FBSessionTests
+
+- (void)setUp
+{
+  [super setUp];
+  self.testedApplication = (id)XCUIApplicationDouble.new;
+  self.shouldTerminateAppValue = FBConfiguration.shouldTerminateApp;
+  [FBConfiguration setShouldTerminateApp:NO];
+  self.session = [FBSession initWithApplication:self.testedApplication];
+}
+
+- (void)tearDown
+{
+  [self.session kill];
+  [FBConfiguration setShouldTerminateApp:self.shouldTerminateAppValue];
+  [super tearDown];
+}
+
+- (void)testSessionFetching
+{
+  FBSession *fetchedSession = [FBSession sessionWithIdentifier:self.session.identifier];
+  XCTAssertEqual(self.session, fetchedSession);
+}
+
+- (void)testSessionFetchingBadIdentifier
+{
+  XCTAssertNil([FBSession sessionWithIdentifier:@"FAKE_IDENTIFIER"]);
+}
+
+- (void)testSessionCreation
+{
+  XCTAssertNotNil(self.session.identifier);
+  XCTAssertNotNil(self.session.elementCache);
+}
+
+- (void)testActiveSession
+{
+  XCTAssertEqual(self.session, [FBSession activeSession]);
+}
+
+- (void)testActiveSessionIsNilAfterKilling
+{
+  [self.session kill];
+  XCTAssertNil([FBSession activeSession]);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/FBXMLSafeStringTests.m

@@ -0,0 +1,35 @@
+/**
+ * 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>
+
+#import "NSString+FBXMLSafeString.h"
+
+@interface FBXMLSafeStringTests : XCTestCase
+@end
+
+@implementation FBXMLSafeStringTests
+
+- (void)testSafeXmlStringTransformationWithEmptyReplacement {
+  NSString *withInvalidChar = [NSString stringWithFormat:@"bla%@", @"\uFFFF"];
+  NSString *withoutInvalidChar = @"bla";
+  XCTAssertNotEqualObjects(withInvalidChar, withoutInvalidChar);
+  XCTAssertEqualObjects([withInvalidChar fb_xmlSafeStringWithReplacement:@""], withoutInvalidChar);
+}
+
+- (void)testSafeXmlStringTransformationWithNonEmptyReplacement {
+  NSString *withInvalidChar = [NSString stringWithFormat:@"bla%@", @"\uFFFF"];
+  XCTAssertEqualObjects([withInvalidChar fb_xmlSafeStringWithReplacement:@"1"], @"bla1");
+}
+
+- (void)testSafeXmlStringTransformationWithSmileys {
+  NSString *validString = @"Yo👿";
+  XCTAssertEqualObjects([validString fb_xmlSafeStringWithReplacement:@""], validString);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/FBXPathTests.m

@@ -0,0 +1,155 @@
+/**
+ * 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>
+
+#import "FBMacros.h"
+#import "FBXPath.h"
+#import "FBXPath-Private.h"
+#import "XCUIElementDouble.h"
+#import "XCElementSnapshotDouble.h"
+#import "FBXCElementSnapshotWrapper+Helpers.h"
+#import "XCTestPrivateSymbols.h"
+
+@interface FBXPathTests : XCTestCase
+@end
+
+@implementation FBXPathTests
+
+- (NSString *)xmlStringWithElement:(id<FBXCElementSnapshot>)snapshot
+                        xpathQuery:(nullable NSString *)query
+               excludingAttributes:(nullable NSArray<NSString *> *)excludedAttributes
+{
+  xmlDocPtr doc;
+  
+  xmlTextWriterPtr writer = xmlNewTextWriterDoc(&doc, 0);
+  NSMutableDictionary *elementStore = [NSMutableDictionary dictionary];
+  int buffersize;
+  xmlChar *xmlbuff = NULL;
+  int rc = xmlTextWriterStartDocument(writer, NULL, "UTF-8", NULL);
+  if (rc >= 0) {
+    rc = [FBXPath xmlRepresentationWithRootElement:snapshot
+                                            writer:writer
+                                      elementStore:elementStore
+                                             query:query
+                               excludingAttributes:excludedAttributes];
+    if (rc >= 0) {
+      rc = xmlTextWriterEndDocument(writer);
+    }
+  }
+  if (rc >= 0) {
+    xmlDocDumpFormatMemory(doc, &xmlbuff, &buffersize, 1);
+  }
+  xmlFreeTextWriter(writer);
+  xmlFreeDoc(doc);
+  
+  XCTAssertTrue(rc >= 0);
+  XCTAssertEqual(1, [elementStore count]);
+
+  NSString *result = [NSString stringWithCString:(const char *)xmlbuff encoding:NSUTF8StringEncoding];
+  xmlFree(xmlbuff);
+  return result;
+}
+
+- (void)testDefaultXPathPresentation
+{
+  XCElementSnapshotDouble *snapshot = [XCElementSnapshotDouble new];
+  id<FBElement> element = (id<FBElement>)[FBXCElementSnapshotWrapper ensureWrapped:(id)snapshot];
+  NSString *resultXml = [self xmlStringWithElement:(id<FBXCElementSnapshot>)element
+                                        xpathQuery:nil
+                               excludingAttributes:nil];
+  NSLog(@"[DefaultXPath] Result XML:\n%@", resultXml);
+  NSString *expectedXml = [NSString stringWithFormat:@"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<%@ type=\"%@\" value=\"%@\" name=\"%@\" label=\"%@\" enabled=\"%@\" visible=\"%@\" accessible=\"%@\" x=\"%@\" y=\"%@\" width=\"%@\" height=\"%@\" index=\"%lu\" traits=\"%@\" private_indexPath=\"top\"/>\n",
+                           element.wdType, element.wdType, element.wdValue, element.wdName, element.wdLabel, FBBoolToString(element.wdEnabled), FBBoolToString(element.wdVisible), FBBoolToString(element.wdAccessible), element.wdRect[@"x"], element.wdRect[@"y"], element.wdRect[@"width"], element.wdRect[@"height"], element.wdIndex, element.wdTraits];
+  XCTAssertTrue([resultXml isEqualToString: expectedXml]);
+}
+
+- (void)testXPathPresentationWithSomeAttributesExcluded
+{
+  XCElementSnapshotDouble *snapshot = [XCElementSnapshotDouble new];
+  id<FBElement> element = (id<FBElement>)[FBXCElementSnapshotWrapper ensureWrapped:(id)snapshot];
+  NSString *resultXml = [self xmlStringWithElement:(id<FBXCElementSnapshot>)element
+                                        xpathQuery:nil
+                               excludingAttributes:@[@"type", @"visible", @"value", @"index", @"traits", @"nativeFrame"]];
+  NSString *expectedXml = [NSString stringWithFormat:@"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<%@ name=\"%@\" label=\"%@\" enabled=\"%@\" accessible=\"%@\" x=\"%@\" y=\"%@\" width=\"%@\" height=\"%@\" private_indexPath=\"top\"/>\n",
+                           element.wdType, element.wdName, element.wdLabel, FBBoolToString(element.wdEnabled), FBBoolToString(element.wdAccessible), element.wdRect[@"x"], element.wdRect[@"y"], element.wdRect[@"width"], element.wdRect[@"height"]];
+  XCTAssertEqualObjects(resultXml, expectedXml);
+}
+
+- (void)testXPathPresentationBasedOnQueryMatchingAllAttributes
+{
+  XCElementSnapshotDouble *snapshot = [XCElementSnapshotDouble new];
+  snapshot.value = @"йоло<>&\"";
+  snapshot.label = @"a\nb";
+  NSString *testCustomActions = @"Custom Action 1, Custom Action 2";
+  snapshot.additionalAttributes[FB_XCAXACustomActionsAttribute] = testCustomActions;
+  id<FBElement> element = (id<FBElement>)[FBXCElementSnapshotWrapper ensureWrapped:(id)snapshot];
+  NSString *resultXml = [self xmlStringWithElement:(id<FBXCElementSnapshot>)element
+                                        xpathQuery:[NSString stringWithFormat:@"//%@[@*]", element.wdType]
+                               excludingAttributes:@[@"visible"]];
+  NSString *expectedXml = [NSString stringWithFormat:@"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<%@ type=\"%@\" value=\"%@\" name=\"%@\" label=\"%@\" enabled=\"%@\" visible=\"%@\" accessible=\"%@\" x=\"%@\" y=\"%@\" width=\"%@\" height=\"%@\" index=\"%lu\" hittable=\"%@\" traits=\"%@\" nativeFrame=\"%@\" customActions=\"%@\" private_indexPath=\"top\"/>\n",
+                           element.wdType, element.wdType, @"йоло&lt;&gt;&amp;&quot;", element.wdName, @"a&#10;b", FBBoolToString(element.wdEnabled), FBBoolToString(element.wdVisible), FBBoolToString(element.wdAccessible), element.wdRect[@"x"], element.wdRect[@"y"], element.wdRect[@"width"], element.wdRect[@"height"], element.wdIndex, FBBoolToString(element.wdHittable), element.wdTraits, NSStringFromCGRect(element.wdNativeFrame), element.wdCustomActions];
+  XCTAssertEqualObjects(expectedXml, resultXml);
+}
+
+- (void)testXPathPresentationBasedOnQueryMatchingSomeAttributes
+{
+  XCElementSnapshotDouble *snapshot = [XCElementSnapshotDouble new];
+  id<FBElement> element = (id<FBElement>)[FBXCElementSnapshotWrapper ensureWrapped:(id)snapshot];
+  NSString *resultXml = [self xmlStringWithElement:(id<FBXCElementSnapshot>)element
+                                        xpathQuery:[NSString stringWithFormat:@"//%@[@%@ and contains(@%@, 'blabla')]", element.wdType, @"value", @"name"]
+                               excludingAttributes:nil];
+  NSString *expectedXml = [NSString stringWithFormat:@"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<%@ value=\"%@\" name=\"%@\" private_indexPath=\"top\"/>\n",
+                           element.wdType, element.wdValue, element.wdName];
+  XCTAssertTrue([resultXml isEqualToString: expectedXml]);
+}
+
+- (void)testSnapshotXPathResultsMatching
+{
+  xmlDocPtr doc;
+
+  xmlTextWriterPtr writer = xmlNewTextWriterDoc(&doc, 0);
+  NSMutableDictionary *elementStore = [NSMutableDictionary dictionary];
+  XCElementSnapshotDouble *snapshot = [XCElementSnapshotDouble new];
+  id<FBElement> root = (id<FBElement>)[FBXCElementSnapshotWrapper ensureWrapped:(id)snapshot];
+  NSString *query = [NSString stringWithFormat:@"//%@", root.wdType];
+  int rc = xmlTextWriterStartDocument(writer, NULL, "UTF-8", NULL);
+  if (rc >= 0) {
+    rc = [FBXPath xmlRepresentationWithRootElement:(id<FBXCElementSnapshot>)root
+                                            writer:writer
+                                      elementStore:elementStore
+                                             query:query
+                               excludingAttributes:nil];
+    if (rc >= 0) {
+      rc = xmlTextWriterEndDocument(writer);
+    }
+  }
+  if (rc < 0) {
+    xmlFreeTextWriter(writer);
+    xmlFreeDoc(doc);
+    XCTFail(@"Unable to create the source XML document");
+  }
+
+  xmlXPathObjectPtr queryResult = [FBXPath evaluate:query document:doc contextNode:NULL];
+  if (NULL == queryResult) {
+    xmlFreeTextWriter(writer);
+    xmlFreeDoc(doc);
+    XCTAssertNotEqual(NULL, queryResult);
+  }
+
+  NSArray *matchingSnapshots = [FBXPath collectMatchingSnapshots:queryResult->nodesetval
+                                                    elementStore:elementStore];
+  xmlXPathFreeObject(queryResult);
+  xmlFreeTextWriter(writer);
+  xmlFreeDoc(doc);
+
+  XCTAssertNotNil(matchingSnapshots);
+  XCTAssertEqual(1, [matchingSnapshots count]);
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/Info.plist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>com.facebook.wda.unitTests</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+</dict>
+</plist>

package/drivers/ios/WebDriverAgent/WebDriverAgentTests/UnitTests/NSDictionaryFBUtf8SafeTests.m

@@ -0,0 +1,34 @@
+/**
+ * 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>
+
+#import "NSDictionary+FBUtf8SafeDictionary.h"
+
+@interface NSDictionaryFBUtf8SafeTests : XCTestCase
+@end
+
+@implementation NSDictionaryFBUtf8SafeTests
+
+- (void)testEmptySafeDictConversion
+{
+  NSDictionary *d = @{};
+  XCTAssertEqualObjects(d, d.fb_utf8SafeDictionary);
+}
+
+- (void)testNonEmptySafeDictConversion
+{
+  NSDictionary *d = @{
+    @"1": @[@3, @4],
+    @"5": @{@"6": @7, @"8": @9},
+    @"10": @"11"
+  };
+  XCTAssertEqualObjects(d, d.fb_utf8SafeDictionary);
+}
+
+@end