Chrome DevTools 协议端点

Google 提供了一个可直接访问的 /cdp/execute 端点。每个 Selenium 绑定都提供了一种方法，允许你将 CDP 域作为字符串传递，并将所需参数作为简单的映射传递。

这些方法最终将被移除。建议尽可能使用 WebDriver-BiDi 或 WebDriver Bidi API 方法，以确保未来的兼容性。

用法

通常，你应该优先使用 CDP API 而不是此方法，但有时语法更简洁或简单得多。

限制包括

  • 它仅适用于仅限于设置或获取信息的用例；任何实际的异步交互都需要另一种实现
  • 你必须确切地知道域和键的“魔术字符串”
  • Chrome 的更新可能会更改所需的参数

示例

可以在 CDP API Set Cookie 中找到备用实现

    Map<String, Object> cookie = new HashMap<>();
    cookie.put("name", "cheese");
    cookie.put("value", "gouda");
    cookie.put("domain", "www.selenium.dev");
    cookie.put("secure", true);

    ((HasCdp) driver).executeCdpCommand("Network.setCookie", cookie);
在 GitHub 上查看完整示例
    cookie = {'name': 'cheese',
              'value': 'gouda',
              'domain': 'www.selenium.dev',
              'secure': True}

    driver.execute_cdp_cmd('Network.setCookie', cookie)
在 GitHub 上查看完整示例
            var cookie = new Dictionary<string, object>
            {
                { "name", "cheese" },
                { "value", "gouda" },
                { "domain", "www.selenium.dev" },
                { "secure", true }
            };

            ((ChromeDriver)driver).ExecuteCdpCommand("Network.setCookie", cookie);
在 GitHub 上查看完整示例

应优先使用 CDP API 设置 Cookie 实现

    cookie = {name: 'cheese',
              value: 'gouda',
              domain: 'www.selenium.dev',
              secure: true}

    driver.execute_cdp('Network.setCookie', **cookie)
在 GitHub 上查看完整示例

添加示例

添加示例

性能指标

可在 CDP API 性能指标 中找到备用实现

应优先使用 CDP API 性能指标 实现

    ((HasCdp) driver).executeCdpCommand("Performance.enable", new HashMap<>());

    Map<String, Object> response =
        ((HasCdp) driver).executeCdpCommand("Performance.getMetrics", new HashMap<>());
在 GitHub 上查看完整示例
    driver.execute_cdp_cmd('Performance.enable', {})

    metric_list = driver.execute_cdp_cmd('Performance.getMetrics', {})["metrics"]
在 GitHub 上查看完整示例
            ((ChromeDriver)driver).ExecuteCdpCommand("Performance.enable", emptyDictionary);

            Dictionary<string, object> response = (Dictionary<string, object>)((ChromeDriver)driver)
                .ExecuteCdpCommand("Performance.getMetrics", emptyDictionary);
在 GitHub 上查看完整示例

应优先使用 CDP API 性能指标 实现

    driver.execute_cdp('Performance.enable')

    metric_list = driver.execute_cdp('Performance.getMetrics')['metrics']
在 GitHub 上查看完整示例

添加示例

添加示例

基本身份验证

可在 CDP API 基本身份验证 和 BiDi API 基本身份验证 中找到备用实现

应优先使用 BiDi API 基本身份验证 实现

    ((HasCdp) driver).executeCdpCommand("Network.enable", new HashMap<>());

    String encodedAuth = Base64.getEncoder().encodeToString("admin:admin".getBytes());
    Map<String, Object> headers =
        ImmutableMap.of("headers", ImmutableMap.of("authorization", "Basic " + encodedAuth));

    ((HasCdp) driver).executeCdpCommand("Network.setExtraHTTPHeaders", headers);
在 GitHub 上查看完整示例
    driver.execute_cdp_cmd("Network.enable", {})

    credentials = base64.b64encode("admin:admin".encode()).decode()
    headers = {'headers': {'authorization': 'Basic ' + credentials}}

    driver.execute_cdp_cmd('Network.setExtraHTTPHeaders', headers)
在 GitHub 上查看完整示例
            ((ChromeDriver)driver).ExecuteCdpCommand("Network.enable", emptyDictionary);
            
            string encodedAuth = Convert.ToBase64String(Encoding.Default.GetBytes("admin:admin"));
            var headers = new Dictionary<string, object>
            {
                { "headers", new Dictionary<string, string> { { "authorization", "Basic " + encodedAuth } } }
            };

            ((ChromeDriver)driver).ExecuteCdpCommand("Network.setExtraHTTPHeaders", headers);
在 GitHub 上查看完整示例

应优先使用 BiDi API 基本身份验证 实现

    driver.execute_cdp('Network.enable')

    credentials = Base64.strict_encode64('admin:admin')
    headers = {authorization: "Basic #{credentials}"}

    driver.execute_cdp('Network.setExtraHTTPHeaders', headers: headers)
在 GitHub 上查看完整示例

添加示例

添加示例

上次修改时间 2023 年 11 月 17 日：升级到 Docsy 0 7 2 (#1529) (48f43616907)