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
-
funzione
Il parametro
callback
ha il seguente aspetto:(url: string) => void
-
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.