Selenium

Browsing Context

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to browsing context commands.

Open a new window

Creates a new browsing context in a new window.

Selenium v4.8

Browsing Context

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

This section contains the APIs related to input commands.

Perform Actions

Selenium v4.17

WebDriver BiDi Network Features

Mon, 01 Jan 0001 00:00:00 +0000

The implementation of these features is being tracked here: #13993

Remember that to use WebDriver BiDi, you must enable it in Options. For more details, see Enabling BiDi

Authentication Handlers

Authentication handlers enable you to intercept authentication requests that occur during a network interaction. These handlers are useful for automating scenarios involving authentication prompts, such as Basic Auth or Digest Auth. They allow you to programmatically provide credentials or modify the authentication flow.

Network

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to network commands.

Add network intercept

Selenium v4.18

Script

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to script commands.

Call function in a browsing context

Selenium v4.15

浏览器导航

Mon, 01 Jan 0001 00:00:00 +0000

打开网站

启动浏览器后你要做的第一件事就是打开你的网站。这可以通过一行代码实现:

 //Convenient
 driver.get("https://selenium.dev");
 
 //Longer way
 driver.navigate().to("https://selenium.dev");

View Complete Code View on GitHub

driver.get("https://www.selenium.dev/selenium/web/index.html")

View Complete Code View on GitHub

 //Convenient
 driver.Url = "https://selenium.dev";
 //Longer
 driver.Navigate().GoToUrl("https://selenium.dev");

View Complete Code View on GitHub


 it 'navigates to a page' do
 driver.navigate.to 'https://www.selenium.dev/'

View Complete Code View on GitHub

 //Convenient
 await driver.get('https://www.selenium.dev');

 //Longer way
 await driver.navigate().to("https://www.selenium.dev/selenium/web/index.html");

View Complete Code View on GitHub

// 简便的方法
driver.get("https://selenium.dev")

// 更长的方法
driver.navigate().to("https://selenium.dev")

后退

按下浏览器的后退按钮:

 //Back
 driver.navigate().back();

View Complete Code View on GitHub

driver.back()

View Complete Code View on GitHub

 //Back
  driver.Navigate().Back();

View Complete Code View on GitHub

 driver.navigate.to 'https://www.selenium.dev/'

View Complete Code View on GitHub

 //Back
 await driver.navigate().back();

View Complete Code View on GitHub

driver.navigate().back()

期望状态的等待

Mon, 01 Jan 0001 00:00:00 +0000

期望状态与显示等待一起使用. 与其定义要使用 lambda 执行的代码块, 不如使用 lambda 执行可以创建 Conditions 方法来表示等待的常见事物. 有些方法将定位器作为参数, 有些方法将元素作为参数.

这些方法可以包括以下条件:

元素存在
元素已过期
元素可见
文本可见
标题包含特定值

Expected Conditions Documentation

Add Example

设计模式和开发策略

Mon, 01 Jan 0001 00:00:00 +0000

（原位置： https://github.com/SeleniumHQ/selenium/wiki/Bot-Style-Tests）

概览

随着时间推移, 项目往往会积累大量测试. 随着测试总数的增加, 对代码库进行改动会变得更困难 —— 即便只是一次“简单”的改动, 也可能导致大量测试失败, 而应用本身仍然能正常工作. 有时这种问题不可避免, 但一旦发生, 你希望能尽快恢复运行. 下面介绍的一些设计模式与策略在 WebDriver 场景下被证明可以简化测试编写与维护, 可能也对你有帮助.

领域驱动设计: 以最终用户的语言来表达测试.

页面对象: 对 Web 应用 UI 的一种简单抽象.

LoadableComponent: 把页面对象建模为可加载的组件.

BotStyleTests: 使用以命令为导向的自动化测试方式, 而不是页面对象更偏向的对象化方法

Loadable Component

其是什么?

LoadableComponent 是一个基类, 目标是让编写页面对象更轻松. 它通过提供一套标准机制来确保页面被正确加载, 并提供在页面加载失败时用于调试的钩子. 你可以利用它来减少测试中的样板代码, 从而降低维护测试的工作量.

目前在 Selenium 中包含了一个 Java 实现, 但该方法足够简单, 可在任何语言中实现.

简单用法

举个我们想要建模的 UI 的例子, 看看 new issue 页面. 对于测试作者而言, 该页面的作用是提供一个提交新 issue 的功能. 一个基本的页面对象(这个简化版本我们称为 EditIssueBasic, 之后会把它改造成 EditIssue 这个 LoadableComponent)看起来像:

Add Example

CLI 选项

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

Different sections are available to configure a Grid. Each section has options can be configured through command line arguments.

A complete description of the component to section mapping can be seen below.

Note that this documentation could be outdated if an option was modified or added but has not been documented yet. In case you bump into this situation, please check the “Config help” section and feel free to send us a pull request updating this page.

Internet Explorer Driver Internals

Mon, 01 Jan 0001 00:00:00 +0000

Client Code Into the Driver

We use the W3C WebDriver protocol to communicate with a local instance of an HTTP server. This greatly simplifies the implementation of the language-specific code, and minimizes the number of entry points into the C++ DLL that must be called using a native-code interop technology such as JNA, ctypes, pinvoke or DL.

