chrome.devtools.network

Descrizione

Utilizza l'API chrome.devtools.network per recuperare le informazioni sulle richieste di rete visualizzate dagli Strumenti per sviluppatori nel riquadro Rete.

Le informazioni sulle richieste di rete sono rappresentate nel formato HTTP Archive (HAR). La descrizione di HAR non rientra nell'ambito di questo documento; consulta la specifica HAR v1.2.

Per quanto riguarda HAR, il metodo chrome.devtools.network.getHAR() restituisce l'intero log HAR, mentre L'evento chrome.devtools.network.onRequestFinished fornisce una voce HAR come argomento per l'evento o la richiamata.

Tieni presente che i contenuti della richiesta non vengono forniti nell'ambito di HAR per motivi di efficienza. Puoi chiamare il metodo getContent() della richiesta per recuperare contenuti.

Se la finestra Strumenti per sviluppatori viene aperta dopo il caricamento della pagina, alcune richieste potrebbero non essere presenti in l'array di voci restituite da getHAR(). Ricarica la pagina per ricevere tutte le richieste. In generale, l'elenco delle richieste restituite da getHAR() deve corrispondere a quello visualizzato nel riquadro Rete.

Consulta il riepilogo delle API di DevTools per un'introduzione generale all'utilizzo delle API degli strumenti per sviluppatori.

Manifest

Per utilizzare questa API, le seguenti chiavi devono essere dichiarate nel manifest.

"devtools_page"

Esempi

Il seguente codice registra gli URL di tutte le immagini più grandi di 40 kB quando vengono caricate:

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) + '"))');
    }
  }
);

Per provare questa API, installa gli esempi di API DevTools da chrome-extension-samples repository Git.

Tipi

Request

Rappresenta una richiesta di rete per una risorsa di documento (script, immagine e così via). Consulta la specifica HAR come riferimento.

Proprietà

  • getContent

    null

    Restituisce il contenuto del corpo della risposta.

    La funzione getContent ha questo aspetto: 

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

    • callback

      funzione

      Il parametro callback ha il seguente aspetto: 

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

      • contenuti

        stringa

        Contenuto del corpo della risposta (potenzialmente codificato).

      • codifica

        stringa

        Vuoto se i contenuti non sono codificati, altrimenti il nome codifica. Al momento è supportato solo il formato base64.

Metodi

getHAR()

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

Restituisce il log HAR che contiene tutte le richieste di rete note.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (harLog: object) => void

    • harLog

      oggetto

      Un registro HAR. Per informazioni dettagliate, consulta la specifica HAR.

Eventi

onNavigated

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

Attivato quando la finestra ispezionata apre una nuova pagina.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (url: string) => void

    • url

      stringa

onRequestFinished

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

Attivato quando una richiesta di rete viene terminata e tutti i dati della richiesta sono disponibili.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (request: Request) => void