chrome.devtools.network

Descripción

Usa la API de chrome.devtools.network para recuperar la información sobre las solicitudes de red que muestran las Herramientas para desarrolladores en el panel Red.

La información de solicitudes de red se representa en el formato de archivo HTTP (HAR). Descripción de El HAR está fuera del alcance de este documento. Consulta la Especificación de HAR v1.2.

En términos de HAR, el método chrome.devtools.network.getHAR() muestra un registro HAR completo, mientras que El evento chrome.devtools.network.onRequestFinished proporciona una entrada HAR como argumento del evento. devolución de llamada.

Ten en cuenta que el contenido de la solicitud no se proporciona como parte del HAR por motivos de eficiencia. Puedes llamar método getContent() de la solicitud para recuperar contenido.

Si se abre la ventana Herramientas para desarrolladores después de cargar la página, es posible que falten algunas solicitudes en el array de entradas que muestra getHAR() Vuelve a cargar la página para obtener todas las solicitudes. En general, el La lista de solicitudes que muestra getHAR() debe coincidir con la que aparece en el panel Red.

Consulta el resumen de las APIs de Herramientas para desarrolladores para ver una introducción general al uso de las APIs de las Herramientas para desarrolladores.

Manifiesto

Para usar esta API, se deben declarar las siguientes claves en el manifiesto.

"devtools_page"

Ejemplos

El siguiente código registra las URLs de todas las imágenes de más de 40 KB mientras se cargan:

chrome.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      chrome.devtools.inspectedWindow.eval(
          'console.log("Large image: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

Para probar esta API, instala los ejemplos de la API de Herramientas para desarrolladores de chrome-extension-samples en un repositorio de confianza.

Tipos

Request

Representa una solicitud de red para un recurso de documento (secuencia de comandos, imagen, etcétera). Consulta la especificación HAR como referencia.

Propiedades

  • getContent

    void

    Muestra el contenido del cuerpo de la respuesta.

    La función getContent se ve de la siguiente manera:

    (callback: function) => {...}

    • callback

      función

      El parámetro callback se ve de la siguiente manera:

      (content: string, encoding: string) => void

      • contenido

        string

        Contenido del cuerpo de la respuesta (potencialmente codificado).

      • encoding

        string

        Este campo está vacío si el contenido no está codificado; de lo contrario, se codifica el nombre. Actualmente, solo se admite Base64.

Métodos

getHAR()

chrome.devtools.network.getHAR(
  callback: function,
)

Muestra el registro HAR que contiene todas las solicitudes de red conocidas.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

    (harLog: object) => void

    • harLog

      objeto

      Un registro HAR. Consulta la especificación de HAR para obtener más información.

Eventos

onNavigated

chrome.devtools.network.onNavigated.addListener(
  callback: function,
)

Se activa cuando la ventana inspeccionada navega a una página nueva.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

    (url: string) => void

    • url

      string

onRequestFinished

chrome.devtools.network.onRequestFinished.addListener(
  callback: function,
)

Se activa cuando finaliza una solicitud de red y todos los datos de la solicitud están disponibles.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera:

    (request: Request) => void