Memory Management

The IE driver utilizes the Active Template Library (ATL) to take advantage of its implementation of smart pointers to COM objects. This makes reference counting and cleanup of COM objects much easier.

Chrome DevTools Logging Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Console Logs

 ((HasLogEvents) driver).onLogEvent(consoleEvent(e -> messages.add(e.getMessages().get(0))));

View Complete Code View on GitHub

 async with driver.bidi_connection() as session:
 async with Log(driver, session).add_listener(Console.ALL) as messages:

View Complete Code View on GitHub

 using IJavaScriptEngine monitor = new JavaScriptEngine(driver);
 var messages = new List<string>();
 monitor.JavaScriptConsoleApiCalled += (_, e) =>
 {
 messages.Add(e.MessageContent);
 };
 await monitor.StartEventMonitoring();

View Complete Code View on GitHub

 driver.on_log_event(:console) { |log| logs << log.args.first }

View Complete Code View on GitHub

Implementation Missing

命令监听器

Mon, 01 Jan 0001 00:00:00 +0000

允许您在每次发送特定 Selenium 命令时执行自定义操作

Add Example

Web元素交互

Mon, 01 Jan 0001 00:00:00 +0000

仅有五种基本命令可用于元素的操作:

点击 (适用于任何元素)
发送键位 (仅适用于文本字段和内容可编辑元素)
清除 (仅适用于文本字段和内容可编辑元素)
提交 (仅适用于表单元素)
选择 (参见选择列表元素)

附加验证

这些方法的设计目的是尽量模拟用户体验, 所以, 与 Actions接口不同, 在指定制定操作之前, 会尝试执行两件事.

如果它确定元素在视口之外, 则会将元素滚动到视图中, 特别是将元素底部与视口底部对齐.
确保元素在执行操作之前是可交互的 . 这可能意味着滚动不成功, 或者该元素没有以其他方式显示.
确定某个元素是否显示在页面上太难了无法直接在webdriver规范中定义, 因此Selenium发送一个带有JavaScript原子的执行命令, 检查是否有可能阻止该元素显示. 如果确定某个元素不在视口中, 不显示, 不可键盘交互, 或不可指针交互, 则返回一个元素不可交互错误.

点击

元素点击命令执行在元素中央. 如果元素中央由于某些原因被遮挡 , Selenium将返回一个元素点击中断错误.

 driver.get("https://www.selenium.dev/selenium/web/inputs.html");

 // Click on the element
 WebElement checkInput = driver.findElement(By.name("checkbox_input"));
 checkInput.click();

View Complete Code View on GitHub

 # Navigate to URL
 driver.get("https://www.selenium.dev/selenium/web/inputs.html")

 # Click on the checkbox
 check_input = driver.find_element(By.NAME, "checkbox_input")
 check_input.click()

View Complete Code View on GitHub

 // Navigate to Url
	 driver.Navigate().GoToUrl("https://www.selenium.dev/selenium/web/inputs.html");
	 // Click on the element 
	 IWebElement checkInput = driver.FindElement(By.Name("checkbox_input"));
	 checkInput.Click();

View Complete Code View on GitHub

 driver.find_element(name: 'color_input').click

View Complete Code View on GitHub

 await submitButton.click();

View Complete Code View on GitHub

 // Navigate to Url
 driver.get("https://www.selenium.dev/selenium/web/inputs.html")

 // Click the element
 driver.findElement(By.name("color_input")).click();

发送键位

元素发送键位命令将录入提供的键位到可编辑的元素. 通常, 这意味着元素是具有 文本 类型的表单的输入元素或具有 内容可编辑 属性的元素. 如果不可编辑, 则返回无效元素状态错误.

HTTP Client Configuration

Mon, 01 Jan 0001 00:00:00 +0000

允许您为HTTP库设置各种参数.

package dev.selenium.drivers;

import dev.selenium.BaseTest;

import org.openqa.selenium.remote.http.ClientConfig;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.chrome.ChromeOptions;
import org.openqa.selenium.remote.RemoteWebDriver;

import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManager;
import javax.net.ssl.TrustManagerFactory;
import javax.net.ssl.X509TrustManager;
import java.io.FileInputStream;
import java.net.URL;
import java.nio.file.Path;
import java.security.KeyStore;
import java.security.cert.CertificateFactory;
import java.security.cert.X509Certificate;
import java.time.Duration;

import org.openqa.selenium.UsernameAndPassword;

import static java.net.http.HttpClient.Version.HTTP_1_1;

public class HttpClientTest extends BaseTest {
 URL gridUrl;

 @BeforeEach
 public void startGrid() {
 gridUrl = startStandaloneGridAdvanced();
 }

