diff --git a/website_and_docs/content/documentation/webdriver/browsers/edge.zh-cn.md b/website_and_docs/content/documentation/webdriver/browsers/edge.zh-cn.md index a78ced964fb..6fdca1f933e 100644 --- a/website_and_docs/content/documentation/webdriver/browsers/edge.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/browsers/edge.zh-cn.md @@ -6,16 +6,16 @@ description: >- 这些是特定于微软Edge浏览器的功能和特性. --- -微软Edge是用Chromium实现的,最早支持版本是v79. +微软Edge是用Chromium实现的, 最早支持版本是v79. 与Chrome类似, Edge驱动的主版本号必须与Edge浏览器的主要版本匹配. 在 [Chrome 页面]({{< ref "chrome.md" >}}) 上找到的所有capabilities和选项也适用于Edge. ## 选项 -Capabilities common to all browsers are described on the [Options page]({{< ref "../drivers/options.md" >}}). +所有浏览器的共有功能在 [Options 页面]({{< ref "../drivers/options.md" >}}). -Capabilities unique to Chromium are documented at Google's page for +Chromium独有的功能记录在谷歌的 [Capabilities & ChromeOptions](https://chromedriver.chromium.org/capabilities) 使用基本定义的选项启动 Edge 会话如下所示: @@ -41,16 +41,16 @@ Capabilities unique to Chromium are documented at Google's page for {{< /tab >}} {{< /tabpane >}} -### Arguments +### 参数 -The `args` parameter is for a list of command line switches to be used when starting the browser. -There are two excellent resources for investigating these arguments: +`args` 参数用于列出启动浏览器时使用的命令行开关. +有两个很好的资源可用于研究这些参数: * [Chrome Flags for Tooling](https://github.com/GoogleChrome/chrome-launcher/blob/main/docs/chrome-flags-for-tools.md) * [List of Chromium Command Line Switches](https://peter.sh/experiments/chromium-command-line-switches/) -Commonly used args include `--start-maximized` and `--headless=new` and `--user-data-dir=...` +常用参数包括 `--start-maximized` 、 `--headless=new` 和 `--user-data-dir=...` -Add an argument to options: +为options添加参数: {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -73,12 +73,12 @@ Add an argument to options: {{< /tab >}} {{< /tabpane >}} -### Start browser in a specified location +### 在指定位置启动浏览器 -The `binary` parameter takes the path of an alternate location of browser to use. With this parameter you can -use chromedriver to drive various Chromium based browsers. +`binary` 参数包含要使用的浏览器备用位置的路径. +使用此参数, 您可以使用 chromedriver 驱动各种基于 Chromium 的浏览器. -Add a browser location to options: +在options中添加浏览器位置: {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -101,13 +101,15 @@ Add a browser location to options: {{< /tab >}} {{< /tabpane >}} -### Add extensions +### 添加扩展 -The `extensions` parameter accepts crx files. As for unpacked directories, -please use the `load-extension` argument instead, as mentioned in -[this post](https://chromedriver.chromium.org/extensions). -Add an extension to options: +`extensions`参数接受 crx 文件. +至于已解压的目录、中提到, +请使用[本文](https://chromedriver.chromium.org/extensions)中提及的 `load-extension`. + + +在options中添加扩展: {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -130,10 +132,11 @@ Add an extension to options: {{< /tab >}} {{< /tabpane >}} -### Keeping browser open +### 保持浏览器打开 -Setting the `detach` parameter to true will keep the browser open after the process has ended, -so long as the quit command is not sent to the driver. +将 `detach` 参数设置为 true后, +只要不向driver发送退出命令, +就可以在进程结束后保持浏览器打开. {{< tabpane text=true >}} {{% tab header="Java" %}} @@ -156,15 +159,15 @@ so long as the quit command is not sent to the driver. {{< /tab >}} {{< /tabpane >}} -### Excluding arguments +### 排除参数 -MSEdgedriver has several default arguments it uses to start the browser. -If you do not want those arguments added, pass them into `excludeSwitches`. -A common example is to turn the popup blocker back on. A full list of default arguments -can be parsed from the +MSEdgedriver 有几个用于启动浏览器的默认参数. +如果不希望添加这些参数, 可将它们传递到 `excludeSwitches` 中. +一个常见的例子就是重新打开弹出窗口拦截器. +默认参数的完整列表参考 [Chromium Source Code](https://source.chromium.org/chromium/chromium/src/+/main:chrome/test/chromedriver/chrome_launcher.cc) -Set excluded arguments on options: +在options中设置排除参数: {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -188,25 +191,26 @@ Set excluded arguments on options: {{< /tabpane >}} -## Service +## 服务 -Examples for creating a default Service object, and for setting driver location and port -can be found on the [Driver Service]({{< ref "../drivers/service.md" >}}) page. +创建默认服务对象, 设置驱动程序位置和端口的示例可以参考 +[Driver服务]({{< ref "../drivers/service.md" >}}) 页面. -### Log output +### 日志输出 -Getting driver logs can be helpful for debugging issues. The Service class lets you -direct where the logs will go. Logging output is ignored unless the user directs it somewhere. +获取驱动程序日志有助于调试问题。 +服务类可让您配置日志的输出。 +日志输出会被忽略, 除非用户显示指定. -#### File output +#### 文件输出 -To change the logging output to save to a specific file: +更改日志输出以保存到特定文件: {{< tabpane text=true >}} {{% tab header="Java" %}} {{< badge-version version="4.10" >}} {{< gh-codeblock path="examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java#L101" >}} -**Note**: Java also allows setting file output by System Property:\ +**注意**: Java同样允许在系统属性中配置文件输出:\ Property key: `EdgeDriverService.EDGE_DRIVER_LOG_PROPERTY`\ Property value: String representing path to log file {{% /tab %}} @@ -228,17 +232,17 @@ Property value: String representing path to log file {{< /tab >}} {{< /tabpane >}} -#### Console output +#### 控制台输出 -To change the logging output to display in the console as STDOUT: +要更改日志输出, 使其在控制台中显示为标准输出: {{< tabpane text=true >}} {{% tab header="Java" %}} {{< badge-version version="4.10" >}} {{< gh-codeblock path="examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java#L114" >}} -**Note**: Java also allows setting console output by System Property;\ -Property key: `EdgeDriverService.EDGE_DRIVER_LOG_PROPERTY`\ -Property value: `DriverService.LOG_STDOUT` or `DriverService.LOG_STDERR` +**注意**: Java同样允许在系统属性中配置控制台输出:\ +属性键: `EdgeDriverService.EDGE_DRIVER_LOG_PROPERTY`\ +属性值: `DriverService.LOG_STDOUT` 或 `DriverService.LOG_STDERR` {{% /tab %}} {{< tab header="Python" >}} {{< badge-version version="4.11" >}} @@ -260,18 +264,19 @@ Property value: `DriverService.LOG_STDOUT` or `DriverService.LOG_STDERR` {{< /tab >}} {{< /tabpane >}} -### Log level -There are 6 available log levels: `ALL`, `DEBUG`, `INFO`, `WARNING`, `SEVERE`, and `OFF`. -Note that `--verbose` is equivalent to `--log-level=ALL` and `--silent` is equivalent to `--log-level=OFF`, -so this example is just setting the log level generically: +### 日志级别 + +有 6 种可用的日志级别: `ALL`, `DEBUG`, `INFO`, `WARNING`, `SEVERE`, 以及 `OFF`. +请注意, `--verbose` 等同于 `--log-level=ALL` , 而 `--silent` 等同于 `--log-level=OFF`, +因此, 本例只是一般性地设置日志级别: {{< tabpane text=true >}} {{% tab header="Java" %}} {{< badge-version version="4.8" >}} {{< gh-codeblock path="examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java#L127-L128" >}} -**Note**: Java also allows setting log level by System Property:\ -Property key: `EdgeDriverService.EDGE_DRIVER_LOG_LEVEL_PROPERTY`\ -Property value: String representation of `ChromiumDriverLogLevel` enum +**注意**: Java同样允许在系统属性中配置日志级别:\ +属性键: `EdgeDriverService.EDGE_DRIVER_LOG_LEVEL_PROPERTY`\ +属性值: String representation of `ChromiumDriverLogLevel` enum {{% /tab %}} {{< tab header="Python" >}} {{< gh-codeblock path="examples/python/tests/browsers/test_edge.py#L93" >}} @@ -291,21 +296,21 @@ Property value: String representation of `ChromiumDriverLogLevel` enum {{< /tab >}} {{< /tabpane >}} -### Log file features -There are 2 features that are only available when logging to a file: -* append log -* readable timestamps +### 日志文件功能 +有 2 项功能只有在记录到文件时才可用: +* 追加日志 +* 可读时间戳 -To use them, you need to also explicitly specify the log path and log level. -The log output will be managed by the driver, not the process, so minor differences may be seen. +要使用它们, 还需要明确指定日志路径和日志级别. +日志输出将由driver而非进程管理, 因此可能会出现细微差别. {{< tabpane text=true >}} {{% tab header="Java" %}} {{< badge-version version="4.8" >}} {{< gh-codeblock path="examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java#L143-L144" >}} -**Note**: Java also allows toggling these features by System Property:\ -Property keys: `EdgeDriverService.EDGE_DRIVER_APPEND_LOG_PROPERTY` and `EdgeDriverService.EDGE_DRIVER_READABLE_TIMESTAMP`\ -Property value: `"true"` or `"false"` +**注意**: Java同样允许在系统属性中配置开闭这些功能:\ +属性键: `EdgeDriverService.EDGE_DRIVER_APPEND_LOG_PROPERTY` 以及 `EdgeDriverService.EDGE_DRIVER_READABLE_TIMESTAMP`\ +属性值: `"true"` 或 `"false"` {{% /tab %}} {{< tab header="Python" >}} {{< gh-codeblock path="examples/python/tests/browsers/test_edge.py#L104" >}} @@ -325,19 +330,20 @@ Property value: `"true"` or `"false"` {{< /tab >}} {{< /tabpane >}} -### Disabling build check +### 禁用构建检查 -Edge browser and msedgedriver versions should match, and if they don't the driver will error. -If you disable the build check, you can force the driver to be used with any version of Edge. -Note that this is an unsupported feature, and bugs will not be investigated. +Edge 浏览器和 msedgedriver 版本应该匹配, +如果不匹配, 驱动程序就会出错. +如果禁用构建检查, 则可以强制驱动程序与任何版本的 Edge 一起使用. +请注意, 这是一项不受支持的功能, 而且不会对错误进行调查. {{< tabpane text=true >}} {{% tab header="Java" %}} {{< badge-version version="4.8" >}} {{< gh-codeblock path="examples/java/src/test/java/dev/selenium/browsers/EdgeTest.java#L161-L162" >}} -**Note**: Java also allows disabling build checks by System Property:\ -Property key: `EdgeDriverService.EDGE_DRIVER_DISABLE_BUILD_CHECK`\ -Property value: `"true"` or `"false"` +**注意**: Java同样允许在系统属性中配置禁用构建检查:\ +属性键: `EdgeDriverService.EDGE_DRIVER_DISABLE_BUILD_CHECK`\ +属性值: `"true"` 或 `"false"` {{% /tab %}} {{< tab header="Python" >}} {{< gh-codeblock path="examples/python/tests/browsers/test_edge.py#L115" >}} @@ -360,17 +366,17 @@ Property value: `"true"` or `"false"` ## Internet Explorer 兼容模式 -微软Edge可以被"Internet Explorer兼容模式"驱动, +微软Edge可以被"Internet Explorer兼容模式"驱动, 该模式使用Internet Explorer驱动类与微软Edge结合使用. 阅读 [Internet Explorer 页面]({{< ref "internet_explorer.md" >}}) 了解更多详情. -## Special Features -Some browsers have implemented additional features that are unique to them. +## 特殊功能 +某些浏览器实现了其特有的附加功能. -### Casting +### Cast -You can drive Chrome Cast devices with Edge, including sharing tabs +您可以使用 Edge 驱动 Chrome Cast 设备, 包括共享标签页 {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -393,9 +399,9 @@ You can drive Chrome Cast devices with Edge, including sharing tabs {{< /tab >}} {{< /tabpane >}} -### Network conditions +### 网络状况 -You can simulate various network conditions. +您可以模拟各种网络状况. {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -418,7 +424,7 @@ You can simulate various network conditions. {{< /tab >}} {{< /tabpane >}} -### Logs +### 日志 {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -441,7 +447,7 @@ You can simulate various network conditions. {{< /tab >}} {{< /tabpane >}} -### Permissions +### 权限 {{< tabpane text=true >}} {{< tab header="Java" >}} @@ -464,6 +470,6 @@ You can simulate various network conditions. {{< /tab >}} {{< /tabpane >}} -### DevTools +### 开发者工具 -See the [Chrome DevTools] section for more information about using DevTools in Edge +有关在 Edge 中使用 DevTools 的更多信息, 请参阅 [Chrome DevTools] 部分.