Définir les paramètres et propriétés du proxy pour le moniteur scripté

Définit un serveur proxy à utiliser pour toutes requests par URL (HTTP, HTTPS et FTP).

Notes supplémentaires :

• Le port est facultatif. S'il n'est pas fourni, il sera dérivé du schéma. Par exemple, pour HTTP, le port serait 80.

• Le nom d'utilisateur et le mot de passe sont supposés être le résultat d'un appel à encodeURIComponent(). Les caractères spéciaux tels que @ et : dans le nom d'utilisateur et/ou le mot de passe doivent être échappés.

  Retours

  Cette méthode renvoie un Promise qui sera résolu une fois la configuration appliquée.

  Paramètres

  paramètres	Type de données	Description
  proxyURL | proxyUrlParsed	Chaîne ou objet	L'URL pour se connecter au serveur proxy. Une chaîne contenant un proxyURL (par exemple, http://proxy_host:8888) ou un objet simple au même format que celui défini par la méthode url.parse(urlString) de Node.

  Exemples

  Un exemple de configuration d'un serveur proxy avec le protocole HTTP sur le port 1234 sans authentification :

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

  Copier

  Un exemple de configuration d'un serveur proxy avec le protocole HTTP avec des informations d'authentification.

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

  Copier

Définit un serveur proxy à utiliser pour toutes requests HTTP.

Notes supplémentaires :

• Le port est facultatif. S'il n'est pas fourni, il sera dérivé du schéma. Par exemple, pour HTTP, le port serait 80.

• Le nom d'utilisateur et le mot de passe sont supposés être le résultat d'un appel à encodeURIComponent(). Les caractères spéciaux tels que @ et : dans le nom d'utilisateur et/ou le mot de passe doivent être échappés.

  Retours

  Cette méthode renvoie un Promise qui sera résolu une fois la configuration appliquée.

  Paramètres

  paramètres	Type de données	Description
  proxyURL | proxyUrlParsed	Chaîne ou objet	L'URL pour se connecter au serveur proxy. Une chaîne contenant un proxyURL (par exemple, http://proxy_host:8888) ou un objet simple au même format que celui défini par la méthode url.parse(urlString) de Node.

  Exemples

  Un exemple de configuration d'un serveur proxy avec le protocole HTTP sur le port 1234 sans authentification :

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

  Copier

  Un exemple de configuration d'un serveur proxy avec le protocole HTTP avec des informations d'authentification.

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

  Copier

Définit un serveur proxy à utiliser pour toutes requests HTTPS.

Notes supplémentaires :

• Le port est facultatif. S'il n'est pas fourni, il sera dérivé du schéma. Par exemple, pour HTTP, le port par défaut serait 443.

• Le nom d'utilisateur et le mot de passe sont supposés être le résultat d'un appel à encodeURIComponent(). Les caractères spéciaux tels que @ et : dans le nom d'utilisateur et/ou le mot de passe doivent être échappés.

  Retours

  Cette méthode renvoie un Promise qui sera résolu une fois la configuration appliquée.

  Paramètres

  paramètres	Type de données	Description
  proxyURL | proxyUrlParsed	Chaîne ou objet	L'URL pour se connecter au serveur proxy. Une chaîne contenant un proxyURL (par exemple, http://proxy_host:8888) ou un objet simple au même format que celui défini par la méthode url.parse(urlString) de Node.

  Exemples

  Un exemple de configuration d'un serveur proxy avec le protocole HTTPS sur le port 1234 sans authentification :

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

  Copier

  Un exemple de configuration d'un serveur proxy avec le protocole HTTPS avec des informations d'identification d'authentification.

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

  Copier

Définit un serveur proxy via un script de configuration automatique de proxy (PAC) et renvoie une promesse. Cette fonction est uniquement disponible pour moniteur de navigateur scripté.

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);

Définit la configuration du proxy à l'aide du format pris en charge par l'API d'extension Chrome pour le proxy. L'entrée est un objet ProxyRules, tel que défini par l'API d'extension Chrome pour configurer les proxys. Vous pouvez ajouter authCredentials pour les proxys qui en ont besoin. Voir Paramètres pour plus de détails.

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);

Efface/supprime la configuration proxy actuelle.

Cette méthode renvoie la configuration proxy actuelle. Il doit être synchronisé dans un rappel de promesse.

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);
  });