Se usó la API de Cloud Translation para traducir esta página.

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 las solicitudes de red se representa en el formato de archivo HTTP (HAR). La descripción de 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 para la devolución de llamada del evento.

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

Si se abre la ventana de 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, la lista de solicitudes que muestra getHAR() debe coincidir con la que se muestra en el panel Network.

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

Manifest

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

"devtools_page"

Ejemplos

El siguiente código registra las URL de todas las imágenes con un tamaño superior a 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 del repositorio chrome-extension-samples.

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
  
  la función
  
  El parámetro callback se ve de la siguiente manera:
```
(content: string,encoding: string)=>void
```
  - contenido
    
    cadena
    
    Contenido del cuerpo de la respuesta (posiblemente codificado).
  - encoding
    
    cadena
    
    Estará vacío si el contenido no está codificado. De lo contrario, se mostrará el nombre de la codificación. 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

la función

El parámetro callback se ve de la siguiente manera:
```
(harLog: object)=>void
```
- harLog
  
  objeto
  
  Un registro HAR. Consulta la especificación HAR para obtener más detalles.

Eventos

onNavigated

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

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

Parámetros

callback

la función

El parámetro callback se ve de la siguiente manera:
```
(url: string)=>void
```
- url
  
  cadena

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

la función

El parámetro callback se ve de la siguiente manera:
```
(request: Request)=>void
```
- request
  
  Solicitud