 @Test
 public void remoteWebDriverWithClientConfig() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createSSLContextWithCA(Path.of("src/test/resources/tls.crt").toAbsolutePath().toString()))
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .authenticateAs(new UsernameAndPassword("admin", "myStrongPassword"))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(gridUrl)
 .config(clientConfig)
 .build();
 }

 @Test
 public void remoteWebDriverIgnoreSSL() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createIgnoreSSLContext())
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .authenticateAs(new UsernameAndPassword("admin", "myStrongPassword"))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(gridUrl)
 .config(clientConfig)
 .build();
 }

 @Test
 public void remoteWebDriverWithEmbedAuthUrl() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createSSLContextWithCA(Path.of("src/test/resources/tls.crt").toAbsolutePath().toString()))
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(embedAuthToUrl(gridUrl, "admin", "myStrongPassword"))
 .config(clientConfig)
 .build();
 }

 private URL embedAuthToUrl(URL url, String username, String password) throws Exception {
 String userInfo = username + ":" + password;
 String urlWithAuth = url.getProtocol() + "://" + userInfo + "@" + url.getHost() + ":" + url.getPort() + url.getPath();
 return new URL(urlWithAuth);
 }

 public static SSLContext createSSLContextWithCA(String caCertPath) throws Exception {
 FileInputStream fis = new FileInputStream(caCertPath);
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 X509Certificate caCert = (X509Certificate) cf.generateCertificate(fis);
 KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
 keyStore.load(null, null);
 keyStore.setCertificateEntry("caCert", caCert);
 TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
 tmf.init(keyStore);
 SSLContext sslContext = SSLContext.getInstance("TLS");
 sslContext.init(null, tmf.getTrustManagers(), null);
 return sslContext;
 }

 public static SSLContext createIgnoreSSLContext() throws Exception {
 TrustManager[] trustAllCerts = new TrustManager[]{
 new X509TrustManager() {
 public X509Certificate[] getAcceptedIssuers() {
 return null;
 }

 public void checkClientTrusted(X509Certificate[] certs, String authType) {
 }

 public void checkServerTrusted(X509Certificate[] certs, String authType) {
 }
 }
 };
 SSLContext sslContext = SSLContext.getInstance("TLS");
 sslContext.init(null, trustAllCerts, new java.security.SecureRandom());
 return sslContext;
 }
}

View on GitHub

import os
import pytest
import sys
from urllib3.util import Retry, Timeout
from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy
from selenium.webdriver.common.proxy import ProxyType
from selenium.webdriver.remote.client_config import ClientConfig


@pytest.mark.skipif(sys.platform == "win32", reason="Gets stuck on Windows, passes locally")
def test_start_remote_with_client_config(grid_server):
 proxy = Proxy({"proxyType": ProxyType.AUTODETECT})
 retries = Retry(connect=2, read=2, redirect=2)
 timeout = Timeout(connect=300, read=3600)
 client_config = ClientConfig(remote_server_addr=grid_server,
 proxy=proxy,
 init_args_for_pool_manager={
 "init_args_for_pool_manager": {"retries": retries, "timeout": timeout}},
 ca_certs=_get_resource_path("tls.crt"),
 username="admin", password="myStrongPassword")
 options = get_default_chrome_options()
 driver = webdriver.Remote(command_executor=grid_server, options=options, client_config=client_config)
 driver.get("https://www.selenium.dev")
 driver.quit()


@pytest.mark.skipif(sys.platform == "win32", reason="Gets stuck on Windows, passes locally")
def test_start_remote_ignore_certs(grid_server):
 proxy = Proxy({"proxyType": ProxyType.AUTODETECT})
 client_config = ClientConfig(remote_server_addr=grid_server,
 proxy=proxy,
 timeout=3600,
 ignore_certificates=True,
 username="admin", password="myStrongPassword")
 options = get_default_chrome_options()
 driver = webdriver.Remote(command_executor=grid_server, options=options, client_config=client_config)
 driver.get("https://www.selenium.dev")
 driver.quit()


def _get_resource_path(file_name: str):
 if os.path.abspath("").endswith("tests"):
 path = os.path.abspath(f"resources/{file_name}")
 else:
 path = os.path.abspath(f"tests/resources/{file_name}")
 return path

def get_default_chrome_options():
 options = webdriver.ChromeOptions()
 options.add_argument("--no-sandbox")
 return options

View on GitHub

Add Example

Selenium Manager (测试版)

Mon, 01 Jan 0001 00:00:00 +0000

动机

简而言之: Selenium Manager 是 Selenium 项目的官方驱动程序管理器, 并且在每次 Selenium 发布时都会随附提供.

Selenium 利用每个浏览器实现的原生支持来执行自动化流程. 因此, Selenium 用户需要在使用 Selenium API 的脚本和浏览器之间放置一个名为 驱动程序(如 chromedriver、geckodriver、msedgedriver 等)的组件. 多年来, 管理这些驱动程序, 对Selenium 用户来说, 一直是个繁琐手动过程. 他们必须下载浏览器所需的驱动程序(如 Chrome 的 chromedriver、Firefox 的 geckodriver 等), 并将其放置在 PATH 中或以系统属性的形式导出驱动程序路径(如 Java、JavaScript 等). 但这种过程很麻烦, 导致了可维护性问题.

