@deque/axe-appium3-webdriveragent 0.0.0-stage → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (678) hide show
  1. package/Configurations/IOSSettings.xcconfig +31 -0
  2. package/Configurations/IOSTestSettings.xcconfig +1 -0
  3. package/Configurations/TVOSSettings.xcconfig +31 -0
  4. package/Configurations/TVOSTestSettings.xcconfig +1 -0
  5. package/LICENSE +66 -0
  6. package/LICENSE-3RD-PARTY.md +70 -0
  7. package/MySwiftFramework/JSONHelper.swift +31 -0
  8. package/MySwiftFramework/MySwiftFramework.h +18 -0
  9. package/PrivateHeaders/AccessibilityUtilities/AXSettings.h +15 -0
  10. package/PrivateHeaders/MobileCoreServices/LSApplicationWorkspace.h +127 -0
  11. package/PrivateHeaders/TextInput/TIPreferencesController.h +45 -0
  12. package/PrivateHeaders/UIKitCore/UIKeyboardImpl.h +27 -0
  13. package/PrivateHeaders/XCTest/CDStructures.h +7 -0
  14. package/PrivateHeaders/XCTest/NSFastEnumeration-Protocol.h +23 -0
  15. package/PrivateHeaders/XCTest/XCAXClient_iOS.h +91 -0
  16. package/PrivateHeaders/XCTest/XCApplicationQuery.h +30 -0
  17. package/PrivateHeaders/XCTest/XCDebugLogDelegate-Protocol.h +23 -0
  18. package/PrivateHeaders/XCTest/XCPointerEvent.h +63 -0
  19. package/PrivateHeaders/XCTest/XCPointerEventPath.h +65 -0
  20. package/PrivateHeaders/XCTest/XCSynthesizedEventRecord.h +55 -0
  21. package/PrivateHeaders/XCTest/XCTAggregateSuiteRunStatistics.h +38 -0
  22. package/PrivateHeaders/XCTest/XCTAttachmentManager.h +33 -0
  23. package/PrivateHeaders/XCTest/XCTCapabilities.h +35 -0
  24. package/PrivateHeaders/XCTest/XCTCapabilitiesProviding-Protocol.h +23 -0
  25. package/PrivateHeaders/XCTest/XCTElementSetTransformer-Protocol.h +35 -0
  26. package/PrivateHeaders/XCTest/XCTElementSnapshotAttributeDataSource-Protocol.h +33 -0
  27. package/PrivateHeaders/XCTest/XCTElementSnapshotProvider-Protocol.h +23 -0
  28. package/PrivateHeaders/XCTest/XCTExpectedFailureContextManager.h +35 -0
  29. package/PrivateHeaders/XCTest/XCTFuture.h +45 -0
  30. package/PrivateHeaders/XCTest/XCTHarnessEventReporting-Protocol.h +29 -0
  31. package/PrivateHeaders/XCTest/XCTIssue.h +49 -0
  32. package/PrivateHeaders/XCTest/XCTIssueHandling-Protocol.h +26 -0
  33. package/PrivateHeaders/XCTest/XCTMacCatalystStatusProviding-Protocol.h +23 -0
  34. package/PrivateHeaders/XCTest/XCTMeasureOptions.h +48 -0
  35. package/PrivateHeaders/XCTest/XCTMemoryChecker.h +50 -0
  36. package/PrivateHeaders/XCTest/XCTMemoryCheckerDelegate-Protocol.h +26 -0
  37. package/PrivateHeaders/XCTest/XCTMessagingChannel_IDEToRunner-Protocol.h +27 -0
  38. package/PrivateHeaders/XCTest/XCTMessagingChannel_RunnerToDaemon-Protocol.h +39 -0
  39. package/PrivateHeaders/XCTest/XCTMessagingChannel_RunnerToIDE-Protocol.h +32 -0
  40. package/PrivateHeaders/XCTest/XCTMessagingRole_ActivityReporting-Protocol.h +24 -0
  41. package/PrivateHeaders/XCTest/XCTMessagingRole_AttachmentFutureResultStatusUpdating-Protocol.h +23 -0
  42. package/PrivateHeaders/XCTest/XCTMessagingRole_BundleRequesting-Protocol.h +24 -0
  43. package/PrivateHeaders/XCTest/XCTMessagingRole_CapabilityExchange-Protocol.h +56 -0
  44. package/PrivateHeaders/XCTest/XCTMessagingRole_DebugLogging-Protocol.h +23 -0
  45. package/PrivateHeaders/XCTest/XCTMessagingRole_EventSynthesis-Protocol.h +34 -0
  46. package/PrivateHeaders/XCTest/XCTMessagingRole_ForcePressureSupportQuerying-Protocol.h +25 -0
  47. package/PrivateHeaders/XCTest/XCTMessagingRole_HIDEventRecording-Protocol.h +25 -0
  48. package/PrivateHeaders/XCTest/XCTMessagingRole_MemoryTesting-Protocol.h +23 -0
  49. package/PrivateHeaders/XCTest/XCTMessagingRole_PerformanceMeasurementReporting-Protocol.h +23 -0
  50. package/PrivateHeaders/XCTest/XCTMessagingRole_ProcessMonitoring-Protocol.h +25 -0
  51. package/PrivateHeaders/XCTest/XCTMessagingRole_ProtectedResourceAuthorization-Protocol.h +22 -0
  52. package/PrivateHeaders/XCTest/XCTMessagingRole_ScreenRecording-Protocol.h +24 -0
  53. package/PrivateHeaders/XCTest/XCTMessagingRole_SelfDiagnosisIssueReporting-Protocol.h +23 -0
  54. package/PrivateHeaders/XCTest/XCTMessagingRole_SignpostRequesting-Protocol.h +24 -0
  55. package/PrivateHeaders/XCTest/XCTMessagingRole_SiriAutomation-Protocol.h +27 -0
  56. package/PrivateHeaders/XCTest/XCTMessagingRole_SystemConfiguration-Protocol.h +27 -0
  57. package/PrivateHeaders/XCTest/XCTMessagingRole_TelemetrySending-Protocol.h +23 -0
  58. package/PrivateHeaders/XCTest/XCTMessagingRole_TestExecution-Protocol.h +28 -0
  59. package/PrivateHeaders/XCTest/XCTMessagingRole_TestReporting-Protocol.h +40 -0
  60. package/PrivateHeaders/XCTest/XCTMessagingRole_UIAutomation-Protocol.h +29 -0
  61. package/PrivateHeaders/XCTest/XCTMessagingRole_UIAutomationRunnerEventReporting-Protocol.h +27 -0
  62. package/PrivateHeaders/XCTest/XCTMessagingRole_UserPresence-Protocol.h +24 -0
  63. package/PrivateHeaders/XCTest/XCTMetricDiagnosticHelper.h +49 -0
  64. package/PrivateHeaders/XCTest/XCTNSPredicateExpectationObject-Protocol.h +23 -0
  65. package/PrivateHeaders/XCTest/XCTPromise.h +30 -0
  66. package/PrivateHeaders/XCTest/XCTRemoteSignpostListenerProxy-Protocol.h +29 -0
  67. package/PrivateHeaders/XCTest/XCTRepetitionPolicy.h +43 -0
  68. package/PrivateHeaders/XCTest/XCTReportingSession.h +50 -0
  69. package/PrivateHeaders/XCTest/XCTReportingSessionConfiguration-Protocol.h +27 -0
  70. package/PrivateHeaders/XCTest/XCTReportingSessionIssueReporter-Protocol.h +23 -0
  71. package/PrivateHeaders/XCTest/XCTReportingSessionTestContainer-Protocol.h +26 -0
  72. package/PrivateHeaders/XCTest/XCTReportingSessionTestReporter.h +51 -0
  73. package/PrivateHeaders/XCTest/XCTRunnerAutomationSession-Protocol.h +38 -0
  74. package/PrivateHeaders/XCTest/XCTRunnerDaemonSession.h +96 -0
  75. package/PrivateHeaders/XCTest/XCTRunnerDaemonSessionUIAutomationDelegate-Protocol.h +33 -0
  76. package/PrivateHeaders/XCTest/XCTRunnerIDESession.h +99 -0
  77. package/PrivateHeaders/XCTest/XCTRunnerIDESessionDelegate-Protocol.h +24 -0
  78. package/PrivateHeaders/XCTest/XCTRuntimeDiagnosticsPolicy.h +36 -0
  79. package/PrivateHeaders/XCTest/XCTRuntimeIssueDetectionPolicy.h +39 -0
  80. package/PrivateHeaders/XCTest/XCTScreenCapturePolicy.h +35 -0
  81. package/PrivateHeaders/XCTest/XCTSignpostListener-Protocol.h +25 -0
  82. package/PrivateHeaders/XCTest/XCTSkippedTestContext.h +37 -0
  83. package/PrivateHeaders/XCTest/XCTSourceCodeContext.h +39 -0
  84. package/PrivateHeaders/XCTest/XCTSourceCodeLocation.h +31 -0
  85. package/PrivateHeaders/XCTest/XCTTagSelection.h +41 -0
  86. package/PrivateHeaders/XCTest/XCTTestIdentifier.h +81 -0
  87. package/PrivateHeaders/XCTest/XCTTestIdentifierSet.h +54 -0
  88. package/PrivateHeaders/XCTest/XCTTestSelection.h +35 -0
  89. package/PrivateHeaders/XCTest/XCTWaiter.h +54 -0
  90. package/PrivateHeaders/XCTest/XCTWaiterManagement-Protocol.h +24 -0
  91. package/PrivateHeaders/XCTest/XCTWaiterManager-Protocol.h +25 -0
  92. package/PrivateHeaders/XCTest/XCTWaiterWait.h +40 -0
  93. package/PrivateHeaders/XCTest/XCTest.h +53 -0
  94. package/PrivateHeaders/XCTest/XCTestCase.h +180 -0
  95. package/PrivateHeaders/XCTest/XCTestCaseDiscoveryUIAutomationDelegate-Protocol.h +20 -0
  96. package/PrivateHeaders/XCTest/XCTestCaseRun.h +28 -0
  97. package/PrivateHeaders/XCTest/XCTestCaseUIAutomationDelegate-Protocol.h +25 -0
  98. package/PrivateHeaders/XCTest/XCTestCastMethodNamesUIAutomationDelegate-Protocol.h +24 -0
  99. package/PrivateHeaders/XCTest/XCTestConfiguration.h +94 -0
  100. package/PrivateHeaders/XCTest/XCTestDriver.h +64 -0
  101. package/PrivateHeaders/XCTest/XCTestExpectation.h +50 -0
  102. package/PrivateHeaders/XCTest/XCTestExpectationDelegate-Protocol.h +23 -0
  103. package/PrivateHeaders/XCTest/XCTestObservationCenter.h +60 -0
  104. package/PrivateHeaders/XCTest/XCTestRun.h +44 -0
  105. package/PrivateHeaders/XCTest/XCUIAXNotificationHandling-Protocol.h +25 -0
  106. package/PrivateHeaders/XCTest/XCUIAccessibilityInterface-Protocol.h +58 -0
  107. package/PrivateHeaders/XCTest/XCUIAlertMonitoring-Protocol.h +27 -0
  108. package/PrivateHeaders/XCTest/XCUIApplication.h +98 -0
  109. package/PrivateHeaders/XCTest/XCUIApplicationAutomationSessionProviding-Protocol.h +26 -0
  110. package/PrivateHeaders/XCTest/XCUIApplicationImpl.h +90 -0
  111. package/PrivateHeaders/XCTest/XCUIApplicationImplReporter-Protocol.h +26 -0
  112. package/PrivateHeaders/XCTest/XCUIApplicationManaging-Protocol.h +23 -0
  113. package/PrivateHeaders/XCTest/XCUIApplicationMonitor-Protocol.h +43 -0
  114. package/PrivateHeaders/XCTest/XCUIApplicationOpenRequest.h +34 -0
  115. package/PrivateHeaders/XCTest/XCUIApplicationPlatformServicesProviderDelegate-Protocol.h +25 -0
  116. package/PrivateHeaders/XCTest/XCUIApplicationProcess.h +105 -0
  117. package/PrivateHeaders/XCTest/XCUIApplicationProcessDelegate-Protocol.h +25 -0
  118. package/PrivateHeaders/XCTest/XCUIApplicationProcessManaging-Protocol.h +26 -0
  119. package/PrivateHeaders/XCTest/XCUIApplicationProcessTracker-Protocol.h +28 -0
  120. package/PrivateHeaders/XCTest/XCUIApplicationRegistry.h +32 -0
  121. package/PrivateHeaders/XCTest/XCUIButtonConsole.h +26 -0
  122. package/PrivateHeaders/XCTest/XCUICoordinate.h +49 -0
  123. package/PrivateHeaders/XCTest/XCUIDevice.h +134 -0
  124. package/PrivateHeaders/XCTest/XCUIDeviceAutomationModeInterface-Protocol.h +25 -0
  125. package/PrivateHeaders/XCTest/XCUIDeviceDelayedAttachmentTransferSupportInterface-Protocol.h +22 -0
  126. package/PrivateHeaders/XCTest/XCUIDeviceEventAndStateInterface-Protocol.h +40 -0
  127. package/PrivateHeaders/XCTest/XCUIElement.h +207 -0
  128. package/PrivateHeaders/XCTest/XCUIElementAttributesPrivate-Protocol.h +26 -0
  129. package/PrivateHeaders/XCTest/XCUIElementEventTarget-Protocol.h +38 -0
  130. package/PrivateHeaders/XCTest/XCUIElementQuery.h +166 -0
  131. package/PrivateHeaders/XCTest/XCUIElementTypeQueryProvider_Private-Protocol.h +24 -0
  132. package/PrivateHeaders/XCTest/XCUIEventRecording-Protocol.h +37 -0
  133. package/PrivateHeaders/XCTest/XCUIHitPointResult.h +25 -0
  134. package/PrivateHeaders/XCTest/XCUIInterruptionMonitoring-Protocol.h +27 -0
  135. package/PrivateHeaders/XCTest/XCUIIssueDiagnosticsProviding-Protocol.h +23 -0
  136. package/PrivateHeaders/XCTest/XCUIKnobControl.h +26 -0
  137. package/PrivateHeaders/XCTest/XCUILocation.h +24 -0
  138. package/PrivateHeaders/XCTest/XCUIPlatformApplicationServicesProviding-Protocol.h +33 -0
  139. package/PrivateHeaders/XCTest/XCUIRemoteAccessibilityInterface-Protocol.h +45 -0
  140. package/PrivateHeaders/XCTest/XCUIRemoteDeviceRunner-Protocol.h +24 -0
  141. package/PrivateHeaders/XCTest/XCUIRemoteSiriInterface-Protocol.h +30 -0
  142. package/PrivateHeaders/XCTest/XCUIResetAuthorizationStatusOfProtectedResourcesInterface-Protocol.h +22 -0
  143. package/PrivateHeaders/XCTest/XCUIScreen.h +53 -0
  144. package/PrivateHeaders/XCTest/XCUIScreenDataSource-Protocol.h +35 -0
  145. package/PrivateHeaders/XCTest/XCUISiriService.h +39 -0
  146. package/PrivateHeaders/XCTest/XCUISystem.h +26 -0
  147. package/PrivateHeaders/XCTest/XCUIXcodeApplicationManaging-Protocol.h +27 -0
  148. package/PrivateHeaders/XCTest/_TtC10XCTestCore19XCTReportingContext.h +26 -0
  149. package/PrivateHeaders/XCTest/_XCTMessaging_VoidProtocol-Protocol.h +20 -0
  150. package/PrivateHeaders/XCTest/_XCTestObservationInternal-Protocol.h +26 -0
  151. package/PrivateHeaders/XCTest/_XCTestObservationPrivate-Protocol.h +27 -0
  152. package/README.md +57 -2
  153. package/Scripts/build-webdriveragent.mjs +93 -0
  154. package/Scripts/build.sh +137 -0
  155. package/Scripts/bundle-mobile-assets.sh +35 -0
  156. package/Scripts/embed-runner-icon.sh +118 -0
  157. package/Scripts/fetch-prebuilt-wda.mjs +81 -0
  158. package/Scripts/update-wda-version.mjs +44 -0
  159. package/WebDriverAgent.xcodeproj/project.pbxproj +8522 -0
  160. package/WebDriverAgent.xcodeproj/project.xcworkspace/contents.xcworkspacedata +7 -0
  161. package/WebDriverAgent.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist +8 -0
  162. package/WebDriverAgent.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +5 -0
  163. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationApp.xcscheme +87 -0
  164. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationApp_tvOS.xcscheme +78 -0
  165. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationApp_watchOS.xcscheme +78 -0
  166. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_1.xcscheme +93 -0
  167. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_2.xcscheme +93 -0
  168. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_3.xcscheme +93 -0
  169. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_tvOS.xcscheme +93 -0
  170. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/IntegrationTests_watchOS.xcscheme +93 -0
  171. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentLib.xcscheme +125 -0
  172. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentLib_tvOS.xcscheme +95 -0
  173. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentLib_watchOS.xcscheme +85 -0
  174. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner-nodebug.xcscheme +87 -0
  175. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner.xcscheme +132 -0
  176. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner_noauth.xcscheme +70 -0
  177. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner_tvOS.xcscheme +123 -0
  178. package/WebDriverAgent.xcodeproj/xcshareddata/xcschemes/WebDriverAgentRunner_watchOS.xcscheme +128 -0
  179. package/WebDriverAgentLib/Categories/FBXCElementSnapshotWrapper+Helpers.h +100 -0
  180. package/WebDriverAgentLib/Categories/FBXCElementSnapshotWrapper+Helpers.m +192 -0
  181. package/WebDriverAgentLib/Categories/NSDictionary+FBUtf8SafeDictionary.h +39 -0
  182. package/WebDriverAgentLib/Categories/NSDictionary+FBUtf8SafeDictionary.m +105 -0
  183. package/WebDriverAgentLib/Categories/NSExpression+FBFormat.h +29 -0
  184. package/WebDriverAgentLib/Categories/NSExpression+FBFormat.m +34 -0
  185. package/WebDriverAgentLib/Categories/NSString+FBVisualLength.h +18 -0
  186. package/WebDriverAgentLib/Categories/NSString+FBVisualLength.m +18 -0
  187. package/WebDriverAgentLib/Categories/NSString+FBXMLSafeString.h +27 -0
  188. package/WebDriverAgentLib/Categories/NSString+FBXMLSafeString.m +30 -0
  189. package/WebDriverAgentLib/Categories/XCAXClient_iOS+FBSnapshotReqParams.h +26 -0
  190. package/WebDriverAgentLib/Categories/XCAXClient_iOS+FBSnapshotReqParams.m +181 -0
  191. package/WebDriverAgentLib/Categories/XCTIssue+FBPatcher.h +17 -0
  192. package/WebDriverAgentLib/Categories/XCTIssue+FBPatcher.m +35 -0
  193. package/WebDriverAgentLib/Categories/XCUIApplication+FBAlert.h +47 -0
  194. package/WebDriverAgentLib/Categories/XCUIApplication+FBAlert.m +179 -0
  195. package/WebDriverAgentLib/Categories/XCUIApplication+FBFocused.h +23 -0
  196. package/WebDriverAgentLib/Categories/XCUIApplication+FBHelpers.h +186 -0
  197. package/WebDriverAgentLib/Categories/XCUIApplication+FBHelpers.m +674 -0
  198. package/WebDriverAgentLib/Categories/XCUIApplication+FBQuiescence.h +24 -0
  199. package/WebDriverAgentLib/Categories/XCUIApplication+FBQuiescence.m +28 -0
  200. package/WebDriverAgentLib/Categories/XCUIApplication+FBTouchAction.h +82 -0
  201. package/WebDriverAgentLib/Categories/XCUIApplication+FBTouchAction.m +198 -0
  202. package/WebDriverAgentLib/Categories/XCUIApplication+FBUIInterruptions.h +22 -0
  203. package/WebDriverAgentLib/Categories/XCUIApplication+FBUIInterruptions.m +31 -0
  204. package/WebDriverAgentLib/Categories/XCUIApplicationProcess+FBQuiescence.h +27 -0
  205. package/WebDriverAgentLib/Categories/XCUIApplicationProcess+FBQuiescence.m +111 -0
  206. package/WebDriverAgentLib/Categories/XCUIDevice+FBHealthCheck.h +30 -0
  207. package/WebDriverAgentLib/Categories/XCUIDevice+FBHealthCheck.m +47 -0
  208. package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.h +236 -0
  209. package/WebDriverAgentLib/Categories/XCUIDevice+FBHelpers.m +478 -0
  210. package/WebDriverAgentLib/Categories/XCUIDevice+FBHinge.h +41 -0
  211. package/WebDriverAgentLib/Categories/XCUIDevice+FBHinge.m +215 -0
  212. package/WebDriverAgentLib/Categories/XCUIDevice+FBRotation.h +46 -0
  213. package/WebDriverAgentLib/Categories/XCUIDevice+FBRotation.m +108 -0
  214. package/WebDriverAgentLib/Categories/XCUIDevice+FBVoiceOver.h +66 -0
  215. package/WebDriverAgentLib/Categories/XCUIDevice+FBVoiceOver.m +218 -0
  216. package/WebDriverAgentLib/Categories/XCUIElement+FBAccessibility.h +29 -0
  217. package/WebDriverAgentLib/Categories/XCUIElement+FBAccessibility.m +50 -0
  218. package/WebDriverAgentLib/Categories/XCUIElement+FBCaching.h +19 -0
  219. package/WebDriverAgentLib/Categories/XCUIElement+FBCaching.m +36 -0
  220. package/WebDriverAgentLib/Categories/XCUIElement+FBClassChain.h +57 -0
  221. package/WebDriverAgentLib/Categories/XCUIElement+FBClassChain.m +239 -0
  222. package/WebDriverAgentLib/Categories/XCUIElement+FBCustomActions.h +27 -0
  223. package/WebDriverAgentLib/Categories/XCUIElement+FBCustomActions.m +127 -0
  224. package/WebDriverAgentLib/Categories/XCUIElement+FBFind.h +75 -0
  225. package/WebDriverAgentLib/Categories/XCUIElement+FBFind.m +146 -0
  226. package/WebDriverAgentLib/Categories/XCUIElement+FBForceTouch.h +38 -0
  227. package/WebDriverAgentLib/Categories/XCUIElement+FBForceTouch.m +55 -0
  228. package/WebDriverAgentLib/Categories/XCUIElement+FBIsVisible.h +28 -0
  229. package/WebDriverAgentLib/Categories/XCUIElement+FBIsVisible.m +78 -0
  230. package/WebDriverAgentLib/Categories/XCUIElement+FBMinMax.h +33 -0
  231. package/WebDriverAgentLib/Categories/XCUIElement+FBMinMax.m +75 -0
  232. package/WebDriverAgentLib/Categories/XCUIElement+FBPickerWheel.h +45 -0
  233. package/WebDriverAgentLib/Categories/XCUIElement+FBPickerWheel.m +59 -0
  234. package/WebDriverAgentLib/Categories/XCUIElement+FBResolve.h +37 -0
  235. package/WebDriverAgentLib/Categories/XCUIElement+FBResolve.m +51 -0
  236. package/WebDriverAgentLib/Categories/XCUIElement+FBScrolling.h +98 -0
  237. package/WebDriverAgentLib/Categories/XCUIElement+FBScrolling.m +465 -0
  238. package/WebDriverAgentLib/Categories/XCUIElement+FBSwiping.h +38 -0
  239. package/WebDriverAgentLib/Categories/XCUIElement+FBSwiping.m +56 -0
  240. package/WebDriverAgentLib/Categories/XCUIElement+FBTVFocuse.h +35 -0
  241. package/WebDriverAgentLib/Categories/XCUIElement+FBTVFocuse.m +71 -0
  242. package/WebDriverAgentLib/Categories/XCUIElement+FBTyping.h +97 -0
  243. package/WebDriverAgentLib/Categories/XCUIElement+FBTyping.m +233 -0
  244. package/WebDriverAgentLib/Categories/XCUIElement+FBUID.h +42 -0
  245. package/WebDriverAgentLib/Categories/XCUIElement+FBUID.m +85 -0
  246. package/WebDriverAgentLib/Categories/XCUIElement+FBUtilities.h +108 -0
  247. package/WebDriverAgentLib/Categories/XCUIElement+FBUtilities.m +175 -0
  248. package/WebDriverAgentLib/Categories/XCUIElement+FBVisibleFrame.h +35 -0
  249. package/WebDriverAgentLib/Categories/XCUIElement+FBVisibleFrame.m +61 -0
  250. package/WebDriverAgentLib/Categories/XCUIElement+FBWebDriverAttributes.h +32 -0
  251. package/WebDriverAgentLib/Categories/XCUIElement+FBWebDriverAttributes.m +299 -0
  252. package/WebDriverAgentLib/Categories/XCUIElementQuery+FBHelpers.h +28 -0
  253. package/WebDriverAgentLib/Categories/XCUIElementQuery+FBHelpers.m +47 -0
  254. package/WebDriverAgentLib/Commands/AxeAuthCommands.h +30 -0
  255. package/WebDriverAgentLib/Commands/AxeAuthCommands.m +175 -0
  256. package/WebDriverAgentLib/Commands/AxeAutoScanCommands.h +19 -0
  257. package/WebDriverAgentLib/Commands/AxeAutoScanCommands.m +143 -0
  258. package/WebDriverAgentLib/Commands/AxeProductDeclaration.h +21 -0
  259. package/WebDriverAgentLib/Commands/AxeProductDeclaration.m +40 -0
  260. package/WebDriverAgentLib/Commands/AxeReportCommands.h +20 -0
  261. package/WebDriverAgentLib/Commands/AxeReportCommands.m +62 -0
  262. package/WebDriverAgentLib/Commands/AxeScanCommands.h +20 -0
  263. package/WebDriverAgentLib/Commands/AxeScanCommands.m +386 -0
  264. package/WebDriverAgentLib/Commands/AxeUsageCommands.h +27 -0
  265. package/WebDriverAgentLib/Commands/AxeUsageCommands.m +90 -0
  266. package/WebDriverAgentLib/Commands/FBAlertViewCommands.h +19 -0
  267. package/WebDriverAgentLib/Commands/FBAlertViewCommands.m +104 -0
  268. package/WebDriverAgentLib/Commands/FBCustomCommands.h +19 -0
  269. package/WebDriverAgentLib/Commands/FBCustomCommands.m +848 -0
  270. package/WebDriverAgentLib/Commands/FBDebugCommands.h +19 -0
  271. package/WebDriverAgentLib/Commands/FBDebugCommands.m +81 -0
  272. package/WebDriverAgentLib/Commands/FBElementCommands.h +19 -0
  273. package/WebDriverAgentLib/Commands/FBElementCommands.m +775 -0
  274. package/WebDriverAgentLib/Commands/FBFindElementCommands.h +18 -0
  275. package/WebDriverAgentLib/Commands/FBFindElementCommands.m +186 -0
  276. package/WebDriverAgentLib/Commands/FBOrientationCommands.h +19 -0
  277. package/WebDriverAgentLib/Commands/FBOrientationCommands.m +192 -0
  278. package/WebDriverAgentLib/Commands/FBScreenshotCommands.h +19 -0
  279. package/WebDriverAgentLib/Commands/FBScreenshotCommands.m +40 -0
  280. package/WebDriverAgentLib/Commands/FBSessionCommands.h +19 -0
  281. package/WebDriverAgentLib/Commands/FBSessionCommands.m +519 -0
  282. package/WebDriverAgentLib/Commands/FBTouchActionCommands.h +19 -0
  283. package/WebDriverAgentLib/Commands/FBTouchActionCommands.m +41 -0
  284. package/WebDriverAgentLib/Commands/FBTouchIDCommands.h +19 -0
  285. package/WebDriverAgentLib/Commands/FBTouchIDCommands.m +30 -0
  286. package/WebDriverAgentLib/Commands/FBUnknownCommands.h +19 -0
  287. package/WebDriverAgentLib/Commands/FBUnknownCommands.m +39 -0
  288. package/WebDriverAgentLib/Commands/FBVideoCommands.h +19 -0
  289. package/WebDriverAgentLib/Commands/FBVideoCommands.m +84 -0
  290. package/WebDriverAgentLib/FBAlert.h +104 -0
  291. package/WebDriverAgentLib/FBAlert.m +454 -0
  292. package/WebDriverAgentLib/Info.plist +26 -0
  293. package/WebDriverAgentLib/Routing/FBCommandHandler.h +38 -0
  294. package/WebDriverAgentLib/Routing/FBCommandStatus.h +80 -0
  295. package/WebDriverAgentLib/Routing/FBCommandStatus.m +279 -0
  296. package/WebDriverAgentLib/Routing/FBElement.h +98 -0
  297. package/WebDriverAgentLib/Routing/FBElementCache.h +61 -0
  298. package/WebDriverAgentLib/Routing/FBElementCache.m +100 -0
  299. package/WebDriverAgentLib/Routing/FBElementUtils.h +76 -0
  300. package/WebDriverAgentLib/Routing/FBElementUtils.m +153 -0
  301. package/WebDriverAgentLib/Routing/FBExceptionHandler.h +29 -0
  302. package/WebDriverAgentLib/Routing/FBExceptionHandler.m +65 -0
  303. package/WebDriverAgentLib/Routing/FBExceptions.h +69 -0
  304. package/WebDriverAgentLib/Routing/FBExceptions.m +27 -0
  305. package/WebDriverAgentLib/Routing/FBHTTPServer.h +97 -0
  306. package/WebDriverAgentLib/Routing/FBHTTPServer.m +955 -0
  307. package/WebDriverAgentLib/Routing/FBHTTPStatusCodes.h +581 -0
  308. package/WebDriverAgentLib/Routing/FBResponseJSONPayload.h +29 -0
  309. package/WebDriverAgentLib/Routing/FBResponseJSONPayload.m +58 -0
  310. package/WebDriverAgentLib/Routing/FBResponsePayload.h +74 -0
  311. package/WebDriverAgentLib/Routing/FBResponsePayload.m +148 -0
  312. package/WebDriverAgentLib/Routing/FBRoute.h +86 -0
  313. package/WebDriverAgentLib/Routing/FBRoute.m +183 -0
  314. package/WebDriverAgentLib/Routing/FBRouteRequest-Private.h +20 -0
  315. package/WebDriverAgentLib/Routing/FBRouteRequest.h +39 -0
  316. package/WebDriverAgentLib/Routing/FBRouteRequest.m +32 -0
  317. package/WebDriverAgentLib/Routing/FBScreenRecordingContainer.h +65 -0
  318. package/WebDriverAgentLib/Routing/FBScreenRecordingContainer.m +88 -0
  319. package/WebDriverAgentLib/Routing/FBScreenRecordingPromise.h +29 -0
  320. package/WebDriverAgentLib/Routing/FBScreenRecordingPromise.m +31 -0
  321. package/WebDriverAgentLib/Routing/FBScreenRecordingRequest.h +39 -0
  322. package/WebDriverAgentLib/Routing/FBScreenRecordingRequest.m +99 -0
  323. package/WebDriverAgentLib/Routing/FBSession-Private.h +26 -0
  324. package/WebDriverAgentLib/Routing/FBSession.h +179 -0
  325. package/WebDriverAgentLib/Routing/FBSession.m +575 -0
  326. package/WebDriverAgentLib/Routing/FBTCPSocket.h +117 -0
  327. package/WebDriverAgentLib/Routing/FBTCPSocket.m +244 -0
  328. package/WebDriverAgentLib/Routing/FBWebServer.h +68 -0
  329. package/WebDriverAgentLib/Routing/FBWebServer.m +306 -0
  330. package/WebDriverAgentLib/Routing/FBXCAccessibilityElement.h +34 -0
  331. package/WebDriverAgentLib/Routing/FBXCAccessibilityElement.m +17 -0
  332. package/WebDriverAgentLib/Routing/FBXCDeviceEvent.h +34 -0
  333. package/WebDriverAgentLib/Routing/FBXCDeviceEvent.m +42 -0
  334. package/WebDriverAgentLib/Routing/FBXCElementSnapshot.h +82 -0
  335. package/WebDriverAgentLib/Routing/FBXCElementSnapshot.m +9 -0
  336. package/WebDriverAgentLib/Routing/FBXCElementSnapshotWrapper.h +29 -0
  337. package/WebDriverAgentLib/Routing/FBXCElementSnapshotWrapper.m +114 -0
  338. package/WebDriverAgentLib/Routing/RouteRequest.h +28 -0
  339. package/WebDriverAgentLib/Routing/RouteRequest.m +25 -0
  340. package/WebDriverAgentLib/Routing/RouteResponse.h +30 -0
  341. package/WebDriverAgentLib/Routing/RouteResponse.m +54 -0
  342. package/WebDriverAgentLib/Utilities/FBAccessibilityTraits.h +20 -0
  343. package/WebDriverAgentLib/Utilities/FBAccessibilityTraits.m +61 -0
  344. package/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.h +56 -0
  345. package/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.m +115 -0
  346. package/WebDriverAgentLib/Utilities/FBAlertsMonitor.h +51 -0
  347. package/WebDriverAgentLib/Utilities/FBAlertsMonitor.m +110 -0
  348. package/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.h +132 -0
  349. package/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.m +165 -0
  350. package/WebDriverAgentLib/Utilities/FBCapabilities.h +43 -0
  351. package/WebDriverAgentLib/Utilities/FBCapabilities.m +24 -0
  352. package/WebDriverAgentLib/Utilities/FBClassChainQueryParser.h +99 -0
  353. package/WebDriverAgentLib/Utilities/FBClassChainQueryParser.m +666 -0
  354. package/WebDriverAgentLib/Utilities/FBConfiguration.h +379 -0
  355. package/WebDriverAgentLib/Utilities/FBConfiguration.m +476 -0
  356. package/WebDriverAgentLib/Utilities/FBDebugLogDelegateDecorator.h +26 -0
  357. package/WebDriverAgentLib/Utilities/FBDebugLogDelegateDecorator.m +49 -0
  358. package/WebDriverAgentLib/Utilities/FBElementHelpers.h +29 -0
  359. package/WebDriverAgentLib/Utilities/FBElementHelpers.m +21 -0
  360. package/WebDriverAgentLib/Utilities/FBElementTypeTransformer.h +45 -0
  361. package/WebDriverAgentLib/Utilities/FBElementTypeTransformer.m +149 -0
  362. package/WebDriverAgentLib/Utilities/FBErrorBuilder.h +64 -0
  363. package/WebDriverAgentLib/Utilities/FBErrorBuilder.m +75 -0
  364. package/WebDriverAgentLib/Utilities/FBFailureProofTestCase.h +19 -0
  365. package/WebDriverAgentLib/Utilities/FBFailureProofTestCase.m +74 -0
  366. package/WebDriverAgentLib/Utilities/FBImageProcessor.h +55 -0
  367. package/WebDriverAgentLib/Utilities/FBImageProcessor.m +197 -0
  368. package/WebDriverAgentLib/Utilities/FBImageUtils.h +25 -0
  369. package/WebDriverAgentLib/Utilities/FBImageUtils.m +80 -0
  370. package/WebDriverAgentLib/Utilities/FBKeyboard.h +37 -0
  371. package/WebDriverAgentLib/Utilities/FBKeyboard.m +123 -0
  372. package/WebDriverAgentLib/Utilities/FBLogger.h +32 -0
  373. package/WebDriverAgentLib/Utilities/FBLogger.m +47 -0
  374. package/WebDriverAgentLib/Utilities/FBMacros.h +66 -0
  375. package/WebDriverAgentLib/Utilities/FBMathUtils.h +100 -0
  376. package/WebDriverAgentLib/Utilities/FBMathUtils.m +147 -0
  377. package/WebDriverAgentLib/Utilities/FBMjpegServer.h +36 -0
  378. package/WebDriverAgentLib/Utilities/FBMjpegServer.m +248 -0
  379. package/WebDriverAgentLib/Utilities/FBNotificationsHelper.h +37 -0
  380. package/WebDriverAgentLib/Utilities/FBNotificationsHelper.m +29 -0
  381. package/WebDriverAgentLib/Utilities/FBPasteboard.h +40 -0
  382. package/WebDriverAgentLib/Utilities/FBPasteboard.m +176 -0
  383. package/WebDriverAgentLib/Utilities/FBProtocolHelpers.h +46 -0
  384. package/WebDriverAgentLib/Utilities/FBProtocolHelpers.m +144 -0
  385. package/WebDriverAgentLib/Utilities/FBReflectionUtils.h +23 -0
  386. package/WebDriverAgentLib/Utilities/FBReflectionUtils.m +31 -0
  387. package/WebDriverAgentLib/Utilities/FBRunLoopSpinner.h +77 -0
  388. package/WebDriverAgentLib/Utilities/FBRunLoopSpinner.m +94 -0
  389. package/WebDriverAgentLib/Utilities/FBRuntimeUtils.h +79 -0
  390. package/WebDriverAgentLib/Utilities/FBRuntimeUtils.m +112 -0
  391. package/WebDriverAgentLib/Utilities/FBScreen.h +49 -0
  392. package/WebDriverAgentLib/Utilities/FBScreen.m +128 -0
  393. package/WebDriverAgentLib/Utilities/FBScreenshot.h +44 -0
  394. package/WebDriverAgentLib/Utilities/FBScreenshot.m +231 -0
  395. package/WebDriverAgentLib/Utilities/FBSettings.h +51 -0
  396. package/WebDriverAgentLib/Utilities/FBSettings.m +45 -0
  397. package/WebDriverAgentLib/Utilities/FBSettingsHandler.h +35 -0
  398. package/WebDriverAgentLib/Utilities/FBSettingsHandler.m +398 -0
  399. package/WebDriverAgentLib/Utilities/FBTVNavigationTracker-Private.h +37 -0
  400. package/WebDriverAgentLib/Utilities/FBTVNavigationTracker.h +77 -0
  401. package/WebDriverAgentLib/Utilities/FBTVNavigationTracker.m +177 -0
  402. package/WebDriverAgentLib/Utilities/FBUnattachedAppLauncher.h +26 -0
  403. package/WebDriverAgentLib/Utilities/FBUnattachedAppLauncher.m +21 -0
  404. package/WebDriverAgentLib/Utilities/FBW3CActionsHelpers.h +42 -0
  405. package/WebDriverAgentLib/Utilities/FBW3CActionsHelpers.m +119 -0
  406. package/WebDriverAgentLib/Utilities/FBW3CActionsSynthesizer.h +19 -0
  407. package/WebDriverAgentLib/Utilities/FBW3CActionsSynthesizer.m +1011 -0
  408. package/WebDriverAgentLib/Utilities/FBWebServerParams.h +22 -0
  409. package/WebDriverAgentLib/Utilities/FBWebServerParams.m +23 -0
  410. package/WebDriverAgentLib/Utilities/FBXCAXClientProxy.h +171 -0
  411. package/WebDriverAgentLib/Utilities/FBXCAXClientProxy.m +240 -0
  412. package/WebDriverAgentLib/Utilities/FBXCTestDaemonsProxy.h +45 -0
  413. package/WebDriverAgentLib/Utilities/FBXCTestDaemonsProxy.m +362 -0
  414. package/WebDriverAgentLib/Utilities/FBXCodeCompatibility.h +73 -0
  415. package/WebDriverAgentLib/Utilities/FBXCodeCompatibility.m +129 -0
  416. package/WebDriverAgentLib/Utilities/FBXMLGenerationOptions.h +45 -0
  417. package/WebDriverAgentLib/Utilities/FBXMLGenerationOptions.m +25 -0
  418. package/WebDriverAgentLib/Utilities/FBXPath-Private.h +61 -0
  419. package/WebDriverAgentLib/Utilities/FBXPath.h +59 -0
  420. package/WebDriverAgentLib/Utilities/FBXPath.m +1087 -0
  421. package/WebDriverAgentLib/Utilities/FBXPathExtensions.h +40 -0
  422. package/WebDriverAgentLib/Utilities/FBXPathExtensions.m +418 -0
  423. package/WebDriverAgentLib/Utilities/LRUCache/LRUCache.h +66 -0
  424. package/WebDriverAgentLib/Utilities/LRUCache/LRUCache.m +149 -0
  425. package/WebDriverAgentLib/Utilities/LRUCache/LRUCacheNode.h +43 -0
  426. package/WebDriverAgentLib/Utilities/LRUCache/LRUCacheNode.m +51 -0
  427. package/WebDriverAgentLib/Utilities/NSPredicate+FBFormat.h +42 -0
  428. package/WebDriverAgentLib/Utilities/NSPredicate+FBFormat.m +69 -0
  429. package/WebDriverAgentLib/Utilities/XCTestPrivateSymbols.h +78 -0
  430. package/WebDriverAgentLib/Utilities/XCTestPrivateSymbols.m +127 -0
  431. package/WebDriverAgentLib/Utilities/XCUIApplicationProcessDelay.h +37 -0
  432. package/WebDriverAgentLib/Utilities/XCUIApplicationProcessDelay.m +83 -0
  433. package/WebDriverAgentLib/WebDriverAgentLib.h +61 -0
  434. package/WebDriverAgentRunner/Assets.xcassets/AppIcon.appiconset/Contents.json +14 -0
  435. package/WebDriverAgentRunner/Assets.xcassets/AppIcon.appiconset/icon-1024.png +0 -0
  436. package/WebDriverAgentRunner/Assets.xcassets/Contents.json +6 -0
  437. package/WebDriverAgentRunner/Info.plist +30 -0
  438. package/WebDriverAgentRunner/UITestingUITests.m +58 -0
  439. package/WebDriverAgentTests/IntegrationApp/COORDINATE_PROBE.md +52 -0
  440. package/WebDriverAgentTests/IntegrationApp/Classes/AppDelegate.h +14 -0
  441. package/WebDriverAgentTests/IntegrationApp/Classes/AppDelegate.m +38 -0
  442. package/WebDriverAgentTests/IntegrationApp/Classes/FBAlertViewController.h +14 -0
  443. package/WebDriverAgentTests/IntegrationApp/Classes/FBAlertViewController.m +82 -0
  444. package/WebDriverAgentTests/IntegrationApp/Classes/FBCoordinateProbeViewController.h +4 -0
  445. package/WebDriverAgentTests/IntegrationApp/Classes/FBCoordinateProbeViewController.m +194 -0
  446. package/WebDriverAgentTests/IntegrationApp/Classes/FBNavigationController.h +12 -0
  447. package/WebDriverAgentTests/IntegrationApp/Classes/FBNavigationController.m +25 -0
  448. package/WebDriverAgentTests/IntegrationApp/Classes/FBScrollViewController.h +13 -0
  449. package/WebDriverAgentTests/IntegrationApp/Classes/FBScrollViewController.m +52 -0
  450. package/WebDriverAgentTests/IntegrationApp/Classes/FBTableDataSource.h +16 -0
  451. package/WebDriverAgentTests/IntegrationApp/Classes/FBTableDataSource.m +35 -0
  452. package/WebDriverAgentTests/IntegrationApp/Classes/SceneDelegate.h +20 -0
  453. package/WebDriverAgentTests/IntegrationApp/Classes/SceneDelegate.m +81 -0
  454. package/WebDriverAgentTests/IntegrationApp/Classes/TouchSpotView.h +17 -0
  455. package/WebDriverAgentTests/IntegrationApp/Classes/TouchSpotView.m +28 -0
  456. package/WebDriverAgentTests/IntegrationApp/Classes/TouchViewController.h +23 -0
  457. package/WebDriverAgentTests/IntegrationApp/Classes/TouchViewController.m +29 -0
  458. package/WebDriverAgentTests/IntegrationApp/Classes/TouchableView.h +30 -0
  459. package/WebDriverAgentTests/IntegrationApp/Classes/TouchableView.m +119 -0
  460. package/WebDriverAgentTests/IntegrationApp/Classes/ViewController.h +12 -0
  461. package/WebDriverAgentTests/IntegrationApp/Classes/ViewController.m +144 -0
  462. package/WebDriverAgentTests/IntegrationApp/Info.plist +71 -0
  463. package/WebDriverAgentTests/IntegrationApp/Resources/Base.lproj/Main.storyboard +650 -0
  464. package/WebDriverAgentTests/IntegrationApp/main.m +15 -0
  465. package/WebDriverAgentTests/IntegrationApp_tvOS/AppDelegate.h +13 -0
  466. package/WebDriverAgentTests/IntegrationApp_tvOS/AppDelegate.m +26 -0
  467. package/WebDriverAgentTests/IntegrationApp_tvOS/Info.plist +41 -0
  468. package/WebDriverAgentTests/IntegrationApp_tvOS/SceneDelegate.h +15 -0
  469. package/WebDriverAgentTests/IntegrationApp_tvOS/SceneDelegate.m +22 -0
  470. package/WebDriverAgentTests/IntegrationApp_tvOS/ViewController.h +13 -0
  471. package/WebDriverAgentTests/IntegrationApp_tvOS/ViewController.m +79 -0
  472. package/WebDriverAgentTests/IntegrationApp_tvOS/main.m +17 -0
  473. package/WebDriverAgentTests/IntegrationApp_watchOS/ContentView.swift +31 -0
  474. package/WebDriverAgentTests/IntegrationApp_watchOS/WatchSpikeApp.swift +18 -0
  475. package/WebDriverAgentTests/IntegrationTests/FBAlertTests.m +175 -0
  476. package/WebDriverAgentTests/IntegrationTests/FBAutoAlertsHandlerTests.m +79 -0
  477. package/WebDriverAgentTests/IntegrationTests/FBConfigurationTests.m +123 -0
  478. package/WebDriverAgentTests/IntegrationTests/FBDisplayGestureTests.m +541 -0
  479. package/WebDriverAgentTests/IntegrationTests/FBElementAttributeTests.m +273 -0
  480. package/WebDriverAgentTests/IntegrationTests/FBElementSwipingTests.m +222 -0
  481. package/WebDriverAgentTests/IntegrationTests/FBElementVisibilityTests.m +68 -0
  482. package/WebDriverAgentTests/IntegrationTests/FBFailureProofTestCaseTests.m +41 -0
  483. package/WebDriverAgentTests/IntegrationTests/FBForceTouchTests.m +88 -0
  484. package/WebDriverAgentTests/IntegrationTests/FBImageProcessorTests.m +116 -0
  485. package/WebDriverAgentTests/IntegrationTests/FBIntegrationAppTests.m +87 -0
  486. package/WebDriverAgentTests/IntegrationTests/FBIntegrationTestCase.h +101 -0
  487. package/WebDriverAgentTests/IntegrationTests/FBIntegrationTestCase.m +176 -0
  488. package/WebDriverAgentTests/IntegrationTests/FBKeyboardTests.m +61 -0
  489. package/WebDriverAgentTests/IntegrationTests/FBPasteboardTests.m +92 -0
  490. package/WebDriverAgentTests/IntegrationTests/FBPickerWheelSelectTests.m +55 -0
  491. package/WebDriverAgentTests/IntegrationTests/FBSafariAlertTests.m +77 -0
  492. package/WebDriverAgentTests/IntegrationTests/FBScreenTests.m +450 -0
  493. package/WebDriverAgentTests/IntegrationTests/FBScrollingTests.m +123 -0
  494. package/WebDriverAgentTests/IntegrationTests/FBSessionIntegrationTests.m +228 -0
  495. package/WebDriverAgentTests/IntegrationTests/FBTapTest.m +186 -0
  496. package/WebDriverAgentTests/IntegrationTests/FBTestMacros.h +33 -0
  497. package/WebDriverAgentTests/IntegrationTests/FBTypingTest.m +68 -0
  498. package/WebDriverAgentTests/IntegrationTests/FBVideoRecordingTests.m +63 -0
  499. package/WebDriverAgentTests/IntegrationTests/FBVoiceOverTests.m +103 -0
  500. package/WebDriverAgentTests/IntegrationTests/FBW3CMultiTouchActionsIntegrationTests.m +159 -0
  501. package/WebDriverAgentTests/IntegrationTests/FBW3CTouchActionsIntegrationTests.m +700 -0
  502. package/WebDriverAgentTests/IntegrationTests/FBW3CTypeActionsTests.m +184 -0
  503. package/WebDriverAgentTests/IntegrationTests/FBXPathIntegrationTests.m +260 -0
  504. package/WebDriverAgentTests/IntegrationTests/Info.plist +24 -0
  505. package/WebDriverAgentTests/IntegrationTests/XCElementSnapshotHelperTests.m +205 -0
  506. package/WebDriverAgentTests/IntegrationTests/XCElementSnapshotHitPointTests.m +30 -0
  507. package/WebDriverAgentTests/IntegrationTests/XCUIApplicationHelperTests.m +162 -0
  508. package/WebDriverAgentTests/IntegrationTests/XCUIDeviceHealthCheckTests.m +27 -0
  509. package/WebDriverAgentTests/IntegrationTests/XCUIDeviceHelperTests.m +236 -0
  510. package/WebDriverAgentTests/IntegrationTests/XCUIDeviceRotationTests.m +105 -0
  511. package/WebDriverAgentTests/IntegrationTests/XCUIElementAttributesTests.m +248 -0
  512. package/WebDriverAgentTests/IntegrationTests/XCUIElementFBFindTests.m +673 -0
  513. package/WebDriverAgentTests/IntegrationTests/XCUIElementHelperIntegrationTests.m +51 -0
  514. package/WebDriverAgentTests/IntegrationTests_tvOS/FBTVFocusIntegrationTests.m +84 -0
  515. package/WebDriverAgentTests/IntegrationTests_tvOS/Info.plist +24 -0
  516. package/WebDriverAgentTests/IntegrationTests_watchOS/IntegrationTests_watchOS-Bridging-Header.h +23 -0
  517. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAAlertIntegrationTests.swift +25 -0
  518. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAAppLifecycleIntegrationTests.swift +37 -0
  519. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAClickIntegrationTests.swift +25 -0
  520. package/WebDriverAgentTests/IntegrationTests_watchOS/WDADeviceIntegrationTests.swift +92 -0
  521. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAElementAttributeIntegrationTests.swift +39 -0
  522. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAFindIntegrationTests.swift +101 -0
  523. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAMjpegStreamingIntegrationTests.swift +81 -0
  524. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAScreenshotAndSourceIntegrationTests.swift +54 -0
  525. package/WebDriverAgentTests/IntegrationTests_watchOS/WDATypingIntegrationTests.swift +73 -0
  526. package/WebDriverAgentTests/IntegrationTests_watchOS/WDAWatchInProcessTestCase.swift +51 -0
  527. package/WebDriverAgentTests/UnitTests/Doubles/XCElementSnapshotDouble.h +16 -0
  528. package/WebDriverAgentTests/UnitTests/Doubles/XCElementSnapshotDouble.m +110 -0
  529. package/WebDriverAgentTests/UnitTests/Doubles/XCUIApplicationDouble.h +17 -0
  530. package/WebDriverAgentTests/UnitTests/Doubles/XCUIApplicationDouble.m +66 -0
  531. package/WebDriverAgentTests/UnitTests/Doubles/XCUIElementDouble.h +55 -0
  532. package/WebDriverAgentTests/UnitTests/Doubles/XCUIElementDouble.m +114 -0
  533. package/WebDriverAgentTests/UnitTests/FBClassChainTests.m +313 -0
  534. package/WebDriverAgentTests/UnitTests/FBConfigurationTests.m +72 -0
  535. package/WebDriverAgentTests/UnitTests/FBCustomCommandsTests.m +144 -0
  536. package/WebDriverAgentTests/UnitTests/FBElementCacheTests.m +124 -0
  537. package/WebDriverAgentTests/UnitTests/FBElementTypeTransformerTests.m +45 -0
  538. package/WebDriverAgentTests/UnitTests/FBElementUtilitiesTests.m +76 -0
  539. package/WebDriverAgentTests/UnitTests/FBErrorBuilderTests.m +61 -0
  540. package/WebDriverAgentTests/UnitTests/FBExceptionHandlerTests.m +59 -0
  541. package/WebDriverAgentTests/UnitTests/FBHTTPServerSessionTests.m +151 -0
  542. package/WebDriverAgentTests/UnitTests/FBHTTPServerTests.m +458 -0
  543. package/WebDriverAgentTests/UnitTests/FBLRUCacheTests.m +161 -0
  544. package/WebDriverAgentTests/UnitTests/FBMathUtilsTests.m +196 -0
  545. package/WebDriverAgentTests/UnitTests/FBProtocolHelpersTests.m +81 -0
  546. package/WebDriverAgentTests/UnitTests/FBResponseJSONPayloadTests.m +76 -0
  547. package/WebDriverAgentTests/UnitTests/FBRouteTests.m +129 -0
  548. package/WebDriverAgentTests/UnitTests/FBRunLoopSpinnerTests.m +98 -0
  549. package/WebDriverAgentTests/UnitTests/FBRuntimeUtilsTests.m +45 -0
  550. package/WebDriverAgentTests/UnitTests/FBSDKVersionTests.m +66 -0
  551. package/WebDriverAgentTests/UnitTests/FBSessionTests.m +268 -0
  552. package/WebDriverAgentTests/UnitTests/FBTouchableViewTests.m +121 -0
  553. package/WebDriverAgentTests/UnitTests/FBXCAXClientProxyTests.m +90 -0
  554. package/WebDriverAgentTests/UnitTests/FBXMLSafeStringTests.m +35 -0
  555. package/WebDriverAgentTests/UnitTests/FBXPathTests.m +381 -0
  556. package/WebDriverAgentTests/UnitTests/Info.plist +24 -0
  557. package/WebDriverAgentTests/UnitTests/NSDictionaryFBUtf8SafeTests.m +77 -0
  558. package/WebDriverAgentTests/UnitTests/NSExpressionFBFormatTests.m +60 -0
  559. package/WebDriverAgentTests/UnitTests/NSPredicateFBFormatTests.m +72 -0
  560. package/WebDriverAgentTests/UnitTests/XCUIElementHelpersTests.m +50 -0
  561. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCAccessibilityElementDouble.h +27 -0
  562. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCAccessibilityElementDouble.m +23 -0
  563. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCElementSnapshotDouble.h +43 -0
  564. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/FBXCElementSnapshotDouble.m +24 -0
  565. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/XCUIElementDouble.h +47 -0
  566. package/WebDriverAgentTests/UnitTests_tvOS/Doubles/XCUIElementDouble.m +81 -0
  567. package/WebDriverAgentTests/UnitTests_tvOS/FBTVNavigationTrackerTests.m +134 -0
  568. package/WebDriverAgentTests/UnitTests_tvOS/Info.plist +24 -0
  569. package/axeDevToolsXCUI.xcframework/Info.plist +50 -0
  570. package/axeDevToolsXCUI.xcframework/LICENSE-3RD-PARTY-axe-devtools-ios.md +29 -0
  571. package/axeDevToolsXCUI.xcframework/axe-devtools-ios-4.3.1.cdx.json +75 -0
  572. package/axeDevToolsXCUI.xcframework/axe-devtools-ios-4.3.1.spdx.json +67 -0
  573. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/HTMLReportTemplate.html +1912 -0
  574. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Headers/AxeTestBundleObserver.h +55 -0
  575. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI-Swift.h +1546 -0
  576. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI.h +17 -0
  577. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Info.plist +57 -0
  578. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/LICENSE.md +7 -0
  579. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.abi.json +34308 -0
  580. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.private.swiftinterface +927 -0
  581. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.swiftdoc +0 -0
  582. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios.swiftinterface +927 -0
  583. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/Modules/module.modulemap +10 -0
  584. package/axeDevToolsXCUI.xcframework/ios-arm64/axeDevToolsXCUI.framework/axeDevToolsXCUI +0 -0
  585. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/HTMLReportTemplate.html +1912 -0
  586. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Headers/AxeTestBundleObserver.h +55 -0
  587. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI-Swift.h +3088 -0
  588. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Headers/axeDevToolsXCUI.h +17 -0
  589. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Info.plist +53 -0
  590. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/LICENSE.md +7 -0
  591. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.abi.json +34308 -0
  592. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface +927 -0
  593. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.swiftdoc +0 -0
  594. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/arm64-apple-ios-simulator.swiftinterface +927 -0
  595. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.abi.json +34308 -0
  596. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface +927 -0
  597. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.swiftdoc +0 -0
  598. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/axeDevToolsXCUI.swiftmodule/x86_64-apple-ios-simulator.swiftinterface +927 -0
  599. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/Modules/module.modulemap +10 -0
  600. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/_CodeSignature/CodeResources +278 -0
  601. package/axeDevToolsXCUI.xcframework/ios-arm64_x86_64-simulator/axeDevToolsXCUI.framework/axeDevToolsXCUI +0 -0
  602. package/build/lib/check-dependencies.d.ts +6 -0
  603. package/build/lib/check-dependencies.d.ts.map +1 -0
  604. package/build/lib/check-dependencies.js +50 -0
  605. package/build/lib/check-dependencies.js.map +1 -0
  606. package/build/lib/constants.d.ts +25 -0
  607. package/build/lib/constants.d.ts.map +1 -0
  608. package/build/lib/constants.js +28 -0
  609. package/build/lib/constants.js.map +1 -0
  610. package/build/lib/index.d.ts +7 -0
  611. package/build/lib/index.d.ts.map +1 -0
  612. package/build/lib/index.js +7 -0
  613. package/build/lib/index.js.map +1 -0
  614. package/build/lib/logger.d.ts +2 -0
  615. package/build/lib/logger.d.ts.map +1 -0
  616. package/build/lib/logger.js +3 -0
  617. package/build/lib/logger.js.map +1 -0
  618. package/build/lib/no-session-proxy.d.ts +7 -0
  619. package/build/lib/no-session-proxy.d.ts.map +1 -0
  620. package/build/lib/no-session-proxy.js +17 -0
  621. package/build/lib/no-session-proxy.js.map +1 -0
  622. package/build/lib/types.d.ts +206 -0
  623. package/build/lib/types.d.ts.map +1 -0
  624. package/build/lib/types.js +2 -0
  625. package/build/lib/types.js.map +1 -0
  626. package/build/lib/utils/index.d.ts +11 -0
  627. package/build/lib/utils/index.d.ts.map +1 -0
  628. package/build/lib/utils/index.js +13 -0
  629. package/build/lib/utils/index.js.map +1 -0
  630. package/build/lib/utils/module.d.ts +25 -0
  631. package/build/lib/utils/module.d.ts.map +1 -0
  632. package/build/lib/utils/module.js +47 -0
  633. package/build/lib/utils/module.js.map +1 -0
  634. package/build/lib/utils/platform.d.ts +19 -0
  635. package/build/lib/utils/platform.d.ts.map +1 -0
  636. package/build/lib/utils/platform.js +32 -0
  637. package/build/lib/utils/platform.js.map +1 -0
  638. package/build/lib/utils/processes.d.ts +34 -0
  639. package/build/lib/utils/processes.d.ts.map +1 -0
  640. package/build/lib/utils/processes.js +151 -0
  641. package/build/lib/utils/processes.js.map +1 -0
  642. package/build/lib/utils/security.d.ts +5 -0
  643. package/build/lib/utils/security.d.ts.map +1 -0
  644. package/build/lib/utils/security.js +12 -0
  645. package/build/lib/utils/security.js.map +1 -0
  646. package/build/lib/utils/xctestrun.d.ts +51 -0
  647. package/build/lib/utils/xctestrun.d.ts.map +1 -0
  648. package/build/lib/utils/xctestrun.js +135 -0
  649. package/build/lib/utils/xctestrun.js.map +1 -0
  650. package/build/lib/wda-strategies.d.ts +69 -0
  651. package/build/lib/wda-strategies.d.ts.map +1 -0
  652. package/build/lib/wda-strategies.js +247 -0
  653. package/build/lib/wda-strategies.js.map +1 -0
  654. package/build/lib/webdriveragent.d.ts +175 -0
  655. package/build/lib/webdriveragent.d.ts.map +1 -0
  656. package/build/lib/webdriveragent.js +540 -0
  657. package/build/lib/webdriveragent.js.map +1 -0
  658. package/build/lib/xcodebuild.d.ts +98 -0
  659. package/build/lib/xcodebuild.d.ts.map +1 -0
  660. package/build/lib/xcodebuild.js +562 -0
  661. package/build/lib/xcodebuild.js.map +1 -0
  662. package/build/tsconfig.tsbuildinfo +1 -0
  663. package/lib/check-dependencies.ts +64 -0
  664. package/lib/constants.ts +33 -0
  665. package/lib/index.ts +7 -0
  666. package/lib/logger.ts +3 -0
  667. package/lib/no-session-proxy.ts +19 -0
  668. package/lib/types.ts +238 -0
  669. package/lib/utils/index.ts +20 -0
  670. package/lib/utils/module.ts +66 -0
  671. package/lib/utils/platform.ts +34 -0
  672. package/lib/utils/processes.ts +174 -0
  673. package/lib/utils/security.ts +16 -0
  674. package/lib/utils/xctestrun.ts +188 -0
  675. package/lib/wda-strategies.ts +343 -0
  676. package/lib/webdriveragent.ts +642 -0
  677. package/lib/xcodebuild.ts +678 -0
  678. package/package.json +114 -3
