selenium-webdriver 2.47.0 → 2.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (529) hide show
  1. package/CHANGES.md +96 -0
  2. package/NOTICE +1 -1
  3. package/README.md +57 -6
  4. package/builder.js +375 -358
  5. package/chrome.js +549 -586
  6. package/edge.js +378 -0
  7. package/error.js +597 -5
  8. package/example/google_search_generator.js +2 -4
  9. package/example/logging.js +6 -2
  10. package/executors.js +11 -27
  11. package/firefox/binary.js +80 -114
  12. package/firefox/extension.js +10 -19
  13. package/firefox/index.js +175 -171
  14. package/firefox/profile.js +221 -239
  15. package/http/index.js +396 -77
  16. package/http/util.js +35 -35
  17. package/ie.js +288 -309
  18. package/index.js +34 -125
  19. package/io/exec.js +58 -39
  20. package/io/index.js +54 -48
  21. package/lib/actions.js +594 -0
  22. package/lib/by.js +276 -0
  23. package/lib/capabilities.js +404 -0
  24. package/lib/{webdriver/command.js → command.js} +89 -72
  25. package/lib/{webdriver/button.js → devmode.js} +13 -8
  26. package/lib/events.js +210 -0
  27. package/lib/firefox/amd64/libnoblur64.so +0 -0
  28. package/lib/firefox/i386/libnoblur.so +0 -0
  29. package/lib/firefox/webdriver.json +6 -1
  30. package/lib/firefox/webdriver.xpi +0 -0
  31. package/lib/{webdriver/key.js → input.js} +82 -2
  32. package/lib/logging.js +668 -0
  33. package/lib/promise.js +3093 -0
  34. package/lib/safari/client.js +697 -659
  35. package/lib/session.js +79 -0
  36. package/{test/promise_aplus_test.js → lib/symbols.js} +15 -25
  37. package/lib/test/build.js +4 -4
  38. package/lib/test/data/click_tests/disappearing_element.html +62 -0
  39. package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
  40. package/lib/test/data/click_tests/overlapping_elements.html +70 -0
  41. package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
  42. package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
  43. package/lib/test/data/readOnlyPage.html +3 -1
  44. package/lib/test/data/selectPage.html +18 -2
  45. package/lib/test/data/simpleTest.html +1 -0
  46. package/lib/test/fileserver.js +3 -4
  47. package/lib/test/index.js +13 -4
  48. package/lib/test/resources.js +1 -1
  49. package/lib/until.js +428 -0
  50. package/lib/webdriver.js +2351 -0
  51. package/net/portprober.js +15 -11
  52. package/opera.js +295 -314
  53. package/package.json +6 -5
  54. package/phantomjs.js +135 -140
  55. package/proxy.js +6 -4
  56. package/remote/index.js +234 -219
  57. package/safari.js +319 -310
  58. package/test/chrome/options_test.js +11 -9
  59. package/test/element_finding_test.js +51 -13
  60. package/test/error_test.js +163 -0
  61. package/test/execute_script_test.js +1 -1
  62. package/test/firefox/firefox_test.js +24 -0
  63. package/test/http/http_test.js +354 -43
  64. package/test/http/util_test.js +25 -23
  65. package/test/io_test.js +6 -1
  66. package/test/lib/by_test.js +127 -0
  67. package/test/lib/capabilities_test.js +84 -0
  68. package/test/lib/events_test.js +177 -0
  69. package/test/lib/logging_test.js +272 -0
  70. package/test/lib/promise_aplus_test.js +74 -0
  71. package/test/lib/promise_error_test.js +808 -0
  72. package/test/lib/promise_flow_test.js +2282 -0
  73. package/test/lib/promise_generator_test.js +308 -0
  74. package/test/lib/promise_test.js +996 -0
  75. package/test/lib/testutil.js +90 -0
  76. package/test/lib/until_test.js +436 -0
  77. package/test/lib/webdriver_test.js +2207 -0
  78. package/test/page_loading_test.js +7 -9
  79. package/test/stale_element_test.js +2 -2
  80. package/test/testing/assert_test.js +374 -0
  81. package/test/testing/index_test.js +9 -11
  82. package/testing/assert.js +334 -17
  83. package/testing/index.js +10 -0
  84. package/_base.js +0 -200
  85. package/docs/Changes.html +0 -317
  86. package/docs/class_bot_Error.html +0 -15
  87. package/docs/class_webdriver_ActionSequence.html +0 -115
  88. package/docs/class_webdriver_Alert.html +0 -24
  89. package/docs/class_webdriver_AlertPromise.html +0 -91
  90. package/docs/class_webdriver_Capabilities.html +0 -60
  91. package/docs/class_webdriver_Command.html +0 -15
  92. package/docs/class_webdriver_EventEmitter.html +0 -35
  93. package/docs/class_webdriver_FileDetector.html +0 -21
  94. package/docs/class_webdriver_Locator.html +0 -12
  95. package/docs/class_webdriver_Serializable.html +0 -9
  96. package/docs/class_webdriver_Session.html +0 -13
  97. package/docs/class_webdriver_TouchSequence.html +0 -49
  98. package/docs/class_webdriver_UnhandledAlertError.html +0 -18
  99. package/docs/class_webdriver_WebDriver.html +0 -313
  100. package/docs/class_webdriver_WebDriver_Logs.html +0 -15
  101. package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
  102. package/docs/class_webdriver_WebDriver_Options.html +0 -41
  103. package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
  104. package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
  105. package/docs/class_webdriver_WebDriver_Window.html +0 -27
  106. package/docs/class_webdriver_WebElement.html +0 -216
  107. package/docs/class_webdriver_WebElementPromise.html +0 -266
  108. package/docs/class_webdriver_http_Executor.html +0 -22
  109. package/docs/class_webdriver_http_Request.html +0 -12
  110. package/docs/class_webdriver_http_Response.html +0 -13
  111. package/docs/class_webdriver_logging_Entry.html +0 -15
  112. package/docs/class_webdriver_logging_Level.html +0 -55
  113. package/docs/class_webdriver_logging_LogRecord.html +0 -45
  114. package/docs/class_webdriver_logging_Logger.html +0 -119
  115. package/docs/class_webdriver_logging_Preferences.html +0 -8
  116. package/docs/class_webdriver_promise_CancellationError.html +0 -18
  117. package/docs/class_webdriver_promise_ControlFlow.html +0 -109
  118. package/docs/class_webdriver_promise_Deferred.html +0 -84
  119. package/docs/class_webdriver_promise_Promise.html +0 -74
  120. package/docs/class_webdriver_stacktrace_Frame.html +0 -20
  121. package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
  122. package/docs/class_webdriver_testing_Assertion.html +0 -99
  123. package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
  124. package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
  125. package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
  126. package/docs/class_webdriver_until_Condition.html +0 -7
  127. package/docs/dossier.css +0 -1
  128. package/docs/dossier.js +0 -86
  129. package/docs/enum_bot_ErrorCode.html +0 -3
  130. package/docs/enum_bot_Error_State.html +0 -2
  131. package/docs/enum_webdriver_Browser.html +0 -2
  132. package/docs/enum_webdriver_Button.html +0 -2
  133. package/docs/enum_webdriver_Capability.html +0 -33
  134. package/docs/enum_webdriver_CommandName.html +0 -3
  135. package/docs/enum_webdriver_Key.html +0 -12
  136. package/docs/enum_webdriver_logging_Type.html +0 -6
  137. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
  138. package/docs/index.html +0 -123
  139. package/docs/interface_webdriver_CommandExecutor.html +0 -9
  140. package/docs/interface_webdriver_http_Client.html +0 -10
  141. package/docs/interface_webdriver_promise_Thenable.html +0 -77
  142. package/docs/module_selenium-webdriver.html +0 -23
  143. package/docs/module_selenium-webdriver__base.html +0 -23
  144. package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
  145. package/docs/module_selenium-webdriver_builder.html +0 -2
  146. package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
  147. package/docs/module_selenium-webdriver_chrome.html +0 -90
  148. package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
  149. package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
  150. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
  151. package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
  152. package/docs/module_selenium-webdriver_class_Builder.html +0 -138
  153. package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
  154. package/docs/module_selenium-webdriver_class_Command.html +0 -15
  155. package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
  156. package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
  157. package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
  158. package/docs/module_selenium-webdriver_class_Session.html +0 -13
  159. package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
  160. package/docs/module_selenium-webdriver_class_WebElement.html +0 -216
  161. package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -266
  162. package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
  163. package/docs/module_selenium-webdriver_enum_Button.html +0 -2
  164. package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
  165. package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
  166. package/docs/module_selenium-webdriver_enum_Key.html +0 -12
  167. package/docs/module_selenium-webdriver_error.html +0 -4
  168. package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
  169. package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
  170. package/docs/module_selenium-webdriver_executors.html +0 -10
  171. package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
  172. package/docs/module_selenium-webdriver_firefox.html +0 -67
  173. package/docs/module_selenium-webdriver_firefox_binary.html +0 -4
  174. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -21
  175. package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -21
  176. package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
  177. package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
  178. package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
  179. package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
  180. package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
  181. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
  182. package/docs/module_selenium-webdriver_http.html +0 -9
  183. package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
  184. package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
  185. package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
  186. package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
  187. package/docs/module_selenium-webdriver_http_util.html +0 -17
  188. package/docs/module_selenium-webdriver_ie.html +0 -11
  189. package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
  190. package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
  191. package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
  192. package/docs/module_selenium-webdriver_io.html +0 -37
  193. package/docs/module_selenium-webdriver_io_exec.html +0 -6
  194. package/docs/module_selenium-webdriver_namespace_By.html +0 -56
  195. package/docs/module_selenium-webdriver_namespace_error.html +0 -4
  196. package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
  197. package/docs/module_selenium-webdriver_namespace_promise.html +0 -162
  198. package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
  199. package/docs/module_selenium-webdriver_namespace_until.html +0 -82
  200. package/docs/module_selenium-webdriver_net.html +0 -7
  201. package/docs/module_selenium-webdriver_net_portprober.html +0 -12
  202. package/docs/module_selenium-webdriver_opera.html +0 -62
  203. package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
  204. package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
  205. package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
  206. package/docs/module_selenium-webdriver_phantomjs.html +0 -2
  207. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
  208. package/docs/module_selenium-webdriver_proxy.html +0 -28
  209. package/docs/module_selenium-webdriver_remote.html +0 -8
  210. package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
  211. package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
  212. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -40
  213. package/docs/module_selenium-webdriver_safari.html +0 -9
  214. package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
  215. package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
  216. package/docs/module_selenium-webdriver_testing.html +0 -74
  217. package/docs/module_selenium-webdriver_testing_assert.html +0 -9
  218. package/docs/namespace_bot.html +0 -4
  219. package/docs/namespace_bot_json.html +0 -20
  220. package/docs/namespace_bot_response.html +0 -18
  221. package/docs/namespace_bot_userAgent.html +0 -33
  222. package/docs/namespace_webdriver.html +0 -30
  223. package/docs/namespace_webdriver_By.html +0 -56
  224. package/docs/namespace_webdriver_http.html +0 -6
  225. package/docs/namespace_webdriver_logging.html +0 -70
  226. package/docs/namespace_webdriver_promise.html +0 -165
  227. package/docs/namespace_webdriver_stacktrace.html +0 -17
  228. package/docs/namespace_webdriver_testing.html +0 -7
  229. package/docs/namespace_webdriver_testing_assert.html +0 -9
  230. package/docs/namespace_webdriver_testing_asserts.html +0 -18
  231. package/docs/namespace_webdriver_until.html +0 -82
  232. package/docs/source/_base.js.src.html +0 -1
  233. package/docs/source/builder.js.src.html +0 -1
  234. package/docs/source/chrome.js.src.html +0 -1
  235. package/docs/source/error.js.src.html +0 -1
  236. package/docs/source/executors.js.src.html +0 -1
  237. package/docs/source/firefox/binary.js.src.html +0 -1
  238. package/docs/source/firefox/extension.js.src.html +0 -1
  239. package/docs/source/firefox/index.js.src.html +0 -1
  240. package/docs/source/firefox/profile.js.src.html +0 -1
  241. package/docs/source/http/index.js.src.html +0 -1
  242. package/docs/source/http/util.js.src.html +0 -1
  243. package/docs/source/ie.js.src.html +0 -1
  244. package/docs/source/index.js.src.html +0 -1
  245. package/docs/source/io/exec.js.src.html +0 -1
  246. package/docs/source/io/index.js.src.html +0 -1
  247. package/docs/source/lib/atoms/error.js.src.html +0 -1
  248. package/docs/source/lib/atoms/json.js.src.html +0 -1
  249. package/docs/source/lib/atoms/response.js.src.html +0 -1
  250. package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
  251. package/docs/source/lib/goog/array/array.js.src.html +0 -1
  252. package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
  253. package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
  254. package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
  255. package/docs/source/lib/goog/async/run.js.src.html +0 -1
  256. package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
  257. package/docs/source/lib/goog/base.js.src.html +0 -1
  258. package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
  259. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
  260. package/docs/source/lib/goog/debug/error.js.src.html +0 -1
  261. package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
  262. package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
  263. package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
  264. package/docs/source/lib/goog/deps.js.src.html +0 -1
  265. package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
  266. package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
  267. package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
  268. package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
  269. package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
  270. package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
  271. package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
  272. package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
  273. package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
  274. package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
  275. package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
  276. package/docs/source/lib/goog/events/event.js.src.html +0 -1
  277. package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
  278. package/docs/source/lib/goog/events/events.js.src.html +0 -1
  279. package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
  280. package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
  281. package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
  282. package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
  283. package/docs/source/lib/goog/events/listener.js.src.html +0 -1
  284. package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
  285. package/docs/source/lib/goog/fs/url.js.src.html +0 -1
  286. package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
  287. package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
  288. package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
  289. package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
  290. package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
  291. package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
  292. package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
  293. package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
  294. package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
  295. package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
  296. package/docs/source/lib/goog/json/json.js.src.html +0 -1
  297. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
  298. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
  299. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
  300. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
  301. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
  302. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
  303. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
  304. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
  305. package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
  306. package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
  307. package/docs/source/lib/goog/math/box.js.src.html +0 -1
  308. package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
  309. package/docs/source/lib/goog/math/math.js.src.html +0 -1
  310. package/docs/source/lib/goog/math/rect.js.src.html +0 -1
  311. package/docs/source/lib/goog/math/size.js.src.html +0 -1
  312. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
  313. package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
  314. package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
  315. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
  316. package/docs/source/lib/goog/object/object.js.src.html +0 -1
  317. package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
  318. package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
  319. package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
  320. package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
  321. package/docs/source/lib/goog/string/const.js.src.html +0 -1
  322. package/docs/source/lib/goog/string/string.js.src.html +0 -1
  323. package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
  324. package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
  325. package/docs/source/lib/goog/structs/map.js.src.html +0 -1
  326. package/docs/source/lib/goog/structs/set.js.src.html +0 -1
  327. package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
  328. package/docs/source/lib/goog/style/style.js.src.html +0 -1
  329. package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
  330. package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
  331. package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
  332. package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
  333. package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
  334. package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
  335. package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
  336. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
  337. package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
  338. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
  339. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
  340. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
  341. package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
  342. package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
  343. package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
  344. package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
  345. package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
  346. package/docs/source/lib/goog/testing/watchers.js.src.html +0 -1
  347. package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
  348. package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
  349. package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
  350. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
  351. package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
  352. package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
  353. package/docs/source/lib/webdriver/button.js.src.html +0 -1
  354. package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
  355. package/docs/source/lib/webdriver/command.js.src.html +0 -1
  356. package/docs/source/lib/webdriver/events.js.src.html +0 -1
  357. package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
  358. package/docs/source/lib/webdriver/key.js.src.html +0 -1
  359. package/docs/source/lib/webdriver/locators.js.src.html +0 -1
  360. package/docs/source/lib/webdriver/logging.js.src.html +0 -1
  361. package/docs/source/lib/webdriver/promise.js.src.html +0 -1
  362. package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
  363. package/docs/source/lib/webdriver/session.js.src.html +0 -1
  364. package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
  365. package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
  366. package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
  367. package/docs/source/lib/webdriver/until.js.src.html +0 -1
  368. package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
  369. package/docs/source/net/index.js.src.html +0 -1
  370. package/docs/source/net/portprober.js.src.html +0 -1
  371. package/docs/source/opera.js.src.html +0 -1
  372. package/docs/source/phantomjs.js.src.html +0 -1
  373. package/docs/source/proxy.js.src.html +0 -1
  374. package/docs/source/remote/index.js.src.html +0 -1
  375. package/docs/source/safari.js.src.html +0 -1
  376. package/docs/source/testing/assert.js.src.html +0 -1
  377. package/docs/source/testing/index.js.src.html +0 -1
  378. package/docs/types.js +0 -1
  379. package/lib/atoms/error.js +0 -202
  380. package/lib/atoms/json.js +0 -80
  381. package/lib/atoms/response.js +0 -110
  382. package/lib/atoms/userAgent.js +0 -257
  383. package/lib/goog/LICENSE +0 -176
  384. package/lib/goog/array/array.js +0 -1655
  385. package/lib/goog/asserts/asserts.js +0 -365
  386. package/lib/goog/async/freelist.js +0 -88
  387. package/lib/goog/async/nexttick.js +0 -241
  388. package/lib/goog/async/run.js +0 -139
  389. package/lib/goog/async/workqueue.js +0 -139
  390. package/lib/goog/base.js +0 -2547
  391. package/lib/goog/debug/debug.js +0 -653
  392. package/lib/goog/debug/entrypointregistry.js +0 -158
  393. package/lib/goog/debug/error.js +0 -63
  394. package/lib/goog/debug/logbuffer.js +0 -148
  395. package/lib/goog/debug/logger.js +0 -873
  396. package/lib/goog/debug/logrecord.js +0 -242
  397. package/lib/goog/deps.js +0 -151
  398. package/lib/goog/disposable/disposable.js +0 -307
  399. package/lib/goog/disposable/idisposable.js +0 -45
  400. package/lib/goog/dom/browserfeature.js +0 -72
  401. package/lib/goog/dom/dom.js +0 -2995
  402. package/lib/goog/dom/nodetype.js +0 -48
  403. package/lib/goog/dom/safe.js +0 -347
  404. package/lib/goog/dom/tagname.js +0 -160
  405. package/lib/goog/dom/tags.js +0 -42
  406. package/lib/goog/dom/vendor.js +0 -96
  407. package/lib/goog/events/browserevent.js +0 -386
  408. package/lib/goog/events/browserfeature.js +0 -85
  409. package/lib/goog/events/event.js +0 -143
  410. package/lib/goog/events/eventid.js +0 -47
  411. package/lib/goog/events/events.js +0 -984
  412. package/lib/goog/events/eventtarget.js +0 -394
  413. package/lib/goog/events/eventtype.js +0 -233
  414. package/lib/goog/events/keycodes.js +0 -420
  415. package/lib/goog/events/listenable.js +0 -335
  416. package/lib/goog/events/listener.js +0 -131
  417. package/lib/goog/events/listenermap.js +0 -308
  418. package/lib/goog/fs/url.js +0 -105
  419. package/lib/goog/functions/functions.js +0 -332
  420. package/lib/goog/html/safehtml.js +0 -756
  421. package/lib/goog/html/safescript.js +0 -234
  422. package/lib/goog/html/safestyle.js +0 -442
  423. package/lib/goog/html/safestylesheet.js +0 -276
  424. package/lib/goog/html/safeurl.js +0 -431
  425. package/lib/goog/html/trustedresourceurl.js +0 -224
  426. package/lib/goog/html/uncheckedconversions.js +0 -231
  427. package/lib/goog/i18n/bidi.js +0 -908
  428. package/lib/goog/iter/iter.js +0 -1305
  429. package/lib/goog/json/json.js +0 -365
  430. package/lib/goog/labs/testing/assertthat.js +0 -58
  431. package/lib/goog/labs/testing/logicmatcher.js +0 -212
  432. package/lib/goog/labs/testing/matcher.js +0 -80
  433. package/lib/goog/labs/testing/numbermatcher.js +0 -346
  434. package/lib/goog/labs/testing/objectmatcher.js +0 -317
  435. package/lib/goog/labs/testing/stringmatcher.js +0 -415
  436. package/lib/goog/labs/useragent/browser.js +0 -327
  437. package/lib/goog/labs/useragent/engine.js +0 -160
  438. package/lib/goog/labs/useragent/platform.js +0 -160
  439. package/lib/goog/labs/useragent/util.js +0 -148
  440. package/lib/goog/math/box.js +0 -389
  441. package/lib/goog/math/coordinate.js +0 -268
  442. package/lib/goog/math/math.js +0 -451
  443. package/lib/goog/math/rect.js +0 -476
  444. package/lib/goog/math/size.js +0 -227
  445. package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
  446. package/lib/goog/net/xhrlike.js +0 -124
  447. package/lib/goog/net/xmlhttp.js +0 -246
  448. package/lib/goog/net/xmlhttpfactory.js +0 -67
  449. package/lib/goog/object/object.js +0 -686
  450. package/lib/goog/promise/promise.js +0 -1310
  451. package/lib/goog/promise/resolver.js +0 -48
  452. package/lib/goog/promise/thenable.js +0 -126
  453. package/lib/goog/reflect/reflect.js +0 -78
  454. package/lib/goog/string/const.js +0 -182
  455. package/lib/goog/string/string.js +0 -1565
  456. package/lib/goog/string/typedstring.js +0 -48
  457. package/lib/goog/structs/collection.js +0 -56
  458. package/lib/goog/structs/map.js +0 -456
  459. package/lib/goog/structs/set.js +0 -279
  460. package/lib/goog/structs/structs.js +0 -354
  461. package/lib/goog/style/style.js +0 -2054
  462. package/lib/goog/testing/asserts.js +0 -1265
  463. package/lib/goog/testing/events/events.js +0 -727
  464. package/lib/goog/testing/functionmock.js +0 -176
  465. package/lib/goog/testing/jsunit.js +0 -162
  466. package/lib/goog/testing/loosemock.js +0 -242
  467. package/lib/goog/testing/mock.js +0 -645
  468. package/lib/goog/testing/mockclock.js +0 -617
  469. package/lib/goog/testing/mockcontrol.js +0 -220
  470. package/lib/goog/testing/mockinterface.js +0 -45
  471. package/lib/goog/testing/mockmatchers.js +0 -400
  472. package/lib/goog/testing/objectpropertystring.js +0 -68
  473. package/lib/goog/testing/propertyreplacer.js +0 -245
  474. package/lib/goog/testing/recordfunction.js +0 -215
  475. package/lib/goog/testing/stacktrace.js +0 -594
  476. package/lib/goog/testing/strictmock.js +0 -130
  477. package/lib/goog/testing/testcase.js +0 -1569
  478. package/lib/goog/testing/testrunner.js +0 -440
  479. package/lib/goog/testing/watchers.js +0 -46
  480. package/lib/goog/uri/uri.js +0 -1507
  481. package/lib/goog/uri/utils.js +0 -1116
  482. package/lib/goog/useragent/product.js +0 -175
  483. package/lib/goog/useragent/product_isversion.js +0 -143
  484. package/lib/goog/useragent/useragent.js +0 -538
  485. package/lib/webdriver/actionsequence.js +0 -356
  486. package/lib/webdriver/builder.js +0 -208
  487. package/lib/webdriver/capabilities.js +0 -411
  488. package/lib/webdriver/events.js +0 -179
  489. package/lib/webdriver/firefoxdomexecutor.js +0 -175
  490. package/lib/webdriver/http/corsclient.js +0 -133
  491. package/lib/webdriver/http/http.js +0 -523
  492. package/lib/webdriver/http/xhrclient.js +0 -67
  493. package/lib/webdriver/locators.js +0 -257
  494. package/lib/webdriver/logging.js +0 -347
  495. package/lib/webdriver/promise.js +0 -2609
  496. package/lib/webdriver/serializable.js +0 -41
  497. package/lib/webdriver/session.js +0 -74
  498. package/lib/webdriver/stacktrace.js +0 -619
  499. package/lib/webdriver/test/builder_test.js +0 -53
  500. package/lib/webdriver/test/capabilities_test.js +0 -72
  501. package/lib/webdriver/test/events_test.js +0 -203
  502. package/lib/webdriver/test/http/corsclient_test.js +0 -151
  503. package/lib/webdriver/test/http/http_test.js +0 -428
  504. package/lib/webdriver/test/http/xhrclient_test.js +0 -196
  505. package/lib/webdriver/test/locators_test.js +0 -59
  506. package/lib/webdriver/test/logging_test.js +0 -85
  507. package/lib/webdriver/test/promise_error_test.js +0 -719
  508. package/lib/webdriver/test/promise_flow_test.js +0 -1957
  509. package/lib/webdriver/test/promise_generator_test.js +0 -251
  510. package/lib/webdriver/test/promise_test.js +0 -1981
  511. package/lib/webdriver/test/stacktrace_test.js +0 -480
  512. package/lib/webdriver/test/test_bootstrap.js +0 -67
  513. package/lib/webdriver/test/testing/asserts_test.js +0 -117
  514. package/lib/webdriver/test/testing/client_test.js +0 -88
  515. package/lib/webdriver/test/testing/testcase_test.js +0 -229
  516. package/lib/webdriver/test/testutil.js +0 -209
  517. package/lib/webdriver/test/testutil_test.js +0 -104
  518. package/lib/webdriver/test/until_test.js +0 -411
  519. package/lib/webdriver/test/webdriver_generator_test.js +0 -92
  520. package/lib/webdriver/test/webdriver_test.js +0 -2369
  521. package/lib/webdriver/testing/asserts.js +0 -487
  522. package/lib/webdriver/testing/client.js +0 -179
  523. package/lib/webdriver/testing/jsunit.js +0 -363
  524. package/lib/webdriver/testing/testcase.js +0 -168
  525. package/lib/webdriver/testing/window.js +0 -244
  526. package/lib/webdriver/touchsequence.js +0 -248
  527. package/lib/webdriver/until.js +0 -412
  528. package/lib/webdriver/webdriver.js +0 -2492
  529. package/test/_base_test.js +0 -129
