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; fai riferimento alla Specifica HAR v1.2.

In termini di 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 il callback dell'evento.

Tieni presente che i contenuti della richiesta non sono forniti come parte di 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 mancare nell'array di voci restituite da getHAR(). Ricarica la pagina per ricevere tutte le richieste. In generale, l'elenco delle richieste restituite da getHAR() dovrebbe corrispondere a quello visualizzato nel riquadro Rete.

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

Manifest

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

"devtools_page"

Esempi

Il seguente codice registra gli URL di tutte le immagini superiori a 40 kB non appena 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 dal repository chrome-extension-samples.

Tipi

Request

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

Proprietà

  • getContent

    void

    Restituisce i contenuti del corpo della risposta.

    La funzione getContent ha il seguente aspetto: 

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

    • callback

      funzione

      Il parametro callback ha il seguente aspetto: 

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

      • nuovi, di alta qualità, pertinenti e variegati

        stringa

        Contenuto del corpo della risposta (potenzialmente codificato).

      • codifica

        stringa

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

Metodi

getHAR()

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

Restituisce un 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 le specifiche HAR.

Eventi

onNavigated

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

Viene 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

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

Viene attivato quando una richiesta di rete viene completata e tutti i dati della richiesta sono disponibili.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (request: Request)=>void