让我们来看一个例子. 假设您手动下载了用于通过 Selenium 驱动 Chrome 的所需 chromedriver. 在执行此操作时, Chrome 的稳定版本是 113, 所以您下载了 chromedriver 113 并将其放在您的 PATH 中. 此时, 您的 Selenium 脚本执行正确. 但问题在于 Chrome 是 保持更新 的. 这指的是 Chrome 能够在有新版本可用时自动且静默地升级到下一个稳定版本. 此功能对终端用户来说很棒, 但对浏览器自动化来说可能很危险. 让我们回到这个例子来明确这一点. 当您本地的 Chrome 最终更新到了 115 版本. 此时, 由于手动下载的驱动程序(113 版)与 Chrome 版本(115 版)不兼容, 您的 Selenium 脚本出错了. 因此, 您的 Selenium 脚本会因以下错误消息而失败: “会话无法创建: 此版本的 ChromeDriver 仅支持 Chrome 版本 113”.

Toml配置选项

Mon, 01 Jan 0001 00:00:00 +0000

CLI选项中显示的所有选项都可以通过 TOML 文件进行配置. 此页面显示不同Grid组件的配置示例.

请注意, 如果修改或添加了选项, 但尚未记录, 则此文档可能已过时. 如果您遇到这种情况, 请查看 “配置帮助” 部分, 并随时向我们发送更新此页面的请求.

概述

Selenium Grid对配置文件使用 TOML 格式. 配置文件由多个部分组成, 每个部分都有选项及其各自的值.

有关详细的使用指南, 请参阅TOML文档 . 如果出现解析错误, 请使用 TOML linter 验证配置.

一般配置结构具有以下模式:

[section1]
option1="value"

[section2]
option2=["value1","value2"]
option3=true

下面是一些使用Toml文件配置的 Grid组件示例, 该组件可以从下面的方式开始:

java -jar selenium-server-<version>.jar <component> --config /path/to/file/<file-name>.toml

单机模式

单机服务器, 在端口4449上运行, 新会话请求超时500秒.

[server]
port = 4449

[sessionqueue]
session-request-timeout = 500

特定浏览器和最大会话数限制

默认情况下仅启用Firefox 和Chrome的单机服务器或节点.

[node]
drivers = ["chrome", "firefox"]
max-sessions = 3

配置和定制驱动程序

具有定制驱动程序的单机或节点服务器, 允许使用Firefox试用或者每日构建的功能, 并且有不同的浏览器版本.

[node]
detect-drivers = false
[[node.driver-configuration]]
max-sessions = 100
display-name = "Firefox Nightly"
stereotype = "{\"browserName\": \"firefox\", \"browserVersion\": \"93\", \"platformName\": \"MAC\", \"moz:firefoxOptions\": {\"binary\": \"/Applications/Firefox Nightly.app/Contents/MacOS/firefox-bin\"}}"
[[node.driver-configuration]]
display-name = "Chrome Beta"
stereotype = "{\"browserName\": \"chrome\", \"browserVersion\": \"94\", \"platformName\": \"MAC\", \"goog:chromeOptions\": {\"binary\": \"/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta\"}}"
[[node.driver-configuration]]
display-name = "Chrome Dev"
stereotype = "{\"browserName\": \"chrome\", \"browserVersion\": \"95\", \"platformName\": \"MAC\", \"goog:chromeOptions\": {\"binary\": \"/Applications/Google Chrome Dev.app/Contents/MacOS/Google Chrome Dev\"}}"
webdriver-executable = '/path/to/chromedriver/95/chromedriver'

带Docker的单机或节点

单机或节点服务器能够在Docker容器中运行每个新会话. 禁用驱动程序检测, 则最多有2个并发会话. 原型配置需要映射一个Docker映像, Docker的守护进程需要通过http/tcp公开. 此外, 可以通过 devices 属性定义在主机上可访问的哪些设备文件将在容器中可用. 有关 docker 设备映射如何工作的更多信息, 请参阅 docker 文档.

驱动服务类

Mon, 01 Jan 0001 00:00:00 +0000

服务类用于管理驱动程序的启动和停止. 它们不能与远程 WebDriver 会话一起使用.

服务类允许您指定有关驱动程序的信息, 诸如位置和要使用的端口. 它们还允许您指定传递哪些参数到命令行. 大多数有用的参数都与日志记录有关.

默认服务实例

使用默认服务实例启动驱动程序:

 ChromeDriverService service = new ChromeDriverService.Builder().build();
 driver = new ChromeDriver(service);

View Complete Code View on GitHub

Selenium v4.11

Chrome 特定功能

Mon, 01 Jan 0001 00:00:00 +0000

默认情况下，Selenium 4与Chrome v75及更高版本兼容. 但是请注意Chrome浏览器的版本与chromedriver的主版本需要匹配.

Options

所有浏览器的通用功能请看这 Options page.

Chrome浏览器的特有功能可以在谷歌的页面找到: Capabilities & ChromeOptions

基于默认选项的Chrome浏览器会话看起来是这样:

 ChromeOptions options = getDefaultChromeOptions();
 driver = new ChromeDriver(options);

View Complete Code View on GitHub

 options = webdriver.ChromeOptions()
 options.add_argument("--no-sandbox")
 driver = webdriver.Chrome(options=options)

