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.
- package/CHANGES.md +116 -0
- package/NOTICE +1 -1
- package/README.md +59 -9
- package/builder.js +375 -358
- package/chrome.js +549 -586
- package/edge.js +378 -0
- package/error.js +9 -6
- package/example/google_search.js +1 -1
- package/example/google_search_generator.js +2 -4
- package/example/logging.js +6 -2
- package/example/sample.js +21 -0
- package/executors.js +11 -27
- package/firefox/binary.js +149 -98
- package/firefox/extension.js +15 -19
- package/firefox/index.js +256 -163
- package/firefox/profile.js +223 -243
- package/http/index.js +487 -81
- package/http/util.js +40 -36
- package/ie.js +288 -309
- package/index.js +34 -125
- package/io/exec.js +58 -39
- package/io/index.js +72 -60
- package/lib/README +4 -0
- package/lib/actions.js +596 -0
- package/lib/by.js +277 -0
- package/lib/capabilities.js +450 -0
- package/lib/{webdriver/command.js → command.js} +91 -72
- package/lib/{webdriver/button.js → devmode.js} +13 -8
- package/lib/error.js +690 -0
- package/lib/events.js +212 -0
- package/lib/firefox/amd64/libnoblur64.so +0 -0
- package/lib/firefox/i386/libnoblur.so +0 -0
- package/lib/firefox/webdriver.json +5 -1
- package/lib/firefox/webdriver.xpi +0 -0
- package/lib/{webdriver/key.js → input.js} +84 -2
- package/lib/logging.js +670 -0
- package/lib/{webdriver/promise.js → promise.js} +817 -644
- package/lib/safari/client.js +266 -214
- package/lib/session.js +80 -0
- package/lib/{webdriver/serializable.js → symbols.js} +16 -19
- package/lib/test/build.js +4 -4
- package/lib/test/data/click_tests/html5_submit_buttons.html +2 -1
- package/lib/test/data/click_tests/overlapping_elements.html +15 -4
- package/lib/test/data/click_tests/partially_overlapping_elements.html +124 -0
- package/lib/test/data/click_tests/wrapped_overlapping_elements.html +13 -0
- package/lib/test/data/hidden_partially.html +45 -0
- package/lib/test/data/readOnlyPage.html +1 -1
- package/lib/test/data/selectPage.html +18 -2
- package/lib/test/fileserver.js +3 -4
- package/lib/test/index.js +7 -3
- package/lib/test/resources.js +1 -1
- package/lib/until.js +376 -0
- package/lib/webdriver.js +2440 -0
- package/net/index.js +4 -0
- package/net/portprober.js +16 -12
- package/opera.js +295 -314
- package/package.json +6 -5
- package/phantomjs.js +144 -147
- package/proxy.js +10 -6
- package/remote/index.js +289 -238
- package/safari.js +326 -311
- package/test/chrome/options_test.js +11 -9
- package/test/element_finding_test.js +51 -13
- package/test/execute_script_test.js +17 -3
- package/test/firefox/firefox_test.js +0 -32
- package/test/http/http_test.js +671 -61
- package/test/http/util_test.js +25 -23
- package/test/io_test.js +67 -1
- package/test/lib/by_test.js +139 -0
- package/test/lib/capabilities_test.js +111 -0
- package/test/lib/error_test.js +325 -0
- package/test/lib/events_test.js +177 -0
- package/test/lib/logging_test.js +272 -0
- package/test/{promise_aplus_test.js → lib/promise_aplus_test.js} +4 -13
- package/test/lib/promise_error_test.js +808 -0
- package/test/lib/promise_flow_test.js +2282 -0
- package/test/lib/promise_generator_test.js +308 -0
- package/test/lib/promise_test.js +996 -0
- package/test/lib/testutil.js +90 -0
- package/test/lib/until_test.js +400 -0
- package/test/lib/webdriver_test.js +2157 -0
- package/test/page_loading_test.js +7 -9
- package/test/remote_test.js +50 -3
- package/test/session_test.js +53 -0
- package/test/stale_element_test.js +2 -2
- package/test/testing/assert_test.js +374 -0
- package/test/testing/index_test.js +9 -11
- package/testing/assert.js +334 -17
- package/testing/index.js +12 -2
- package/_base.js +0 -200
- package/docs/Changes.html +0 -356
- package/docs/class_bot_Error.html +0 -15
- package/docs/class_webdriver_ActionSequence.html +0 -115
- package/docs/class_webdriver_Alert.html +0 -24
- package/docs/class_webdriver_AlertPromise.html +0 -92
- package/docs/class_webdriver_Capabilities.html +0 -60
- package/docs/class_webdriver_Command.html +0 -15
- package/docs/class_webdriver_EventEmitter.html +0 -35
- package/docs/class_webdriver_FileDetector.html +0 -21
- package/docs/class_webdriver_Locator.html +0 -12
- package/docs/class_webdriver_Serializable.html +0 -9
- package/docs/class_webdriver_Session.html +0 -13
- package/docs/class_webdriver_TouchSequence.html +0 -49
- package/docs/class_webdriver_UnhandledAlertError.html +0 -18
- package/docs/class_webdriver_WebDriver.html +0 -313
- package/docs/class_webdriver_WebDriver_Logs.html +0 -15
- package/docs/class_webdriver_WebDriver_Navigation.html +0 -16
- package/docs/class_webdriver_WebDriver_Options.html +0 -41
- package/docs/class_webdriver_WebDriver_TargetLocator.html +0 -38
- package/docs/class_webdriver_WebDriver_Timeouts.html +0 -29
- package/docs/class_webdriver_WebDriver_Window.html +0 -27
- package/docs/class_webdriver_WebElement.html +0 -223
- package/docs/class_webdriver_WebElementPromise.html +0 -274
- package/docs/class_webdriver_http_Executor.html +0 -22
- package/docs/class_webdriver_http_Request.html +0 -12
- package/docs/class_webdriver_http_Response.html +0 -13
- package/docs/class_webdriver_logging_Entry.html +0 -15
- package/docs/class_webdriver_logging_Level.html +0 -55
- package/docs/class_webdriver_logging_LogRecord.html +0 -45
- package/docs/class_webdriver_logging_Logger.html +0 -119
- package/docs/class_webdriver_logging_Preferences.html +0 -8
- package/docs/class_webdriver_promise_CancellationError.html +0 -17
- package/docs/class_webdriver_promise_ControlFlow.html +0 -153
- package/docs/class_webdriver_promise_Deferred.html +0 -84
- package/docs/class_webdriver_promise_MultipleUnhandledRejectionError.html +0 -14
- package/docs/class_webdriver_promise_Promise.html +0 -75
- package/docs/class_webdriver_stacktrace_Frame.html +0 -20
- package/docs/class_webdriver_stacktrace_Snapshot.html +0 -6
- package/docs/class_webdriver_testing_Assertion.html +0 -99
- package/docs/class_webdriver_testing_Assertion_DelegatingMatcher_.html +0 -13
- package/docs/class_webdriver_testing_ContainsMatcher.html +0 -11
- package/docs/class_webdriver_testing_NegatedAssertion.html +0 -97
- package/docs/class_webdriver_until_Condition.html +0 -7
- package/docs/dossier.css +0 -1
- package/docs/dossier.js +0 -86
- package/docs/enum_bot_ErrorCode.html +0 -3
- package/docs/enum_bot_Error_State.html +0 -2
- package/docs/enum_webdriver_Browser.html +0 -2
- package/docs/enum_webdriver_Button.html +0 -2
- package/docs/enum_webdriver_Capability.html +0 -33
- package/docs/enum_webdriver_CommandName.html +0 -3
- package/docs/enum_webdriver_Key.html +0 -12
- package/docs/enum_webdriver_logging_Type.html +0 -6
- package/docs/enum_webdriver_promise_ControlFlow_EventType.html +0 -9
- package/docs/index.html +0 -125
- package/docs/interface_webdriver_CommandExecutor.html +0 -9
- package/docs/interface_webdriver_http_Client.html +0 -10
- package/docs/interface_webdriver_promise_Thenable.html +0 -77
- package/docs/module_selenium-webdriver.html +0 -23
- package/docs/module_selenium-webdriver__base.html +0 -23
- package/docs/module_selenium-webdriver__base_class_Context.html +0 -5
- package/docs/module_selenium-webdriver_builder.html +0 -2
- package/docs/module_selenium-webdriver_builder_class_Builder.html +0 -138
- package/docs/module_selenium-webdriver_chrome.html +0 -90
- package/docs/module_selenium-webdriver_chrome_class_Driver.html +0 -280
- package/docs/module_selenium-webdriver_chrome_class_Options.html +0 -127
- package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +0 -46
- package/docs/module_selenium-webdriver_class_ActionSequence.html +0 -115
- package/docs/module_selenium-webdriver_class_Builder.html +0 -138
- package/docs/module_selenium-webdriver_class_Capabilities.html +0 -60
- package/docs/module_selenium-webdriver_class_Command.html +0 -15
- package/docs/module_selenium-webdriver_class_EventEmitter.html +0 -35
- package/docs/module_selenium-webdriver_class_FileDetector.html +0 -21
- package/docs/module_selenium-webdriver_class_Serializable.html +0 -9
- package/docs/module_selenium-webdriver_class_Session.html +0 -13
- package/docs/module_selenium-webdriver_class_WebDriver.html +0 -313
- package/docs/module_selenium-webdriver_class_WebElement.html +0 -223
- package/docs/module_selenium-webdriver_class_WebElementPromise.html +0 -274
- package/docs/module_selenium-webdriver_enum_Browser.html +0 -2
- package/docs/module_selenium-webdriver_enum_Button.html +0 -2
- package/docs/module_selenium-webdriver_enum_Capability.html +0 -33
- package/docs/module_selenium-webdriver_enum_CommandName.html +0 -3
- package/docs/module_selenium-webdriver_enum_Key.html +0 -12
- package/docs/module_selenium-webdriver_error.html +0 -4
- package/docs/module_selenium-webdriver_error_class_Error.html +0 -15
- package/docs/module_selenium-webdriver_error_enum_ErrorCode.html +0 -3
- package/docs/module_selenium-webdriver_executors.html +0 -10
- package/docs/module_selenium-webdriver_executors_class_DeferredExecutor.html +0 -12
- package/docs/module_selenium-webdriver_firefox.html +0 -68
- package/docs/module_selenium-webdriver_firefox_binary.html +0 -5
- package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +0 -20
- package/docs/module_selenium-webdriver_firefox_class_Binary.html +0 -20
- package/docs/module_selenium-webdriver_firefox_class_Driver.html +0 -276
- package/docs/module_selenium-webdriver_firefox_class_Options.html +0 -19
- package/docs/module_selenium-webdriver_firefox_class_Profile.html +0 -50
- package/docs/module_selenium-webdriver_firefox_extension.html +0 -8
- package/docs/module_selenium-webdriver_firefox_profile.html +0 -13
- package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +0 -50
- package/docs/module_selenium-webdriver_http.html +0 -9
- package/docs/module_selenium-webdriver_http_class_Executor.html +0 -22
- package/docs/module_selenium-webdriver_http_class_HttpClient.html +0 -16
- package/docs/module_selenium-webdriver_http_class_Request.html +0 -12
- package/docs/module_selenium-webdriver_http_class_Response.html +0 -13
- package/docs/module_selenium-webdriver_http_util.html +0 -17
- package/docs/module_selenium-webdriver_ie.html +0 -11
- package/docs/module_selenium-webdriver_ie_class_Driver.html +0 -274
- package/docs/module_selenium-webdriver_ie_class_Options.html +0 -89
- package/docs/module_selenium-webdriver_ie_enum_Level.html +0 -1
- package/docs/module_selenium-webdriver_io.html +0 -37
- package/docs/module_selenium-webdriver_io_exec.html +0 -6
- package/docs/module_selenium-webdriver_namespace_By.html +0 -56
- package/docs/module_selenium-webdriver_namespace_error.html +0 -4
- package/docs/module_selenium-webdriver_namespace_logging.html +0 -18
- package/docs/module_selenium-webdriver_namespace_promise.html +0 -163
- package/docs/module_selenium-webdriver_namespace_stacktrace.html +0 -17
- package/docs/module_selenium-webdriver_namespace_until.html +0 -82
- package/docs/module_selenium-webdriver_net.html +0 -7
- package/docs/module_selenium-webdriver_net_portprober.html +0 -12
- package/docs/module_selenium-webdriver_opera.html +0 -62
- package/docs/module_selenium-webdriver_opera_class_Driver.html +0 -276
- package/docs/module_selenium-webdriver_opera_class_Options.html +0 -44
- package/docs/module_selenium-webdriver_opera_class_ServiceBuilder.html +0 -35
- package/docs/module_selenium-webdriver_phantomjs.html +0 -2
- package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +0 -299
- package/docs/module_selenium-webdriver_proxy.html +0 -28
- package/docs/module_selenium-webdriver_remote.html +0 -8
- package/docs/module_selenium-webdriver_remote_class_DriverService.html +0 -32
- package/docs/module_selenium-webdriver_remote_class_FileDetector.html +0 -22
- package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +0 -41
- package/docs/module_selenium-webdriver_safari.html +0 -9
- package/docs/module_selenium-webdriver_safari_class_Driver.html +0 -279
- package/docs/module_selenium-webdriver_safari_class_Options.html +0 -23
- package/docs/module_selenium-webdriver_testing.html +0 -74
- package/docs/module_selenium-webdriver_testing_assert.html +0 -9
- package/docs/namespace_bot.html +0 -4
- package/docs/namespace_bot_json.html +0 -20
- package/docs/namespace_bot_response.html +0 -18
- package/docs/namespace_bot_userAgent.html +0 -33
- package/docs/namespace_webdriver.html +0 -30
- package/docs/namespace_webdriver_By.html +0 -56
- package/docs/namespace_webdriver_http.html +0 -6
- package/docs/namespace_webdriver_logging.html +0 -70
- package/docs/namespace_webdriver_promise.html +0 -688
- package/docs/namespace_webdriver_stacktrace.html +0 -17
- package/docs/namespace_webdriver_testing.html +0 -7
- package/docs/namespace_webdriver_testing_assert.html +0 -9
- package/docs/namespace_webdriver_testing_asserts.html +0 -18
- package/docs/namespace_webdriver_until.html +0 -82
- package/docs/source/_base.js.src.html +0 -1
- package/docs/source/builder.js.src.html +0 -1
- package/docs/source/chrome.js.src.html +0 -1
- package/docs/source/error.js.src.html +0 -1
- package/docs/source/executors.js.src.html +0 -1
- package/docs/source/firefox/binary.js.src.html +0 -1
- package/docs/source/firefox/extension.js.src.html +0 -1
- package/docs/source/firefox/index.js.src.html +0 -1
- package/docs/source/firefox/profile.js.src.html +0 -1
- package/docs/source/http/index.js.src.html +0 -1
- package/docs/source/http/util.js.src.html +0 -1
- package/docs/source/ie.js.src.html +0 -1
- package/docs/source/index.js.src.html +0 -1
- package/docs/source/io/exec.js.src.html +0 -1
- package/docs/source/io/index.js.src.html +0 -1
- package/docs/source/lib/atoms/error.js.src.html +0 -1
- package/docs/source/lib/atoms/json.js.src.html +0 -1
- package/docs/source/lib/atoms/response.js.src.html +0 -1
- package/docs/source/lib/atoms/userAgent.js.src.html +0 -1
- package/docs/source/lib/goog/array/array.js.src.html +0 -1
- package/docs/source/lib/goog/asserts/asserts.js.src.html +0 -1
- package/docs/source/lib/goog/async/freelist.js.src.html +0 -1
- package/docs/source/lib/goog/async/nexttick.js.src.html +0 -1
- package/docs/source/lib/goog/async/run.js.src.html +0 -1
- package/docs/source/lib/goog/async/workqueue.js.src.html +0 -1
- package/docs/source/lib/goog/base.js.src.html +0 -1
- package/docs/source/lib/goog/debug/debug.js.src.html +0 -1
- package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +0 -1
- package/docs/source/lib/goog/debug/error.js.src.html +0 -1
- package/docs/source/lib/goog/debug/logbuffer.js.src.html +0 -1
- package/docs/source/lib/goog/debug/logger.js.src.html +0 -1
- package/docs/source/lib/goog/debug/logrecord.js.src.html +0 -1
- package/docs/source/lib/goog/deps.js.src.html +0 -1
- package/docs/source/lib/goog/disposable/disposable.js.src.html +0 -1
- package/docs/source/lib/goog/disposable/idisposable.js.src.html +0 -1
- package/docs/source/lib/goog/dom/browserfeature.js.src.html +0 -1
- package/docs/source/lib/goog/dom/dom.js.src.html +0 -1
- package/docs/source/lib/goog/dom/nodetype.js.src.html +0 -1
- package/docs/source/lib/goog/dom/safe.js.src.html +0 -1
- package/docs/source/lib/goog/dom/tagname.js.src.html +0 -1
- package/docs/source/lib/goog/dom/tags.js.src.html +0 -1
- package/docs/source/lib/goog/dom/vendor.js.src.html +0 -1
- package/docs/source/lib/goog/events/browserevent.js.src.html +0 -1
- package/docs/source/lib/goog/events/browserfeature.js.src.html +0 -1
- package/docs/source/lib/goog/events/event.js.src.html +0 -1
- package/docs/source/lib/goog/events/eventid.js.src.html +0 -1
- package/docs/source/lib/goog/events/events.js.src.html +0 -1
- package/docs/source/lib/goog/events/eventtarget.js.src.html +0 -1
- package/docs/source/lib/goog/events/eventtype.js.src.html +0 -1
- package/docs/source/lib/goog/events/keycodes.js.src.html +0 -1
- package/docs/source/lib/goog/events/listenable.js.src.html +0 -1
- package/docs/source/lib/goog/events/listener.js.src.html +0 -1
- package/docs/source/lib/goog/events/listenermap.js.src.html +0 -1
- package/docs/source/lib/goog/fs/url.js.src.html +0 -1
- package/docs/source/lib/goog/functions/functions.js.src.html +0 -1
- package/docs/source/lib/goog/html/safehtml.js.src.html +0 -1
- package/docs/source/lib/goog/html/safescript.js.src.html +0 -1
- package/docs/source/lib/goog/html/safestyle.js.src.html +0 -1
- package/docs/source/lib/goog/html/safestylesheet.js.src.html +0 -1
- package/docs/source/lib/goog/html/safeurl.js.src.html +0 -1
- package/docs/source/lib/goog/html/trustedresourceurl.js.src.html +0 -1
- package/docs/source/lib/goog/html/uncheckedconversions.js.src.html +0 -1
- package/docs/source/lib/goog/i18n/bidi.js.src.html +0 -1
- package/docs/source/lib/goog/iter/iter.js.src.html +0 -1
- package/docs/source/lib/goog/json/json.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/matcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/browser.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/engine.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/platform.js.src.html +0 -1
- package/docs/source/lib/goog/labs/useragent/util.js.src.html +0 -1
- package/docs/source/lib/goog/log/log.js.src.html +0 -1
- package/docs/source/lib/goog/math/box.js.src.html +0 -1
- package/docs/source/lib/goog/math/coordinate.js.src.html +0 -1
- package/docs/source/lib/goog/math/math.js.src.html +0 -1
- package/docs/source/lib/goog/math/rect.js.src.html +0 -1
- package/docs/source/lib/goog/math/size.js.src.html +0 -1
- package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +0 -1
- package/docs/source/lib/goog/net/xhrlike.js.src.html +0 -1
- package/docs/source/lib/goog/net/xmlhttp.js.src.html +0 -1
- package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +0 -1
- package/docs/source/lib/goog/object/object.js.src.html +0 -1
- package/docs/source/lib/goog/promise/promise.js.src.html +0 -1
- package/docs/source/lib/goog/promise/resolver.js.src.html +0 -1
- package/docs/source/lib/goog/promise/thenable.js.src.html +0 -1
- package/docs/source/lib/goog/reflect/reflect.js.src.html +0 -1
- package/docs/source/lib/goog/string/const.js.src.html +0 -1
- package/docs/source/lib/goog/string/string.js.src.html +0 -1
- package/docs/source/lib/goog/string/typedstring.js.src.html +0 -1
- package/docs/source/lib/goog/structs/collection.js.src.html +0 -1
- package/docs/source/lib/goog/structs/map.js.src.html +0 -1
- package/docs/source/lib/goog/structs/set.js.src.html +0 -1
- package/docs/source/lib/goog/structs/structs.js.src.html +0 -1
- package/docs/source/lib/goog/style/style.js.src.html +0 -1
- package/docs/source/lib/goog/testing/asserts.js.src.html +0 -1
- package/docs/source/lib/goog/testing/events/events.js.src.html +0 -1
- package/docs/source/lib/goog/testing/functionmock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/jsunit.js.src.html +0 -1
- package/docs/source/lib/goog/testing/loosemock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockclock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockcontrol.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockinterface.js.src.html +0 -1
- package/docs/source/lib/goog/testing/mockmatchers.js.src.html +0 -1
- package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +0 -1
- package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +0 -1
- package/docs/source/lib/goog/testing/recordfunction.js.src.html +0 -1
- package/docs/source/lib/goog/testing/stacktrace.js.src.html +0 -1
- package/docs/source/lib/goog/testing/strictmock.js.src.html +0 -1
- package/docs/source/lib/goog/testing/testcase.js.src.html +0 -1
- package/docs/source/lib/goog/testing/testrunner.js.src.html +0 -1
- package/docs/source/lib/goog/uri/uri.js.src.html +0 -1
- package/docs/source/lib/goog/uri/utils.js.src.html +0 -1
- package/docs/source/lib/goog/useragent/product.js.src.html +0 -1
- package/docs/source/lib/goog/useragent/product_isversion.js.src.html +0 -1
- package/docs/source/lib/goog/useragent/useragent.js.src.html +0 -1
- package/docs/source/lib/webdriver/actionsequence.js.src.html +0 -1
- package/docs/source/lib/webdriver/button.js.src.html +0 -1
- package/docs/source/lib/webdriver/capabilities.js.src.html +0 -1
- package/docs/source/lib/webdriver/command.js.src.html +0 -1
- package/docs/source/lib/webdriver/events.js.src.html +0 -1
- package/docs/source/lib/webdriver/http/http.js.src.html +0 -1
- package/docs/source/lib/webdriver/key.js.src.html +0 -1
- package/docs/source/lib/webdriver/locators.js.src.html +0 -1
- package/docs/source/lib/webdriver/logging.js.src.html +0 -1
- package/docs/source/lib/webdriver/promise.js.src.html +0 -1
- package/docs/source/lib/webdriver/serializable.js.src.html +0 -1
- package/docs/source/lib/webdriver/session.js.src.html +0 -1
- package/docs/source/lib/webdriver/stacktrace.js.src.html +0 -1
- package/docs/source/lib/webdriver/testing/asserts.js.src.html +0 -1
- package/docs/source/lib/webdriver/touchsequence.js.src.html +0 -1
- package/docs/source/lib/webdriver/until.js.src.html +0 -1
- package/docs/source/lib/webdriver/webdriver.js.src.html +0 -1
- package/docs/source/net/index.js.src.html +0 -1
- package/docs/source/net/portprober.js.src.html +0 -1
- package/docs/source/opera.js.src.html +0 -1
- package/docs/source/phantomjs.js.src.html +0 -1
- package/docs/source/proxy.js.src.html +0 -1
- package/docs/source/remote/index.js.src.html +0 -1
- package/docs/source/safari.js.src.html +0 -1
- package/docs/source/testing/assert.js.src.html +0 -1
- package/docs/source/testing/index.js.src.html +0 -1
- package/docs/types.js +0 -1
- package/lib/atoms/error.js +0 -202
- package/lib/atoms/json.js +0 -80
- package/lib/atoms/response.js +0 -110
- package/lib/atoms/userAgent.js +0 -257
- package/lib/goog/LICENSE +0 -176
- package/lib/goog/array/array.js +0 -1654
- package/lib/goog/asserts/asserts.js +0 -365
- package/lib/goog/async/freelist.js +0 -88
- package/lib/goog/async/nexttick.js +0 -241
- package/lib/goog/async/run.js +0 -133
- package/lib/goog/async/workqueue.js +0 -139
- package/lib/goog/base.js +0 -2548
- package/lib/goog/debug/debug.js +0 -653
- package/lib/goog/debug/entrypointregistry.js +0 -158
- package/lib/goog/debug/error.js +0 -63
- package/lib/goog/debug/logbuffer.js +0 -148
- package/lib/goog/debug/logger.js +0 -873
- package/lib/goog/debug/logrecord.js +0 -242
- package/lib/goog/deps.js +0 -151
- package/lib/goog/disposable/disposable.js +0 -307
- package/lib/goog/disposable/idisposable.js +0 -45
- package/lib/goog/dom/browserfeature.js +0 -72
- package/lib/goog/dom/dom.js +0 -2991
- package/lib/goog/dom/nodetype.js +0 -48
- package/lib/goog/dom/safe.js +0 -347
- package/lib/goog/dom/tagname.js +0 -160
- package/lib/goog/dom/tags.js +0 -41
- package/lib/goog/dom/vendor.js +0 -96
- package/lib/goog/events/browserevent.js +0 -400
- package/lib/goog/events/browserfeature.js +0 -85
- package/lib/goog/events/event.js +0 -143
- package/lib/goog/events/eventid.js +0 -47
- package/lib/goog/events/events.js +0 -984
- package/lib/goog/events/eventtarget.js +0 -394
- package/lib/goog/events/eventtype.js +0 -237
- package/lib/goog/events/keycodes.js +0 -427
- package/lib/goog/events/listenable.js +0 -335
- package/lib/goog/events/listener.js +0 -131
- package/lib/goog/events/listenermap.js +0 -308
- package/lib/goog/fs/url.js +0 -109
- package/lib/goog/functions/functions.js +0 -442
- package/lib/goog/html/safehtml.js +0 -757
- package/lib/goog/html/safescript.js +0 -234
- package/lib/goog/html/safestyle.js +0 -442
- package/lib/goog/html/safestylesheet.js +0 -276
- package/lib/goog/html/safeurl.js +0 -398
- package/lib/goog/html/trustedresourceurl.js +0 -224
- package/lib/goog/html/uncheckedconversions.js +0 -232
- package/lib/goog/i18n/bidi.js +0 -908
- package/lib/goog/iter/iter.js +0 -1302
- package/lib/goog/json/json.js +0 -363
- package/lib/goog/labs/testing/assertthat.js +0 -58
- package/lib/goog/labs/testing/logicmatcher.js +0 -212
- package/lib/goog/labs/testing/matcher.js +0 -80
- package/lib/goog/labs/testing/numbermatcher.js +0 -346
- package/lib/goog/labs/testing/objectmatcher.js +0 -317
- package/lib/goog/labs/testing/stringmatcher.js +0 -415
- package/lib/goog/labs/useragent/browser.js +0 -341
- package/lib/goog/labs/useragent/engine.js +0 -160
- package/lib/goog/labs/useragent/platform.js +0 -160
- package/lib/goog/labs/useragent/util.js +0 -148
- package/lib/goog/log/log.js +0 -197
- package/lib/goog/math/box.js +0 -398
- package/lib/goog/math/coordinate.js +0 -268
- package/lib/goog/math/math.js +0 -451
- package/lib/goog/math/rect.js +0 -476
- package/lib/goog/math/size.js +0 -227
- package/lib/goog/net/wrapperxmlhttpfactory.js +0 -71
- package/lib/goog/net/xhrlike.js +0 -124
- package/lib/goog/net/xmlhttp.js +0 -246
- package/lib/goog/net/xmlhttpfactory.js +0 -67
- package/lib/goog/object/object.js +0 -686
- package/lib/goog/promise/promise.js +0 -1350
- package/lib/goog/promise/resolver.js +0 -48
- package/lib/goog/promise/thenable.js +0 -126
- package/lib/goog/reflect/reflect.js +0 -77
- package/lib/goog/string/const.js +0 -182
- package/lib/goog/string/string.js +0 -1599
- package/lib/goog/string/typedstring.js +0 -48
- package/lib/goog/structs/collection.js +0 -56
- package/lib/goog/structs/map.js +0 -457
- package/lib/goog/structs/set.js +0 -279
- package/lib/goog/structs/structs.js +0 -354
- package/lib/goog/style/style.js +0 -2037
- package/lib/goog/testing/asserts.js +0 -1278
- package/lib/goog/testing/events/events.js +0 -767
- package/lib/goog/testing/functionmock.js +0 -175
- package/lib/goog/testing/jsunit.js +0 -162
- package/lib/goog/testing/loosemock.js +0 -242
- package/lib/goog/testing/mock.js +0 -645
- package/lib/goog/testing/mockclock.js +0 -606
- package/lib/goog/testing/mockcontrol.js +0 -220
- package/lib/goog/testing/mockinterface.js +0 -45
- package/lib/goog/testing/mockmatchers.js +0 -400
- package/lib/goog/testing/objectpropertystring.js +0 -68
- package/lib/goog/testing/propertyreplacer.js +0 -262
- package/lib/goog/testing/recordfunction.js +0 -215
- package/lib/goog/testing/stacktrace.js +0 -594
- package/lib/goog/testing/strictmock.js +0 -130
- package/lib/goog/testing/testcase.js +0 -1629
- package/lib/goog/testing/testrunner.js +0 -440
- package/lib/goog/uri/uri.js +0 -1524
- package/lib/goog/uri/utils.js +0 -1064
- package/lib/goog/useragent/product.js +0 -183
- package/lib/goog/useragent/product_isversion.js +0 -144
- package/lib/goog/useragent/useragent.js +0 -572
- package/lib/webdriver/actionsequence.js +0 -356
- package/lib/webdriver/builder.js +0 -207
- package/lib/webdriver/capabilities.js +0 -412
- package/lib/webdriver/events.js +0 -179
- package/lib/webdriver/firefoxdomexecutor.js +0 -175
- package/lib/webdriver/http/corsclient.js +0 -133
- package/lib/webdriver/http/http.js +0 -525
- package/lib/webdriver/http/xhrclient.js +0 -67
- package/lib/webdriver/locators.js +0 -257
- package/lib/webdriver/logging.js +0 -347
- package/lib/webdriver/session.js +0 -74
- package/lib/webdriver/stacktrace.js +0 -619
- package/lib/webdriver/test/builder_test.js +0 -53
- package/lib/webdriver/test/capabilities_test.js +0 -72
- package/lib/webdriver/test/events_test.js +0 -203
- package/lib/webdriver/test/http/corsclient_test.js +0 -151
- package/lib/webdriver/test/http/http_test.js +0 -428
- package/lib/webdriver/test/http/xhrclient_test.js +0 -196
- package/lib/webdriver/test/locators_test.js +0 -59
- package/lib/webdriver/test/logging_test.js +0 -85
- package/lib/webdriver/test/promise_error_test.js +0 -892
- package/lib/webdriver/test/promise_flow_test.js +0 -2365
- package/lib/webdriver/test/promise_generator_test.js +0 -323
- package/lib/webdriver/test/promise_test.js +0 -2012
- package/lib/webdriver/test/stacktrace_test.js +0 -480
- package/lib/webdriver/test/test_bootstrap.js +0 -67
- package/lib/webdriver/test/testing/asserts_test.js +0 -117
- package/lib/webdriver/test/testing/client_test.js +0 -88
- package/lib/webdriver/test/testing/testcase_test.js +0 -229
- package/lib/webdriver/test/testutil.js +0 -209
- package/lib/webdriver/test/testutil_test.js +0 -104
- package/lib/webdriver/test/until_test.js +0 -411
- package/lib/webdriver/test/webdriver_generator_test.js +0 -92
- package/lib/webdriver/test/webdriver_test.js +0 -2369
- package/lib/webdriver/testing/asserts.js +0 -487
- package/lib/webdriver/testing/client.js +0 -179
- package/lib/webdriver/testing/jsunit.js +0 -363
- package/lib/webdriver/testing/testcase.js +0 -168
- package/lib/webdriver/testing/window.js +0 -244
- package/lib/webdriver/touchsequence.js +0 -248
- package/lib/webdriver/until.js +0 -412
- package/lib/webdriver/webdriver.js +0 -2511
- 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>until.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/until.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>// "License"); 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>// "AS IS" 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 common conditions for use with<tr><td><a id="l20"></a><a href="#l20">20</a><td> * {@link webdriver.WebDriver#wait WebDriver wait}.<tr><td><a id="l21"></a><a href="#l21">21</a><td> *<tr><td><a id="l22"></a><a href="#l22">22</a><td> * Sample usage:<tr><td><a id="l23"></a><a href="#l23">23</a><td> *<tr><td><a id="l24"></a><a href="#l24">24</a><td> * driver.get('http://www.google.com/ncr');<tr><td><a id="l25"></a><a href="#l25">25</a><td> *<tr><td><a id="l26"></a><a href="#l26">26</a><td> * var query = driver.wait(until.elementLocated(By.name('q')));<tr><td><a id="l27"></a><a href="#l27">27</a><td> * query.sendKeys('webdriver\n');<tr><td><a id="l28"></a><a href="#l28">28</a><td> *<tr><td><a id="l29"></a><a href="#l29">29</a><td> * driver.wait(until.titleIs('webdriver - Google Search'));<tr><td><a id="l30"></a><a href="#l30">30</a><td> *<tr><td><a id="l31"></a><a href="#l31">31</a><td> * To define a custom condition, simply call WebDriver.wait with a function<tr><td><a id="l32"></a><a href="#l32">32</a><td> * that will eventually return a truthy-value (neither null, undefined, false,<tr><td><a id="l33"></a><a href="#l33">33</a><td> * 0, or the empty string):<tr><td><a id="l34"></a><a href="#l34">34</a><td> *<tr><td><a id="l35"></a><a href="#l35">35</a><td> * driver.wait(function() {<tr><td><a id="l36"></a><a href="#l36">36</a><td> * return driver.getTitle().then(function(title) {<tr><td><a id="l37"></a><a href="#l37">37</a><td> * return title === 'webdriver - Google Search';<tr><td><a id="l38"></a><a href="#l38">38</a><td> * });<tr><td><a id="l39"></a><a href="#l39">39</a><td> * }, 1000);<tr><td><a id="l40"></a><a href="#l40">40</a><td> */<tr><td><a id="l41"></a><a href="#l41">41</a><td><tr><td><a id="l42"></a><a href="#l42">42</a><td>goog.provide('webdriver.until');<tr><td><a id="l43"></a><a href="#l43">43</a><td><tr><td><a id="l44"></a><a href="#l44">44</a><td>goog.require('bot.ErrorCode');<tr><td><a id="l45"></a><a href="#l45">45</a><td>goog.require('goog.array');<tr><td><a id="l46"></a><a href="#l46">46</a><td>goog.require('goog.string');<tr><td><a id="l47"></a><a href="#l47">47</a><td>goog.require('webdriver.Locator');<tr><td><a id="l48"></a><a href="#l48">48</a><td><tr><td><a id="l49"></a><a href="#l49">49</a><td><tr><td><a id="l50"></a><a href="#l50">50</a><td><tr><td><a id="l51"></a><a href="#l51">51</a><td>goog.scope(function() {<tr><td><a id="l52"></a><a href="#l52">52</a><td><tr><td><a id="l53"></a><a href="#l53">53</a><td>var until = webdriver.until;<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> * Defines a condition to<tr><td><a id="l58"></a><a href="#l58">58</a><td> * @param {string} message A descriptive error message. Should complete the<tr><td><a id="l59"></a><a href="#l59">59</a><td> * sentence "Waiting [...]"<tr><td><a id="l60"></a><a href="#l60">60</a><td> * @param {function(!webdriver.WebDriver): OUT} fn The condition function to<tr><td><a id="l61"></a><a href="#l61">61</a><td> * evaluate on each iteration of the wait loop.<tr><td><a id="l62"></a><a href="#l62">62</a><td> * @constructor<tr><td><a id="l63"></a><a href="#l63">63</a><td> * @struct<tr><td><a id="l64"></a><a href="#l64">64</a><td> * @final<tr><td><a id="l65"></a><a href="#l65">65</a><td> * @template OUT<tr><td><a id="l66"></a><a href="#l66">66</a><td> */<tr><td><a id="l67"></a><a href="#l67">67</a><td>until.Condition = function(message, fn) {<tr><td><a id="l68"></a><a href="#l68">68</a><td> /** @private {string} */<tr><td><a id="l69"></a><a href="#l69">69</a><td> this.description_ = 'Waiting ' + message;<tr><td><a id="l70"></a><a href="#l70">70</a><td><tr><td><a id="l71"></a><a href="#l71">71</a><td> /** @type {function(!webdriver.WebDriver): OUT} */<tr><td><a id="l72"></a><a href="#l72">72</a><td> this.fn = fn;<tr><td><a id="l73"></a><a href="#l73">73</a><td>};<tr><td><a id="l74"></a><a href="#l74">74</a><td><tr><td><a id="l75"></a><a href="#l75">75</a><td><tr><td><a id="l76"></a><a href="#l76">76</a><td>/** @return {string} A description of this condition. */<tr><td><a id="l77"></a><a href="#l77">77</a><td>until.Condition.prototype.description = function() {<tr><td><a id="l78"></a><a href="#l78">78</a><td> return this.description_;<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><tr><td><a id="l82"></a><a href="#l82">82</a><td>/**<tr><td><a id="l83"></a><a href="#l83">83</a><td> * Creates a condition that will wait until the input driver is able to switch<tr><td><a id="l84"></a><a href="#l84">84</a><td> * to the designated frame. The target frame may be specified as<tr><td><a id="l85"></a><a href="#l85">85</a><td> *<tr><td><a id="l86"></a><a href="#l86">86</a><td> * 1. a numeric index into<tr><td><a id="l87"></a><a href="#l87">87</a><td> * [window.frames](https://developer.mozilla.org/en-US/docs/Web/API/Window.frames)<tr><td><a id="l88"></a><a href="#l88">88</a><td> * for the currently selected frame.<tr><td><a id="l89"></a><a href="#l89">89</a><td> * 2. a {@link webdriver.WebElement}, which must reference a FRAME or IFRAME<tr><td><a id="l90"></a><a href="#l90">90</a><td> * element on the current page.<tr><td><a id="l91"></a><a href="#l91">91</a><td> * 3. a locator which may be used to first locate a FRAME or IFRAME on the<tr><td><a id="l92"></a><a href="#l92">92</a><td> * current page before attempting to switch to it.<tr><td><a id="l93"></a><a href="#l93">93</a><td> *<tr><td><a id="l94"></a><a href="#l94">94</a><td> * Upon successful resolution of this condition, the driver will be left<tr><td><a id="l95"></a><a href="#l95">95</a><td> * focused on the new frame.<tr><td><a id="l96"></a><a href="#l96">96</a><td> *<tr><td><a id="l97"></a><a href="#l97">97</a><td> * @param {!(number|webdriver.WebElement|<tr><td><a id="l98"></a><a href="#l98">98</a><td> * webdriver.Locator|webdriver.By.Hash|<tr><td><a id="l99"></a><a href="#l99">99</a><td> * function(!webdriver.WebDriver): !webdriver.WebElement)} frame<tr><td><a id="l100"></a><a href="#l100">100</a><td> * The frame identifier.<tr><td><a id="l101"></a><a href="#l101">101</a><td> * @return {!until.Condition.<boolean>} A new condition.<tr><td><a id="l102"></a><a href="#l102">102</a><td> */<tr><td><a id="l103"></a><a href="#l103">103</a><td>until.ableToSwitchToFrame = function(frame) {<tr><td><a id="l104"></a><a href="#l104">104</a><td> var condition;<tr><td><a id="l105"></a><a href="#l105">105</a><td> if (goog.isNumber(frame) || frame instanceof webdriver.WebElement) {<tr><td><a id="l106"></a><a href="#l106">106</a><td> condition = attemptToSwitchFrames;<tr><td><a id="l107"></a><a href="#l107">107</a><td> } else {<tr><td><a id="l108"></a><a href="#l108">108</a><td> condition = function(driver) {<tr><td><a id="l109"></a><a href="#l109">109</a><td> var locator =<tr><td><a id="l110"></a><a href="#l110">110</a><td> /** @type {!(webdriver.Locator|webdriver.By.Hash|Function)} */(frame);<tr><td><a id="l111"></a><a href="#l111">111</a><td> return driver.findElements(locator).then(function(els) {<tr><td><a id="l112"></a><a href="#l112">112</a><td> if (els.length) {<tr><td><a id="l113"></a><a href="#l113">113</a><td> return attemptToSwitchFrames(driver, els[0]);<tr><td><a id="l114"></a><a href="#l114">114</a><td> }<tr><td><a id="l115"></a><a href="#l115">115</a><td> });<tr><td><a id="l116"></a><a href="#l116">116</a><td> };<tr><td><a id="l117"></a><a href="#l117">117</a><td> }<tr><td><a id="l118"></a><a href="#l118">118</a><td><tr><td><a id="l119"></a><a href="#l119">119</a><td> return new until.Condition('to be able to switch to frame', condition);<tr><td><a id="l120"></a><a href="#l120">120</a><td><tr><td><a id="l121"></a><a href="#l121">121</a><td> function attemptToSwitchFrames(driver, frame) {<tr><td><a id="l122"></a><a href="#l122">122</a><td> return driver.switchTo().frame(frame).then(<tr><td><a id="l123"></a><a href="#l123">123</a><td> function() { return true; },<tr><td><a id="l124"></a><a href="#l124">124</a><td> function(e) {<tr><td><a id="l125"></a><a href="#l125">125</a><td> if (e && e.code !== bot.ErrorCode.NO_SUCH_FRAME) {<tr><td><a id="l126"></a><a href="#l126">126</a><td> throw e;<tr><td><a id="l127"></a><a href="#l127">127</a><td> }<tr><td><a id="l128"></a><a href="#l128">128</a><td> });<tr><td><a id="l129"></a><a href="#l129">129</a><td> }<tr><td><a id="l130"></a><a href="#l130">130</a><td>};<tr><td><a id="l131"></a><a href="#l131">131</a><td><tr><td><a id="l132"></a><a href="#l132">132</a><td><tr><td><a id="l133"></a><a href="#l133">133</a><td>/**<tr><td><a id="l134"></a><a href="#l134">134</a><td> * Creates a condition that waits for an alert to be opened. Upon success, the<tr><td><a id="l135"></a><a href="#l135">135</a><td> * returned promise will be fulfilled with the handle for the opened alert.<tr><td><a id="l136"></a><a href="#l136">136</a><td> *<tr><td><a id="l137"></a><a href="#l137">137</a><td> * @return {!until.Condition.<!webdriver.Alert>} The new condition.<tr><td><a id="l138"></a><a href="#l138">138</a><td> */<tr><td><a id="l139"></a><a href="#l139">139</a><td>until.alertIsPresent = function() {<tr><td><a id="l140"></a><a href="#l140">140</a><td> return new until.Condition('for alert to be present', function(driver) {<tr><td><a id="l141"></a><a href="#l141">141</a><td> return driver.switchTo().alert().thenCatch(function(e) {<tr><td><a id="l142"></a><a href="#l142">142</a><td> if (e && e.code !== bot.ErrorCode.NO_SUCH_ALERT) {<tr><td><a id="l143"></a><a href="#l143">143</a><td> throw e;<tr><td><a id="l144"></a><a href="#l144">144</a><td> }<tr><td><a id="l145"></a><a href="#l145">145</a><td> });<tr><td><a id="l146"></a><a href="#l146">146</a><td> });<tr><td><a id="l147"></a><a href="#l147">147</a><td>};<tr><td><a id="l148"></a><a href="#l148">148</a><td><tr><td><a id="l149"></a><a href="#l149">149</a><td><tr><td><a id="l150"></a><a href="#l150">150</a><td>/**<tr><td><a id="l151"></a><a href="#l151">151</a><td> * Creates a condition that will wait for the current page's title to match the<tr><td><a id="l152"></a><a href="#l152">152</a><td> * given value.<tr><td><a id="l153"></a><a href="#l153">153</a><td> *<tr><td><a id="l154"></a><a href="#l154">154</a><td> * @param {string} title The expected page title.<tr><td><a id="l155"></a><a href="#l155">155</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l156"></a><a href="#l156">156</a><td> */<tr><td><a id="l157"></a><a href="#l157">157</a><td>until.titleIs = function(title) {<tr><td><a id="l158"></a><a href="#l158">158</a><td> return new until.Condition(<tr><td><a id="l159"></a><a href="#l159">159</a><td> 'for title to be ' + goog.string.quote(title),<tr><td><a id="l160"></a><a href="#l160">160</a><td> function(driver) {<tr><td><a id="l161"></a><a href="#l161">161</a><td> return driver.getTitle().then(function(t) {<tr><td><a id="l162"></a><a href="#l162">162</a><td> return t === title;<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>};<tr><td><a id="l166"></a><a href="#l166">166</a><td><tr><td><a id="l167"></a><a href="#l167">167</a><td><tr><td><a id="l168"></a><a href="#l168">168</a><td>/**<tr><td><a id="l169"></a><a href="#l169">169</a><td> * Creates a condition that will wait for the current page's title to contain<tr><td><a id="l170"></a><a href="#l170">170</a><td> * the given substring.<tr><td><a id="l171"></a><a href="#l171">171</a><td> *<tr><td><a id="l172"></a><a href="#l172">172</a><td> * @param {string} substr The substring that should be present in the page<tr><td><a id="l173"></a><a href="#l173">173</a><td> * title.<tr><td><a id="l174"></a><a href="#l174">174</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l175"></a><a href="#l175">175</a><td> */<tr><td><a id="l176"></a><a href="#l176">176</a><td>until.titleContains = function(substr) {<tr><td><a id="l177"></a><a href="#l177">177</a><td> return new until.Condition(<tr><td><a id="l178"></a><a href="#l178">178</a><td> 'for title to contain ' + goog.string.quote(substr),<tr><td><a id="l179"></a><a href="#l179">179</a><td> function(driver) {<tr><td><a id="l180"></a><a href="#l180">180</a><td> return driver.getTitle().then(function(title) {<tr><td><a id="l181"></a><a href="#l181">181</a><td> return title.indexOf(substr) !== -1;<tr><td><a id="l182"></a><a href="#l182">182</a><td> });<tr><td><a id="l183"></a><a href="#l183">183</a><td> });<tr><td><a id="l184"></a><a href="#l184">184</a><td>};<tr><td><a id="l185"></a><a href="#l185">185</a><td><tr><td><a id="l186"></a><a href="#l186">186</a><td><tr><td><a id="l187"></a><a href="#l187">187</a><td>/**<tr><td><a id="l188"></a><a href="#l188">188</a><td> * Creates a condition that will wait for the current page's title to match the<tr><td><a id="l189"></a><a href="#l189">189</a><td> * given regular expression.<tr><td><a id="l190"></a><a href="#l190">190</a><td> *<tr><td><a id="l191"></a><a href="#l191">191</a><td> * @param {!RegExp} regex The regular expression to test against.<tr><td><a id="l192"></a><a href="#l192">192</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l193"></a><a href="#l193">193</a><td> */<tr><td><a id="l194"></a><a href="#l194">194</a><td>until.titleMatches = function(regex) {<tr><td><a id="l195"></a><a href="#l195">195</a><td> return new until.Condition('for title to match ' + regex, function(driver) {<tr><td><a id="l196"></a><a href="#l196">196</a><td> return driver.getTitle().then(function(title) {<tr><td><a id="l197"></a><a href="#l197">197</a><td> return regex.test(title);<tr><td><a id="l198"></a><a href="#l198">198</a><td> });<tr><td><a id="l199"></a><a href="#l199">199</a><td> });<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>/**<tr><td><a id="l204"></a><a href="#l204">204</a><td> * Creates a condition that will loop until an element is<tr><td><a id="l205"></a><a href="#l205">205</a><td> * {@link webdriver.WebDriver#findElement found} with the given locator.<tr><td><a id="l206"></a><a href="#l206">206</a><td> *<tr><td><a id="l207"></a><a href="#l207">207</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator<tr><td><a id="l208"></a><a href="#l208">208</a><td> * to use.<tr><td><a id="l209"></a><a href="#l209">209</a><td> * @return {!until.Condition.<!webdriver.WebElement>} The new condition.<tr><td><a id="l210"></a><a href="#l210">210</a><td> */<tr><td><a id="l211"></a><a href="#l211">211</a><td>until.elementLocated = function(locator) {<tr><td><a id="l212"></a><a href="#l212">212</a><td> locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l213"></a><a href="#l213">213</a><td> var locatorStr = goog.isFunction(locator) ? 'by function()' : locator + '';<tr><td><a id="l214"></a><a href="#l214">214</a><td> return new until.Condition('for element to be located ' + locatorStr,<tr><td><a id="l215"></a><a href="#l215">215</a><td> function(driver) {<tr><td><a id="l216"></a><a href="#l216">216</a><td> return driver.findElements(locator).then(function(elements) {<tr><td><a id="l217"></a><a href="#l217">217</a><td> return elements[0];<tr><td><a id="l218"></a><a href="#l218">218</a><td> });<tr><td><a id="l219"></a><a href="#l219">219</a><td> });<tr><td><a id="l220"></a><a href="#l220">220</a><td>};<tr><td><a id="l221"></a><a href="#l221">221</a><td><tr><td><a id="l222"></a><a href="#l222">222</a><td><tr><td><a id="l223"></a><a href="#l223">223</a><td>/**<tr><td><a id="l224"></a><a href="#l224">224</a><td> * Creates a condition that will loop until at least one element is<tr><td><a id="l225"></a><a href="#l225">225</a><td> * {@link webdriver.WebDriver#findElement found} with the given locator.<tr><td><a id="l226"></a><a href="#l226">226</a><td> *<tr><td><a id="l227"></a><a href="#l227">227</a><td> * @param {!(webdriver.Locator|webdriver.By.Hash|Function)} locator The locator<tr><td><a id="l228"></a><a href="#l228">228</a><td> * to use.<tr><td><a id="l229"></a><a href="#l229">229</a><td> * @return {!until.Condition.<!Array.<!webdriver.WebElement>>} The new<tr><td><a id="l230"></a><a href="#l230">230</a><td> * condition.<tr><td><a id="l231"></a><a href="#l231">231</a><td> */<tr><td><a id="l232"></a><a href="#l232">232</a><td>until.elementsLocated = function(locator) {<tr><td><a id="l233"></a><a href="#l233">233</a><td> locator = webdriver.Locator.checkLocator(locator);<tr><td><a id="l234"></a><a href="#l234">234</a><td> var locatorStr = goog.isFunction(locator) ? 'by function()' : locator + '';<tr><td><a id="l235"></a><a href="#l235">235</a><td> return new until.Condition(<tr><td><a id="l236"></a><a href="#l236">236</a><td> 'for at least one element to be located ' + locatorStr,<tr><td><a id="l237"></a><a href="#l237">237</a><td> function(driver) {<tr><td><a id="l238"></a><a href="#l238">238</a><td> return driver.findElements(locator).then(function(elements) {<tr><td><a id="l239"></a><a href="#l239">239</a><td> return elements.length > 0 ? elements : null;<tr><td><a id="l240"></a><a href="#l240">240</a><td> });<tr><td><a id="l241"></a><a href="#l241">241</a><td> });<tr><td><a id="l242"></a><a href="#l242">242</a><td>};<tr><td><a id="l243"></a><a href="#l243">243</a><td><tr><td><a id="l244"></a><a href="#l244">244</a><td><tr><td><a id="l245"></a><a href="#l245">245</a><td>/**<tr><td><a id="l246"></a><a href="#l246">246</a><td> * Creates a condition that will wait for the given element to become stale. An<tr><td><a id="l247"></a><a href="#l247">247</a><td> * element is considered stale once it is removed from the DOM, or a new page<tr><td><a id="l248"></a><a href="#l248">248</a><td> * has loaded.<tr><td><a id="l249"></a><a href="#l249">249</a><td> *<tr><td><a id="l250"></a><a href="#l250">250</a><td> * @param {!webdriver.WebElement} element The element that should become stale.<tr><td><a id="l251"></a><a href="#l251">251</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l252"></a><a href="#l252">252</a><td> */<tr><td><a id="l253"></a><a href="#l253">253</a><td>until.stalenessOf = function(element) {<tr><td><a id="l254"></a><a href="#l254">254</a><td> return new until.Condition('element to become stale', function() {<tr><td><a id="l255"></a><a href="#l255">255</a><td> return element.getTagName().then(<tr><td><a id="l256"></a><a href="#l256">256</a><td> function() { return false; },<tr><td><a id="l257"></a><a href="#l257">257</a><td> function(e) {<tr><td><a id="l258"></a><a href="#l258">258</a><td> if (e.code === bot.ErrorCode.STALE_ELEMENT_REFERENCE) {<tr><td><a id="l259"></a><a href="#l259">259</a><td> return true;<tr><td><a id="l260"></a><a href="#l260">260</a><td> }<tr><td><a id="l261"></a><a href="#l261">261</a><td> throw e;<tr><td><a id="l262"></a><a href="#l262">262</a><td> });<tr><td><a id="l263"></a><a href="#l263">263</a><td> });<tr><td><a id="l264"></a><a href="#l264">264</a><td>};<tr><td><a id="l265"></a><a href="#l265">265</a><td><tr><td><a id="l266"></a><a href="#l266">266</a><td><tr><td><a id="l267"></a><a href="#l267">267</a><td>/**<tr><td><a id="l268"></a><a href="#l268">268</a><td> * Creates a condition that will wait for the given element to become visible.<tr><td><a id="l269"></a><a href="#l269">269</a><td> *<tr><td><a id="l270"></a><a href="#l270">270</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l271"></a><a href="#l271">271</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l272"></a><a href="#l272">272</a><td> * @see webdriver.WebDriver#isDisplayed<tr><td><a id="l273"></a><a href="#l273">273</a><td> */<tr><td><a id="l274"></a><a href="#l274">274</a><td>until.elementIsVisible = function(element) {<tr><td><a id="l275"></a><a href="#l275">275</a><td> return new until.Condition('until element is visible', function() {<tr><td><a id="l276"></a><a href="#l276">276</a><td> return element.isDisplayed();<tr><td><a id="l277"></a><a href="#l277">277</a><td> });<tr><td><a id="l278"></a><a href="#l278">278</a><td>};<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>/**<tr><td><a id="l282"></a><a href="#l282">282</a><td> * Creates a condition that will wait for the given element to be in the DOM,<tr><td><a id="l283"></a><a href="#l283">283</a><td> * yet not visible to the user.<tr><td><a id="l284"></a><a href="#l284">284</a><td> *<tr><td><a id="l285"></a><a href="#l285">285</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l286"></a><a href="#l286">286</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l287"></a><a href="#l287">287</a><td> * @see webdriver.WebDriver#isDisplayed<tr><td><a id="l288"></a><a href="#l288">288</a><td> */<tr><td><a id="l289"></a><a href="#l289">289</a><td>until.elementIsNotVisible = function(element) {<tr><td><a id="l290"></a><a href="#l290">290</a><td> return new until.Condition('until element is not visible', function() {<tr><td><a id="l291"></a><a href="#l291">291</a><td> return element.isDisplayed().then(function(v) {<tr><td><a id="l292"></a><a href="#l292">292</a><td> return !v;<tr><td><a id="l293"></a><a href="#l293">293</a><td> });<tr><td><a id="l294"></a><a href="#l294">294</a><td> });<tr><td><a id="l295"></a><a href="#l295">295</a><td>};<tr><td><a id="l296"></a><a href="#l296">296</a><td><tr><td><a id="l297"></a><a href="#l297">297</a><td><tr><td><a id="l298"></a><a href="#l298">298</a><td>/**<tr><td><a id="l299"></a><a href="#l299">299</a><td> * Creates a condition that will wait for the given element to be enabled.<tr><td><a id="l300"></a><a href="#l300">300</a><td> *<tr><td><a id="l301"></a><a href="#l301">301</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l302"></a><a href="#l302">302</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l303"></a><a href="#l303">303</a><td> * @see webdriver.WebDriver#isEnabled<tr><td><a id="l304"></a><a href="#l304">304</a><td> */<tr><td><a id="l305"></a><a href="#l305">305</a><td>until.elementIsEnabled = function(element) {<tr><td><a id="l306"></a><a href="#l306">306</a><td> return new until.Condition('until element is enabled', function() {<tr><td><a id="l307"></a><a href="#l307">307</a><td> return element.isEnabled();<tr><td><a id="l308"></a><a href="#l308">308</a><td> });<tr><td><a id="l309"></a><a href="#l309">309</a><td>};<tr><td><a id="l310"></a><a href="#l310">310</a><td><tr><td><a id="l311"></a><a href="#l311">311</a><td><tr><td><a id="l312"></a><a href="#l312">312</a><td>/**<tr><td><a id="l313"></a><a href="#l313">313</a><td> * Creates a condition that will wait for the given element to be disabled.<tr><td><a id="l314"></a><a href="#l314">314</a><td> *<tr><td><a id="l315"></a><a href="#l315">315</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l316"></a><a href="#l316">316</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l317"></a><a href="#l317">317</a><td> * @see webdriver.WebDriver#isEnabled<tr><td><a id="l318"></a><a href="#l318">318</a><td> */<tr><td><a id="l319"></a><a href="#l319">319</a><td>until.elementIsDisabled = function(element) {<tr><td><a id="l320"></a><a href="#l320">320</a><td> return new until.Condition('until element is disabled', function() {<tr><td><a id="l321"></a><a href="#l321">321</a><td> return element.isEnabled().then(function(v) {<tr><td><a id="l322"></a><a href="#l322">322</a><td> return !v;<tr><td><a id="l323"></a><a href="#l323">323</a><td> });<tr><td><a id="l324"></a><a href="#l324">324</a><td> });<tr><td><a id="l325"></a><a href="#l325">325</a><td>};<tr><td><a id="l326"></a><a href="#l326">326</a><td><tr><td><a id="l327"></a><a href="#l327">327</a><td><tr><td><a id="l328"></a><a href="#l328">328</a><td>/**<tr><td><a id="l329"></a><a href="#l329">329</a><td> * Creates a condition that will wait for the given element to be selected.<tr><td><a id="l330"></a><a href="#l330">330</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l331"></a><a href="#l331">331</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l332"></a><a href="#l332">332</a><td> * @see webdriver.WebDriver#isSelected<tr><td><a id="l333"></a><a href="#l333">333</a><td> */<tr><td><a id="l334"></a><a href="#l334">334</a><td>until.elementIsSelected = function(element) {<tr><td><a id="l335"></a><a href="#l335">335</a><td> return new until.Condition('until element is selected', function() {<tr><td><a id="l336"></a><a href="#l336">336</a><td> return element.isSelected();<tr><td><a id="l337"></a><a href="#l337">337</a><td> });<tr><td><a id="l338"></a><a href="#l338">338</a><td>};<tr><td><a id="l339"></a><a href="#l339">339</a><td><tr><td><a id="l340"></a><a href="#l340">340</a><td><tr><td><a id="l341"></a><a href="#l341">341</a><td>/**<tr><td><a id="l342"></a><a href="#l342">342</a><td> * Creates a condition that will wait for the given element to be deselected.<tr><td><a id="l343"></a><a href="#l343">343</a><td> *<tr><td><a id="l344"></a><a href="#l344">344</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l345"></a><a href="#l345">345</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l346"></a><a href="#l346">346</a><td> * @see webdriver.WebDriver#isSelected<tr><td><a id="l347"></a><a href="#l347">347</a><td> */<tr><td><a id="l348"></a><a href="#l348">348</a><td>until.elementIsNotSelected = function(element) {<tr><td><a id="l349"></a><a href="#l349">349</a><td> return new until.Condition('until element is not selected', function() {<tr><td><a id="l350"></a><a href="#l350">350</a><td> return element.isSelected().then(function(v) {<tr><td><a id="l351"></a><a href="#l351">351</a><td> return !v;<tr><td><a id="l352"></a><a href="#l352">352</a><td> });<tr><td><a id="l353"></a><a href="#l353">353</a><td> });<tr><td><a id="l354"></a><a href="#l354">354</a><td>};<tr><td><a id="l355"></a><a href="#l355">355</a><td><tr><td><a id="l356"></a><a href="#l356">356</a><td><tr><td><a id="l357"></a><a href="#l357">357</a><td>/**<tr><td><a id="l358"></a><a href="#l358">358</a><td> * Creates a condition that will wait for the given element's<tr><td><a id="l359"></a><a href="#l359">359</a><td> * {@link webdriver.WebDriver#getText visible text} to match the given<tr><td><a id="l360"></a><a href="#l360">360</a><td> * {@code text} exactly.<tr><td><a id="l361"></a><a href="#l361">361</a><td> *<tr><td><a id="l362"></a><a href="#l362">362</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l363"></a><a href="#l363">363</a><td> * @param {string} text The expected text.<tr><td><a id="l364"></a><a href="#l364">364</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l365"></a><a href="#l365">365</a><td> * @see webdriver.WebDriver#getText<tr><td><a id="l366"></a><a href="#l366">366</a><td> */<tr><td><a id="l367"></a><a href="#l367">367</a><td>until.elementTextIs = function(element, text) {<tr><td><a id="l368"></a><a href="#l368">368</a><td> return new until.Condition('until element text is', function() {<tr><td><a id="l369"></a><a href="#l369">369</a><td> return element.getText().then(function(t) {<tr><td><a id="l370"></a><a href="#l370">370</a><td> return t === text;<tr><td><a id="l371"></a><a href="#l371">371</a><td> });<tr><td><a id="l372"></a><a href="#l372">372</a><td> });<tr><td><a id="l373"></a><a href="#l373">373</a><td>};<tr><td><a id="l374"></a><a href="#l374">374</a><td><tr><td><a id="l375"></a><a href="#l375">375</a><td><tr><td><a id="l376"></a><a href="#l376">376</a><td>/**<tr><td><a id="l377"></a><a href="#l377">377</a><td> * Creates a condition that will wait for the given element's<tr><td><a id="l378"></a><a href="#l378">378</a><td> * {@link webdriver.WebDriver#getText visible text} to contain the given<tr><td><a id="l379"></a><a href="#l379">379</a><td> * substring.<tr><td><a id="l380"></a><a href="#l380">380</a><td> *<tr><td><a id="l381"></a><a href="#l381">381</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l382"></a><a href="#l382">382</a><td> * @param {string} substr The substring to search for.<tr><td><a id="l383"></a><a href="#l383">383</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l384"></a><a href="#l384">384</a><td> * @see webdriver.WebDriver#getText<tr><td><a id="l385"></a><a href="#l385">385</a><td> */<tr><td><a id="l386"></a><a href="#l386">386</a><td>until.elementTextContains = function(element, substr) {<tr><td><a id="l387"></a><a href="#l387">387</a><td> return new until.Condition('until element text contains', function() {<tr><td><a id="l388"></a><a href="#l388">388</a><td> return element.getText().then(function(t) {<tr><td><a id="l389"></a><a href="#l389">389</a><td> return t.indexOf(substr) != -1;<tr><td><a id="l390"></a><a href="#l390">390</a><td> });<tr><td><a id="l391"></a><a href="#l391">391</a><td> });<tr><td><a id="l392"></a><a href="#l392">392</a><td>};<tr><td><a id="l393"></a><a href="#l393">393</a><td><tr><td><a id="l394"></a><a href="#l394">394</a><td><tr><td><a id="l395"></a><a href="#l395">395</a><td>/**<tr><td><a id="l396"></a><a href="#l396">396</a><td> * Creates a condition that will wait for the given element's<tr><td><a id="l397"></a><a href="#l397">397</a><td> * {@link webdriver.WebDriver#getText visible text} to match a regular<tr><td><a id="l398"></a><a href="#l398">398</a><td> * expression.<tr><td><a id="l399"></a><a href="#l399">399</a><td> *<tr><td><a id="l400"></a><a href="#l400">400</a><td> * @param {!webdriver.WebElement} element The element to test.<tr><td><a id="l401"></a><a href="#l401">401</a><td> * @param {!RegExp} regex The regular expression to test against.<tr><td><a id="l402"></a><a href="#l402">402</a><td> * @return {!until.Condition.<boolean>} The new condition.<tr><td><a id="l403"></a><a href="#l403">403</a><td> * @see webdriver.WebDriver#getText<tr><td><a id="l404"></a><a href="#l404">404</a><td> */<tr><td><a id="l405"></a><a href="#l405">405</a><td>until.elementTextMatches = function(element, regex) {<tr><td><a id="l406"></a><a href="#l406">406</a><td> return new until.Condition('until element text matches', function() {<tr><td><a id="l407"></a><a href="#l407">407</a><td> return element.getText().then(function(t) {<tr><td><a id="l408"></a><a href="#l408">408</a><td> return regex.test(t);<tr><td><a id="l409"></a><a href="#l409">409</a><td> });<tr><td><a id="l410"></a><a href="#l410">410</a><td> });<tr><td><a id="l411"></a><a href="#l411">411</a><td>};<tr><td><a id="l412"></a><a href="#l412">412</a><td>}); // goog.scope</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>
|