selenium-webdriver 2.48.2 → 2.53.3

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 (534) hide show
  1. package/CHANGES.md +116 -0
  2. package/NOTICE +1 -1
  3. package/README.md +59 -9
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +9 -6
  8. package/example/google_search.js +1 -1
  9. package/example/google_search_generator.js +2 -4
  10. package/example/logging.js +6 -2
  11. package/example/sample.js +21 -0
  12. package/executors.js +11 -27
  13. package/firefox/binary.js +149 -98
  14. package/firefox/extension.js +15 -19
  15. package/firefox/index.js +256 -163
  16. package/firefox/profile.js +223 -243
  17. package/http/index.js +487 -81
  18. package/http/util.js +40 -36
  19. package/ie.js +288 -309
  20. package/index.js +34 -125
  21. package/io/exec.js +58 -39
  22. package/io/index.js +72 -60
  23. package/lib/README +4 -0
  24. package/lib/actions.js +596 -0
  25. package/lib/by.js +277 -0
  26. package/lib/capabilities.js +450 -0
  27. package/lib/{webdriver/command.js → command.js} +91 -72
  28. package/lib/{webdriver/button.js → devmode.js} +13 -8
  29. package/lib/error.js +690 -0
  30. package/lib/events.js +212 -0
  31. package/lib/firefox/amd64/libnoblur64.so +0 -0
  32. package/lib/firefox/i386/libnoblur.so +0 -0
  33. package/lib/firefox/webdriver.json +5 -1
  34. package/lib/firefox/webdriver.xpi +0 -0
  35. package/lib/{webdriver/key.js → input.js} +84 -2
  36. package/lib/logging.js +670 -0
  37. package/lib/{webdriver/promise.js → promise.js} +817 -644
  38. package/lib/safari/client.js +266 -214
  39. package/lib/session.js +80 -0
  40. package/lib/{webdriver/serializable.js → symbols.js} +16 -19
  41. package/lib/test/build.js +4 -4
  42. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  43. package/lib/test/data/click_tests/overlapping_elements.html +15 -4
  44. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  45. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  46. package/lib/test/data/hidden_partially.html +45 -0
  47. package/lib/test/data/readOnlyPage.html +1 -1
  48. package/lib/test/data/selectPage.html +18 -2
  49. package/lib/test/fileserver.js +3 -4
  50. package/lib/test/index.js +7 -3
  51. package/lib/test/resources.js +1 -1
  52. package/lib/until.js +376 -0
  53. package/lib/webdriver.js +2440 -0
  54. package/net/index.js +4 -0
  55. package/net/portprober.js +16 -12
  56. package/opera.js +295 -314
  57. package/package.json +6 -5
  58. package/phantomjs.js +144 -147
  59. package/proxy.js +10 -6
  60. package/remote/index.js +289 -238
  61. package/safari.js +326 -311
  62. package/test/chrome/options_test.js +11 -9
  63. package/test/element_finding_test.js +51 -13
  64. package/test/execute_script_test.js +17 -3
  65. package/test/firefox/firefox_test.js +0 -32
  66. package/test/http/http_test.js +671 -61
  67. package/test/http/util_test.js +25 -23
  68. package/test/io_test.js +67 -1
  69. package/test/lib/by_test.js +139 -0
  70. package/test/lib/capabilities_test.js +111 -0
  71. package/test/lib/error_test.js +325 -0
  72. package/test/lib/events_test.js +177 -0
  73. package/test/lib/logging_test.js +272 -0
  74. package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
  75. package/test/lib/promise_error_test.js +808 -0
  76. package/test/lib/promise_flow_test.js +2282 -0
  77. package/test/lib/promise_generator_test.js +308 -0
  78. package/test/lib/promise_test.js +996 -0
  79. package/test/lib/testutil.js +90 -0
  80. package/test/lib/until_test.js +400 -0
  81. package/test/lib/webdriver_test.js +2157 -0
  82. package/test/page_loading_test.js +7 -9
  83. package/test/remote_test.js +50 -3
  84. package/test/session_test.js +53 -0
  85. package/test/stale_element_test.js +2 -2
  86. package/test/testing/assert_test.js +374 -0
  87. package/test/testing/index_test.js +9 -11
  88. package/testing/assert.js +334 -17
  89. package/testing/index.js +12 -2
  90. package/_base.js +0 -200
  91. package/docs/Changes.html +0 -356
  92. package/docs/class_bot_Error.html +0 -15
  93. package/docs/class_webdriver_ActionSequence.html +0 -115
  94. package/docs/class_webdriver_Alert.html +0 -24
  95. package/docs/class_webdriver_AlertPromise.html +0 -92
  96. package/docs/class_webdriver_Capabilities.html +0 -60
  97. package/docs/class_webdriver_Command.html +0 -15
  98. package/docs/class_webdriver_EventEmitter.html +0 -35
  99. package/docs/class_webdriver_FileDetector.html +0 -21
  100. package/docs/class_webdriver_Locator.html +0 -12
  101. package/docs/class_webdriver_Serializable.html +0 -9
  102. package/docs/class_webdriver_Session.html +0 -13
  103. package/docs/class_webdriver_TouchSequence.html +0 -49
  104. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  105. package/docs/class_webdriver_WebDriver.html +0 -313
  106. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  107. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  108. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  109. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  110. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  111. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  112. package/docs/class_webdriver_WebElement.html +0 -223
  113. package/docs/class_webdriver_WebElementPromise.html +0 -274
  114. package/docs/class_webdriver_http_Executor.html +0 -22
  115. package/docs/class_webdriver_http_Request.html +0 -12
  116. package/docs/class_webdriver_http_Response.html +0 -13
  117. package/docs/class_webdriver_logging_Entry.html +0 -15
  118. package/docs/class_webdriver_logging_Level.html +0 -55
  119. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  120. package/docs/class_webdriver_logging_Logger.html +0 -119
  121. package/docs/class_webdriver_logging_Preferences.html +0 -8
  122. package/docs/class_webdriver_promise_CancellationError.html +0 -17
  123. package/docs/class_webdriver_promise_ControlFlow.html +0 -153
  124. package/docs/class_webdriver_promise_Deferred.html +0 -84
  125. package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
  126. package/docs/class_webdriver_promise_Promise.html +0 -75
  127. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  128. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  129. package/docs/class_webdriver_testing_Assertion.html +0 -99
  130. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  131. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  132. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  133. package/docs/class_webdriver_until_Condition.html +0 -7
  134. package/docs/dossier.css +0 -1
  135. package/docs/dossier.js +0 -86
  136. package/docs/enum_bot_ErrorCode.html +0 -3
  137. package/docs/enum_bot_Error_State.html +0 -2
  138. package/docs/enum_webdriver_Browser.html +0 -2
  139. package/docs/enum_webdriver_Button.html +0 -2
  140. package/docs/enum_webdriver_Capability.html +0 -33
  141. package/docs/enum_webdriver_CommandName.html +0 -3
  142. package/docs/enum_webdriver_Key.html +0 -12
  143. package/docs/enum_webdriver_logging_Type.html +0 -6
  144. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  145. package/docs/index.html +0 -125
  146. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  147. package/docs/interface_webdriver_http_Client.html +0 -10
  148. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  149. package/docs/module_selenium-webdriver.html +0 -23
  150. package/docs/module_selenium-webdriver__base.html +0 -23
  151. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  152. package/docs/module_selenium-webdriver_builder.html +0 -2
  153. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  154. package/docs/module_selenium-webdriver_chrome.html +0 -90
  155. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  156. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  157. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  158. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  159. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  160. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  161. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  162. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  163. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  164. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  165. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  166. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  167. package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
  168. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
  169. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  170. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  171. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  172. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  173. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  174. package/docs/module_selenium-webdriver_error.html +0 -4
  175. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  176. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  177. package/docs/module_selenium-webdriver_executors.html +0 -10
  178. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  179. package/docs/module_selenium-webdriver_firefox.html +0 -68
  180. package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
  181. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
  182. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
  183. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  184. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  185. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  186. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  187. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  188. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  189. package/docs/module_selenium-webdriver_http.html +0 -9
  190. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  191. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  192. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  193. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  194. package/docs/module_selenium-webdriver_http_util.html +0 -17
  195. package/docs/module_selenium-webdriver_ie.html +0 -11
  196. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  197. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  198. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  199. package/docs/module_selenium-webdriver_io.html +0 -37
  200. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  201. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  202. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  203. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  204. package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
  205. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  206. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  207. package/docs/module_selenium-webdriver_net.html +0 -7
  208. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  209. package/docs/module_selenium-webdriver_opera.html +0 -62
  210. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  211. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  212. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  213. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  214. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  215. package/docs/module_selenium-webdriver_proxy.html +0 -28
  216. package/docs/module_selenium-webdriver_remote.html +0 -8
  217. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  218. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  219. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
  220. package/docs/module_selenium-webdriver_safari.html +0 -9
  221. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  222. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  223. package/docs/module_selenium-webdriver_testing.html +0 -74
  224. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  225. package/docs/namespace_bot.html +0 -4
  226. package/docs/namespace_bot_json.html +0 -20
  227. package/docs/namespace_bot_response.html +0 -18
  228. package/docs/namespace_bot_userAgent.html +0 -33
  229. package/docs/namespace_webdriver.html +0 -30
  230. package/docs/namespace_webdriver_By.html +0 -56
  231. package/docs/namespace_webdriver_http.html +0 -6
  232. package/docs/namespace_webdriver_logging.html +0 -70
  233. package/docs/namespace_webdriver_promise.html +0 -688
  234. package/docs/namespace_webdriver_stacktrace.html +0 -17
  235. package/docs/namespace_webdriver_testing.html +0 -7
  236. package/docs/namespace_webdriver_testing_assert.html +0 -9
  237. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  238. package/docs/namespace_webdriver_until.html +0 -82
  239. package/docs/source/_base.js.src.html +0 -1
  240. package/docs/source/builder.js.src.html +0 -1
  241. package/docs/source/chrome.js.src.html +0 -1
  242. package/docs/source/error.js.src.html +0 -1
  243. package/docs/source/executors.js.src.html +0 -1
  244. package/docs/source/firefox/binary.js.src.html +0 -1
  245. package/docs/source/firefox/extension.js.src.html +0 -1
  246. package/docs/source/firefox/index.js.src.html +0 -1
  247. package/docs/source/firefox/profile.js.src.html +0 -1
  248. package/docs/source/http/index.js.src.html +0 -1
  249. package/docs/source/http/util.js.src.html +0 -1
  250. package/docs/source/ie.js.src.html +0 -1
  251. package/docs/source/index.js.src.html +0 -1
  252. package/docs/source/io/exec.js.src.html +0 -1
  253. package/docs/source/io/index.js.src.html +0 -1
  254. package/docs/source/lib/atoms/error.js.src.html +0 -1
  255. package/docs/source/lib/atoms/json.js.src.html +0 -1
  256. package/docs/source/lib/atoms/response.js.src.html +0 -1
  257. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  258. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  259. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  260. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  261. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  262. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  263. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  264. package/docs/source/lib/goog/base.js.src.html +0 -1
  265. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  266. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  267. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  268. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  269. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  270. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  271. package/docs/source/lib/goog/deps.js.src.html +0 -1
  272. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  273. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  274. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  275. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  276. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  277. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  278. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  279. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  280. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  282. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  283. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  284. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  285. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  286. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  287. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  288. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  289. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  290. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  291. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  292. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  293. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  294. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  295. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  296. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  297. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  298. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  299. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  300. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  301. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  302. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  303. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  304. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  305. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  306. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  307. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  308. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  309. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  310. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  311. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  312. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  313. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  314. package/docs/source/lib/goog/log/log.js.src.html +0 -1
  315. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  316. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  317. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  318. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  319. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  320. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  321. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  322. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  323. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  324. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  325. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  326. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  327. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  328. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  329. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  330. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  331. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  332. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  333. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  334. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  335. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  336. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  344. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  345. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  346. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  347. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  348. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  349. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  350. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  351. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  352. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  353. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  354. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  355. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  356. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  357. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  358. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  366. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  367. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  368. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  369. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  370. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  371. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  372. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  373. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  374. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  375. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  376. package/docs/source/net/index.js.src.html +0 -1
  377. package/docs/source/net/portprober.js.src.html +0 -1
  378. package/docs/source/opera.js.src.html +0 -1
  379. package/docs/source/phantomjs.js.src.html +0 -1
  380. package/docs/source/proxy.js.src.html +0 -1
  381. package/docs/source/remote/index.js.src.html +0 -1
  382. package/docs/source/safari.js.src.html +0 -1
  383. package/docs/source/testing/assert.js.src.html +0 -1
  384. package/docs/source/testing/index.js.src.html +0 -1
  385. package/docs/types.js +0 -1
  386. package/lib/atoms/error.js +0 -202
  387. package/lib/atoms/json.js +0 -80
  388. package/lib/atoms/response.js +0 -110
  389. package/lib/atoms/userAgent.js +0 -257
  390. package/lib/goog/LICENSE +0 -176
  391. package/lib/goog/array/array.js +0 -1654
  392. package/lib/goog/asserts/asserts.js +0 -365
  393. package/lib/goog/async/freelist.js +0 -88
  394. package/lib/goog/async/nexttick.js +0 -241
  395. package/lib/goog/async/run.js +0 -133
  396. package/lib/goog/async/workqueue.js +0 -139
  397. package/lib/goog/base.js +0 -2548
  398. package/lib/goog/debug/debug.js +0 -653
  399. package/lib/goog/debug/entrypointregistry.js +0 -158
  400. package/lib/goog/debug/error.js +0 -63
  401. package/lib/goog/debug/logbuffer.js +0 -148
  402. package/lib/goog/debug/logger.js +0 -873
  403. package/lib/goog/debug/logrecord.js +0 -242
  404. package/lib/goog/deps.js +0 -151
  405. package/lib/goog/disposable/disposable.js +0 -307
  406. package/lib/goog/disposable/idisposable.js +0 -45
  407. package/lib/goog/dom/browserfeature.js +0 -72
  408. package/lib/goog/dom/dom.js +0 -2991
  409. package/lib/goog/dom/nodetype.js +0 -48
  410. package/lib/goog/dom/safe.js +0 -347
  411. package/lib/goog/dom/tagname.js +0 -160
  412. package/lib/goog/dom/tags.js +0 -41
  413. package/lib/goog/dom/vendor.js +0 -96
  414. package/lib/goog/events/browserevent.js +0 -400
  415. package/lib/goog/events/browserfeature.js +0 -85
  416. package/lib/goog/events/event.js +0 -143
  417. package/lib/goog/events/eventid.js +0 -47
  418. package/lib/goog/events/events.js +0 -984
  419. package/lib/goog/events/eventtarget.js +0 -394
  420. package/lib/goog/events/eventtype.js +0 -237
  421. package/lib/goog/events/keycodes.js +0 -427
  422. package/lib/goog/events/listenable.js +0 -335
  423. package/lib/goog/events/listener.js +0 -131
  424. package/lib/goog/events/listenermap.js +0 -308
  425. package/lib/goog/fs/url.js +0 -109
  426. package/lib/goog/functions/functions.js +0 -442
  427. package/lib/goog/html/safehtml.js +0 -757
  428. package/lib/goog/html/safescript.js +0 -234
  429. package/lib/goog/html/safestyle.js +0 -442
  430. package/lib/goog/html/safestylesheet.js +0 -276
  431. package/lib/goog/html/safeurl.js +0 -398
  432. package/lib/goog/html/trustedresourceurl.js +0 -224
  433. package/lib/goog/html/uncheckedconversions.js +0 -232
  434. package/lib/goog/i18n/bidi.js +0 -908
  435. package/lib/goog/iter/iter.js +0 -1302
  436. package/lib/goog/json/json.js +0 -363
  437. package/lib/goog/labs/testing/assertthat.js +0 -58
  438. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  439. package/lib/goog/labs/testing/matcher.js +0 -80
  440. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  441. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  442. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  443. package/lib/goog/labs/useragent/browser.js +0 -341
  444. package/lib/goog/labs/useragent/engine.js +0 -160
  445. package/lib/goog/labs/useragent/platform.js +0 -160
  446. package/lib/goog/labs/useragent/util.js +0 -148
  447. package/lib/goog/log/log.js +0 -197
  448. package/lib/goog/math/box.js +0 -398
  449. package/lib/goog/math/coordinate.js +0 -268
  450. package/lib/goog/math/math.js +0 -451
  451. package/lib/goog/math/rect.js +0 -476
  452. package/lib/goog/math/size.js +0 -227
  453. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  454. package/lib/goog/net/xhrlike.js +0 -124
  455. package/lib/goog/net/xmlhttp.js +0 -246
  456. package/lib/goog/net/xmlhttpfactory.js +0 -67
  457. package/lib/goog/object/object.js +0 -686
  458. package/lib/goog/promise/promise.js +0 -1350
  459. package/lib/goog/promise/resolver.js +0 -48
  460. package/lib/goog/promise/thenable.js +0 -126
  461. package/lib/goog/reflect/reflect.js +0 -77
  462. package/lib/goog/string/const.js +0 -182
  463. package/lib/goog/string/string.js +0 -1599
  464. package/lib/goog/string/typedstring.js +0 -48
  465. package/lib/goog/structs/collection.js +0 -56
  466. package/lib/goog/structs/map.js +0 -457
  467. package/lib/goog/structs/set.js +0 -279
  468. package/lib/goog/structs/structs.js +0 -354
  469. package/lib/goog/style/style.js +0 -2037
  470. package/lib/goog/testing/asserts.js +0 -1278
  471. package/lib/goog/testing/events/events.js +0 -767
  472. package/lib/goog/testing/functionmock.js +0 -175
  473. package/lib/goog/testing/jsunit.js +0 -162
  474. package/lib/goog/testing/loosemock.js +0 -242
  475. package/lib/goog/testing/mock.js +0 -645
  476. package/lib/goog/testing/mockclock.js +0 -606
  477. package/lib/goog/testing/mockcontrol.js +0 -220
  478. package/lib/goog/testing/mockinterface.js +0 -45
  479. package/lib/goog/testing/mockmatchers.js +0 -400
  480. package/lib/goog/testing/objectpropertystring.js +0 -68
  481. package/lib/goog/testing/propertyreplacer.js +0 -262
  482. package/lib/goog/testing/recordfunction.js +0 -215
  483. package/lib/goog/testing/stacktrace.js +0 -594
  484. package/lib/goog/testing/strictmock.js +0 -130
  485. package/lib/goog/testing/testcase.js +0 -1629
  486. package/lib/goog/testing/testrunner.js +0 -440
  487. package/lib/goog/uri/uri.js +0 -1524
  488. package/lib/goog/uri/utils.js +0 -1064
  489. package/lib/goog/useragent/product.js +0 -183
  490. package/lib/goog/useragent/product_isversion.js +0 -144
  491. package/lib/goog/useragent/useragent.js +0 -572
  492. package/lib/webdriver/actionsequence.js +0 -356
  493. package/lib/webdriver/builder.js +0 -207
  494. package/lib/webdriver/capabilities.js +0 -412
  495. package/lib/webdriver/events.js +0 -179
  496. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  497. package/lib/webdriver/http/corsclient.js +0 -133
  498. package/lib/webdriver/http/http.js +0 -525
  499. package/lib/webdriver/http/xhrclient.js +0 -67
  500. package/lib/webdriver/locators.js +0 -257
  501. package/lib/webdriver/logging.js +0 -347
  502. package/lib/webdriver/session.js +0 -74
  503. package/lib/webdriver/stacktrace.js +0 -619
  504. package/lib/webdriver/test/builder_test.js +0 -53
  505. package/lib/webdriver/test/capabilities_test.js +0 -72
  506. package/lib/webdriver/test/events_test.js +0 -203
  507. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  508. package/lib/webdriver/test/http/http_test.js +0 -428
  509. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  510. package/lib/webdriver/test/locators_test.js +0 -59
  511. package/lib/webdriver/test/logging_test.js +0 -85
  512. package/lib/webdriver/test/promise_error_test.js +0 -892
  513. package/lib/webdriver/test/promise_flow_test.js +0 -2365
  514. package/lib/webdriver/test/promise_generator_test.js +0 -323
  515. package/lib/webdriver/test/promise_test.js +0 -2012
  516. package/lib/webdriver/test/stacktrace_test.js +0 -480
  517. package/lib/webdriver/test/test_bootstrap.js +0 -67
  518. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  519. package/lib/webdriver/test/testing/client_test.js +0 -88
  520. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  521. package/lib/webdriver/test/testutil.js +0 -209
  522. package/lib/webdriver/test/testutil_test.js +0 -104
  523. package/lib/webdriver/test/until_test.js +0 -411
  524. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  525. package/lib/webdriver/test/webdriver_test.js +0 -2369
  526. package/lib/webdriver/testing/asserts.js +0 -487
  527. package/lib/webdriver/testing/client.js +0 -179
  528. package/lib/webdriver/testing/jsunit.js +0 -363
  529. package/lib/webdriver/testing/testcase.js +0 -168
  530. package/lib/webdriver/testing/window.js +0 -244
  531. package/lib/webdriver/touchsequence.js +0 -248
  532. package/lib/webdriver/until.js +0 -412
  533. package/lib/webdriver/webdriver.js +0 -2511
  534. package/test/_base_test.js +0 -129