@@ -0,0 +1,188 @@
1
+ import {arch} from 'node:os';
2
+ import path from 'node:path';
3
+
4
+ import {fs, plist, util} from '@appium/support';
5
+
6
+ import {log} from '../logger.js';
7
+ import type {DeviceInfo} from '../types.js';
8
+ import {isTvOS, isWatchOS} from './platform.js';
9
+
10
+ /**
11
+ * Arguments for setting xctestrun file
12
+ */
13
+ export interface XctestrunFileArgs {
14
+ deviceInfo: DeviceInfo;
15
+ sdkVersion: string;
16
+ bootstrapPath: string;
17
+ wdaRemotePort: number | string;
18
+ wdaBindingIP?: string;
19
+ maxHttpRequestBodySize?: number | string;
20
+ }
21
+
22
+ /**
23
+ * Creates xctestrun file per device & platform version.
24
+ * We expect to have WebDriverAgentRunner_iphoneos${sdkVersion|platformVersion}-arm64.xctestrun for real device
25
+ * and WebDriverAgentRunner_iphonesimulator${sdkVersion|platformVersion}-${x86_64|arm64}.xctestrun for simulator located @bootstrapPath
26
+ * Newer Xcode (Xcode 10.0 at least) generates xctestrun file following sdkVersion.
27
+ * e.g. Xcode which has iOS SDK Version 12.2 on an intel Mac host machine generates WebDriverAgentRunner_iphonesimulator.2-x86_64.xctestrun
28
+ * even if the cap has platform version 11.4
29
+ *
30
+ * @param args
31
+ * @return returns xctestrunFilePath for given device
32
+ * @throws if WebDriverAgentRunner_iphoneos${sdkVersion|platformVersion}-arm64.xctestrun for real device
33
+ * or WebDriverAgentRunner_iphonesimulator${sdkVersion|platformVersion}-x86_64.xctestrun for simulator is not found @bootstrapPath,
34
+ * then it will throw a file not found exception
35
+ */
36
+ export async function setXctestrunFile(args: XctestrunFileArgs): Promise<string> {
37
+ const {
38
+ deviceInfo,
39
+ sdkVersion,
40
+ bootstrapPath,
41
+ wdaRemotePort,
42
+ wdaBindingIP,
43
+ maxHttpRequestBodySize,
44
+ } = args;
45
+ const xctestrunFilePath = await getXctestrunFilePath(deviceInfo, sdkVersion, bootstrapPath);
46
+ const xctestRunContent = await plist.parsePlistFile(xctestrunFilePath);
47
+ const updateWDAPort = getAdditionalRunContent(
48
+ deviceInfo.platformName,
49
+ wdaRemotePort,
50
+ wdaBindingIP,
51
+ maxHttpRequestBodySize,
52
+ );
53
+ const newXctestRunContent = mergeObjects(xctestRunContent, updateWDAPort);
54
+ await plist.updatePlistFile(xctestrunFilePath, newXctestRunContent, true);
55
+
56
+ return xctestrunFilePath;
57
+ }
58
+
59
+ /**
60
+ * Return the WDA object which appends existing xctest runner content
61
+ * @param platformName - The name of the platform
62
+ * @param wdaRemotePort - The remote port number
63
+ * @param wdaBindingIP - The IP address to bind to. If not given, it binds to all interfaces.
64
+ * @param maxHttpRequestBodySize - The maximum HTTP request body size in bytes.
65
+ * @return returns a runner object which has USE_PORT and optionally USE_IP
66
+ */
67
+ export function getAdditionalRunContent(
68
+ platformName: string,
69
+ wdaRemotePort: number | string,
70
+ wdaBindingIP?: string,
71
+ maxHttpRequestBodySize?: number | string,
72
+ ): Record<string, any> {
73
+ const runner = `WebDriverAgentRunner${getRunnerSchemeSuffix(platformName)}`;
74
+ return {
75
+ [runner]: {
76
+ EnvironmentVariables: {
77
+ // USE_PORT must be 'string'
78
+ USE_PORT: `${wdaRemotePort}`,
79
+ ...(wdaBindingIP ? {USE_IP: wdaBindingIP} : {}),
80
+ ...(maxHttpRequestBodySize
81
+ ? {MAX_HTTP_REQUEST_BODY_SIZE: `${maxHttpRequestBodySize}`}
82
+ : {}),
83
+ },
84
+ },
85
+ };
86
+ }
87
+
88
+ /**
89
+ * Return the path of xctestrun if it exists
90
+ * @param deviceInfo
91
+ * @param sdkVersion - The Xcode SDK version of OS.
92
+ * @param bootstrapPath - The folder path containing xctestrun file.
93
+ */
94
+ export async function getXctestrunFilePath(
95
+ deviceInfo: DeviceInfo,
96
+ sdkVersion: string,
97
+ bootstrapPath: string,
98
+ ): Promise<string> {
99
+ // First try the SDK path, for Xcode 10 (at least)
100
+ const sdkBased: [string, string] = [
101
+ path.resolve(bootstrapPath, `${deviceInfo.udid}_${sdkVersion}.xctestrun`),
102
+ sdkVersion,
103
+ ];
104
+ // Next try Platform path, for earlier Xcode versions
105
+ const platformBased: [string, string] = [
106
+ path.resolve(bootstrapPath, `${deviceInfo.udid}_${deviceInfo.platformVersion}.xctestrun`),
107
+ deviceInfo.platformVersion,
108
+ ];
109
+
110
+ for (const [filePath, version] of [sdkBased, platformBased]) {
111
+ if (await fs.exists(filePath)) {
112
+ log.info(`Using '${filePath}' as xctestrun file`);
113
+ return filePath;
114
+ }
115
+ const originalXctestrunFile = path.resolve(
116
+ bootstrapPath,
117
+ getXctestrunFileName(deviceInfo, version),
118
+ );
119
+ if (await fs.exists(originalXctestrunFile)) {
120
+ // If this is first time run for given device, then first generate xctestrun file for device.
121
+ // We need to have a xctestrun file **per device** because we cannot have same wda port for all devices.
122
+ await fs.copyFile(originalXctestrunFile, filePath);
123
+ log.info(`Using '${filePath}' as xctestrun file copied by '${originalXctestrunFile}'`);
124
+ return filePath;
125
+ }
126
+ }
127
+
128
+ throw new Error(
129
+ `If you are using 'useXctestrunFile' capability then you ` +
130
+ `need to have a xctestrun file (expected: ` +
131
+ `'${path.resolve(bootstrapPath, getXctestrunFileName(deviceInfo, sdkVersion))}')`,
132
+ );
133
+ }
134
+
135
+ /**
136
+ * Return the name of xctestrun file
137
+ * @param deviceInfo
138
+ * @param version - The Xcode SDK version of OS.
139
+ * @return returns xctestrunFilePath for given device
140
+ */
141
+ export function getXctestrunFileName(deviceInfo: DeviceInfo, version: string): string {
142
+ const archSuffix = deviceInfo.isRealDevice
143
+ ? `os${version}-arm64`
144
+ : `simulator${version}-${arch() === 'arm64' ? 'arm64' : 'x86_64'}`;
145
+ return `WebDriverAgentRunner_${getXctestrunSdkPrefix(deviceInfo.platformName)}${archSuffix}.xctestrun`;
146
+ }
147
+
148
+ /**
149
+ * @returns The `WebDriverAgentRunner` scheme name suffix for the given platform.
150
+ */
151
+ function getRunnerSchemeSuffix(platformName: string): string {
152
+ if (isTvOS(platformName)) {
153
+ return '_tvOS';
154
+ }
155
+ if (isWatchOS(platformName)) {
156
+ return '_watchOS';
157
+ }
158
+ return '';
159
+ }
160
+
161
+ /**
162
+ * @returns The scheme-and-SDK prefix used in auto-generated xctestrun file names for the given platform.
163
+ */
164
+ function getXctestrunSdkPrefix(platformName: string): string {
165
+ if (isTvOS(platformName)) {
166
+ return 'tvOS_appletv';
167
+ }
168
+ if (isWatchOS(platformName)) {
169
+ return 'watchOS_watch';
170
+ }
171
+ return 'iphone';
172
+ }
173
+
174
+ function mergeObjects<T extends Record<string, any>, U extends Record<string, any>>(
175
+ target: T,
176
+ source: U,
177
+ ): T & U {
178
+ const output: Record<string, any> = {...target};
179
+ for (const [key, sourceValue] of Object.entries(source)) {
180
+ const targetValue = output[key];
181
+ if (util.isPlainObject(targetValue) && util.isPlainObject(sourceValue)) {
182
+ output[key] = mergeObjects(targetValue, sourceValue);
183
+ continue;
184
+ }
185
+ output[key] = sourceValue;
186
+ }
187
+ return output as T & U;
188
+ }
@@ -0,0 +1,343 @@
1
+ import {fs} from '@appium/support';
2
+ import type {AppiumLogger, StringRecord} from '@appium/types';
3
+ import {exec} from 'teen_process';
4
+
5
+ import {PACKAGE_VERSION} from './utils/module.js';
6
+ import type {NoSessionProxy} from './no-session-proxy.js';
7
+ import type {
8
+ AppleDevice,
9
+ RealDevicePreinstalledHostOps,
10
+ RealDeviceXcodebuildHostOps,
11
+ SimulatorHostOps,
12
+ WdaHostOps,
13
+ WdaLaunchEnvironment,
14
+ WdaStartupStrategyName,
15
+ } from './types.js';
16
+ import {getPIDsListeningOnPort, resetTestProcesses} from './utils/index.js';
17
+ import type {XcodeBuild} from './xcodebuild.js';
18
+
19
+ const WDA_AGENT_PORT = 8100;
20
+ const HOST_OPS_REQUIRED_MESSAGE =
21
+ 'Host operations must be provided to launch or terminate preinstalled WebDriverAgent';
22
+
23
+ export interface WdaStartupStrategy {
24
+ readonly name: WdaStartupStrategyName;
25
+ launch(sessionId: string): Promise<StringRecord | null>;
26
+ quit(): Promise<void>;
27
+ }
28
+
29
+ export interface WdaStartupStrategyContext {
30
+ readonly argsWebDriverAgentUrl?: string;
31
+ readonly webDriverAgentUrl?: string;
32
+ readonly usePreinstalledWDA?: boolean;
33
+ readonly useXctestrunFile?: boolean;
34
+ readonly usePrebuiltWDA?: boolean;
35
+ readonly prebuildWDA?: boolean;
36
+ readonly isRealDevice: boolean;
37
+ readonly device: AppleDevice;
38
+ readonly agentPath: string;
39
+ readonly bootstrapPath: string;
40
+ readonly bundleIdForXctest: string;
41
+ readonly wdaLocalPort?: number;
42
+ readonly wdaRemotePort: number;
43
+ readonly wdaBindingIP?: string;
44
+ readonly wdaLaunchTimeout: number;
45
+ readonly mjpegServerPort?: number;
46
+ readonly maxHttpRequestBodySize?: number;
47
+ readonly platformName?: string;
48
+ readonly platformVersion?: string;
49
+ readonly log: AppiumLogger;
50
+ readonly hostOps: Required<WdaHostOps>;
51
+ setWebDriverAgentUrl(value?: string): void;
52
+ setUrl(value: string): void;
53
+ setupProxies(sessionId: string): void;
54
+ getStatus(timeoutMs?: number): Promise<StringRecord | null>;
55
+ cleanupProjectIfFresh(): Promise<void>;
56
+ xcodebuild(): XcodeBuild;
57
+ noSessionProxy(): NoSessionProxy;
58
+ setStarted(started: boolean): void;
59
+ }
60
+
61
+ class ExistingWdaUrlStrategy implements WdaStartupStrategy {
62
+ readonly name = 'existing-url' as const;
63
+
64
+ constructor(private readonly ctx: WdaStartupStrategyContext) {}
65
+
66
+ async launch(sessionId: string): Promise<StringRecord | null> {
67
+ this.ctx.log.info(`Using provided WebdriverAgent at '${this.ctx.webDriverAgentUrl}'`);
68
+ this.ctx.setUrl(this.ctx.webDriverAgentUrl as string);
69
+ this.ctx.setupProxies(sessionId);
70
+ return await this.ctx.getStatus();
71
+ }
72
+
73
+ async quit(): Promise<void> {
74
+ this.ctx.log.debug(
75
+ 'Stopping neither xcodebuild nor XCTest session since WDA lifecycle is not managed by this driver',
76
+ );
77
+ }
78
+ }
79
+
80
+ class SimulatorWdaStrategy implements WdaStartupStrategy {
81
+ readonly name = 'simulator' as const;
82
+
83
+ constructor(private readonly ctx: WdaStartupStrategyContext) {}
84
+
85
+ async launch(sessionId: string): Promise<StringRecord | null> {
86
+ if (this.ctx.usePreinstalledWDA) {
87
+ return await launchPreinstalled(this.ctx, this.ctx.hostOps.simulator, sessionId);
88
+ }
89
+ return await launchWithXcodebuild(this.ctx, sessionId);
90
+ }
91
+
92
+ async quit(): Promise<void> {
93
+ if (this.ctx.usePreinstalledWDA) {
94
+ await terminatePreinstalled(this.ctx, this.ctx.hostOps.simulator);
95
+ return;
96
+ }
97
+ await quitXcodebuild(this.ctx);
98
+ }
99
+ }
100
+
101
+ class RealDeviceXcodebuildStrategy implements WdaStartupStrategy {
102
+ readonly name = 'real-device-xcodebuild' as const;
103
+
104
+ constructor(private readonly ctx: WdaStartupStrategyContext) {}
105
+
106
+ async launch(sessionId: string): Promise<StringRecord | null> {
107
+ return await launchWithXcodebuild(this.ctx, sessionId);
108
+ }
109
+
110
+ async quit(): Promise<void> {
111
+ await quitXcodebuild(this.ctx);
112
+ }
113
+ }
114
+
115
+ class RealDevicePreinstalledStrategy implements WdaStartupStrategy {
116
+ readonly name = 'real-device-preinstalled' as const;
117
+
118
+ constructor(private readonly ctx: WdaStartupStrategyContext) {}
119
+
120
+ async launch(sessionId: string): Promise<StringRecord | null> {
121
+ return await launchPreinstalled(this.ctx, this.ctx.hostOps.realDevicePreinstalled, sessionId);
122
+ }
123
+
124
+ async quit(): Promise<void> {
125
+ await terminatePreinstalled(this.ctx, this.ctx.hostOps.realDevicePreinstalled);
126
+ }
127
+ }
128
+
129
+ /**
130
+ * Selects the WDA startup strategy for the provided launch arguments.
131
+ */
132
+ export function selectWdaStartupStrategyName(args: {
133
+ realDevice?: boolean;
134
+ webDriverAgentUrl?: string;
135
+ usePreinstalledWDA?: boolean;
136
+ }): WdaStartupStrategyName {
137
+ if (args.webDriverAgentUrl) {
138
+ return 'existing-url';
139
+ }
140
+ if (!args.realDevice) {
141
+ return 'simulator';
142
+ }
143
+ if (args.usePreinstalledWDA) {
144
+ return 'real-device-preinstalled';
145
+ }
146
+ return 'real-device-xcodebuild';
147
+ }
148
+
149
+ /**
150
+ * Creates a WDA startup strategy for the current facade state.
151
+ */
152
+ export function createWdaStartupStrategy(ctx: WdaStartupStrategyContext): WdaStartupStrategy {
153
+ const startupStrategy = selectWdaStartupStrategyName({
154
+ realDevice: ctx.isRealDevice,
155
+ webDriverAgentUrl: ctx.webDriverAgentUrl,
156
+ usePreinstalledWDA: ctx.usePreinstalledWDA,
157
+ });
158
+ switch (startupStrategy) {
159
+ case 'existing-url':
160
+ return new ExistingWdaUrlStrategy(ctx);
161
+ case 'simulator':
162
+ return new SimulatorWdaStrategy(ctx);
163
+ case 'real-device-preinstalled':
164
+ return new RealDevicePreinstalledStrategy(ctx);
165
+ case 'real-device-xcodebuild':
166
+ return new RealDeviceXcodebuildStrategy(ctx);
167
+ default:
168
+ throw new Error(`Unknown WDA startup strategy: ${startupStrategy}`);
169
+ }
170
+ }
171
+
172
+ /**
173
+ * Creates default host operations for flows the package can own directly.
174
+ */
175
+ export function createDefaultWdaHostOps(): Required<WdaHostOps> {
176
+ return {
177
+ simulator: createDefaultSimulatorWdaHostOps(),
178
+ realDevicePreinstalled: createDefaultRealDevicePreinstalledHostOps(),
179
+ realDeviceXcodebuild: createDefaultRealDeviceXcodebuildHostOps(),
180
+ };
181
+ }
182
+
183
+ /**
184
+ * Creates default simulator host operations.
185
+ */
186
+ export function createDefaultSimulatorWdaHostOps(): SimulatorHostOps {
187
+ return {
188
+ async launchPreinstalled() {
189
+ throw new Error(HOST_OPS_REQUIRED_MESSAGE);
190
+ },
191
+ async terminate() {
192
+ throw new Error(HOST_OPS_REQUIRED_MESSAGE);
193
+ },
194
+ async resetTestProcesses({udid, isSimulator}) {
195
+ await resetTestProcesses(udid, isSimulator);
196
+ },
197
+ };
198
+ }
199
+
200
+ /**
201
+ * Creates default real-device preinstalled host operations.
202
+ */
203
+ export function createDefaultRealDevicePreinstalledHostOps(): RealDevicePreinstalledHostOps {
204
+ return {
205
+ async launchPreinstalled() {
206
+ throw new Error(HOST_OPS_REQUIRED_MESSAGE);
207
+ },
208
+ async terminate() {
209
+ throw new Error(HOST_OPS_REQUIRED_MESSAGE);
210
+ },
211
+ };
212
+ }
213
+
214
+ /**
215
+ * Creates default real-device xcodebuild host operations.
216
+ */
217
+ export function createDefaultRealDeviceXcodebuildHostOps(): RealDeviceXcodebuildHostOps {
218
+ return {
219
+ async resetTestProcesses({udid, isSimulator}) {
220
+ await resetTestProcesses(udid, isSimulator);
221
+ },
222
+ async cleanupObsoleteProcesses({udid, port, commandLineIncludes}) {
223
+ const obsoletePids = await getPIDsListeningOnPort(
224
+ port,
225
+ (cmdLine) =>
226
+ cmdLine.includes(commandLineIncludes) &&
227
+ !cmdLine.toLowerCase().includes(udid.toLowerCase()),
228
+ );
229
+
230
+ if (obsoletePids.length > 0) {
231
+ await exec('kill', obsoletePids);
232
+ }
233
+ },
234
+ };
235
+ }
236
+
237
+ async function launchWithXcodebuild(
238
+ ctx: WdaStartupStrategyContext,
239
+ sessionId: string,
240
+ ): Promise<StringRecord | null> {
241
+ ctx.log.info('Launching WebDriverAgent on the device');
242
+
243
+ ctx.setupProxies(sessionId);
244
+
245
+ if (!ctx.useXctestrunFile && !(await fs.exists(ctx.agentPath))) {
246
+ throw new Error(
247
+ `Trying to use WebDriverAgent project at '${ctx.agentPath}' but the file does not exist`,
248
+ );
249
+ }
250
+
251
+ if (ctx.useXctestrunFile || ctx.usePrebuiltWDA) {
252
+ ctx.log.info('Skipped WDA project cleanup according to the provided capabilities');
253
+ } else {
254
+ await ctx.cleanupProjectIfFresh();
255
+ }
256
+
257
+ const resetTestProcesses = ctx.isRealDevice
258
+ ? ctx.hostOps.realDeviceXcodebuild.resetTestProcesses
259
+ : ctx.hostOps.simulator.resetTestProcesses;
260
+ await resetTestProcesses?.({
261
+ udid: ctx.device.udid,
262
+ isSimulator: !ctx.isRealDevice,
263
+ });
264
+
265
+ const xcodebuild = ctx.xcodebuild();
266
+ await xcodebuild.init(ctx.noSessionProxy());
267
+
268
+ if (ctx.prebuildWDA) {
269
+ await xcodebuild.prebuild();
270
+ }
271
+ return (await xcodebuild.start()) as StringRecord | null;
272
+ }
273
+
274
+ async function launchPreinstalled(
275
+ ctx: WdaStartupStrategyContext,
276
+ hostOps: SimulatorHostOps | RealDevicePreinstalledHostOps,
277
+ sessionId: string,
278
+ ): Promise<StringRecord | null> {
279
+ const xctestEnv = createPreinstalledWdaEnvironment(ctx);
280
+ ctx.log.info('Launching WebDriverAgent on the device without xcodebuild');
281
+ await hostOps.launchPreinstalled({
282
+ udid: ctx.device.udid,
283
+ bundleId: ctx.bundleIdForXctest,
284
+ env: xctestEnv,
285
+ wdaLocalPort: ctx.wdaLocalPort,
286
+ wdaRemotePort: ctx.wdaRemotePort,
287
+ platformName: ctx.platformName,
288
+ platformVersion: ctx.platformVersion,
289
+ timeoutMs: ctx.wdaLaunchTimeout,
290
+ });
291
+
292
+ ctx.setupProxies(sessionId);
293
+ let status: StringRecord | null;
294
+ try {
295
+ status = await ctx.getStatus(ctx.wdaLaunchTimeout);
296
+ } catch {
297
+ throw new Error(
298
+ `Failed to start the preinstalled WebDriverAgent in ${ctx.wdaLaunchTimeout} ms. ` +
299
+ `The WebDriverAgent might not be properly built or the device might be locked. ` +
300
+ `The 'appium:wdaLaunchTimeout' capability modifies the timeout.`,
301
+ );
302
+ }
303
+ ctx.setStarted(true);
304
+ return status;
305
+ }
306
+
307
+ async function terminatePreinstalled(
308
+ ctx: WdaStartupStrategyContext,
309
+ hostOps: SimulatorHostOps | RealDevicePreinstalledHostOps,
310
+ ): Promise<void> {
311
+ ctx.log.info('Stopping the XCTest session');
312
+ try {
313
+ await hostOps.terminate({
314
+ udid: ctx.device.udid,
315
+ bundleId: ctx.bundleIdForXctest,
316
+ });
317
+ } catch (e: any) {
318
+ ctx.log.warn(e.message);
319
+ }
320
+ }
321
+
322
+ async function quitXcodebuild(ctx: WdaStartupStrategyContext): Promise<void> {
323
+ ctx.log.info('Shutting down sub-processes');
324
+ await ctx.xcodebuild().quit();
325
+ }
326
+
327
+ function createPreinstalledWdaEnvironment(ctx: WdaStartupStrategyContext): WdaLaunchEnvironment {
328
+ const xctestEnv: WdaLaunchEnvironment = {
329
+ USE_PORT: ctx.wdaRemotePort || WDA_AGENT_PORT,
330
+ WDA_PRODUCT_BUNDLE_IDENTIFIER: ctx.bundleIdForXctest,
331
+ WDA_PACKAGE_VERSION: PACKAGE_VERSION,
332
+ };
333
+ if (ctx.mjpegServerPort) {
334
+ xctestEnv.MJPEG_SERVER_PORT = ctx.mjpegServerPort;
335
+ }
336
+ if (ctx.wdaBindingIP) {
337
+ xctestEnv.USE_IP = ctx.wdaBindingIP;
338
+ }
339
+ if (ctx.maxHttpRequestBodySize) {
340
+ xctestEnv.MAX_HTTP_REQUEST_BODY_SIZE = ctx.maxHttpRequestBodySize;
341
+ }
342
+ return xctestEnv;
343
+ }