View Complete Code View on GitHub

 var options = new ChromeOptions();
 driver = new ChromeDriver(options);

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.chrome
 @driver = Selenium::WebDriver.for :chrome, options: options

View Complete Code View on GitHub

 const Options = new Chrome.Options();
 let driver = new Builder()
 .forBrowser(Browser.CHROME)
 .setChromeOptions(Options)
 .build();

View Complete Code View on GitHub

Add Example

Chrome DevTools Network Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Basic authentication

Some applications make use of browser authentication to secure pages. It used to be common to handle them in the URL, but browsers stopped supporting this. With this code you can insert the credentials into the header when necessary

定位策略

Mon, 01 Jan 0001 00:00:00 +0000

定位器是在页面上标识元素的一种方法。它是传送给查找元素方法的参数。

查看鼓励测试练习寻找定位器的小技巧，包含在查找方法中，不同时间，不同原因下，单独声明的定位器的使用方法。

元素选择策略

在 WebDriver 中有 8 种不同的内置元素定位策略：

定位器 Locator	描述
class name	定位class属性与搜索值匹配的元素（不允许使用复合类名）
css selector	定位 CSS 选择器匹配的元素
id	定位 id 属性与搜索值匹配的元素
name	定位 name 属性与搜索值匹配的元素
link text	定位link text可视文本与搜索值完全匹配的锚元素
partial link text	定位link text可视文本部分与搜索值部分匹配的锚点元素。如果匹配多个元素，则只选择第一个元素。
tag name	定位标签名称与搜索值匹配的元素
xpath	定位与 XPath 表达式匹配的元素

Creating Locators

To work on a web element using Selenium, we need to first locate it on the web page. Selenium provides us above mentioned ways, using which we can locate element on the page. To understand and create locator we will use the following HTML snippet.

记录 Selenium 命令

Mon, 01 Jan 0001 00:00:00 +0000

启用日志记录是获取额外信息的宝贵方法, 这些信息可能有助于您确定遇到问题的原因.

获取一个logger

Java 日志通常是按类创建的. 您可以通过默认logger来使用所有loggers. 为了过滤特定类, 请参考过滤器

