blob: 14874ee1a599a68d5420decc987575e7b9b5120c [file] [log] [blame] [edit]
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>
Module: Selenium::WebDriver
&mdash; Documentation by YARD 0.9.37
</title>
<link rel="stylesheet" href="../css/style.css" type="text/css" />
<link rel="stylesheet" href="../css/common.css" type="text/css" />
<script type="text/javascript">
pathId = "Selenium::WebDriver";
relpath = '../';
</script>
<script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
<script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
</head>
<body>
<div class="nav_wrap">
<iframe id="nav" src="../class_list.html?1"></iframe>
<div id="resizer"></div>
</div>
<div id="main" tabindex="-1">
<div id="header">
<div id="menu">
<a href="../_index.html">Index (W)</a> &raquo;
<span class='title'><span class='object_link'><a href="../Selenium.html" title="Selenium (module)">Selenium</a></span></span>
&raquo;
<span class="title">WebDriver</span>
</div>
<div id="search">
<a class="full_list_link" id="class_list_link"
href="../class_list.html">
<svg width="24" height="24">
<rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
<rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
<rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
</svg>
</a>
</div>
<div class="clear"></div>
</div>
<div id="content"><h1>Module: Selenium::WebDriver
</h1>
<div class="box_info">
<dl>
<dt>Defined in:</dt>
<dd>rb/lib/selenium/webdriver.rb<span class="defines">,<br />
rb/lib/selenium/webdriver/ie.rb,<br /> rb/lib/selenium/webdriver/bidi.rb,<br /> rb/lib/selenium/webdriver/edge.rb,<br /> rb/lib/selenium/webdriver/atoms.rb,<br /> rb/lib/selenium/webdriver/chrome.rb,<br /> rb/lib/selenium/webdriver/remote.rb,<br /> rb/lib/selenium/webdriver/safari.rb,<br /> rb/lib/selenium/webdriver/firefox.rb,<br /> rb/lib/selenium/webdriver/version.rb,<br /> rb/lib/selenium/webdriver/chromium.rb,<br /> rb/lib/selenium/webdriver/devtools.rb,<br /> rb/lib/selenium/webdriver/ie/driver.rb,<br /> rb/lib/selenium/webdriver/ie/options.rb,<br /> rb/lib/selenium/webdriver/ie/service.rb,<br /> rb/lib/selenium/webdriver/bidi/struct.rb,<br /> rb/lib/selenium/webdriver/common/keys.rb,<br /> rb/lib/selenium/webdriver/common/logs.rb,<br /> rb/lib/selenium/webdriver/common/wait.rb,<br /> rb/lib/selenium/webdriver/edge/driver.rb,<br /> rb/lib/selenium/webdriver/ie/features.rb,<br /> rb/lib/selenium/webdriver/bidi/network.rb,<br /> rb/lib/selenium/webdriver/bidi/session.rb,<br /> rb/lib/selenium/webdriver/common/alert.rb,<br /> rb/lib/selenium/webdriver/common/error.rb,<br /> rb/lib/selenium/webdriver/common/fedcm.rb,<br /> rb/lib/selenium/webdriver/common/proxy.rb,<br /> rb/lib/selenium/webdriver/edge/options.rb,<br /> rb/lib/selenium/webdriver/edge/profile.rb,<br /> rb/lib/selenium/webdriver/edge/service.rb,<br /> rb/lib/selenium/webdriver/firefox/util.rb,<br /> rb/lib/selenium/webdriver/chrome/driver.rb,<br /> rb/lib/selenium/webdriver/common/driver.rb,<br /> rb/lib/selenium/webdriver/common/logger.rb,<br /> rb/lib/selenium/webdriver/common/script.rb,<br /> rb/lib/selenium/webdriver/common/window.rb,<br /> rb/lib/selenium/webdriver/common/zipper.rb,<br /> rb/lib/selenium/webdriver/edge/features.rb,<br /> rb/lib/selenium/webdriver/remote/bridge.rb,<br /> rb/lib/selenium/webdriver/remote/driver.rb,<br /> rb/lib/selenium/webdriver/safari/driver.rb,<br /> rb/lib/selenium/webdriver/support/color.rb,<br /> rb/lib/selenium/webdriver/chrome/options.rb,<br /> rb/lib/selenium/webdriver/chrome/profile.rb,<br /> rb/lib/selenium/webdriver/chrome/service.rb,<br /> rb/lib/selenium/webdriver/common/element.rb,<br /> rb/lib/selenium/webdriver/common/manager.rb,<br /> rb/lib/selenium/webdriver/common/network.rb,<br /> rb/lib/selenium/webdriver/common/options.rb,<br /> rb/lib/selenium/webdriver/common/service.rb,<br /> rb/lib/selenium/webdriver/firefox/driver.rb,<br /> rb/lib/selenium/webdriver/safari/options.rb,<br /> rb/lib/selenium/webdriver/safari/service.rb,<br /> rb/lib/selenium/webdriver/support/guards.rb,<br /> rb/lib/selenium/webdriver/support/select.rb,<br /> rb/lib/selenium/webdriver/chrome/features.rb,<br /> rb/lib/selenium/webdriver/chromium/driver.rb,<br /> rb/lib/selenium/webdriver/common/platform.rb,<br /> rb/lib/selenium/webdriver/common/timeouts.rb,<br /> rb/lib/selenium/webdriver/firefox/options.rb,<br /> rb/lib/selenium/webdriver/firefox/profile.rb,<br /> rb/lib/selenium/webdriver/firefox/service.rb,<br /> rb/lib/selenium/webdriver/remote/features.rb,<br /> rb/lib/selenium/webdriver/remote/response.rb,<br /> rb/lib/selenium/webdriver/safari/features.rb,<br /> rb/lib/selenium/webdriver/support/escaper.rb,<br /> rb/lib/selenium/webdriver/bidi/log_handler.rb,<br /> rb/lib/selenium/webdriver/chromium/options.rb,<br /> rb/lib/selenium/webdriver/chromium/profile.rb,<br /> rb/lib/selenium/webdriver/common/log_entry.rb,<br /> rb/lib/selenium/webdriver/devtools/request.rb,<br /> rb/lib/selenium/webdriver/firefox/features.rb,<br /> rb/lib/selenium/webdriver/remote/http/curb.rb,<br /> rb/lib/selenium/webdriver/chromium/features.rb,<br /> rb/lib/selenium/webdriver/common/navigation.rb,<br /> rb/lib/selenium/webdriver/devtools/response.rb,<br /> rb/lib/selenium/webdriver/firefox/extension.rb,<br /> rb/lib/selenium/webdriver/bidi/log/filter_by.rb,<br /> rb/lib/selenium/webdriver/bidi/log_inspector.rb,<br /> rb/lib/selenium/webdriver/common/file_reaper.rb,<br /> rb/lib/selenium/webdriver/common/port_prober.rb,<br /> rb/lib/selenium/webdriver/common/shadow_root.rb,<br /> rb/lib/selenium/webdriver/common/socket_lock.rb,<br /> rb/lib/selenium/webdriver/remote/bidi_bridge.rb,<br /> rb/lib/selenium/webdriver/remote/http/common.rb,<br /> rb/lib/selenium/webdriver/common/fedcm/dialog.rb,<br /> rb/lib/selenium/webdriver/common/local_driver.rb,<br /> rb/lib/selenium/webdriver/remote/capabilities.rb,<br /> rb/lib/selenium/webdriver/remote/http/default.rb,<br /> rb/lib/selenium/webdriver/remote/server_error.rb,<br /> rb/lib/selenium/webdriver/bidi/network/cookies.rb,<br /> rb/lib/selenium/webdriver/bidi/network/headers.rb,<br /> rb/lib/selenium/webdriver/common/child_process.rb,<br /> rb/lib/selenium/webdriver/common/driver_finder.rb,<br /> rb/lib/selenium/webdriver/common/fedcm/account.rb,<br /> rb/lib/selenium/webdriver/common/socket_poller.rb,<br /> rb/lib/selenium/webdriver/firefox/profiles_ini.rb,<br /> rb/lib/selenium/webdriver/support/guards/guard.rb,<br /> rb/lib/selenium/webdriver/bidi/browsing_context.rb,<br /> rb/lib/selenium/webdriver/common/action_builder.rb,<br /> rb/lib/selenium/webdriver/common/profile_helper.rb,<br /> rb/lib/selenium/webdriver/common/search_context.rb,<br /> rb/lib/selenium/webdriver/common/target_locator.rb,<br /> rb/lib/selenium/webdriver/common/service_manager.rb,<br /> rb/lib/selenium/webdriver/devtools/console_event.rb,<br /> rb/lib/selenium/webdriver/devtools/pinned_script.rb,<br /> rb/lib/selenium/webdriver/remote/bridge/commands.rb,<br /> rb/lib/selenium/webdriver/bidi/log/base_log_entry.rb,<br /> rb/lib/selenium/webdriver/common/selenium_manager.rb,<br /> rb/lib/selenium/webdriver/common/takes_screenshot.rb,<br /> rb/lib/selenium/webdriver/devtools/mutation_event.rb,<br /> rb/lib/selenium/webdriver/bidi/network/credentials.rb,<br /> rb/lib/selenium/webdriver/bidi/network/url_pattern.rb,<br /> rb/lib/selenium/webdriver/devtools/exception_event.rb,<br /> rb/lib/selenium/webdriver/support/relative_locator.rb,<br /> rb/lib/selenium/webdriver/common/interactions/pause.rb,<br /> rb/lib/selenium/webdriver/bidi/log/console_log_entry.rb,<br /> rb/lib/selenium/webdriver/bidi/log/generic_log_entry.rb,<br /> rb/lib/selenium/webdriver/common/interactions/scroll.rb,<br /> rb/lib/selenium/webdriver/common/websocket_connection.rb,<br /> rb/lib/selenium/webdriver/support/event_firing_bridge.rb,<br /> rb/lib/selenium/webdriver/devtools/network_interceptor.rb,<br /> rb/lib/selenium/webdriver/support/block_event_listener.rb,<br /> rb/lib/selenium/webdriver/bidi/log/javascript_log_entry.rb,<br /> rb/lib/selenium/webdriver/bidi/network/intercepted_auth.rb,<br /> rb/lib/selenium/webdriver/bidi/network/intercepted_item.rb,<br /> rb/lib/selenium/webdriver/common/interactions/key_input.rb,<br /> rb/lib/selenium/webdriver/common/interactions/none_input.rb,<br /> rb/lib/selenium/webdriver/support/guards/guard_condition.rb,<br /> rb/lib/selenium/webdriver/common/interactions/interaction.rb,<br /> rb/lib/selenium/webdriver/common/interactions/key_actions.rb,<br /> rb/lib/selenium/webdriver/common/interactions/wheel_input.rb,<br /> rb/lib/selenium/webdriver/remote/bridge/locator_converter.rb,<br /> rb/lib/selenium/webdriver/support/abstract_event_listener.rb,<br /> rb/lib/selenium/webdriver/bidi/network/intercepted_request.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_cdp.rb,<br /> rb/lib/selenium/webdriver/common/interactions/input_device.rb,<br /> rb/lib/selenium/webdriver/common/interactions/interactions.rb,<br /> rb/lib/selenium/webdriver/common/interactions/pointer_move.rb,<br /> rb/lib/selenium/webdriver/bidi/network/intercepted_response.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_bidi.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_logs.rb,<br /> rb/lib/selenium/webdriver/common/interactions/pointer_input.rb,<br /> rb/lib/selenium/webdriver/common/interactions/pointer_press.rb,<br /> rb/lib/selenium/webdriver/common/interactions/scroll_origin.rb,<br /> rb/lib/selenium/webdriver/common/interactions/wheel_actions.rb,<br /> rb/lib/selenium/webdriver/common/interactions/pointer_cancel.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_addons.rb,<br /> rb/lib/selenium/webdriver/common/interactions/pointer_actions.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_casting.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_context.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/prints_page.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_debugger.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_devtools.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_launching.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/uploads_files.rb,<br /> rb/lib/selenium/webdriver/common/interactions/typing_interaction.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_log_events.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_session_id.rb,<br /> rb/lib/selenium/webdriver/common/virtual_authenticator/credential.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/downloads_files.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_permissions.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_fedcm_dialog.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_authentication.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_file_downloads.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_pinned_scripts.rb,<br /> rb/lib/selenium/webdriver/common/interactions/pointer_event_properties.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/full_page_screenshot.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_apple_permissions.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_network_conditions.rb,<br /> rb/lib/selenium/webdriver/common/driver_extensions/has_network_interception.rb,<br /> rb/lib/selenium/webdriver/common/virtual_authenticator/virtual_authenticator.rb,<br /> rb/lib/selenium/webdriver/common/virtual_authenticator/virtual_authenticator_options.rb</span>
</dd>
</dl>
</div>
<h2>Defined Under Namespace</h2>
<p class="children">
<strong class="modules">Modules:</strong> <span class='object_link'><a href="WebDriver/Atoms.html" title="Selenium::WebDriver::Atoms (module)">Atoms</a></span>, <span class='object_link'><a href="WebDriver/Chrome.html" title="Selenium::WebDriver::Chrome (module)">Chrome</a></span>, <span class='object_link'><a href="WebDriver/Chromium.html" title="Selenium::WebDriver::Chromium (module)">Chromium</a></span>, <span class='object_link'><a href="WebDriver/DriverExtensions.html" title="Selenium::WebDriver::DriverExtensions (module)">DriverExtensions</a></span>, <span class='object_link'><a href="WebDriver/Edge.html" title="Selenium::WebDriver::Edge (module)">Edge</a></span>, <span class='object_link'><a href="WebDriver/Error.html" title="Selenium::WebDriver::Error (module)">Error</a></span>, <span class='object_link'><a href="WebDriver/FedCM.html" title="Selenium::WebDriver::FedCM (module)">FedCM</a></span>, <span class='object_link'><a href="WebDriver/FileReaper.html" title="Selenium::WebDriver::FileReaper (module)">FileReaper</a></span>, <span class='object_link'><a href="WebDriver/Firefox.html" title="Selenium::WebDriver::Firefox (module)">Firefox</a></span>, <span class='object_link'><a href="WebDriver/IE.html" title="Selenium::WebDriver::IE (module)">IE</a></span>, <span class='object_link'><a href="WebDriver/Interactions.html" title="Selenium::WebDriver::Interactions (module)">Interactions</a></span>, <span class='object_link'><a href="WebDriver/KeyActions.html" title="Selenium::WebDriver::KeyActions (module)">KeyActions</a></span>, <span class='object_link'><a href="WebDriver/Keys.html" title="Selenium::WebDriver::Keys (module)">Keys</a></span>, <span class='object_link'><a href="WebDriver/LocalDriver.html" title="Selenium::WebDriver::LocalDriver (module)">LocalDriver</a></span>, <span class='object_link'><a href="WebDriver/Platform.html" title="Selenium::WebDriver::Platform (module)">Platform</a></span>, <span class='object_link'><a href="WebDriver/PointerActions.html" title="Selenium::WebDriver::PointerActions (module)">PointerActions</a></span>, <span class='object_link'><a href="WebDriver/ProfileHelper.html" title="Selenium::WebDriver::ProfileHelper (module)">ProfileHelper</a></span>, <span class='object_link'><a href="WebDriver/Remote.html" title="Selenium::WebDriver::Remote (module)">Remote</a></span>, <span class='object_link'><a href="WebDriver/Safari.html" title="Selenium::WebDriver::Safari (module)">Safari</a></span>, <span class='object_link'><a href="WebDriver/SearchContext.html" title="Selenium::WebDriver::SearchContext (module)">SearchContext</a></span>, <span class='object_link'><a href="WebDriver/Support.html" title="Selenium::WebDriver::Support (module)">Support</a></span>, <span class='object_link'><a href="WebDriver/TakesScreenshot.html" title="Selenium::WebDriver::TakesScreenshot (module)">TakesScreenshot</a></span>, <span class='object_link'><a href="WebDriver/WheelActions.html" title="Selenium::WebDriver::WheelActions (module)">WheelActions</a></span>, <span class='object_link'><a href="WebDriver/Zipper.html" title="Selenium::WebDriver::Zipper (module)">Zipper</a></span>
<strong class="classes">Classes:</strong> <span class='object_link'><a href="WebDriver/ActionBuilder.html" title="Selenium::WebDriver::ActionBuilder (class)">ActionBuilder</a></span>, <span class='object_link'><a href="WebDriver/Alert.html" title="Selenium::WebDriver::Alert (class)">Alert</a></span>, <span class='object_link'><a href="WebDriver/BiDi.html" title="Selenium::WebDriver::BiDi (class)">BiDi</a></span>, <span class='object_link'><a href="WebDriver/ChildProcess.html" title="Selenium::WebDriver::ChildProcess (class)">ChildProcess</a></span>, <span class='object_link'><a href="WebDriver/Credential.html" title="Selenium::WebDriver::Credential (class)">Credential</a></span>, <span class='object_link'><a href="WebDriver/DevTools.html" title="Selenium::WebDriver::DevTools (class)">DevTools</a></span>, <span class='object_link'><a href="WebDriver/Dimension.html" title="Selenium::WebDriver::Dimension (class)">Dimension</a></span>, <span class='object_link'><a href="WebDriver/Driver.html" title="Selenium::WebDriver::Driver (class)">Driver</a></span>, <span class='object_link'><a href="WebDriver/DriverFinder.html" title="Selenium::WebDriver::DriverFinder (class)">DriverFinder</a></span>, <span class='object_link'><a href="WebDriver/Element.html" title="Selenium::WebDriver::Element (class)">Element</a></span>, <span class='object_link'><a href="WebDriver/LogEntry.html" title="Selenium::WebDriver::LogEntry (class)">LogEntry</a></span>, <span class='object_link'><a href="WebDriver/Logger.html" title="Selenium::WebDriver::Logger (class)">Logger</a></span>, <span class='object_link'><a href="WebDriver/Logs.html" title="Selenium::WebDriver::Logs (class)">Logs</a></span>, <span class='object_link'><a href="WebDriver/Manager.html" title="Selenium::WebDriver::Manager (class)">Manager</a></span>, <span class='object_link'><a href="WebDriver/Navigation.html" title="Selenium::WebDriver::Navigation (class)">Navigation</a></span>, <span class='object_link'><a href="WebDriver/Network.html" title="Selenium::WebDriver::Network (class)">Network</a></span>, <span class='object_link'><a href="WebDriver/Options.html" title="Selenium::WebDriver::Options (class)">Options</a></span>, <span class='object_link'><a href="WebDriver/Point.html" title="Selenium::WebDriver::Point (class)">Point</a></span>, <span class='object_link'><a href="WebDriver/PortProber.html" title="Selenium::WebDriver::PortProber (class)">PortProber</a></span>, <span class='object_link'><a href="WebDriver/Proxy.html" title="Selenium::WebDriver::Proxy (class)">Proxy</a></span>, <span class='object_link'><a href="WebDriver/Rectangle.html" title="Selenium::WebDriver::Rectangle (class)">Rectangle</a></span>, <span class='object_link'><a href="WebDriver/Script.html" title="Selenium::WebDriver::Script (class)">Script</a></span>, <span class='object_link'><a href="WebDriver/SeleniumManager.html" title="Selenium::WebDriver::SeleniumManager (class)">SeleniumManager</a></span>, <span class='object_link'><a href="WebDriver/Service.html" title="Selenium::WebDriver::Service (class)">Service</a></span>, <span class='object_link'><a href="WebDriver/ServiceManager.html" title="Selenium::WebDriver::ServiceManager (class)">ServiceManager</a></span>, <span class='object_link'><a href="WebDriver/ShadowRoot.html" title="Selenium::WebDriver::ShadowRoot (class)">ShadowRoot</a></span>, <span class='object_link'><a href="WebDriver/SocketLock.html" title="Selenium::WebDriver::SocketLock (class)">SocketLock</a></span>, <span class='object_link'><a href="WebDriver/SocketPoller.html" title="Selenium::WebDriver::SocketPoller (class)">SocketPoller</a></span>, <span class='object_link'><a href="WebDriver/TargetLocator.html" title="Selenium::WebDriver::TargetLocator (class)">TargetLocator</a></span>, <span class='object_link'><a href="WebDriver/Timeouts.html" title="Selenium::WebDriver::Timeouts (class)">Timeouts</a></span>, <span class='object_link'><a href="WebDriver/VirtualAuthenticator.html" title="Selenium::WebDriver::VirtualAuthenticator (class)">VirtualAuthenticator</a></span>, <span class='object_link'><a href="WebDriver/VirtualAuthenticatorOptions.html" title="Selenium::WebDriver::VirtualAuthenticatorOptions (class)">VirtualAuthenticatorOptions</a></span>, <span class='object_link'><a href="WebDriver/Wait.html" title="Selenium::WebDriver::Wait (class)">Wait</a></span>, <span class='object_link'><a href="WebDriver/WebSocketConnection.html" title="Selenium::WebDriver::WebSocketConnection (class)">WebSocketConnection</a></span>, <span class='object_link'><a href="WebDriver/Window.html" title="Selenium::WebDriver::Window (class)">Window</a></span>
</p>
<h2>
Constant Summary
<small><a href="#" class="constants_summary_toggle">collapse</a></small>
</h2>
<dl class="constants">
<dt id="VERSION-constant" class="">VERSION =
</dt>
<dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>4.30.0</span><span class='tstring_end'>&#39;</span></span></pre></dd>
</dl>
<h2>
Class Method Summary
<small><a href="#" class="summary_toggle">collapse</a></small>
</h2>
<ul class="summary">
<li class="public ">
<span class="summary_signature">
<a href="#for-class_method" title="for (class method)">.<strong>for</strong>(*args) &#x21d2; Driver </a>
</span>
<span class="summary_desc"><div class='inline'>
<p>Create a new Driver instance with the correct bridge for the given browser.</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#logger-class_method" title="logger (class method)">.<strong>logger</strong>(**opts) &#x21d2; Logger </a>
</span>
<span class="summary_desc"><div class='inline'>
<p>Returns logger instance that can be used across the whole Selenium.</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#root-class_method" title="root (class method)">.<strong>root</strong> &#x21d2; Object </a>
</span>
<span class="private note title">private</span>
<span class="summary_desc"><div class='inline'></div></span>
</li>
</ul>
<div id="class_method_details" class="method_details_list">
<h2>Class Method Details</h2>
<div class="method_details first">
<h3 class="signature first" id="for-class_method">
<span class="overload">.<strong>for</strong>(browser) &#x21d2; <tt><span class='object_link'><a href="WebDriver/Driver.html" title="Selenium::WebDriver::Driver (class)">Driver</a></span></tt> </span>
<span class="overload">.<strong>for</strong>(browser, opts) &#x21d2; <tt><span class='object_link'><a href="WebDriver/Driver.html" title="Selenium::WebDriver::Driver (class)">Driver</a></span></tt> </span>
</h3><div class="docstring">
<div class="discussion">
<p>Create a new Driver instance with the correct bridge for the given browser</p>
<p>One special argument is not passed on to the bridges, :listener. You can pass a listener for this option to get notified of WebDriver events. The passed object must respond to #call or implement the methods from AbstractEventListener.</p>
</div>
</div>
<div class="tags">
<div class="examples">
<h4 class="tag_title">Examples:</h4>
<pre class="example code"><code>
<span class='const'><span class='object_link'><a href="" title="Selenium::WebDriver (module)">WebDriver</a></span></span><span class='period'>.</span><span class='id identifier rubyid_for'>for</span> <span class='symbol'>:firefox</span><span class='comma'>,</span> <span class='label'>profile:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>some-profile</span><span class='tstring_end'>&#39;</span></span>
<span class='const'><span class='object_link'><a href="" title="Selenium::WebDriver (module)">WebDriver</a></span></span><span class='period'>.</span><span class='id identifier rubyid_for'>for</span> <span class='symbol'>:firefox</span><span class='comma'>,</span> <span class='label'>profile:</span> <span class='const'>Profile</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
<span class='const'><span class='object_link'><a href="" title="Selenium::WebDriver (module)">WebDriver</a></span></span><span class='period'>.</span><span class='id identifier rubyid_for'>for</span> <span class='symbol'>:remote</span><span class='comma'>,</span> <span class='label'>url:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>http://localhost:4444/wd/hub</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>capabilities:</span> <span class='id identifier rubyid_caps'>caps</span></code></pre>
</div>
<p class="tag_title">Overloads:</p>
<ul class="overload">
<li class="overload_item">
<span class="signature">.<strong>for</strong>(browser) &#x21d2; <tt><span class='object_link'><a href="WebDriver/Driver.html" title="Selenium::WebDriver::Driver (class)">Driver</a></span></tt> </span>
<div class="docstring">
<div class="discussion">
</div>
</div>
<div class="tags">
<p class="tag_title">Parameters:</p>
<ul class="param">
<li>
<span class='name'>browser</span>
<span class='type'>(<tt>:ie</tt>, <tt>:internet_explorer</tt>, <tt>:edge</tt>, <tt>:remote</tt>, <tt>:chrome</tt>, <tt>:firefox</tt>, <tt>:ff</tt>, <tt>:safari</tt>)</span>
&mdash;
<div class='inline'>
<p>The browser to create the driver for</p>
</div>
</li>
</ul>
</div>
</li>
<li class="overload_item">
<span class="signature">.<strong>for</strong>(browser, opts) &#x21d2; <tt><span class='object_link'><a href="WebDriver/Driver.html" title="Selenium::WebDriver::Driver (class)">Driver</a></span></tt> </span>
<div class="docstring">
<div class="discussion">
</div>
</div>
<div class="tags">
<p class="tag_title">Parameters:</p>
<ul class="param">
<li>
<span class='name'>browser</span>
<span class='type'>(<tt>:ie</tt>, <tt>:internet_explorer</tt>, <tt>:edge</tt>, <tt>:remote</tt>, <tt>:chrome</tt>, <tt>:firefox</tt>, <tt>:ff</tt>, <tt>:safari</tt>)</span>
&mdash;
<div class='inline'>
<p>The browser to create the driver for</p>
</div>
</li>
<li>
<span class='name'>opts</span>
<span class='type'>(<tt>Hash</tt>)</span>
&mdash;
<div class='inline'>
<p>Options passed to Driver.new</p>
</div>
</li>
</ul>
</div>
</li>
</ul>
<p class="tag_title">Returns:</p>
<ul class="return">
<li>
<span class='type'>(<tt><span class='object_link'><a href="WebDriver/Driver.html" title="Selenium::WebDriver::Driver (class)">Driver</a></span></tt>)</span>
</li>
</ul>
<p class="tag_title">See Also:</p>
<ul class="see">
<li><span class='object_link'><a href="WebDriver/Remote/Driver.html" title="Selenium::WebDriver::Remote::Driver (class)">Selenium::WebDriver::Remote::Driver</a></span></li>
<li><span class='object_link'><a href="WebDriver/Firefox/Driver.html" title="Selenium::WebDriver::Firefox::Driver (class)">Selenium::WebDriver::Firefox::Driver</a></span></li>
<li><span class='object_link'><a href="WebDriver/IE/Driver.html" title="Selenium::WebDriver::IE::Driver (class)">Selenium::WebDriver::IE::Driver</a></span></li>
<li><span class='object_link'><a href="WebDriver/Edge/Driver.html" title="Selenium::WebDriver::Edge::Driver (class)">Selenium::WebDriver::Edge::Driver</a></span></li>
<li><span class='object_link'><a href="WebDriver/Chrome/Driver.html" title="Selenium::WebDriver::Chrome::Driver (class)">Selenium::WebDriver::Chrome::Driver</a></span></li>
<li><span class='object_link'><a href="WebDriver/Safari/Driver.html" title="Selenium::WebDriver::Safari::Driver (class)">Selenium::WebDriver::Safari::Driver</a></span></li>
<li><span class='object_link'><a href="WebDriver/Support/AbstractEventListener.html" title="Selenium::WebDriver::Support::AbstractEventListener (class)">Selenium::WebDriver::Support::AbstractEventListener</a></span></li>
</ul>
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
88
89
90</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'rb/lib/selenium/webdriver.rb', line 88</span>
<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='kw'>for</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
<span class='const'>WebDriver</span><span class='op'>::</span><span class='const'>Driver</span><span class='period'>.</span><span class='id identifier rubyid_for'>for</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
<span class='kw'>end</span></pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<h3 class="signature " id="logger-class_method">
.<strong>logger</strong>(**opts) &#x21d2; <tt><span class='object_link'><a href="WebDriver/Logger.html" title="Selenium::WebDriver::Logger (class)">Logger</a></span></tt>
</h3><div class="docstring">
<div class="discussion">
<p>Returns logger instance that can be used across the whole Selenium.</p>
</div>
</div>
<div class="tags">
<p class="tag_title">Returns:</p>
<ul class="return">
<li>
<span class='type'>(<tt><span class='object_link'><a href="WebDriver/Logger.html" title="Selenium::WebDriver::Logger (class)">Logger</a></span></tt>)</span>
</li>
</ul>
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
98
99
100
101</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'rb/lib/selenium/webdriver.rb', line 98</span>
<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_logger'>logger</span><span class='lparen'>(</span><span class='op'>**</span><span class='id identifier rubyid_opts'>opts</span><span class='rparen'>)</span>
<span class='id identifier rubyid_level'>level</span> <span class='op'>=</span> <span class='gvar'>$DEBUG</span> <span class='op'>||</span> <span class='const'>ENV</span><span class='period'>.</span><span class='id identifier rubyid_key?'>key?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>DEBUG</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span> <span class='op'>?</span> <span class='symbol'>:debug</span> <span class='op'>:</span> <span class='symbol'>:info</span>
<span class='ivar'>@logger</span> <span class='op'>||=</span> <span class='const'><span class='object_link'><a href="" title="Selenium::WebDriver (module)">WebDriver</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="WebDriver/Logger.html" title="Selenium::WebDriver::Logger (class)">Logger</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="WebDriver/Logger.html#initialize-instance_method" title="Selenium::WebDriver::Logger#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Selenium</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>default_level:</span> <span class='id identifier rubyid_level'>level</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_opts'>opts</span><span class='rparen'>)</span>
<span class='kw'>end</span></pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<h3 class="signature " id="root-class_method">
.<strong>root</strong> &#x21d2; <tt>Object</tt>
</h3><div class="docstring">
<div class="discussion">
<p class="note private">
<strong>This method is part of a private API.</strong>
You should avoid using this method if possible, as it may be removed or be changed in the future.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
51
52
53</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'rb/lib/selenium/webdriver.rb', line 51</span>
<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_root'><span class='object_link'><a href="../top-level-namespace.html" title="Top Level Namespace (root)">root</a></span></span>
<span class='ivar'>@root</span> <span class='op'>||=</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>..</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='id identifier rubyid___dir__'>__dir__</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rparen'>)</span>
<span class='kw'>end</span></pre>
</td>
</tr>
</table>
</div>
</div>
</div>
<div id="footer">
Generated on Fri Mar 21 20:02:31 2025 by
<a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
0.9.37 (ruby-3.1.6).
</div>
</div>
</body>
</html>