browser.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.

In termini di HAR, il metodo browser.devtools.network.getHAR() restituisce l'intero log HAR, mentre l'evento browser.devtools.network.onRequestFinished fornisce la voce HAR come argomento per il callback dell'evento.

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

Se la finestra Strumenti per sviluppatori viene aperta dopo il caricamento della pagina, alcune richieste potrebbero non essere presenti nell'array di voci restituite da getHAR(). Ricarica la pagina per visualizzare 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 DevTools per un'introduzione generale all'utilizzo delle API Strumenti per sviluppatori.

Manifest

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

"devtools_page"

Esempi

Il seguente codice registra gli URL di tutte le immagini di dimensioni superiori a 40 kB durante il caricamento:

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

Per provare questa API, installa gli esempi di API devtools dal repository chrome-extension-samples.

Tipi

Request

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

Proprietà

  • getContent

    void

    Restituisce i contenuti del corpo della risposta.

    La funzione getContent ha il seguente aspetto: 

    () => {...}

    • returns

      Promise<object>

      Chrome 151 e versioni successive browser.* da Chrome 152

      Una funzione che riceve il corpo della risposta al completamento della richiesta.

Metodi

getHAR()

browser.devtools.network.getHAR(): Promise<object>

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

Resi

  • Promise<object>

    Chrome 151 e versioni successive browser.* da Chrome 152

    Una funzione che riceve il log HAR al completamento della richiesta.

Eventi

onNavigated

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

Attivato quando la finestra ispezionata passa a una nuova pagina.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (url: string) => void

    • url

      stringa

onRequestFinished

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

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

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (request: Request) => void