chrome.proxy

Descripción

Permisos

Manifiesto

Debes declarar el "proxy" permiso en el manifiesto de extensión para usar la configuración de proxy en la API de Cloud. Por ejemplo:

{
  "name": "My extension",
  ...
  "permissions": [
    "proxy"
  ],
  ...
}

Objetos y propiedades

Los parámetros de configuración de proxy se definen en un objeto proxy.ProxyConfig. Según la configuración de proxy de Chrome, la configuración puede contener proxy.ProxyRules o proxy.PacScript.

Modos de proxy

El atributo mode de un objeto ProxyConfig determina el comportamiento general de Chrome con respecto a lo siguiente: el uso de proxy. Puede tener los siguientes valores:

direct

En el modo direct, todas las conexiones se crean directamente, sin ningún proxy involucrado. Este modo permite No hay más parámetros en el objeto ProxyConfig.

auto_detect

En el modo auto_detect, la configuración del proxy se determina mediante una secuencia de comandos de PAC que se puede descargar. en http://wpad/wpad.dat. Este modo no permite más parámetros en el objeto ProxyConfig.

pac_script

En el modo pac_script, la configuración del proxy se determina mediante una secuencia de comandos de PAC que se recupera. de la URL especificada en el objeto proxy.PacScript o tomada literalmente del elemento data especificadas en el objeto proxy.PacScript. Además de esto, este modo no permite otros parámetros en el objeto ProxyConfig.

fixed_servers

En el modo fixed_servers, la configuración del proxy se codifica en un objeto proxy.ProxyRules. Es se describe en Reglas del proxy. Además de esto, el modo fixed_servers no permite parámetros del objeto ProxyConfig.

system

En el modo system, la configuración del proxy se toma del sistema operativo. Este modo no permite parámetros adicionales en el objeto ProxyConfig Ten en cuenta que el modo system es diferente del no establece ninguna configuración de proxy. En este último caso, Chrome recurre a la configuración del sistema solo si Ninguna opción de la línea de comandos influye en la configuración del proxy.

Reglas de proxy

El objeto proxy.ProxyRules puede contener un atributo singleProxy o un subconjunto de proxyForHttp, proxyForHttps, proxyForFtp y fallbackProxy.

En el primer caso, el tráfico HTTP, HTTPS y FTP se dirige a través del servidor proxy especificado. Otra opción el tráfico se envía directamente. En este último caso, el comportamiento es un poco más sutil: si un servidor proxy para el protocolo HTTP, HTTPS o FTP, el tráfico respectivo se envía a través del proxy servidor especificado. Si no se especifica tal servidor proxy o si el tráfico usa un protocolo diferente al HTTP, HTTPS o FTP, se usa el fallbackProxy. Si no se especifica un fallbackProxy, se envía el tráfico directamente sin un servidor proxy.

Objetos del servidor proxy

Se configura un servidor proxy en un objeto proxy.ProxyServer. La conexión con el servidor proxy (definida por el atributo host) usa el protocolo definido en el atributo scheme. Si la respuesta es no Si se especifica scheme, la conexión con el proxy se establece de forma predeterminada en http.

Si no se define un port en un objeto proxy.ProxyServer, el puerto se deriva del esquema. Los puertos predeterminados son los siguientes:

Lista de excepciones

Los servidores individuales pueden excluirse del proxy con el bypassList. Esta lista puede contener las siguientes entradas:

[SCHEME://]HOST_PATTERN[:PORT]

Haz coincidir todos los nombres de host que coincidan con el patrón HOST_PATTERN. Un "." inicial se interpreta como un "*."

Ejemplos: "foobar.com", "*foobar.com", "*.foobar.com", "*foobar.com:99", "https://x.*.y.com:99".

Patrón	Mostrar coincidencias	No coincide
".foobar.com"	"www.foobar.com"	"foobar.com"
"*.foobar.com"	"www.foobar.com"	"foobar.com"
"foobar.com"	"foobar.com"	"www.foobar.com"
"*foobar.com"	"foobar.com", "www.foobar.com", "foofoobar.com"

[SCHEME://]IP_LITERAL[:PORT]

Hacer coincidir las URLs que son literales de dirección IP Conceptualmente, esto es similar al primer caso, pero con casos especiales para manejar la canonicalización literal de IP. Por ejemplo, si se busca coincidencia con “[0:0:0::1]”. es lo mismo que la coincidencia con "[::1]" porque la canonicalización de IPv6 se hace internamente.

Ejemplos: 127.0.1, [0:0::1], [::1]:80, https://[::1]:443

IP_LITERAL/PREFIX_LENGTH_IN_BITS

Hacer coincidir cualquier URL que contenga un literal de IP (IP_LITERAL) dentro del valor especificado del rango de destino de la ruta. El rango de IP (PREFIX_LENGTH_IN_BITS) se especifica mediante CIDR Notación de imagen.

Haz coincidir cualquier URL que contenga un literal de IP dentro del rango especificado. El rango de IP se especifica mediante CIDR la notación global. Ejemplos: "192.168.1.1/16", "fefe:13::abc/33"

<local>

La string literal <local> coincide con nombres de host simples. Un nombre de host simple es aquel que no contiene puntos y no es un literal de IP. Por ejemplo, example y localhost son nombres de host simples, mientras que example.com, example. y [::1] no lo son.

Ejemplo: "<local>"

Ejemplos

El siguiente código configura un proxy SOCKS 5 para las conexiones HTTP a todos los servidores excepto a foobar.com y utiliza conexiones directas para todos los demás protocolos. La configuración se aplica a las ventanas regulares y de incógnito, las ventanas de incógnito heredan la configuración de las ventanas normales. Consulta también la API de Types en la documentación de Google Cloud.

var config = {
  mode: "fixed_servers",
  rules: {
    proxyForHttp: {
      scheme: "socks5",
      host: "1.2.3.4"
    },
    bypassList: ["foobar.com"]
  }
};
chrome.proxy.settings.set(
  {value: config, scope: 'regular'},
  function() {}
);

El siguiente código configura una secuencia de comandos de PAC personalizada.

var config = {
  mode: "pac_script",
  pacScript: {
    data: "function FindProxyForURL(url, host) {\n" +
          "  if (host == 'foobar.com')\n" +
          "    return 'PROXY blackhole:80';\n" +
          "  return 'DIRECT';\n" +
          "}"
  }
};
chrome.proxy.settings.set(
  {value: config, scope: 'regular'},
  function() {}
);

El siguiente fragmento consulta la configuración de proxy vigente en este momento. La configuración efectiva del proxy puede ser determinados por otra extensión o por una política. Consulta la documentación de la API de Types para obtener más información.

chrome.proxy.settings.get(
  {'incognito': false},
  function(config) {
    console.log(JSON.stringify(config));
  }
);

Ten en cuenta que el objeto value que se pasa a set() no es idéntico al objeto value que se pasa a función de devolución de llamada de get(). Este último contendrá un elemento rules.proxyForHttp.port.

chrome.proxy.onProxyError.addListener(
  callback: function,
)