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
@@ -1,365 +0,0 @@
1
- // Copyright 2008 The Closure Library Authors. All Rights Reserved.
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS-IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
-
15
- /**
16
- * @fileoverview Utilities to check the preconditions, postconditions and
17
- * invariants runtime.
18
- *
19
- * Methods in this package should be given special treatment by the compiler
20
- * for type-inference. For example, <code>goog.asserts.assert(foo)</code>
21
- * will restrict <code>foo</code> to a truthy value.
22
- *
23
- * The compiler has an option to disable asserts. So code like:
24
- * <code>
25
- * var x = goog.asserts.assert(foo()); goog.asserts.assert(bar());
26
- * </code>
27
- * will be transformed into:
28
- * <code>
29
- * var x = foo();
30
- * </code>
31
- * The compiler will leave in foo() (because its return value is used),
32
- * but it will remove bar() because it assumes it does not have side-effects.
33
- *
34
- * @author agrieve@google.com (Andrew Grieve)
35
- */
36
-
37
- goog.provide('goog.asserts');
38
- goog.provide('goog.asserts.AssertionError');
39
-
40
- goog.require('goog.debug.Error');
41
- goog.require('goog.dom.NodeType');
42
- goog.require('goog.string');
43
-
44
-
45
- /**
46
- * @define {boolean} Whether to strip out asserts or to leave them in.
47
- */
48
- goog.define('goog.asserts.ENABLE_ASSERTS', goog.DEBUG);
49
-
50
-
51
-
52
- /**
53
- * Error object for failed assertions.
54
- * @param {string} messagePattern The pattern that was used to form message.
55
- * @param {!Array<*>} messageArgs The items to substitute into the pattern.
56
- * @constructor
57
- * @extends {goog.debug.Error}
58
- * @final
59
- */
60
- goog.asserts.AssertionError = function(messagePattern, messageArgs) {
61
- messageArgs.unshift(messagePattern);
62
- goog.debug.Error.call(this, goog.string.subs.apply(null, messageArgs));
63
- // Remove the messagePattern afterwards to avoid permanently modifying the
64
- // passed in array.
65
- messageArgs.shift();
66
-
67
- /**
68
- * The message pattern used to format the error message. Error handlers can
69
- * use this to uniquely identify the assertion.
70
- * @type {string}
71
- */
72
- this.messagePattern = messagePattern;
73
- };
74
- goog.inherits(goog.asserts.AssertionError, goog.debug.Error);
75
-
76
-
77
- /** @override */
78
- goog.asserts.AssertionError.prototype.name = 'AssertionError';
79
-
80
-
81
- /**
82
- * The default error handler.
83
- * @param {!goog.asserts.AssertionError} e The exception to be handled.
84
- */
85
- goog.asserts.DEFAULT_ERROR_HANDLER = function(e) { throw e; };
86
-
87
-
88
- /**
89
- * The handler responsible for throwing or logging assertion errors.
90
- * @private {function(!goog.asserts.AssertionError)}
91
- */
92
- goog.asserts.errorHandler_ = goog.asserts.DEFAULT_ERROR_HANDLER;
93
-
94
-
95
- /**
96
- * Throws an exception with the given message and "Assertion failed" prefixed
97
- * onto it.
98
- * @param {string} defaultMessage The message to use if givenMessage is empty.
99
- * @param {Array<*>} defaultArgs The substitution arguments for defaultMessage.
100
- * @param {string|undefined} givenMessage Message supplied by the caller.
101
- * @param {Array<*>} givenArgs The substitution arguments for givenMessage.
102
- * @throws {goog.asserts.AssertionError} When the value is not a number.
103
- * @private
104
- */
105
- goog.asserts.doAssertFailure_ =
106
- function(defaultMessage, defaultArgs, givenMessage, givenArgs) {
107
- var message = 'Assertion failed';
108
- if (givenMessage) {
109
- message += ': ' + givenMessage;
110
- var args = givenArgs;
111
- } else if (defaultMessage) {
112
- message += ': ' + defaultMessage;
113
- args = defaultArgs;
114
- }
115
- // The '' + works around an Opera 10 bug in the unit tests. Without it,
116
- // a stack trace is added to var message above. With this, a stack trace is
117
- // not added until this line (it causes the extra garbage to be added after
118
- // the assertion message instead of in the middle of it).
119
- var e = new goog.asserts.AssertionError('' + message, args || []);
120
- goog.asserts.errorHandler_(e);
121
- };
122
-
123
-
124
- /**
125
- * Sets a custom error handler that can be used to customize the behavior of
126
- * assertion failures, for example by turning all assertion failures into log
127
- * messages.
128
- * @param {function(!goog.asserts.AssertionError)} errorHandler
129
- */
130
- goog.asserts.setErrorHandler = function(errorHandler) {
131
- if (goog.asserts.ENABLE_ASSERTS) {
132
- goog.asserts.errorHandler_ = errorHandler;
133
- }
134
- };
135
-
136
-
137
- /**
138
- * Checks if the condition evaluates to true if goog.asserts.ENABLE_ASSERTS is
139
- * true.
140
- * @template T
141
- * @param {T} condition The condition to check.
142
- * @param {string=} opt_message Error message in case of failure.
143
- * @param {...*} var_args The items to substitute into the failure message.
144
- * @return {T} The value of the condition.
145
- * @throws {goog.asserts.AssertionError} When the condition evaluates to false.
146
- */
147
- goog.asserts.assert = function(condition, opt_message, var_args) {
148
- if (goog.asserts.ENABLE_ASSERTS && !condition) {
149
- goog.asserts.doAssertFailure_('', null, opt_message,
150
- Array.prototype.slice.call(arguments, 2));
151
- }
152
- return condition;
153
- };
154
-
155
-
156
- /**
157
- * Fails if goog.asserts.ENABLE_ASSERTS is true. This function is useful in case
158
- * when we want to add a check in the unreachable area like switch-case
159
- * statement:
160
- *
161
- * <pre>
162
- * switch(type) {
163
- * case FOO: doSomething(); break;
164
- * case BAR: doSomethingElse(); break;
165
- * default: goog.assert.fail('Unrecognized type: ' + type);
166
- * // We have only 2 types - "default:" section is unreachable code.
167
- * }
168
- * </pre>
169
- *
170
- * @param {string=} opt_message Error message in case of failure.
171
- * @param {...*} var_args The items to substitute into the failure message.
172
- * @throws {goog.asserts.AssertionError} Failure.
173
- */
174
- goog.asserts.fail = function(opt_message, var_args) {
175
- if (goog.asserts.ENABLE_ASSERTS) {
176
- goog.asserts.errorHandler_(new goog.asserts.AssertionError(
177
- 'Failure' + (opt_message ? ': ' + opt_message : ''),
178
- Array.prototype.slice.call(arguments, 1)));
179
- }
180
- };
181
-
182
-
183
- /**
184
- * Checks if the value is a number if goog.asserts.ENABLE_ASSERTS is true.
185
- * @param {*} value The value to check.
186
- * @param {string=} opt_message Error message in case of failure.
187
- * @param {...*} var_args The items to substitute into the failure message.
188
- * @return {number} The value, guaranteed to be a number when asserts enabled.
189
- * @throws {goog.asserts.AssertionError} When the value is not a number.
190
- */
191
- goog.asserts.assertNumber = function(value, opt_message, var_args) {
192
- if (goog.asserts.ENABLE_ASSERTS && !goog.isNumber(value)) {
193
- goog.asserts.doAssertFailure_('Expected number but got %s: %s.',
194
- [goog.typeOf(value), value], opt_message,
195
- Array.prototype.slice.call(arguments, 2));
196
- }
197
- return /** @type {number} */ (value);
198
- };
199
-
200
-
201
- /**
202
- * Checks if the value is a string if goog.asserts.ENABLE_ASSERTS is true.
203
- * @param {*} value The value to check.
204
- * @param {string=} opt_message Error message in case of failure.
205
- * @param {...*} var_args The items to substitute into the failure message.
206
- * @return {string} The value, guaranteed to be a string when asserts enabled.
207
- * @throws {goog.asserts.AssertionError} When the value is not a string.
208
- */
209
- goog.asserts.assertString = function(value, opt_message, var_args) {
210
- if (goog.asserts.ENABLE_ASSERTS && !goog.isString(value)) {
211
- goog.asserts.doAssertFailure_('Expected string but got %s: %s.',
212
- [goog.typeOf(value), value], opt_message,
213
- Array.prototype.slice.call(arguments, 2));
214
- }
215
- return /** @type {string} */ (value);
216
- };
217
-
218
-
219
- /**
220
- * Checks if the value is a function if goog.asserts.ENABLE_ASSERTS is true.
221
- * @param {*} value The value to check.
222
- * @param {string=} opt_message Error message in case of failure.
223
- * @param {...*} var_args The items to substitute into the failure message.
224
- * @return {!Function} The value, guaranteed to be a function when asserts
225
- * enabled.
226
- * @throws {goog.asserts.AssertionError} When the value is not a function.
227
- */
228
- goog.asserts.assertFunction = function(value, opt_message, var_args) {
229
- if (goog.asserts.ENABLE_ASSERTS && !goog.isFunction(value)) {
230
- goog.asserts.doAssertFailure_('Expected function but got %s: %s.',
231
- [goog.typeOf(value), value], opt_message,
232
- Array.prototype.slice.call(arguments, 2));
233
- }
234
- return /** @type {!Function} */ (value);
235
- };
236
-
237
-
238
- /**
239
- * Checks if the value is an Object if goog.asserts.ENABLE_ASSERTS is true.
240
- * @param {*} value The value to check.
241
- * @param {string=} opt_message Error message in case of failure.
242
- * @param {...*} var_args The items to substitute into the failure message.
243
- * @return {!Object} The value, guaranteed to be a non-null object.
244
- * @throws {goog.asserts.AssertionError} When the value is not an object.
245
- */
246
- goog.asserts.assertObject = function(value, opt_message, var_args) {
247
- if (goog.asserts.ENABLE_ASSERTS && !goog.isObject(value)) {
248
- goog.asserts.doAssertFailure_('Expected object but got %s: %s.',
249
- [goog.typeOf(value), value],
250
- opt_message, Array.prototype.slice.call(arguments, 2));
251
- }
252
- return /** @type {!Object} */ (value);
253
- };
254
-
255
-
256
- /**
257
- * Checks if the value is an Array if goog.asserts.ENABLE_ASSERTS is true.
258
- * @param {*} value The value to check.
259
- * @param {string=} opt_message Error message in case of failure.
260
- * @param {...*} var_args The items to substitute into the failure message.
261
- * @return {!Array<?>} The value, guaranteed to be a non-null array.
262
- * @throws {goog.asserts.AssertionError} When the value is not an array.
263
- */
264
- goog.asserts.assertArray = function(value, opt_message, var_args) {
265
- if (goog.asserts.ENABLE_ASSERTS && !goog.isArray(value)) {
266
- goog.asserts.doAssertFailure_('Expected array but got %s: %s.',
267
- [goog.typeOf(value), value], opt_message,
268
- Array.prototype.slice.call(arguments, 2));
269
- }
270
- return /** @type {!Array<?>} */ (value);
271
- };
272
-
273
-
274
- /**
275
- * Checks if the value is a boolean if goog.asserts.ENABLE_ASSERTS is true.
276
- * @param {*} value The value to check.
277
- * @param {string=} opt_message Error message in case of failure.
278
- * @param {...*} var_args The items to substitute into the failure message.
279
- * @return {boolean} The value, guaranteed to be a boolean when asserts are
280
- * enabled.
281
- * @throws {goog.asserts.AssertionError} When the value is not a boolean.
282
- */
283
- goog.asserts.assertBoolean = function(value, opt_message, var_args) {
284
- if (goog.asserts.ENABLE_ASSERTS && !goog.isBoolean(value)) {
285
- goog.asserts.doAssertFailure_('Expected boolean but got %s: %s.',
286
- [goog.typeOf(value), value], opt_message,
287
- Array.prototype.slice.call(arguments, 2));
288
- }
289
- return /** @type {boolean} */ (value);
290
- };
291
-
292
-
293
- /**
294
- * Checks if the value is a DOM Element if goog.asserts.ENABLE_ASSERTS is true.
295
- * @param {*} value The value to check.
296
- * @param {string=} opt_message Error message in case of failure.
297
- * @param {...*} var_args The items to substitute into the failure message.
298
- * @return {!Element} The value, likely to be a DOM Element when asserts are
299
- * enabled.
300
- * @throws {goog.asserts.AssertionError} When the value is not an Element.
301
- */
302
- goog.asserts.assertElement = function(value, opt_message, var_args) {
303
- if (goog.asserts.ENABLE_ASSERTS && (!goog.isObject(value) ||
304
- value.nodeType != goog.dom.NodeType.ELEMENT)) {
305
- goog.asserts.doAssertFailure_('Expected Element but got %s: %s.',
306
- [goog.typeOf(value), value], opt_message,
307
- Array.prototype.slice.call(arguments, 2));
308
- }
309
- return /** @type {!Element} */ (value);
310
- };
311
-
312
-
313
- /**
314
- * Checks if the value is an instance of the user-defined type if
315
- * goog.asserts.ENABLE_ASSERTS is true.
316
- *
317
- * The compiler may tighten the type returned by this function.
318
- *
319
- * @param {?} value The value to check.
320
- * @param {function(new: T, ...)} type A user-defined constructor.
321
- * @param {string=} opt_message Error message in case of failure.
322
- * @param {...*} var_args The items to substitute into the failure message.
323
- * @throws {goog.asserts.AssertionError} When the value is not an instance of
324
- * type.
325
- * @return {T}
326
- * @template T
327
- */
328
- goog.asserts.assertInstanceof = function(value, type, opt_message, var_args) {
329
- if (goog.asserts.ENABLE_ASSERTS && !(value instanceof type)) {
330
- goog.asserts.doAssertFailure_('Expected instanceof %s but got %s.',
331
- [goog.asserts.getType_(type), goog.asserts.getType_(value)],
332
- opt_message, Array.prototype.slice.call(arguments, 3));
333
- }
334
- return value;
335
- };
336
-
337
-
338
- /**
339
- * Checks that no enumerable keys are present in Object.prototype. Such keys
340
- * would break most code that use {@code for (var ... in ...)} loops.
341
- */
342
- goog.asserts.assertObjectPrototypeIsIntact = function() {
343
- for (var key in Object.prototype) {
344
- goog.asserts.fail(key + ' should not be enumerable in Object.prototype.');
345
- }
346
- };
347
-
348
-
349
- /**
350
- * Returns the type of a value. If a constructor is passed, and a suitable
351
- * string cannot be found, 'unknown type name' will be returned.
352
- * @param {*} value A constructor, object, or primitive.
353
- * @return {string} The best display name for the value, or 'unknown type name'.
354
- * @private
355
- */
356
- goog.asserts.getType_ = function(value) {
357
- if (value instanceof Function) {
358
- return value.displayName || value.name || 'unknown type name';
359
- } else if (value instanceof Object) {
360
- return value.constructor.displayName || value.constructor.name ||
361
- Object.prototype.toString.call(value);
362
- } else {
363
- return value === null ? 'null' : typeof value;
364
- }
365
- };
@@ -1,88 +0,0 @@
1
- // Copyright 2015 The Closure Library Authors. All Rights Reserved.
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS-IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
-
15
- /**
16
- * @fileoverview Simple freelist.
17
- *
18
- * An anterative to goog.structs.SimplePool, it imposes the requirement that the
19
- * objects in the list contain a "next" property that can be used to maintain
20
- * the pool.
21
- */
22
-
23
- goog.provide('goog.async.FreeList');
24
-
25
-
26
- /**
27
- * @template ITEM
28
- */
29
- goog.async.FreeList = goog.defineClass(null, {
30
- /**
31
- * @param {function():ITEM} create
32
- * @param {function(ITEM):void} reset
33
- * @param {number} limit
34
- */
35
- constructor: function(create, reset, limit) {
36
- /** @const {number} */
37
- this.limit_ = limit;
38
- /** @const {function()} */
39
- this.create_ = create;
40
- /** @const {function(ITEM):void} */
41
- this.reset_ = reset;
42
-
43
- /** @type {number} */
44
- this.occupants_ = 0;
45
- /** @type {ITEM} */
46
- this.head_ = null;
47
- },
48
-
49
- /**
50
- * @return {ITEM}
51
- */
52
- get: function() {
53
- var item;
54
- if (this.occupants_ > 0) {
55
- this.occupants_--;
56
- item = this.head_;
57
- this.head_ = item.next;
58
- item.next = null;
59
- } else {
60
- item = this.create_();
61
- }
62
- return item;
63
- },
64
-
65
- /**
66
- * @param {ITEM} item An item available for possible future reuse.
67
- */
68
- put: function(item) {
69
- this.reset_(item);
70
- if (this.occupants_ < this.limit_) {
71
- this.occupants_++;
72
- item.next = this.head_;
73
- this.head_ = item;
74
- }
75
- },
76
-
77
- /**
78
- * Visible for testing.
79
- * @package
80
- * @return {number}
81
- */
82
- occupants: function() {
83
- return this.occupants_;
84
- }
85
- });
86
-
87
-
88
-
@@ -1,241 +0,0 @@
1
- // Copyright 2013 The Closure Library Authors. All Rights Reserved.
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS-IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
-
15
- /**
16
- * @fileoverview Provides a function to schedule running a function as soon
17
- * as possible after the current JS execution stops and yields to the event
18
- * loop.
19
- *
20
- */
21
-
22
- goog.provide('goog.async.nextTick');
23
- goog.provide('goog.async.throwException');
24
-
25
- goog.require('goog.debug.entryPointRegistry');
26
- goog.require('goog.dom.TagName');
27
- goog.require('goog.functions');
28
- goog.require('goog.labs.userAgent.browser');
29
- goog.require('goog.labs.userAgent.engine');
30
-
31
-
32
- /**
33
- * Throw an item without interrupting the current execution context. For
34
- * example, if processing a group of items in a loop, sometimes it is useful
35
- * to report an error while still allowing the rest of the batch to be
36
- * processed.
37
- * @param {*} exception
38
- */
39
- goog.async.throwException = function(exception) {
40
- // Each throw needs to be in its own context.
41
- goog.global.setTimeout(function() { throw exception; }, 0);
42
- };
43
-
44
-
45
- /**
46
- * Fires the provided callbacks as soon as possible after the current JS
47
- * execution context. setTimeout(…, 0) takes at least 4ms when called from
48
- * within another setTimeout(…, 0) for legacy reasons.
49
- *
50
- * This will not schedule the callback as a microtask (i.e. a task that can
51
- * preempt user input or networking callbacks). It is meant to emulate what
52
- * setTimeout(_, 0) would do if it were not throttled. If you desire microtask
53
- * behavior, use {@see goog.Promise} instead.
54
- *
55
- * @param {function(this:SCOPE)} callback Callback function to fire as soon as
56
- * possible.
57
- * @param {SCOPE=} opt_context Object in whose scope to call the listener.
58
- * @param {boolean=} opt_useSetImmediate Avoid the IE workaround that
59
- * ensures correctness at the cost of speed. See comments for details.
60
- * @template SCOPE
61
- */
62
- goog.async.nextTick = function(callback, opt_context, opt_useSetImmediate) {
63
- var cb = callback;
64
- if (opt_context) {
65
- cb = goog.bind(callback, opt_context);
66
- }
67
- cb = goog.async.nextTick.wrapCallback_(cb);
68
- // window.setImmediate was introduced and currently only supported by IE10+,
69
- // but due to a bug in the implementation it is not guaranteed that
70
- // setImmediate is faster than setTimeout nor that setImmediate N is before
71
- // setImmediate N+1. That is why we do not use the native version if
72
- // available. We do, however, call setImmediate if it is a normal function
73
- // because that indicates that it has been replaced by goog.testing.MockClock
74
- // which we do want to support.
75
- // See
76
- // http://connect.microsoft.com/IE/feedback/details/801823/setimmediate-and-messagechannel-are-broken-in-ie10
77
- //
78
- // Note we do allow callers to also request setImmediate if they are willing
79
- // to accept the possible tradeoffs of incorrectness in exchange for speed.
80
- // The IE fallback of readystate change is much slower.
81
- if (goog.isFunction(goog.global.setImmediate) &&
82
- // Opt in.
83
- (opt_useSetImmediate ||
84
- // or it isn't a browser or the environment is weird
85
- !goog.global.Window || !goog.global.Window.prototype ||
86
- // or something redefined setImmediate in which case we (YOLO) decide
87
- // to use it (This is so that we use the mockClock setImmediate. sigh).
88
- goog.global.Window.prototype.setImmediate != goog.global.setImmediate)) {
89
- goog.global.setImmediate(cb);
90
- return;
91
- }
92
-
93
- // Look for and cache the custom fallback version of setImmediate.
94
- if (!goog.async.nextTick.setImmediate_) {
95
- goog.async.nextTick.setImmediate_ =
96
- goog.async.nextTick.getSetImmediateEmulator_();
97
- }
98
- goog.async.nextTick.setImmediate_(cb);
99
- };
100
-
101
-
102
- /**
103
- * Cache for the setImmediate implementation.
104
- * @type {function(function())}
105
- * @private
106
- */
107
- goog.async.nextTick.setImmediate_;
108
-
109
-
110
- /**
111
- * Determines the best possible implementation to run a function as soon as
112
- * the JS event loop is idle.
113
- * @return {function(function())} The "setImmediate" implementation.
114
- * @private
115
- */
116
- goog.async.nextTick.getSetImmediateEmulator_ = function() {
117
- // Create a private message channel and use it to postMessage empty messages
118
- // to ourselves.
119
- var Channel = goog.global['MessageChannel'];
120
- // If MessageChannel is not available and we are in a browser, implement
121
- // an iframe based polyfill in browsers that have postMessage and
122
- // document.addEventListener. The latter excludes IE8 because it has a
123
- // synchronous postMessage implementation.
124
- if (typeof Channel === 'undefined' && typeof window !== 'undefined' &&
125
- window.postMessage && window.addEventListener &&
126
- // Presto (The old pre-blink Opera engine) has problems with iframes
127
- // and contentWindow.
128
- !goog.labs.userAgent.engine.isPresto()) {
129
- /** @constructor */
130
- Channel = function() {
131
- // Make an empty, invisible iframe.
132
- var iframe = document.createElement(goog.dom.TagName.IFRAME);
133
- iframe.style.display = 'none';
134
- iframe.src = '';
135
- document.documentElement.appendChild(iframe);
136
- var win = iframe.contentWindow;
137
- var doc = win.document;
138
- doc.open();
139
- doc.write('');
140
- doc.close();
141
- // Do not post anything sensitive over this channel, as the workaround for
142
- // pages with file: origin could allow that information to be modified or
143
- // intercepted.
144
- var message = 'callImmediate' + Math.random();
145
- // The same origin policy rejects attempts to postMessage from file: urls
146
- // unless the origin is '*'.
147
- // TODO(b/16335441): Use '*' origin for data: and other similar protocols.
148
- var origin = win.location.protocol == 'file:' ?
149
- '*' : win.location.protocol + '//' + win.location.host;
150
- var onmessage = goog.bind(function(e) {
151
- // Validate origin and message to make sure that this message was
152
- // intended for us. If the origin is set to '*' (see above) only the
153
- // message needs to match since, for example, '*' != 'file://'. Allowing
154
- // the wildcard is ok, as we are not concerned with security here.
155
- if ((origin != '*' && e.origin != origin) || e.data != message) {
156
- return;
157
- }
158
- this['port1'].onmessage();
159
- }, this);
160
- win.addEventListener('message', onmessage, false);
161
- this['port1'] = {};
162
- this['port2'] = {
163
- postMessage: function() {
164
- win.postMessage(message, origin);
165
- }
166
- };
167
- };
168
- }
169
- if (typeof Channel !== 'undefined' &&
170
- (!goog.labs.userAgent.browser.isIE())) {
171
- // Exclude all of IE due to
172
- // http://codeforhire.com/2013/09/21/setimmediate-and-messagechannel-broken-on-internet-explorer-10/
173
- // which allows starving postMessage with a busy setTimeout loop.
174
- // This currently affects IE10 and IE11 which would otherwise be able
175
- // to use the postMessage based fallbacks.
176
- var channel = new Channel();
177
- // Use a fifo linked list to call callbacks in the right order.
178
- var head = {};
179
- var tail = head;
180
- channel['port1'].onmessage = function() {
181
- if (goog.isDef(head.next)) {
182
- head = head.next;
183
- var cb = head.cb;
184
- head.cb = null;
185
- cb();
186
- }
187
- };
188
- return function(cb) {
189
- tail.next = {
190
- cb: cb
191
- };
192
- tail = tail.next;
193
- channel['port2'].postMessage(0);
194
- };
195
- }
196
- // Implementation for IE6+: Script elements fire an asynchronous
197
- // onreadystatechange event when inserted into the DOM.
198
- if (typeof document !== 'undefined' && 'onreadystatechange' in
199
- document.createElement(goog.dom.TagName.SCRIPT)) {
200
- return function(cb) {
201
- var script = document.createElement(goog.dom.TagName.SCRIPT);
202
- script.onreadystatechange = function() {
203
- // Clean up and call the callback.
204
- script.onreadystatechange = null;
205
- script.parentNode.removeChild(script);
206
- script = null;
207
- cb();
208
- cb = null;
209
- };
210
- document.documentElement.appendChild(script);
211
- };
212
- }
213
- // Fall back to setTimeout with 0. In browsers this creates a delay of 5ms
214
- // or more.
215
- return function(cb) {
216
- goog.global.setTimeout(cb, 0);
217
- };
218
- };
219
-
220
-
221
- /**
222
- * Helper function that is overrided to protect callbacks with entry point
223
- * monitor if the application monitors entry points.
224
- * @param {function()} callback Callback function to fire as soon as possible.
225
- * @return {function()} The wrapped callback.
226
- * @private
227
- */
228
- goog.async.nextTick.wrapCallback_ = goog.functions.identity;
229
-
230
-
231
- // Register the callback function as an entry point, so that it can be
232
- // monitored for exception handling, etc. This has to be done in this file
233
- // since it requires special code to handle all browsers.
234
- goog.debug.entryPointRegistry.register(
235
- /**
236
- * @param {function(!Function): !Function} transformer The transforming
237
- * function.
238
- */
239
- function(transformer) {
240
- goog.async.nextTick.wrapCallback_ = transformer;
241
- });