@@ -0,0 +1,996 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ 'use strict';
19
+
20
+ const assert = require('assert');
21
+
22
+ const testutil = require('./testutil');
23
+ const promise = require('../../lib/promise');
24
+
25
+ // Aliases for readability.
26
+ const NativePromise = Promise;
27
+ const StubError = testutil.StubError;
28
+ const assertIsStubError = testutil.assertIsStubError;
29
+ const callbackHelper = testutil.callbackHelper;
30
+ const callbackPair = testutil.callbackPair;
31
+ const throwStubError = testutil.throwStubError;
32
+ const fail = () => assert.fail();
33
+
34
+ // Refer to promise_aplus_test for promise compliance with standard behavior.
35
+ describe('promise', function() {
36
+ var app, uncaughtExceptions;
37
+
38
+ beforeEach(function setUp() {
39
+ promise.LONG_STACK_TRACES = false;
40
+ uncaughtExceptions = [];
41
+
42
+ app = promise.controlFlow();
43
+ app.on(promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION,
44
+ (e) => uncaughtExceptions.push(e));
45
+ });
46
+
47
+ afterEach(function tearDown() {
48
+ app.reset();
49
+ promise.setDefaultFlow(new promise.ControlFlow);
50
+ assert.deepEqual([], uncaughtExceptions,
51
+ 'Did not expect any uncaught exceptions');
52
+ promise.LONG_STACK_TRACES = false;
53
+ });
54
+
55
+ const assertIsPromise = (p) => assert.ok(promise.isPromise(p));
56
+ const assertNotPromise = (v) => assert.ok(!promise.isPromise(v));
57
+
58
+ function createRejectedPromise(reason) {
59
+ var p = promise.rejected(reason);
60
+ p.catch(function() {});
61
+ return p;
62
+ }
63
+
64
+ it('testCanDetectPromiseLikeObjects', function() {
65
+ assertIsPromise(new promise.Promise(function(fulfill) {
66
+ fulfill();
67
+ }));
68
+ assertIsPromise(new promise.Deferred());
69
+ assertIsPromise(new promise.Deferred().promise);
70
+ assertIsPromise({then:function() {}});
71
+
72
+ assertNotPromise(undefined);
73
+ assertNotPromise(null);
74
+ assertNotPromise('');
75
+ assertNotPromise(true);
76
+ assertNotPromise(false);
77
+ assertNotPromise(1);
78
+ assertNotPromise({});
79
+ assertNotPromise({then:1});
80
+ assertNotPromise({then:true});
81
+ assertNotPromise({then:''});
82
+ });
83
+
84
+ describe('then', function() {
85
+ it('returnsOwnPromiseIfNoCallbacksWereGiven', function() {
86
+ var deferred = new promise.Deferred();
87
+ assert.equal(deferred.promise, deferred.promise.then());
88
+ assert.equal(deferred.promise, deferred.promise.catch());
89
+ assert.equal(deferred.promise, promise.when(deferred.promise));
90
+ });
91
+
92
+ it('stillConsideredUnHandledIfNoCallbacksWereGivenOnCallsToThen', function() {
93
+ promise.rejected(new StubError).then();
94
+ var handler = callbackHelper(assertIsStubError);
95
+
96
+ // so tearDown() doesn't throw
97
+ app.removeAllListeners();
98
+ app.on(promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION, handler);
99
+ return NativePromise.resolve().then(() => handler.assertCalled());
100
+ });
101
+ });
102
+
103
+ describe('thenFinally', function() {
104
+ it('nonFailingCallbackDoesNotSuppressOriginalError', function() {
105
+ var done = callbackHelper(assertIsStubError);
106
+ return promise.rejected(new StubError).
107
+ thenFinally(function() {}).
108
+ catch(done).
109
+ thenFinally(done.assertCalled);
110
+ });
111
+
112
+ it('failingCallbackSuppressesOriginalError', function() {
113
+ var done = callbackHelper(assertIsStubError);
114
+ return promise.rejected(new Error('original')).
115
+ thenFinally(throwStubError).
116
+ catch(done).
117
+ thenFinally(done.assertCalled);
118
+ });
119
+
120
+ it('callbackThrowsAfterFulfilledPromise', function() {
121
+ var done = callbackHelper(assertIsStubError);
122
+ return promise.fulfilled().
123
+ thenFinally(throwStubError).
124
+ catch(done).
125
+ thenFinally(done.assertCalled);
126
+ });
127
+
128
+ it('callbackReturnsRejectedPromise', function() {
129
+ var done = callbackHelper(assertIsStubError);
130
+ return promise.fulfilled().
131
+ thenFinally(function() {
132
+ return promise.rejected(new StubError);
133
+ }).
134
+ catch(done).
135
+ thenFinally(done.assertCalled);
136
+ });
137
+ });
138
+
139
+ describe('cancel', function() {
140
+ it('passesTheCancellationReasonToReject', function() {
141
+ var d = new promise.Deferred();
142
+ var res = d.then(assert.fail, function(e) {
143
+ assert.ok(e instanceof promise.CancellationError);
144
+ assert.equal('because i said so', e.message);
145
+ });
146
+ d.cancel('because i said so');
147
+ return res;
148
+ });
149
+
150
+ it('canCancelADeferredFromAChainedPromise', function() {
151
+ var d = new promise.Deferred();
152
+ var p = d.then(assert.fail, function(e) {
153
+ assert.ok(e instanceof promise.CancellationError);
154
+ assert.equal('because i said so', e.message);
155
+ });
156
+ var p2 = p.then(function() {}, assert.fail);
157
+
158
+ p.cancel('because i said so');
159
+ return p2;
160
+ });
161
+
162
+ it('canCancelATimeout', function() {
163
+ var p = promise.delayed(25)
164
+ .then(assert.fail, (e) => e instanceof promise.CancellationError);
165
+ setTimeout(() => p.cancel(), 20);
166
+ p.cancel();
167
+ return p;
168
+ });
169
+
170
+ it('cancelIsANoopOnceAPromiseHasBeenFulfilled', function() {
171
+ var p = promise.fulfilled(123);
172
+ p.cancel();
173
+ return p.then((v) => assert.equal(123, v));
174
+ });
175
+
176
+ it('cancelIsANoopOnceAPromiseHasBeenRejected', function() {
177
+ var p = promise.rejected(new StubError);
178
+ p.cancel();
179
+
180
+ var pair = callbackPair(null, assertIsStubError);
181
+ return p.then(assert.fail, assertIsStubError);
182
+ });
183
+
184
+ it('noopCancelTriggeredOnCallbackOfResolvedPromise', function() {
185
+ var d = promise.defer();
186
+ var p = d.promise.then();
187
+
188
+ d.fulfill();
189
+ p.cancel(); // This should not throw.
190
+ return p; // This should not trigger a failure.
191
+ });
192
+ });
193
+
194
+ describe('when', function() {
195
+ it('ReturnsAResolvedPromiseIfGivenANonPromiseValue', function() {
196
+ var ret = promise.when('abc');
197
+ assertIsPromise(ret);
198
+ return ret.then((value) => assert.equal('abc', value));
199
+ });
200
+
201
+ it('PassesRawErrorsToCallbacks', function() {
202
+ var error = new Error('boo!');
203
+ return promise.when(error, function(value) {
204
+ assert.equal(error, value);
205
+ });
206
+ });
207
+
208
+ it('WaitsForValueToBeResolvedBeforeInvokingCallback', function() {
209
+ var d = new promise.Deferred(), callback;
210
+ let result = promise.when(d, callback = callbackHelper(function(value) {
211
+ assert.equal('hi', value);
212
+ }));
213
+ callback.assertNotCalled();
214
+ d.fulfill('hi');
215
+ return result.then(callback.assertCalled);
216
+ });
217
+
218
+ it('canCancelReturnedPromise', function() {
219
+ var callbacks = callbackPair(null, function(e) {
220
+ assert.ok(e instanceof promise.CancellationError);
221
+ assert.equal('just because', e.message);
222
+ });
223
+
224
+ var promiseLike = {
225
+ then: function(cb, eb) {
226
+ this.callback = cb;
227
+ this.errback = eb;
228
+ }
229
+ };
230
+
231
+ var aPromise = promise.when(promiseLike,
232
+ callbacks.callback, callbacks.errback);
233
+
234
+ assert.ok(aPromise.isPending());
235
+ aPromise.cancel('just because');
236
+
237
+ return aPromise.thenFinally(callbacks.assertErrback);
238
+ });
239
+ });
240
+
241
+ it('firesUncaughtExceptionEventIfRejectionNeverHandled', function() {
242
+ promise.rejected(new StubError);
243
+ var handler = callbackHelper(assertIsStubError);
244
+
245
+ // so tearDown() doesn't throw
246
+ app.removeAllListeners();
247
+ app.on(promise.ControlFlow.EventType.UNCAUGHT_EXCEPTION, handler);
248
+
249
+ return NativePromise.resolve().then(handler.assertCalled);
250
+ });
251
+
252
+ it('cannotResolveADeferredWithItself', function() {
253
+ var deferred = new promise.Deferred();
254
+ assert.throws(() => deferred.fulfill(deferred));
255
+ assert.throws(() => deferred.reject(deferred));
256
+ });
257
+
258
+ describe('fullyResolved', function() {
259
+ it('primitives', function() {
260
+ function runTest(value) {
261
+ var callback, errback;
262
+ return promise.fullyResolved(value)
263
+ .then((resolved) => assert.equal(value, resolved));
264
+ }
265
+ return runTest(true)
266
+ .then(() => runTest(function() {}))
267
+ .then(() => runTest(null))
268
+ .then(() => runTest(123))
269
+ .then(() => runTest('foo bar'))
270
+ .then(() => runTest(undefined));
271
+ });
272
+
273
+ it('arrayOfPrimitives', function() {
274
+ var fn = function() {};
275
+ var array = [true, fn, null, 123, '', undefined, 1];
276
+ return promise.fullyResolved(array).then(function(resolved) {
277
+ assert.equal(array, resolved);
278
+ assert.deepEqual([true, fn, null, 123, '', undefined, 1],
279
+ resolved);
280
+ });
281
+ });
282
+
283
+ it('nestedArrayOfPrimitives', function() {
284
+ var fn = function() {};
285
+ var array = [true, [fn, null, 123], '', undefined];
286
+ return promise.fullyResolved(array)
287
+ .then(function(resolved) {
288
+ assert.equal(array, resolved);
289
+ assert.deepEqual([true, [fn, null, 123], '', undefined], resolved);
290
+ assert.deepEqual([fn, null, 123], resolved[1]);
291
+ });
292
+ });
293
+
294
+ it('arrayWithPromisedPrimitive', function() {
295
+ return promise.fullyResolved([promise.fulfilled(123)])
296
+ .then(function(resolved) {
297
+ assert.deepEqual([123], resolved);
298
+ });
299
+ });
300
+
301
+ it('promiseResolvesToPrimitive', function() {
302
+ return promise.fullyResolved(promise.fulfilled(123))
303
+ .then((resolved) => assert.equal(123, resolved));
304
+ });
305
+
306
+ it('promiseResolvesToArray', function() {
307
+ var fn = function() {};
308
+ var array = [true, [fn, null, 123], '', undefined];
309
+ var aPromise = promise.fulfilled(array);
310
+
311
+ var result = promise.fullyResolved(aPromise);
312
+ return result.then(function(resolved) {
313
+ assert.equal(array, resolved);
314
+ assert.deepEqual([true, [fn, null, 123], '', undefined],
315
+ resolved);
316
+ assert.deepEqual([fn, null, 123], resolved[1]);
317
+ });
318
+ });
319
+
320
+ it('promiseResolvesToArrayWithPromises', function() {
321
+ var nestedPromise = promise.fulfilled(123);
322
+ var aPromise = promise.fulfilled([true, nestedPromise]);
323
+ return promise.fullyResolved(aPromise)
324
+ .then(function(resolved) {
325
+ assert.deepEqual([true, 123], resolved);
326
+ });
327
+ });
328
+
329
+ it('rejectsIfArrayPromiseRejects', function() {
330
+ var nestedPromise = createRejectedPromise(new StubError);
331
+ var aPromise = promise.fulfilled([true, nestedPromise]);
332
+
333
+ var pair = callbackPair(null, assertIsStubError);
334
+ return promise.fullyResolved(aPromise)
335
+ .then(assert.fail, assertIsStubError);
336
+ });
337
+
338
+ it('rejectsOnFirstArrayRejection', function() {
339
+ var e1 = new Error('foo');
340
+ var e2 = new Error('bar');
341
+ var aPromise = promise.fulfilled([
342
+ createRejectedPromise(e1),
343
+ createRejectedPromise(e2)
344
+ ]);
345
+
346
+ return promise.fullyResolved(aPromise)
347
+ .then(assert.fail, function(error) {
348
+ assert.strictEqual(e1, error);
349
+ });
350
+ });
351
+
352
+ it('rejectsIfNestedArrayPromiseRejects', function() {
353
+ var aPromise = promise.fulfilled([
354
+ promise.fulfilled([
355
+ createRejectedPromise(new StubError)
356
+ ])
357
+ ]);
358
+
359
+ return promise.fullyResolved(aPromise)
360
+ .then(assert.fail, assertIsStubError);
361
+ });
362
+
363
+ it('simpleHash', function() {
364
+ var hash = {'a': 123};
365
+ return promise.fullyResolved(hash)
366
+ .then(function(resolved) {
367
+ assert.strictEqual(hash, resolved);
368
+ assert.deepEqual(hash, {'a': 123});
369
+ });
370
+ });
371
+
372
+ it('nestedHash', function() {
373
+ var nestedHash = {'foo':'bar'};
374
+ var hash = {'a': 123, 'b': nestedHash};
375
+
376
+ return promise.fullyResolved(hash)
377
+ .then(function(resolved) {
378
+ assert.strictEqual(hash, resolved);
379
+ assert.deepEqual({'a': 123, 'b': {'foo': 'bar'}}, resolved);
380
+ assert.strictEqual(nestedHash, resolved['b']);
381
+ });
382
+ });
383
+
384
+ it('promiseResolvesToSimpleHash', function() {
385
+ var hash = {'a': 123};
386
+ var aPromise = promise.fulfilled(hash);
387
+
388
+ return promise.fullyResolved(aPromise)
389
+ .then((resolved) => assert.strictEqual(hash, resolved));
390
+ });
391
+
392
+ it('promiseResolvesToNestedHash', function() {
393
+ var nestedHash = {'foo':'bar'};
394
+ var hash = {'a': 123, 'b': nestedHash};
395
+ var aPromise = promise.fulfilled(hash);
396
+
397
+ return promise.fullyResolved(aPromise)
398
+ .then(function(resolved) {
399
+ assert.strictEqual(hash, resolved);
400
+ assert.strictEqual(nestedHash, resolved['b']);
401
+ assert.deepEqual(hash, {'a': 123, 'b': {'foo': 'bar'}});
402
+ });
403
+ });
404
+
405
+ it('promiseResolvesToHashWithPromises', function() {
406
+ var aPromise = promise.fulfilled({
407
+ 'a': promise.fulfilled(123)
408
+ });
409
+
410
+ return promise.fullyResolved(aPromise)
411
+ .then(function(resolved) {
412
+ assert.deepEqual({'a': 123}, resolved);
413
+ });
414
+ });
415
+
416
+ it('rejectsIfHashPromiseRejects', function() {
417
+ var aPromise = promise.fulfilled({
418
+ 'a': createRejectedPromise(new StubError)
419
+ });
420
+
421
+ return promise.fullyResolved(aPromise)
422
+ .then(assert.fail, assertIsStubError);
423
+ });
424
+
425
+ it('rejectsIfNestedHashPromiseRejects', function() {
426
+ var aPromise = promise.fulfilled({
427
+ 'a': {'b': createRejectedPromise(new StubError)}
428
+ });
429
+
430
+ return promise.fullyResolved(aPromise)
431
+ .then(assert.fail, assertIsStubError);
432
+ });
433
+
434
+ it('instantiatedObject', function() {
435
+ function Foo() {
436
+ this.bar = 'baz';
437
+ }
438
+ var foo = new Foo;
439
+
440
+ return promise.fullyResolved(foo).then(function(resolvedFoo) {
441
+ assert.equal(foo, resolvedFoo);
442
+ assert.ok(resolvedFoo instanceof Foo);
443
+ assert.deepEqual(new Foo, resolvedFoo);
444
+ });
445
+ });
446
+
447
+ it('withEmptyArray', function() {
448
+ return promise.fullyResolved([]).then(function(resolved) {
449
+ assert.deepEqual([], resolved);
450
+ });
451
+ });
452
+
453
+ it('withEmptyHash', function() {
454
+ return promise.fullyResolved({}).then(function(resolved) {
455
+ assert.deepEqual({}, resolved);
456
+ });
457
+ });
458
+
459
+ it('arrayWithPromisedHash', function() {
460
+ var obj = {'foo': 'bar'};
461
+ var array = [promise.fulfilled(obj)];
462
+
463
+ return promise.fullyResolved(array).then(function(resolved) {
464
+ assert.deepEqual(resolved, [obj]);
465
+ });
466
+ });
467
+ });
468
+
469
+ describe('checkedNodeCall', function() {
470
+ it('functionThrows', function() {
471
+ return promise.checkedNodeCall(throwStubError)
472
+ .then(assert.fail, assertIsStubError);
473
+ });
474
+
475
+ it('functionReturnsAnError', function() {
476
+ return promise.checkedNodeCall(function(callback) {
477
+ callback(new StubError);
478
+ }).then(assert.fail, assertIsStubError);
479
+ });
480
+
481
+ it('functionReturnsSuccess', function() {
482
+ var success = 'success!';
483
+ return promise.checkedNodeCall(function(callback) {
484
+ callback(null, success);
485
+ }).then((value) => assert.equal(success, value));
486
+ });
487
+
488
+ it('functionReturnsAndThrows', function() {
489
+ var error = new Error('boom');
490
+ var error2 = new Error('boom again');
491
+ return promise.checkedNodeCall(function(callback) {
492
+ callback(error);
493
+ throw error2;
494
+ }).then(assert.fail, (e) => assert.equal(error, e));
495
+ });
496
+
497
+ it('functionThrowsAndReturns', function() {
498
+ var error = new Error('boom');
499
+ var error2 = new Error('boom again');
500
+ return promise.checkedNodeCall(function(callback) {
501
+ setTimeout(() => callback(error), 10);
502
+ throw error2;
503
+ }).then(assert.fail, (e) => assert.equal(error2, e));
504
+ });
505
+ });
506
+
507
+ describe('all', function() {
508
+ it('(base case)', function() {
509
+ var a = [
510
+ 0, 1,
511
+ promise.defer(),
512
+ promise.defer(),
513
+ 4, 5, 6
514
+ ];
515
+ delete a[5];
516
+
517
+ var pair = callbackPair(function(value) {
518
+ assert.deepEqual([0, 1, 2, 3, 4, undefined, 6], value);
519
+ });
520
+
521
+ var result = promise.all(a).then(pair.callback, pair.errback);
522
+ pair.assertNeither();
523
+
524
+ a[2].fulfill(2);
525
+ pair.assertNeither();
526
+
527
+ a[3].fulfill(3);
528
+ return result.then(() => pair.assertCallback());
529
+ });
530
+
531
+ it('empty array', function() {
532
+ return promise.all([]).then((a) => assert.deepEqual([], a));
533
+ });
534
+
535
+ it('usesFirstRejection', function() {
536
+ var a = [
537
+ promise.defer(),
538
+ promise.defer()
539
+ ];
540
+
541
+ var result = promise.all(a).then(assert.fail, assertIsStubError);
542
+ a[1].reject(new StubError);
543
+ setTimeout(() => a[0].reject(Error('ignored')), 0);
544
+ return result;
545
+ });
546
+ });
547
+
548
+ describe('map', function() {
549
+ it('(base case)', function() {
550
+ var a = [1, 2, 3];
551
+ return promise.map(a, function(value, index, a2) {
552
+ assert.equal(a, a2);
553
+ assert.equal('number', typeof index, 'not a number');
554
+ return value + 1;
555
+ }).then(function(value) {
556
+ assert.deepEqual([2, 3, 4], value);
557
+ });
558
+ });
559
+
560
+ it('omitsDeleted', function() {
561
+ var a = [0, 1, 2, 3, 4, 5, 6];
562
+ delete a[1];
563
+ delete a[3];
564
+ delete a[4];
565
+ delete a[6];
566
+
567
+ var expected = [0, 1, 4, 9, 16, 25, 36];
568
+ delete expected[1];
569
+ delete expected[3];
570
+ delete expected[4];
571
+ delete expected[6];
572
+
573
+ return promise.map(a, function(value) {
574
+ return value * value;
575
+ }).then(function(value) {
576
+ assert.deepEqual(expected, value);
577
+ });
578
+ });
579
+
580
+ it('emptyArray', function() {
581
+ return promise.map([], function(value) {
582
+ return value + 1;
583
+ }).then(function(value) {
584
+ assert.deepEqual([], value);
585
+ });
586
+ });
587
+
588
+ it('inputIsPromise', function() {
589
+ var input = promise.defer();
590
+ var result = promise.map(input, function(value) {
591
+ return value + 1;
592
+ });
593
+
594
+ var pair = callbackPair(function(value) {
595
+ assert.deepEqual([2, 3, 4], value);
596
+ });
597
+ result = result.then(pair.callback, pair.errback);
598
+
599
+ setTimeout(function() {
600
+ pair.assertNeither();
601
+ input.fulfill([1, 2, 3]);
602
+ }, 10);
603
+
604
+ return result;
605
+ });
606
+
607
+ it('waitsForFunctionResultToResolve', function() {
608
+ var innerResults = [
609
+ promise.defer(),
610
+ promise.defer()
611
+ ];
612
+
613
+ var result = promise.map([1, 2], function(value, index) {
614
+ return innerResults[index].promise;
615
+ });
616
+
617
+ var pair = callbackPair(function(value) {
618
+ assert.deepEqual(['a', 'b'], value);
619
+ });
620
+ result = result.then(pair.callback, pair.errback);
621
+
622
+ return NativePromise.resolve()
623
+ .then(function() {
624
+ pair.assertNeither();
625
+ innerResults[0].fulfill('a');
626
+ })
627
+ .then(function() {
628
+ pair.assertNeither();
629
+ innerResults[1].fulfill('b');
630
+ return result;
631
+ })
632
+ .then(pair.assertCallback);
633
+ });
634
+
635
+ it('rejectsPromiseIfFunctionThrows', function() {
636
+ return promise.map([1], throwStubError)
637
+ .then(assert.fail, assertIsStubError);
638
+ });
639
+
640
+ it('rejectsPromiseIfFunctionReturnsRejectedPromise', function() {
641
+ return promise.map([1], function() {
642
+ return promise.rejected(new StubError);
643
+ }).then(assert.fail, assertIsStubError);
644
+ });
645
+
646
+ it('stopsCallingFunctionIfPreviousIterationFailed', function() {
647
+ var count = 0;
648
+ return promise.map([1, 2, 3, 4], function() {
649
+ count++;
650
+ if (count == 3) {
651
+ throw new StubError;
652
+ }
653
+ }).then(assert.fail, function(e) {
654
+ assertIsStubError(e);
655
+ assert.equal(3, count);
656
+ });
657
+ });
658
+
659
+ it('rejectsWithFirstRejectedPromise', function() {
660
+ var innerResult = [
661
+ promise.fulfilled(),
662
+ createRejectedPromise(new StubError),
663
+ createRejectedPromise(Error('should be ignored'))
664
+ ];
665
+ var count = 0;
666
+ return promise.map([1, 2, 3, 4], function(value, index) {
667
+ count += 1;
668
+ return innerResult[index];
669
+ }).then(assert.fail, function(e) {
670
+ assertIsStubError(e);
671
+ assert.equal(2, count);
672
+ });
673
+ });
674
+
675
+ it('preservesOrderWhenMapReturnsPromise', function() {
676
+ var deferreds = [
677
+ promise.defer(),
678
+ promise.defer(),
679
+ promise.defer(),
680
+ promise.defer()
681
+ ];
682
+ var result = promise.map(deferreds, function(value) {
683
+ return value.promise;
684
+ });
685
+
686
+ var pair = callbackPair(function(value) {
687
+ assert.deepEqual([0, 1, 2, 3], value);
688
+ });
689
+ result = result.then(pair.callback, pair.errback);
690
+
691
+ return NativePromise.resolve()
692
+ .then(function() {
693
+ pair.assertNeither();
694
+ for (let i = deferreds.length; i > 0; i -= 1) {
695
+ deferreds[i - 1].fulfill(i - 1);
696
+ }
697
+ return result;
698
+ }).then(pair.assertCallback);
699
+ });
700
+ });
701
+
702
+ describe('filter', function() {
703
+ it('basicFiltering', function() {
704
+ var a = [0, 1, 2, 3];
705
+ return promise.filter(a, function(val, index, a2) {
706
+ assert.equal(a, a2);
707
+ assert.equal('number', typeof index, 'not a number');
708
+ return val > 1;
709
+ }).then(function(val) {
710
+ assert.deepEqual([2, 3], val);
711
+ });
712
+ });
713
+
714
+ it('omitsDeleted', function() {
715
+ var a = [0, 1, 2, 3, 4, 5, 6];
716
+ delete a[3];
717
+ delete a[4];
718
+
719
+ return promise.filter(a, function(value) {
720
+ return value > 1 && value < 6;
721
+ }).then(function(val) {
722
+ assert.deepEqual([2, 5], val);
723
+ });
724
+ });
725
+
726
+ it('preservesInputs', function() {
727
+ var a = [0, 1, 2, 3];
728
+
729
+ return promise.filter(a, function(value, i, a2) {
730
+ assert.equal(a, a2);
731
+ // Even if a function modifies the input array, the original value
732
+ // should be inserted into the new array.
733
+ a2[i] = a2[i] - 1;
734
+ return a2[i] >= 1;
735
+ }).then(function(val) {
736
+ assert.deepEqual([2, 3], val);
737
+ });
738
+ });
739
+
740
+ it('inputIsPromise', function() {
741
+ var input = promise.defer();
742
+ var result = promise.filter(input, function(value) {
743
+ return value > 1 && value < 3;
744
+ });
745
+
746
+ var pair = callbackPair(function(value) {
747
+ assert.deepEqual([2], value);
748
+ });
749
+ result = result.then(pair.callback, pair.errback);
750
+ return NativePromise.resolve()
751
+ .then(function() {
752
+ pair.assertNeither();
753
+ input.fulfill([1, 2, 3]);
754
+ return result;
755
+ })
756
+ .then(pair.assertCallback);
757
+ });
758
+
759
+ it('waitsForFunctionResultToResolve', function() {
760
+ var innerResults = [
761
+ promise.defer(),
762
+ promise.defer()
763
+ ];
764
+
765
+ var result = promise.filter([1, 2], function(value, index) {
766
+ return innerResults[index].promise;
767
+ });
768
+
769
+ var pair = callbackPair(function(value) {
770
+ assert.deepEqual([2], value);
771
+ });
772
+ result = result.then(pair.callback, pair.errback);
773
+ return NativePromise.resolve()
774
+ .then(function() {
775
+ pair.assertNeither();
776
+ innerResults[0].fulfill(false);
777
+ })
778
+ .then(function() {
779
+ pair.assertNeither();
780
+ innerResults[1].fulfill(true);
781
+ return result;
782
+ })
783
+ .then(pair.assertCallback);
784
+ });
785
+
786
+ it('rejectsPromiseIfFunctionReturnsRejectedPromise', function() {
787
+ return promise.filter([1], function() {
788
+ return promise.rejected(new StubError);
789
+ }).then(assert.fail, assertIsStubError);
790
+ });
791
+
792
+ it('stopsCallingFunctionIfPreviousIterationFailed', function() {
793
+ var count = 0;
794
+ return promise.filter([1, 2, 3, 4], function() {
795
+ count++;
796
+ if (count == 3) {
797
+ throw new StubError;
798
+ }
799
+ }).then(assert.fail, function(e) {
800
+ assertIsStubError(e);
801
+ assert.equal(3, count);
802
+ });
803
+ });
804
+
805
+ it('rejectsWithFirstRejectedPromise', function() {
806
+ var innerResult = [
807
+ promise.fulfilled(),
808
+ createRejectedPromise(new StubError),
809
+ createRejectedPromise(Error('should be ignored'))
810
+ ];
811
+
812
+ return promise.filter([1, 2, 3, 4], function(value, index) {
813
+ assert.ok(index < innerResult.length);
814
+ return innerResult[index];
815
+ }).then(assert.fail, assertIsStubError);
816
+ });
817
+
818
+ it('preservesOrderWhenFilterReturnsPromise', function() {
819
+ var deferreds = [
820
+ promise.defer(),
821
+ promise.defer(),
822
+ promise.defer(),
823
+ promise.defer()
824
+ ];
825
+ var result = promise.filter([0, 1, 2, 3], function(value, index) {
826
+ return deferreds[index].promise;
827
+ });
828
+
829
+ var pair = callbackPair(function(value) {
830
+ assert.deepEqual([1, 2], value);
831
+ });
832
+ result = result.then(pair.callback, pair.errback);
833
+
834
+ return NativePromise.resolve()
835
+ .then(function() {
836
+ pair.assertNeither();
837
+ for (let i = deferreds.length - 1; i >= 0; i -= 1) {
838
+ deferreds[i].fulfill(i > 0 && i < 3);
839
+ }
840
+ return result;
841
+ }).then(pair.assertCallback);
842
+ });
843
+ });
844
+
845
+ it('testAddThenableImplementation', function() {
846
+ function tmp() {}
847
+ assert.ok(!promise.Thenable.isImplementation(new tmp()));
848
+ promise.Thenable.addImplementation(tmp);
849
+ assert.ok(promise.Thenable.isImplementation(new tmp()));
850
+
851
+ class tmpClass {}
852
+ assert.ok(!promise.Thenable.isImplementation(new tmpClass()));
853
+ promise.Thenable.addImplementation(tmpClass);
854
+ assert.ok(promise.Thenable.isImplementation(new tmpClass()));
855
+ });
856
+
857
+ describe('testLongStackTraces', function() {
858
+ beforeEach(() => promise.LONG_STACK_TRACES = false);
859
+ afterEach(() => promise.LONG_STACK_TRACES = false);
860
+
861
+ it('doesNotAppendStackIfFeatureDisabled', function() {
862
+ promise.LONG_STACK_TRACES = false;
863
+
864
+ var error = Error('hello');
865
+ var originalStack = error.stack;
866
+ return promise.rejected(error).
867
+ then(fail).
868
+ then(fail).
869
+ then(fail).
870
+ then(fail, function(e) {
871
+ assert.equal(error, e);
872
+ assert.equal(originalStack, e.stack);
873
+ });
874
+ });
875
+
876
+ function getStackMessages(error) {
877
+ return error.stack.split(/\n/).filter(function(line) {
878
+ return /^From: /.test(line);
879
+ });
880
+ }
881
+
882
+ it('appendsInitialPromiseCreation_resolverThrows', function() {
883
+ promise.LONG_STACK_TRACES = true;
884
+
885
+ var error = Error('hello');
886
+ var originalStack = '(placeholder; will be overwritten later)';
887
+
888
+ return new promise.Promise(function() {
889
+ try {
890
+ throw error;
891
+ } catch (e) {
892
+ originalStack = e.stack;
893
+ throw e;
894
+ }
895
+ }).then(fail, function(e) {
896
+ assert.strictEqual(error, e);
897
+ if (typeof originalStack !== 'string') {
898
+ return;
899
+ }
900
+ assert.notEqual(originalStack, e.stack);
901
+ assert.equal(e.stack.indexOf(originalStack), 0,
902
+ 'should start with original stack');
903
+ assert.deepEqual(['From: ManagedPromise: new'], getStackMessages(e));
904
+ });
905
+ });
906
+
907
+ it('appendsInitialPromiseCreation_rejectCalled', function() {
908
+ promise.LONG_STACK_TRACES = true;
909
+
910
+ var error = Error('hello');
911
+ var originalStack = error.stack;
912
+
913
+ return new promise.Promise(function(_, reject) {
914
+ reject(error);
915
+ }).then(fail, function(e) {
916
+ assert.equal(error, e);
917
+ if (typeof originalStack !== 'string') {
918
+ return;
919
+ }
920
+ assert.notEqual(originalStack, e.stack);
921
+ assert.equal(e.stack.indexOf(originalStack), 0,
922
+ 'should start with original stack');
923
+ assert.deepEqual(['From: ManagedPromise: new'], getStackMessages(e));
924
+ });
925
+ });
926
+
927
+ it('appendsEachStepToRejectionError', function() {
928
+ promise.LONG_STACK_TRACES = true;
929
+
930
+ var error = Error('hello');
931
+ var originalStack = '(placeholder; will be overwritten later)';
932
+
933
+ return new promise.Promise(function() {
934
+ try {
935
+ throw error;
936
+ } catch (e) {
937
+ originalStack = e.stack;
938
+ throw e;
939
+ }
940
+ }).
941
+ then(fail).
942
+ catch(function(e) { throw e; }).
943
+ then(fail).
944
+ catch(function(e) { throw e; }).
945
+ then(fail, function(e) {
946
+ assert.equal(error, e);
947
+ if (typeof originalStack !== 'string') {
948
+ return;
949
+ }
950
+ assert.notEqual(originalStack, e.stack);
951
+ assert.equal(e.stack.indexOf(originalStack), 0,
952
+ 'should start with original stack');
953
+ assert.deepEqual([
954
+ 'From: ManagedPromise: new',
955
+ 'From: Promise: then',
956
+ 'From: Promise: catch',
957
+ 'From: Promise: then',
958
+ 'From: Promise: catch',
959
+ ], getStackMessages(e));
960
+ });
961
+ });
962
+
963
+ it('errorOccursInCallbackChain', function() {
964
+ promise.LONG_STACK_TRACES = true;
965
+
966
+ var error = Error('hello');
967
+ var originalStack = '(placeholder; will be overwritten later)';
968
+
969
+ return promise.fulfilled().
970
+ then(function() {}).
971
+ then(function() {}).
972
+ then(function() {
973
+ try {
974
+ throw error;
975
+ } catch (e) {
976
+ originalStack = e.stack;
977
+ throw e;
978
+ }
979
+ }).
980
+ catch(function(e) { throw e; }).
981
+ then(fail, function(e) {
982
+ assert.equal(error, e);
983
+ if (typeof originalStack !== 'string') {
984
+ return;
985
+ }
986
+ assert.notEqual(originalStack, e.stack);
987
+ assert.equal(e.stack.indexOf(originalStack), 0,
988
+ 'should start with original stack');
989
+ assert.deepEqual([
990
+ 'From: Promise: then',
991
+ 'From: Promise: catch',
992
+ ], getStackMessages(e));
993
+ });
994
+ });
995
+ });
996
+ });