获取根logger:

 public void logging() throws IOException {

View Complete Code View on GitHub

Java日志并不简单直接, 如果您只是在寻找一种简单的方法查看重要的Selenium日志, 请参阅 Selenium Logger 项目

关于网络元素的信息

Mon, 01 Jan 0001 00:00:00 +0000

您可以查询有关特定元素的许多详细信息。

是否显示

此方法用于检查连接的元素是否正确显示在网页上. 返回一个 Boolean 值，如果连接的元素显示在当前的浏览器上下文中，则为True，否则返回false。

此功能于W3C规范中提及，但由于无法覆盖所有潜在条件而无法定义。因此，Selenium不能期望驱动程序直接实现这种功能，现在依赖于直接执行大量JavaScript函数。这个函数对一个元素的性质和在树中的关系做了许多近似的判断，以返回一个值。

 boolean isEmailVisible = driver.findElement(By.name("email_input")).isDisplayed();
 assertTrue(isEmailVisible);

View Complete Code View on GitHub

 driver.get("https://www.selenium.dev/selenium/web/inputs.html")

 # isDisplayed
 is_email_visible = driver.find_element(By.NAME, "email_input").is_displayed()

View Complete Code View on GitHub

 // Navigate to Url
 driver.Url= "https://www.selenium.dev/selenium/web/inputs.html";
 // isDisplayed 
 // Get boolean value for is element display
 bool isEmailVisible = driver.FindElement(By.Name("email_input")).Displayed;

View Complete Code View on GitHub

 displayed_value = driver.find_element(name: 'email_input').displayed?

View Complete Code View on GitHub

 // Resolves Promise and returns boolean value
 let result = await driver.findElement(By.name("email_input")).isDisplayed();

View Complete Code View on GitHub

//navigates to url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

//returns true if element is displayed else returns false
val flag = driver.findElement(By.name("email_input")).isDisplayed()

是否启用

此方法用于检查所连接的元素在网页上是启用还是禁用状态。返回一个布尔值，如果在当前浏览上下文中是启用状态，则返回 true，否则返回 false。

自定义Node

Mon, 01 Jan 0001 00:00:00 +0000

如何自定义节点

有时候我们希望根据自己的需求自定义Node。

例如，我们可能希望在会话开始执行前做一些额外的设置，在会话完成后做一些清理工作。

可以按照以下步骤进行：

创建一个类，继承自 org.openqa.selenium.grid.node.Node
在新建的类中添加一个静态方法（工厂方法），其签名如下：

public static Node create(Config config)。其中：
- Node 类型为 org.openqa.selenium.grid.node.Node
- Config 类型为 org.openqa.selenium.grid.config.Config
在工厂方法中，包含创建新类的逻辑。
要将自定义逻辑接入 hub，启动 node 时通过参数 --node-implementation 传入上述类的完整类名。

下面我们来看一个完整的示例：

作为 uber jar 的自定义 Node

使用你喜欢的构建工具 (Maven|Gradle) 创建一个示例项目。
在项目中添加如下依赖：
- org.seleniumhq.selenium/selenium-grid
将你的自定义 Node 添加到项目中。
构建一个 uber jar，以便通过 java -jar 命令启动 Node。
现在使用如下命令启动 Node：

java -jar custom_node-server.jar node \
--node-implementation org.seleniumhq.samples.DecoratedLoggingNode

注意： 如果你使用 Maven 作为构建工具，建议使用 maven-shade-plugin 而不是 maven-assembly-plugin，因为 maven-assembly-plugin 在合并多个 Service Provider Interface 文件 (META-INF/services) 时可能存在问题。

作为普通 jar 的自定义 Node

使用你喜欢的构建工具 (Maven|Gradle) 创建一个示例项目。
在项目中添加如下依赖：
- org.seleniumhq.selenium/selenium-grid
将你的自定义 Node 添加到项目中。
使用构建工具构建项目 jar 包。
现在使用如下命令启动 Node：

java -jar selenium-server-4.6.0.jar \
--ext custom_node-1.0-SNAPSHOT.jar node \
--node-implementation org.seleniumhq.samples.DecoratedLoggingNode

下面是一个示例：当Node有相关活动（会话创建、会话删除、WebDriver 命令执行等）时，仅在控制台打印一些消息。

Edge 特定功能

Mon, 01 Jan 0001 00:00:00 +0000

微软Edge是用Chromium实现的, 最早支持版本是v79. 与Chrome类似, Edge驱动的主版本号必须与Edge浏览器的主要版本匹配.

在 Chrome 页面上找到的所有capabilities和选项也适用于Edge.

选项

所有浏览器的共有功能在 Options 页面.

Chromium独有的功能记录在谷歌的 Capabilities & ChromeOptions

使用基本定义的选项启动 Edge 会话如下所示:


 @Test

View Complete Code View on GitHub

 options = webdriver.EdgeOptions()
 options.add_argument("--no-sandbox")
 driver = webdriver.Edge(options=options)

View Complete Code View on GitHub

 catch (IOException)
 {

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.edge
 options.args << '--no-sandbox'
 @driver = Selenium::WebDriver.for :edge, options: options

View Complete Code View on GitHub

 let options = new edge.Options().addArguments('--no-sandbox');
 driver = new Builder()
 .forBrowser(Browser.EDGE)
 .setEdgeOptions(options)
 .build();

View Complete Code View on GitHub

Add Example

External datastore

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

Introduction

Selenium Grid allows you to persist information related to currently running sessions into an external data store. The external data store could be backed by your favourite database (or) Redis Cache system.

触控笔操作

Mon, 01 Jan 0001 00:00:00 +0000

Chromium Only

触控笔是一种指针输入设备，其行为大多与鼠标相同，但也可以具有触控笔特有的事件属性。此外，鼠标有 5 个按钮，而触控笔有 3 种等效的按钮状态:

0 - 触摸接触（默认设置；相当于左键单击）
2 - 桶形按钮/侧键（相当于右键点击）
5 - 橡皮擦按钮（当前驱动程序不支持）

使用触控笔

Selenium v4.2

文件上传

Mon, 01 Jan 0001 00:00:00 +0000

由于 Selenium 不能与文件上传对话框交互，因此它提供了一种无需打开对话框即可上传文件的方法。如果该元素是一个类型为 file 的 input 元素，则可以使用 send keys 方法发送将要上传文件的完整路径。

 WebElement fileInput = driver.findElement(By.cssSelector("input[type=file]"));
 fileInput.sendKeys(uploadFile.getAbsolutePath());
 driver.findElement(By.id("file-submit")).click();

View Complete Code View on GitHub

 file_input = driver.find_element(By.CSS_SELECTOR, "input[type='file']")
 file_input.send_keys(upload_file)
 driver.find_element(By.ID, "file-submit").click()

View Complete Code View on GitHub

 IWebElement fileInput = driver.FindElement(By.CssSelector("input[type=file]"));
 fileInput.SendKeys(uploadFile);
 driver.FindElement(By.Id("file-submit")).Click();

View Complete Code View on GitHub

 file_input = driver.find_element(css: 'input[type=file]')
 file_input.send_keys(upload_file)
 driver.find_element(id: 'file-submit').click

View Complete Code View on GitHub

 await driver.get('https://the-internet.herokuapp.com/upload');
 // Upload snapshot

View Complete Code View on GitHub

Move Code

Firefox specific functionality

Mon, 01 Jan 0001 00:00:00 +0000

Selenium 4 requires Firefox 78 or greater. It is recommended to always use the latest version of geckodriver.

Options

Capabilities common to all browsers are described on the Options page.

Capabilities unique to Firefox can be found at Mozilla’s page for firefoxOptions

Starting a Firefox session with basic defined options looks like this:

 driver = new FirefoxDriver(options);
 }

View Complete Code View on GitHub

 options = webdriver.FirefoxOptions()
 driver = webdriver.Firefox(options=options)

View Complete Code View on GitHub

 public void BasicOptions()
 {

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.firefox
 @driver = Selenium::WebDriver.for :firefox, options: options

View Complete Code View on GitHub

 driver = new Builder()
 .forBrowser(Browser.FIREFOX)
 .setFirefoxOptions(options)
 .build();

View Complete Code View on GitHub

Add Example

与IFrames和frames一起工作

Mon, 01 Jan 0001 00:00:00 +0000

框架是一种现在已被弃用的方法，用于从同一域中的多个文档构建站点布局。除非你使用的是 HTML5 之前的 webapp，否则你不太可能与他们合作。内嵌框架允许插入来自完全不同领域的文档，并且仍然经常使用。

如果您需要使用框架或 iframe, WebDriver 允许您以相同的方式使用它们。考虑 iframe 中的一个按钮。如果我们使用浏览器开发工具检查元素，我们可能会看到以下内容:

<div id="modal">
 <iframe id="buttonframe" name="myframe" src="https://seleniumhq.github.io">
 <button>Click here</button>
 </iframe>
</div>

如果不是 iframe，我们可能会使用如下方式点击按钮:

// 这不会工作
driver.findElement(By.tagName("button")).click();

 # 这不会工作
driver.find_element(By.TAG_NAME, 'button').click()

// 这不会工作
driver.FindElement(By.TagName("button")).Click();

 # 这不会工作
driver.find_element(:tag_name,'button').click

// 这不会工作
await driver.findElement(By.css('button')).click();

// 这不会工作
driver.findElement(By.tagName("button")).click()

但是，如果 iframe 之外没有按钮，那么您可能会得到一个 no such element 无此元素 的错误。这是因为 Selenium 只知道顶层文档中的元素。为了与按钮进行交互，我们需要首先切换到框架，这与切换窗口的方式类似。WebDriver 提供了三种切换到帧的方法。

Chrome DevTools Script Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Script Pinning

 ScriptKey key = ((JavascriptExecutor) driver).pin("return arguments;");
 List<Object> arguments =
 (List<Object>) ((JavascriptExecutor) driver).executeScript(key, 1, true, element);

View Complete Code View on GitHub

Implementation Missing

Style guide for Selenium documentation

Mon, 01 Jan 0001 00:00:00 +0000

Read our contributing documentation for complete instructions on how to add content to this documentation.

Alerts

Alerts have been added to direct potential contributors to where specific content is missing.

{{< alert-content />}}

{{< alert-content >}}
Additional information about what specific content is needed
{{< /alert-content >}}

Which gets displayed like this:

Content Help

Note: This section needs additional and/or updated content

Additional information about what specific content is needed

Check our contribution guidelines if you’d like to help.

滚轮操作

Mon, 01 Jan 0001 00:00:00 +0000

Selenium v4.2

Chromium Only

在页面上滚动有 5 种情况.

滚动到元素

这是最常见的场景. 与传统的点击和发送按键的方法不同, 动作类不会自动将目标元素滚动到视图中, 因此如果元素不在视口内, 就需要使用此方法.

此方法仅将一个网页元素作为参数.

无论该元素是在当前视图屏幕的上方还是下方, 视口都会滚动, 使该元素的底部位于屏幕底部.

 WebElement iframe = driver.findElement(By.tagName("iframe"));
 new Actions(driver)
 .scrollToElement(iframe)
 .perform();

View Complete Code View on GitHub

 iframe = driver.find_element(By.TAG_NAME, "iframe")
 ActionChains(driver)\
 .scroll_to_element(iframe)\
 .perform()

View Complete Code View on GitHub

 IWebElement iframe = driver.FindElement(By.TagName("iframe"));
 new Actions(driver)
 .ScrollToElement(iframe)
 .Perform();

View Complete Code View on GitHub

 iframe = driver.find_element(tag_name: 'iframe')
 driver.action
 .scroll_to(iframe)
 .perform

View Complete Code View on GitHub

 const iframe = await driver.findElement(By.css("iframe"))
 await driver.actions()
 .scroll(0, 0, 0, 0, iframe)
 .perform()

View Complete Code View on GitHub

 val iframe = driver.findElement(By.tagName("iframe"))
 Actions(driver)
 .scrollToElement(iframe)
 .perform()

View Complete Code View on GitHub

按给定的量进行滚动

这是第二种最常见的滚动场景. 传入一个 x 方向的偏移量和一个 y 方向的偏移量, 表示向右和向下滚动的距离. 负值分别表示向左和向上滚动.

IE 特定功能

Mon, 01 Jan 0001 00:00:00 +0000

自2022年6月起, Selenium 正式不再支持独立的 Internet Explorer. Internet Explorer 驱动程序仍支持在 “IE 兼容模式” 下运行 Microsoft Edge.

特别注意事项

IE 驱动程序是 Selenium 项目直接维护的唯一驱动程序. 虽然 32 位和 64 位版本的版本的二进制文件, 但有一些64位驱动程序的已知限制. 因此, 建议使用 32 位驱动程序.

有关使用 Internet Explorer 的其他信息, 请参见 IE 驱动程序服务器页面

选项

在 Internet Explorer 兼容模式下启动 Microsoft Edge 浏览器, 并使用基本定义的选项, 看起来就像这样:

 InternetExplorerOptions options = new InternetExplorerOptions();
 options.attachToEdgeChrome();
 options.withEdgeExecutablePath(getEdgeLocation());
 driver = new InternetExplorerDriver(options);

View Complete Code View on GitHub

 options = webdriver.IeOptions()
 options.attach_to_edge_chrome = True
 options.edge_executable_path = edge_bin
 driver = webdriver.Ie(options=options)

View Complete Code View on GitHub

 var options = new InternetExplorerOptions();
 options.AttachToEdgeChrome = true;
 options.EdgeExecutablePath = GetEdgeLocation();
 _driver = new InternetExplorerDriver(options);

View Complete Code View on GitHub

 options = Selenium::WebDriver::IE::Options.new
 options.attach_to_edge_chrome = true
 options.edge_executable_path = edge_location
 @driver = Selenium::WebDriver.for :ie, options: options

View Complete Code View on GitHub

Add Example

同窗口和标签一起工作

Mon, 01 Jan 0001 00:00:00 +0000

窗口和标签页

WebDriver 没有区分窗口和标签页。如果你的站点打开了一个新标签页或窗口，Selenium 将允许您使用窗口句柄来处理它。每个窗口都有一个唯一的标识符，该标识符在单个会话中保持持久性。你可以使用以下方法获得当前窗口的窗口句柄:

 // Navigate to Url
 driver.get("https://www.selenium.dev/selenium/web/window_switching_tests/page_with_frame.html");
 //fetch handle of this
 String currHandle=driver.getWindowHandle();
 assertNotNull(currHandle);

View Complete Code View on GitHub

 driver.get(url)
 current_handle = driver.current_window_handle
 assert current_handle is not None

View Complete Code View on GitHub

 // Navigate to Url
  driver.Url="https://www.selenium.dev/selenium/web/window_switching_tests/page_with_frame.html";
  //fetch handle of this
  String currHandle = driver.CurrentWindowHandle;
  Assert.IsNotNull(currHandle);

View Complete Code View on GitHub

driver.window_handle

await driver.getWindowHandle();

driver.windowHandle

切换窗口或标签页

单击在 <a href=“https://seleniumhq.github.io"target="_blank”>新窗口中打开链接，则屏幕会聚焦在新窗口或新标签页上，但 WebDriver 不知道操作系统认为哪个窗口是活动的。要使用新窗口，您需要切换到它。如果只有两个选项卡或窗口被打开，并且你知道从哪个窗口开始，则你可以遍历 WebDriver，通过排除法可以看到两个窗口或选项卡，然后切换到你需要的窗口或选项卡。

Selenium

Browsing Context

Commands

Open a new window

Browsing Context

Perform Actions

WebDriver BiDi Network Features

Authentication Handlers

Network

Commands

Add network intercept

Script

Commands

Call function in a browsing context

浏览器导航

打开网站

/examples/java/src/test/java/dev/selenium/interactions/NavigationTest.java

/examples/python/tests/interactions/test_navigation.py

/examples/dotnet/SeleniumDocs/Interactions/NavigationTest.cs

/examples/ruby/spec/interactions/navigation_spec.rb

/examples/javascript/test/interactions/navigation.spec.js

后退

/examples/java/src/test/java/dev/selenium/interactions/NavigationTest.java

/examples/python/tests/interactions/test_navigation.py

/examples/dotnet/SeleniumDocs/Interactions/NavigationTest.cs

/examples/ruby/spec/interactions/navigation_spec.rb

/examples/javascript/test/interactions/navigation.spec.js

期望状态的等待

设计模式和开发策略

概览

Loadable Component

其是什么?

简单用法

CLI 选项

Internet Explorer Driver Internals

Client Code Into the Driver

Memory Management

Chrome DevTools Logging Features

Console Logs

/examples/java/src/test/java/dev/selenium/bidi/cdp/LoggingTest.java

/examples/python/tests/bidi/cdp/test_logs.py

/examples/dotnet/SeleniumDocs/BiDi/CDP/LoggingTest.cs

/examples/ruby/spec/bidi/cdp/logging_spec.rb

命令监听器

Web元素交互

附加验证

点击

/examples/java/src/test/java/dev/selenium/elements/InteractionTest.java

/examples/python/tests/elements/test_interaction.py

/examples/dotnet/SeleniumDocs/Elements/InteractionTest.cs

/examples/ruby/spec/elements/interaction_spec.rb

/examples/javascript/test/getting_started/firstScript.spec.js

发送键位

HTTP Client Configuration

Selenium Manager (测试版)

动机

Toml配置选项

概述

单机模式

特定浏览器和最大会话数限制

配置和定制驱动程序

带Docker的单机或节点

驱动服务类

默认服务实例

/examples/java/src/test/java/dev/selenium/drivers/ServiceTest.java

Chrome 特定功能

Options

/examples/java/src/test/java/dev/selenium/browsers/ChromeTest.java

/examples/python/tests/browsers/test_chrome.py

/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs

/examples/ruby/spec/browsers/chrome_spec.rb

/examples/javascript/test/browser/chromeSpecificCaps.spec.js

Chrome DevTools Network Features

Basic authentication

定位策略

元素选择策略

Creating Locators

记录 Selenium 命令

获取一个logger

/examples/java/src/test/java/dev/selenium/troubleshooting/LoggingTest.java