スクリプトによるモニターのプロキシ設定とプロパティの設定

すべてのURL単位のリクエスト（HTTP、HTTPS、FTP）に使用するプロキシサーバーを設定します。

その他の注意事項：

• ポートはオプションです。省略された場合は、スキームに基づいて決定されます。例えば、HTTPの場合、ポートは80となります。

• ユーザー名とパスワードは、 encodeURIComponent()への呼び出しの結果であると見なされます。ユーザー名やパスワードの@や:などの特殊文字はエスケープする必要があります。

  リターンズ

  このメソッドは、構成が適用されると解決されるPromiseを返します。

  パラメーター

  パラメータ	データタイプ	説明
  proxyURL | proxyUrlParsed	文字列またはオブジェクト	プロキシサーバーに接続するためのURL。 proxyURL （たとえば、 http://proxy_host:8888 ）を含む文字列、またはノードのurl.parse(urlString)メソッドで定義されたものと同じ形式のプレーンオブジェクト。

  例

  HTTPプロトコルでポート1234に認証なしのプロキシサーバーを設定した例です。

  $network.setProxy('http://host.com:1234')

  コピー

  認証情報付きのHTTPプロトコルでプロキシサーバーを設定した例です。

  $network.setProxy('http://proxyUsername:proxyPassword@proxyHost:1234')

  コピー

すべてのHTTPリクエストに使用するプロキシサーバーを設定します。

その他の注意事項：

• ポートはオプションです。省略された場合は、スキームに基づいて決定されます。例えば、HTTPの場合、ポートは80となります。

• ユーザー名とパスワードは、 encodeURIComponent()への呼び出しの結果であると見なされます。ユーザー名やパスワードの@や:などの特殊文字はエスケープする必要があります。

  リターンズ

  このメソッドは、構成が適用されると解決されるPromiseを返します。

  パラメーター

  パラメータ	データタイプ	説明
  proxyURL | proxyUrlParsed	文字列またはオブジェクト	プロキシサーバーに接続するためのURL。 proxyURL （たとえば、 http://proxy_host:8888 ）を含む文字列、またはノードのurl.parse(urlString)メソッドで定義されたものと同じ形式のプレーンオブジェクト。

  例

  HTTPプロトコルでポート1234に認証なしのプロキシサーバーを設定した例です。

  $network.setProxyForHttp('http://host.com:1234')

  コピー

  認証情報付きのHTTPプロトコルでプロキシサーバーを設定した例です。

  $network.setProxyForHttp('http://proxyUsername:proxyPassword@proxyHost:1234')

  コピー

すべてのHTTPSリクエストに使用するプロキシサーバーを設定します。

その他の注意事項：

• ポートはオプションです。省略された場合は、スキームから導き出されます。例えば、HTTPの場合、デフォルトのポートは443です。

• ユーザー名とパスワードは、 encodeURIComponent()への呼び出しの結果であると見なされます。ユーザー名やパスワードの@や:などの特殊文字はエスケープする必要があります。

  リターンズ

  このメソッドは、構成が適用されると解決されるPromiseを返します。

  パラメーター

  パラメータ	データタイプ	説明
  proxyURL | proxyUrlParsed	文字列またはオブジェクト	プロキシサーバーに接続するためのURL。 proxyURL （たとえば、 http://proxy_host:8888 ）を含む文字列、またはノードのurl.parse(urlString)メソッドで定義されたものと同じ形式のプレーンオブジェクト。

  例

  プロキシサーバーに、認証なしでポート1234にHTTPSプロトコルを設定した例です。

  $network.setProxyForHttps('https://host.com:1234')

  コピー

  認証情報を持つHTTPSプロトコルのプロキシサーバーを設定する例です。

  $network.setProxyForHttps('https://proxyUsername:proxyPassword@proxyHost:1234')

  コピー

PAC(Proxy Auto-Config)スクリプトによりプロキシサーバーを設定し、プロミスを返します。この機能は、 スクリプトによるブラウザモニター でのみ利用可能です。

var authCredentialsMap = {
  "example.com": { username: "authUsername", password: "authPassword" },
};

var authCredentialsMap = {
  "example.com": { username: "authUsername", password: "authPassword" },
  "anotherExample.com": { username: "authUsername", password: "authPassword" },
};

$network.setProxyPAC("https://www.example.com/pacScript", authCredentialsMap);

Chrome Extension APIforProxyingでサポートされている形式を使用してプロキシ構成を設定します。入力は、プロキシを構成するためにChrome拡張APIによって定義されたProxyRulesオブジェクトです。 authCredentialsを必要とするプロキシに追加できます。詳細については、パラメーターを参照してください。

var proxyRules = {
  singleProxy: {
    host: "example.com",
    authCredentials: {
      username: "authUsername",
      password: "authPassword",
    },
  },
};

var proxyRules = {
  singleProxy: { host: "entproxy.mycompany.com", port: 8888, scheme: "http" },
  bypassList: ["s3.amazonaws.com", "*.localcdn.com"],
};
$network.setProxyAdvanced(proxyRules);

現在のプロキシ設定をクリア/削除します。

このメソッドは、現在のプロキシ設定を返します。プロミスのコールバックで同期させる必要があります。

var assert = require("assert");

$network
  .setProxy("http://user:password@myproxyurl.com")
  .then(function () {
    console.log("Proxy configuration applied");

    // Note: $network.getProxy() is not synchronized with the webdriver Control Flow.
    // To make sure we get the proxy configuration after the call to setProxy() above
    // succeeds we need to use a promise callback
    var proxyData = $network.getProxy();
    console.log(proxyData);
  })
  .then(function () {
    // Again: getProxy() is not synchronized with the Webdriver Control Flow: we
    // need this promise callback otherwise clearProxy() might be called before the call
    // to getProxy() above returns
    return $network.clearProxy();
  })
  .then(function () {
    console.log("Proxy configuration cleared");

    // We need this promise callback for reasons explained above
    var proxyData = $network.getProxy();
    assert.equal(proxyData.rules, null);
  });