@@ -1 +0,0 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"><meta http-equiv="Content-Language" content="en"><meta http-equiv="X-UA-Compatible" content="IE=edge"><title>logging.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><header><div><form><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></header><main><article class="srcfile"><h1>lib/webdriver/logging.js</h1><div><table><tr><td><a id="l1"></a><a href="#l1">1</a><td>// Licensed to the Software Freedom Conservancy (SFC) under one<tr><td><a id="l2"></a><a href="#l2">2</a><td>// or more contributor license agreements. See the NOTICE file<tr><td><a id="l3"></a><a href="#l3">3</a><td>// distributed with this work for additional information<tr><td><a id="l4"></a><a href="#l4">4</a><td>// regarding copyright ownership. The SFC licenses this file<tr><td><a id="l5"></a><a href="#l5">5</a><td>// to you under the Apache License, Version 2.0 (the<tr><td><a id="l6"></a><a href="#l6">6</a><td>// &quot;License&quot;); you may not use this file except in compliance<tr><td><a id="l7"></a><a href="#l7">7</a><td>// with the License. You may obtain a copy of the License at<tr><td><a id="l8"></a><a href="#l8">8</a><td>//<tr><td><a id="l9"></a><a href="#l9">9</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a id="l10"></a><a href="#l10">10</a><td>//<tr><td><a id="l11"></a><a href="#l11">11</a><td>// Unless required by applicable law or agreed to in writing,<tr><td><a id="l12"></a><a href="#l12">12</a><td>// software distributed under the License is distributed on an<tr><td><a id="l13"></a><a href="#l13">13</a><td>// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY<tr><td><a id="l14"></a><a href="#l14">14</a><td>// KIND, either express or implied. See the License for the<tr><td><a id="l15"></a><a href="#l15">15</a><td>// specific language governing permissions and limitations<tr><td><a id="l16"></a><a href="#l16">16</a><td>// under the License.<tr><td><a id="l17"></a><a href="#l17">17</a><td><tr><td><a id="l18"></a><a href="#l18">18</a><td>/**<tr><td><a id="l19"></a><a href="#l19">19</a><td> * @fileoverview Defines WebDriver&#39;s logging system. The logging system is<tr><td><a id="l20"></a><a href="#l20">20</a><td> * broken into major components: local and remote logging.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * The local logging API, which is anchored by the<tr><td><a id="l23"></a><a href="#l23">23</a><td> * {@link webdriver.logging.Logger Logger} class, is similar to Java&#39;s<tr><td><a id="l24"></a><a href="#l24">24</a><td> * logging API. Loggers, retrieved by {@link webdriver.logging.getLogger}, use<tr><td><a id="l25"></a><a href="#l25">25</a><td> * hierarchical, dot-delimited namespaces<tr><td><a id="l26"></a><a href="#l26">26</a><td> * (e.g. &quot;&quot; &gt; &quot;webdriver&quot; &gt; &quot;webdriver.logging&quot;). Recorded log messages are<tr><td><a id="l27"></a><a href="#l27">27</a><td> * represented by the {@link webdriver.logging.LogRecord LogRecord} class. You<tr><td><a id="l28"></a><a href="#l28">28</a><td> * can capture log records by<tr><td><a id="l29"></a><a href="#l29">29</a><td> * {@linkplain webdriver.logging.Logger#addHandler attaching} a handler function<tr><td><a id="l30"></a><a href="#l30">30</a><td> * to the desired logger. For convenience, you can quickly enable logging to<tr><td><a id="l31"></a><a href="#l31">31</a><td> * the console by simply calling<tr><td><a id="l32"></a><a href="#l32">32</a><td> * {@link webdriver.logging.installConsoleHandler()}.<tr><td><a id="l33"></a><a href="#l33">33</a><td> *<tr><td><a id="l34"></a><a href="#l34">34</a><td> * The [remote logging API](https://github.com/SeleniumHQ/selenium/wiki/Logging)<tr><td><a id="l35"></a><a href="#l35">35</a><td> * allows you to retrieve logs from a remote WebDriver server. This API uses the<tr><td><a id="l36"></a><a href="#l36">36</a><td> * {@link Preferences} class to define desired log levels prior to create a<tr><td><a id="l37"></a><a href="#l37">37</a><td> * WebDriver session:<tr><td><a id="l38"></a><a href="#l38">38</a><td> *<tr><td><a id="l39"></a><a href="#l39">39</a><td> * var prefs = new webdriver.logging.Preferences();<tr><td><a id="l40"></a><a href="#l40">40</a><td> * prefs.setLevel(webdriver.logging.Type.BROWSER,<tr><td><a id="l41"></a><a href="#l41">41</a><td> * webdriver.logging.Level.DEBUG);<tr><td><a id="l42"></a><a href="#l42">42</a><td> *<tr><td><a id="l43"></a><a href="#l43">43</a><td> * var caps = webdriver.Capabilities.chrome();<tr><td><a id="l44"></a><a href="#l44">44</a><td> * caps.setLoggingPrefs(prefs);<tr><td><a id="l45"></a><a href="#l45">45</a><td> * // ...<tr><td><a id="l46"></a><a href="#l46">46</a><td> *<tr><td><a id="l47"></a><a href="#l47">47</a><td> * Remote log entries are represented by the {@link Entry} class and may be<tr><td><a id="l48"></a><a href="#l48">48</a><td> * retrieved via {@link webdriver.WebDriver.Logs}:<tr><td><a id="l49"></a><a href="#l49">49</a><td> *<tr><td><a id="l50"></a><a href="#l50">50</a><td> * driver.manage().logs().get(webdriver.logging.Type.BROWSER)<tr><td><a id="l51"></a><a href="#l51">51</a><td> * .then(function(entries) {<tr><td><a id="l52"></a><a href="#l52">52</a><td> * entries.forEach(function(entry) {<tr><td><a id="l53"></a><a href="#l53">53</a><td> * console.log(&#39;[%s] %s&#39;, entry.level.name, entry.message);<tr><td><a id="l54"></a><a href="#l54">54</a><td> * });<tr><td><a id="l55"></a><a href="#l55">55</a><td> * });<tr><td><a id="l56"></a><a href="#l56">56</a><td> *<tr><td><a id="l57"></a><a href="#l57">57</a><td> * **NOTE:** Only a few browsers support the remote logging API (notably<tr><td><a id="l58"></a><a href="#l58">58</a><td> * Firefox and Chrome). Firefox supports basic logging functionality, while<tr><td><a id="l59"></a><a href="#l59">59</a><td> * Chrome exposes robust<tr><td><a id="l60"></a><a href="#l60">60</a><td> * [performance logging](https://sites.google.com/a/chromium.org/chromedriver/logging)<tr><td><a id="l61"></a><a href="#l61">61</a><td> * options. Remote logging is still considered a non-standard feature, and the<tr><td><a id="l62"></a><a href="#l62">62</a><td> * APIs exposed by this module for it are non-frozen. Once logging is officially<tr><td><a id="l63"></a><a href="#l63">63</a><td> * defined by the [W3C WebDriver spec](http://www.w3.org/TR/webdriver/), this<tr><td><a id="l64"></a><a href="#l64">64</a><td> * module will be updated to use a consistent API for local and remote logging.<tr><td><a id="l65"></a><a href="#l65">65</a><td> */<tr><td><a id="l66"></a><a href="#l66">66</a><td><tr><td><a id="l67"></a><a href="#l67">67</a><td>goog.module(&#39;webdriver.logging&#39;);<tr><td><a id="l68"></a><a href="#l68">68</a><td>goog.module.declareLegacyNamespace();<tr><td><a id="l69"></a><a href="#l69">69</a><td><tr><td><a id="l70"></a><a href="#l70">70</a><td>var LogManager = goog.require(&#39;goog.debug.LogManager&#39;);<tr><td><a id="l71"></a><a href="#l71">71</a><td>var LogRecord = goog.require(&#39;goog.debug.LogRecord&#39;);<tr><td><a id="l72"></a><a href="#l72">72</a><td>var Logger = goog.require(&#39;goog.debug.Logger&#39;);<tr><td><a id="l73"></a><a href="#l73">73</a><td>var Objects = goog.require(&#39;goog.object&#39;);<tr><td><a id="l74"></a><a href="#l74">74</a><td>var padNumber = goog.require(&#39;goog.string&#39;).padNumber;<tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td><tr><td><a id="l77"></a><a href="#l77">77</a><td>/** @const */<tr><td><a id="l78"></a><a href="#l78">78</a><td>exports.LogRecord = LogRecord;<tr><td><a id="l79"></a><a href="#l79">79</a><td><tr><td><a id="l80"></a><a href="#l80">80</a><td><tr><td><a id="l81"></a><a href="#l81">81</a><td>/** @const */<tr><td><a id="l82"></a><a href="#l82">82</a><td>exports.Logger = Logger;<tr><td><a id="l83"></a><a href="#l83">83</a><td><tr><td><a id="l84"></a><a href="#l84">84</a><td><tr><td><a id="l85"></a><a href="#l85">85</a><td>/** @const */<tr><td><a id="l86"></a><a href="#l86">86</a><td>exports.Level = Logger.Level;<tr><td><a id="l87"></a><a href="#l87">87</a><td><tr><td><a id="l88"></a><a href="#l88">88</a><td><tr><td><a id="l89"></a><a href="#l89">89</a><td>/**<tr><td><a id="l90"></a><a href="#l90">90</a><td> * DEBUG is a message level for debugging messages and has the same log level<tr><td><a id="l91"></a><a href="#l91">91</a><td> * as the {@link Logger.Level.CONFIG} message level.<tr><td><a id="l92"></a><a href="#l92">92</a><td> * @const {!Logger.Level}<tr><td><a id="l93"></a><a href="#l93">93</a><td> */<tr><td><a id="l94"></a><a href="#l94">94</a><td>Logger.Level.DEBUG = new Logger.Level(&#39;DEBUG&#39;, Logger.Level.CONFIG.value);<tr><td><a id="l95"></a><a href="#l95">95</a><td><tr><td><a id="l96"></a><a href="#l96">96</a><td><tr><td><a id="l97"></a><a href="#l97">97</a><td>/**<tr><td><a id="l98"></a><a href="#l98">98</a><td> * Finds a named logger.<tr><td><a id="l99"></a><a href="#l99">99</a><td> *<tr><td><a id="l100"></a><a href="#l100">100</a><td> * @param {string=} opt_name The dot-delimited logger name, such as<tr><td><a id="l101"></a><a href="#l101">101</a><td> * &quot;webdriver.logging.Logger&quot;. Defaults to the name of the root logger.<tr><td><a id="l102"></a><a href="#l102">102</a><td> * @return {!Logger} The named logger.<tr><td><a id="l103"></a><a href="#l103">103</a><td> */<tr><td><a id="l104"></a><a href="#l104">104</a><td>function getLogger(opt_name) {<tr><td><a id="l105"></a><a href="#l105">105</a><td> return LogManager.getLogger(opt_name || Logger.ROOT_LOGGER_NAME);<tr><td><a id="l106"></a><a href="#l106">106</a><td>}<tr><td><a id="l107"></a><a href="#l107">107</a><td>exports.getLogger = getLogger;<tr><td><a id="l108"></a><a href="#l108">108</a><td><tr><td><a id="l109"></a><a href="#l109">109</a><td><tr><td><a id="l110"></a><a href="#l110">110</a><td>/**<tr><td><a id="l111"></a><a href="#l111">111</a><td> * Logs all messages to the Console API.<tr><td><a id="l112"></a><a href="#l112">112</a><td> */<tr><td><a id="l113"></a><a href="#l113">113</a><td>function consoleHandler(record) {<tr><td><a id="l114"></a><a href="#l114">114</a><td> if (typeof console === &#39;undefined&#39;) {<tr><td><a id="l115"></a><a href="#l115">115</a><td> return;<tr><td><a id="l116"></a><a href="#l116">116</a><td> }<tr><td><a id="l117"></a><a href="#l117">117</a><td> record = /** @type {!LogRecord} */(record);<tr><td><a id="l118"></a><a href="#l118">118</a><td> var timestamp = new Date(record.getMillis());<tr><td><a id="l119"></a><a href="#l119">119</a><td> var msg =<tr><td><a id="l120"></a><a href="#l120">120</a><td> &#39;[&#39; + timestamp.getUTCFullYear() + &#39;-&#39; +<tr><td><a id="l121"></a><a href="#l121">121</a><td> padNumber(timestamp.getUTCMonth() + 1, 2) + &#39;-&#39; +<tr><td><a id="l122"></a><a href="#l122">122</a><td> padNumber(timestamp.getUTCDate(), 2) + &#39;T&#39; +<tr><td><a id="l123"></a><a href="#l123">123</a><td> padNumber(timestamp.getUTCHours(), 2) + &#39;:&#39; +<tr><td><a id="l124"></a><a href="#l124">124</a><td> padNumber(timestamp.getUTCMinutes(), 2) + &#39;:&#39; +<tr><td><a id="l125"></a><a href="#l125">125</a><td> padNumber(timestamp.getUTCSeconds(), 2) + &#39;Z]&#39; +<tr><td><a id="l126"></a><a href="#l126">126</a><td> &#39;[&#39; + record.getLevel().name + &#39;]&#39; +<tr><td><a id="l127"></a><a href="#l127">127</a><td> &#39;[&#39; + record.getLoggerName() + &#39;] &#39; +<tr><td><a id="l128"></a><a href="#l128">128</a><td> record.getMessage();<tr><td><a id="l129"></a><a href="#l129">129</a><td><tr><td><a id="l130"></a><a href="#l130">130</a><td> var level = record.getLevel().value;<tr><td><a id="l131"></a><a href="#l131">131</a><td> if (level &gt;= Logger.Level.SEVERE.value) {<tr><td><a id="l132"></a><a href="#l132">132</a><td> console.error(msg);<tr><td><a id="l133"></a><a href="#l133">133</a><td> } else if (level &gt;= Logger.Level.WARNING.value) {<tr><td><a id="l134"></a><a href="#l134">134</a><td> console.warn(msg);<tr><td><a id="l135"></a><a href="#l135">135</a><td> } else {<tr><td><a id="l136"></a><a href="#l136">136</a><td> console.log(msg);<tr><td><a id="l137"></a><a href="#l137">137</a><td> }<tr><td><a id="l138"></a><a href="#l138">138</a><td>}<tr><td><a id="l139"></a><a href="#l139">139</a><td><tr><td><a id="l140"></a><a href="#l140">140</a><td><tr><td><a id="l141"></a><a href="#l141">141</a><td>/**<tr><td><a id="l142"></a><a href="#l142">142</a><td> * Adds the console handler to the given logger. The console handler will log<tr><td><a id="l143"></a><a href="#l143">143</a><td> * all messages using the JavaScript Console API.<tr><td><a id="l144"></a><a href="#l144">144</a><td> *<tr><td><a id="l145"></a><a href="#l145">145</a><td> * @param {Logger=} opt_logger The logger to add the handler to; defaults<tr><td><a id="l146"></a><a href="#l146">146</a><td> * to the root logger.<tr><td><a id="l147"></a><a href="#l147">147</a><td> * @see exports.removeConsoleHandler<tr><td><a id="l148"></a><a href="#l148">148</a><td> */<tr><td><a id="l149"></a><a href="#l149">149</a><td>exports.addConsoleHandler = function(opt_logger) {<tr><td><a id="l150"></a><a href="#l150">150</a><td> var logger = opt_logger || getLogger();<tr><td><a id="l151"></a><a href="#l151">151</a><td> logger.addHandler(consoleHandler);<tr><td><a id="l152"></a><a href="#l152">152</a><td>};<tr><td><a id="l153"></a><a href="#l153">153</a><td><tr><td><a id="l154"></a><a href="#l154">154</a><td><tr><td><a id="l155"></a><a href="#l155">155</a><td>/**<tr><td><a id="l156"></a><a href="#l156">156</a><td> * Installs the console log handler on the root logger.<tr><td><a id="l157"></a><a href="#l157">157</a><td> * @see exports.addConsoleHandler<tr><td><a id="l158"></a><a href="#l158">158</a><td> */<tr><td><a id="l159"></a><a href="#l159">159</a><td>exports.installConsoleHandler = function() {<tr><td><a id="l160"></a><a href="#l160">160</a><td> exports.addConsoleHandler();<tr><td><a id="l161"></a><a href="#l161">161</a><td>};<tr><td><a id="l162"></a><a href="#l162">162</a><td><tr><td><a id="l163"></a><a href="#l163">163</a><td><tr><td><a id="l164"></a><a href="#l164">164</a><td>/**<tr><td><a id="l165"></a><a href="#l165">165</a><td> * Removes the console log handler from the given logger.<tr><td><a id="l166"></a><a href="#l166">166</a><td> *<tr><td><a id="l167"></a><a href="#l167">167</a><td> * @param {Logger=} opt_logger The logger to remove the handler from; defaults<tr><td><a id="l168"></a><a href="#l168">168</a><td> * to the root logger.<tr><td><a id="l169"></a><a href="#l169">169</a><td> * @see exports.addConsoleHandler<tr><td><a id="l170"></a><a href="#l170">170</a><td> */<tr><td><a id="l171"></a><a href="#l171">171</a><td>exports.removeConsoleHandler = function(opt_logger) {<tr><td><a id="l172"></a><a href="#l172">172</a><td> var logger = opt_logger || getLogger();<tr><td><a id="l173"></a><a href="#l173">173</a><td> logger.removeHandler(consoleHandler);<tr><td><a id="l174"></a><a href="#l174">174</a><td>};<tr><td><a id="l175"></a><a href="#l175">175</a><td><tr><td><a id="l176"></a><a href="#l176">176</a><td><tr><td><a id="l177"></a><a href="#l177">177</a><td>/**<tr><td><a id="l178"></a><a href="#l178">178</a><td> * Converts a level name or value to a {@link webdriver.logging.Level} value.<tr><td><a id="l179"></a><a href="#l179">179</a><td> * If the name/value is not recognized, {@link webdriver.logging.Level.ALL}<tr><td><a id="l180"></a><a href="#l180">180</a><td> * will be returned.<tr><td><a id="l181"></a><a href="#l181">181</a><td> * @param {(number|string)} nameOrValue The log level name, or value, to<tr><td><a id="l182"></a><a href="#l182">182</a><td> * convert .<tr><td><a id="l183"></a><a href="#l183">183</a><td> * @return {!Logger.Level} The converted level.<tr><td><a id="l184"></a><a href="#l184">184</a><td> */<tr><td><a id="l185"></a><a href="#l185">185</a><td>function getLevel(nameOrValue) {<tr><td><a id="l186"></a><a href="#l186">186</a><td> // DEBUG is not a predefined Closure log level, but maps to CONFIG. Since<tr><td><a id="l187"></a><a href="#l187">187</a><td> // DEBUG is a predefined level for the WebDriver protocol, we prefer it over<tr><td><a id="l188"></a><a href="#l188">188</a><td> // CONFIG.<tr><td><a id="l189"></a><a href="#l189">189</a><td> if (&#39;DEBUG&#39; === nameOrValue || Logger.Level.DEBUG.value === nameOrValue) {<tr><td><a id="l190"></a><a href="#l190">190</a><td> return Logger.Level.DEBUG;<tr><td><a id="l191"></a><a href="#l191">191</a><td> } else if (goog.isString(nameOrValue)) {<tr><td><a id="l192"></a><a href="#l192">192</a><td> return Logger.Level.getPredefinedLevel(/** @type {string} */(nameOrValue))<tr><td><a id="l193"></a><a href="#l193">193</a><td> || Logger.Level.ALL;<tr><td><a id="l194"></a><a href="#l194">194</a><td> } else {<tr><td><a id="l195"></a><a href="#l195">195</a><td> return Logger.Level.getPredefinedLevelByValue(<tr><td><a id="l196"></a><a href="#l196">196</a><td> /** @type {number} */(nameOrValue)) || Logger.Level.ALL;<tr><td><a id="l197"></a><a href="#l197">197</a><td> }<tr><td><a id="l198"></a><a href="#l198">198</a><td>}<tr><td><a id="l199"></a><a href="#l199">199</a><td>exports.getLevel = getLevel;<tr><td><a id="l200"></a><a href="#l200">200</a><td><tr><td><a id="l201"></a><a href="#l201">201</a><td><tr><td><a id="l202"></a><a href="#l202">202</a><td>/**<tr><td><a id="l203"></a><a href="#l203">203</a><td> * Normalizes a {@link Logger.Level} to one of the distinct values recognized<tr><td><a id="l204"></a><a href="#l204">204</a><td> * by WebDriver&#39;s wire protocol.<tr><td><a id="l205"></a><a href="#l205">205</a><td> * @param {!Logger.Level} level The input level.<tr><td><a id="l206"></a><a href="#l206">206</a><td> * @return {!Logger.Level} The normalized level.<tr><td><a id="l207"></a><a href="#l207">207</a><td> */<tr><td><a id="l208"></a><a href="#l208">208</a><td>function normalizeLevel(level) {<tr><td><a id="l209"></a><a href="#l209">209</a><td> if (level.value &lt;= Logger.Level.ALL.value) { // ALL is 0.<tr><td><a id="l210"></a><a href="#l210">210</a><td> return Logger.Level.ALL;<tr><td><a id="l211"></a><a href="#l211">211</a><td><tr><td><a id="l212"></a><a href="#l212">212</a><td> } else if (level.value === Logger.Level.OFF.value) { // OFF is Infinity<tr><td><a id="l213"></a><a href="#l213">213</a><td> return Logger.Level.OFF;<tr><td><a id="l214"></a><a href="#l214">214</a><td><tr><td><a id="l215"></a><a href="#l215">215</a><td> } else if (level.value &lt; Logger.Level.INFO.value) {<tr><td><a id="l216"></a><a href="#l216">216</a><td> return Logger.Level.DEBUG;<tr><td><a id="l217"></a><a href="#l217">217</a><td><tr><td><a id="l218"></a><a href="#l218">218</a><td> } else if (level.value &lt; Logger.Level.WARNING.value) {<tr><td><a id="l219"></a><a href="#l219">219</a><td> return Logger.Level.INFO;<tr><td><a id="l220"></a><a href="#l220">220</a><td><tr><td><a id="l221"></a><a href="#l221">221</a><td> } else if (level.value &lt; Logger.Level.SEVERE.value) {<tr><td><a id="l222"></a><a href="#l222">222</a><td> return Logger.Level.WARNING;<tr><td><a id="l223"></a><a href="#l223">223</a><td><tr><td><a id="l224"></a><a href="#l224">224</a><td> } else {<tr><td><a id="l225"></a><a href="#l225">225</a><td> return Logger.Level.SEVERE;<tr><td><a id="l226"></a><a href="#l226">226</a><td> }<tr><td><a id="l227"></a><a href="#l227">227</a><td>}<tr><td><a id="l228"></a><a href="#l228">228</a><td><tr><td><a id="l229"></a><a href="#l229">229</a><td><tr><td><a id="l230"></a><a href="#l230">230</a><td>/**<tr><td><a id="l231"></a><a href="#l231">231</a><td> * Common log types.<tr><td><a id="l232"></a><a href="#l232">232</a><td> * @enum {string}<tr><td><a id="l233"></a><a href="#l233">233</a><td> */<tr><td><a id="l234"></a><a href="#l234">234</a><td>var Type = {<tr><td><a id="l235"></a><a href="#l235">235</a><td> /** Logs originating from the browser. */<tr><td><a id="l236"></a><a href="#l236">236</a><td> BROWSER: &#39;browser&#39;,<tr><td><a id="l237"></a><a href="#l237">237</a><td> /** Logs from a WebDriver client. */<tr><td><a id="l238"></a><a href="#l238">238</a><td> CLIENT: &#39;client&#39;,<tr><td><a id="l239"></a><a href="#l239">239</a><td> /** Logs from a WebDriver implementation. */<tr><td><a id="l240"></a><a href="#l240">240</a><td> DRIVER: &#39;driver&#39;,<tr><td><a id="l241"></a><a href="#l241">241</a><td> /** Logs related to performance. */<tr><td><a id="l242"></a><a href="#l242">242</a><td> PERFORMANCE: &#39;performance&#39;,<tr><td><a id="l243"></a><a href="#l243">243</a><td> /** Logs from the remote server. */<tr><td><a id="l244"></a><a href="#l244">244</a><td> SERVER: &#39;server&#39;<tr><td><a id="l245"></a><a href="#l245">245</a><td>};<tr><td><a id="l246"></a><a href="#l246">246</a><td>exports.Type = Type;<tr><td><a id="l247"></a><a href="#l247">247</a><td><tr><td><a id="l248"></a><a href="#l248">248</a><td><tr><td><a id="l249"></a><a href="#l249">249</a><td>/**<tr><td><a id="l250"></a><a href="#l250">250</a><td> * Describes the log preferences for a WebDriver session.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @final<tr><td><a id="l252"></a><a href="#l252">252</a><td> */<tr><td><a id="l253"></a><a href="#l253">253</a><td>var Preferences = goog.defineClass(null, {<tr><td><a id="l254"></a><a href="#l254">254</a><td> /** @constructor */<tr><td><a id="l255"></a><a href="#l255">255</a><td> constructor: function() {<tr><td><a id="l256"></a><a href="#l256">256</a><td> /** @private {!Object.&lt;string, Logger.Level&gt;} */<tr><td><a id="l257"></a><a href="#l257">257</a><td> this.prefs_ = {};<tr><td><a id="l258"></a><a href="#l258">258</a><td> },<tr><td><a id="l259"></a><a href="#l259">259</a><td><tr><td><a id="l260"></a><a href="#l260">260</a><td> /**<tr><td><a id="l261"></a><a href="#l261">261</a><td> * Sets the desired logging level for a particular log type.<tr><td><a id="l262"></a><a href="#l262">262</a><td> * @param {(string|Type)} type The log type.<tr><td><a id="l263"></a><a href="#l263">263</a><td> * @param {!Logger.Level} level The desired log level.<tr><td><a id="l264"></a><a href="#l264">264</a><td> */<tr><td><a id="l265"></a><a href="#l265">265</a><td> setLevel: function(type, level) {<tr><td><a id="l266"></a><a href="#l266">266</a><td> this.prefs_[type] = normalizeLevel(level);<tr><td><a id="l267"></a><a href="#l267">267</a><td> },<tr><td><a id="l268"></a><a href="#l268">268</a><td><tr><td><a id="l269"></a><a href="#l269">269</a><td> /**<tr><td><a id="l270"></a><a href="#l270">270</a><td> * Converts this instance to its JSON representation.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @return {!Object.&lt;string, string&gt;} The JSON representation of this set of<tr><td><a id="l272"></a><a href="#l272">272</a><td> * preferences.<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td> toJSON: function() {<tr><td><a id="l275"></a><a href="#l275">275</a><td> var obj = {};<tr><td><a id="l276"></a><a href="#l276">276</a><td> for (var type in this.prefs_) {<tr><td><a id="l277"></a><a href="#l277">277</a><td> if (this.prefs_.hasOwnProperty(type)) {<tr><td><a id="l278"></a><a href="#l278">278</a><td> obj[type] = this.prefs_[type].name;<tr><td><a id="l279"></a><a href="#l279">279</a><td> }<tr><td><a id="l280"></a><a href="#l280">280</a><td> }<tr><td><a id="l281"></a><a href="#l281">281</a><td> return obj;<tr><td><a id="l282"></a><a href="#l282">282</a><td> }<tr><td><a id="l283"></a><a href="#l283">283</a><td>});<tr><td><a id="l284"></a><a href="#l284">284</a><td>exports.Preferences = Preferences;<tr><td><a id="l285"></a><a href="#l285">285</a><td><tr><td><a id="l286"></a><a href="#l286">286</a><td><tr><td><a id="l287"></a><a href="#l287">287</a><td>/**<tr><td><a id="l288"></a><a href="#l288">288</a><td> * A single log entry recorded by a WebDriver component, such as a remote<tr><td><a id="l289"></a><a href="#l289">289</a><td> * WebDriver server.<tr><td><a id="l290"></a><a href="#l290">290</a><td> * @final<tr><td><a id="l291"></a><a href="#l291">291</a><td> */<tr><td><a id="l292"></a><a href="#l292">292</a><td>var Entry = goog.defineClass(null, {<tr><td><a id="l293"></a><a href="#l293">293</a><td> /**<tr><td><a id="l294"></a><a href="#l294">294</a><td> * @param {(!Logger.Level|string)} level The entry level.<tr><td><a id="l295"></a><a href="#l295">295</a><td> * @param {string} message The log message.<tr><td><a id="l296"></a><a href="#l296">296</a><td> * @param {number=} opt_timestamp The time this entry was generated, in<tr><td><a id="l297"></a><a href="#l297">297</a><td> * milliseconds since 0:00:00, January 1, 1970 UTC. If omitted, the<tr><td><a id="l298"></a><a href="#l298">298</a><td> * current time will be used.<tr><td><a id="l299"></a><a href="#l299">299</a><td> * @param {string=} opt_type The log type, if known.<tr><td><a id="l300"></a><a href="#l300">300</a><td> * @constructor<tr><td><a id="l301"></a><a href="#l301">301</a><td> */<tr><td><a id="l302"></a><a href="#l302">302</a><td> constructor: function(level, message, opt_timestamp, opt_type) {<tr><td><a id="l303"></a><a href="#l303">303</a><td><tr><td><a id="l304"></a><a href="#l304">304</a><td> /** @type {!Logger.Level} */<tr><td><a id="l305"></a><a href="#l305">305</a><td> this.level = goog.isString(level) ? getLevel(level) : level;<tr><td><a id="l306"></a><a href="#l306">306</a><td><tr><td><a id="l307"></a><a href="#l307">307</a><td> /** @type {string} */<tr><td><a id="l308"></a><a href="#l308">308</a><td> this.message = message;<tr><td><a id="l309"></a><a href="#l309">309</a><td><tr><td><a id="l310"></a><a href="#l310">310</a><td> /** @type {number} */<tr><td><a id="l311"></a><a href="#l311">311</a><td> this.timestamp = goog.isNumber(opt_timestamp) ? opt_timestamp : goog.now();<tr><td><a id="l312"></a><a href="#l312">312</a><td><tr><td><a id="l313"></a><a href="#l313">313</a><td> /** @type {string} */<tr><td><a id="l314"></a><a href="#l314">314</a><td> this.type = opt_type || &#39;&#39;;<tr><td><a id="l315"></a><a href="#l315">315</a><td> },<tr><td><a id="l316"></a><a href="#l316">316</a><td><tr><td><a id="l317"></a><a href="#l317">317</a><td> statics: {<tr><td><a id="l318"></a><a href="#l318">318</a><td> /**<tr><td><a id="l319"></a><a href="#l319">319</a><td> * Converts a {@link goog.debug.LogRecord} into a<tr><td><a id="l320"></a><a href="#l320">320</a><td> * {@link webdriver.logging.Entry}.<tr><td><a id="l321"></a><a href="#l321">321</a><td> * @param {!goog.debug.LogRecord} logRecord The record to convert.<tr><td><a id="l322"></a><a href="#l322">322</a><td> * @param {string=} opt_type The log type.<tr><td><a id="l323"></a><a href="#l323">323</a><td> * @return {!Entry} The converted entry.<tr><td><a id="l324"></a><a href="#l324">324</a><td> */<tr><td><a id="l325"></a><a href="#l325">325</a><td> fromClosureLogRecord: function(logRecord, opt_type) {<tr><td><a id="l326"></a><a href="#l326">326</a><td> return new Entry(<tr><td><a id="l327"></a><a href="#l327">327</a><td> normalizeLevel(/** @type {!Logger.Level} */(logRecord.getLevel())),<tr><td><a id="l328"></a><a href="#l328">328</a><td> &#39;[&#39; + logRecord.getLoggerName() + &#39;] &#39; + logRecord.getMessage(),<tr><td><a id="l329"></a><a href="#l329">329</a><td> logRecord.getMillis(),<tr><td><a id="l330"></a><a href="#l330">330</a><td> opt_type);<tr><td><a id="l331"></a><a href="#l331">331</a><td> }<tr><td><a id="l332"></a><a href="#l332">332</a><td> },<tr><td><a id="l333"></a><a href="#l333">333</a><td><tr><td><a id="l334"></a><a href="#l334">334</a><td> /**<tr><td><a id="l335"></a><a href="#l335">335</a><td> * @return {{level: string, message: string, timestamp: number,<tr><td><a id="l336"></a><a href="#l336">336</a><td> * type: string}} The JSON representation of this entry.<tr><td><a id="l337"></a><a href="#l337">337</a><td> */<tr><td><a id="l338"></a><a href="#l338">338</a><td> toJSON: function() {<tr><td><a id="l339"></a><a href="#l339">339</a><td> return {<tr><td><a id="l340"></a><a href="#l340">340</a><td> &#39;level&#39;: this.level.name,<tr><td><a id="l341"></a><a href="#l341">341</a><td> &#39;message&#39;: this.message,<tr><td><a id="l342"></a><a href="#l342">342</a><td> &#39;timestamp&#39;: this.timestamp,<tr><td><a id="l343"></a><a href="#l343">343</a><td> &#39;type&#39;: this.type<tr><td><a id="l344"></a><a href="#l344">344</a><td> };<tr><td><a id="l345"></a><a href="#l345">345</a><td> }<tr><td><a id="l346"></a><a href="#l346">346</a><td>});<tr><td><a id="l347"></a><a href="#l347">347</a><td>exports.Entry = Entry;</table></div></article><nav><h3><a href="../../../index.html" tabindex="2">Overview</a></h3><div><input type="checkbox" id="nav-modules" checked/><label for="nav-modules"><h3><span class="selectable" tabindex="2">Modules</span></h3></label><div id="nav-modules-view"></div></div><div><input type="checkbox" id="nav-types" checked/><label for="nav-types"><h3><span class="selectable" tabindex="2">Types</span></h3></label><div id="nav-types-view"></div></div><h3><a href="../../../Changes.html" tabindex="2">Changes</a></h3></nav></main><footer><div><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></div></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>