Beschrijving
Gebruik de chrome.devtools.network
API om de informatie op te halen over netwerkverzoeken die worden weergegeven door de ontwikkelaarstools in het netwerkpaneel.
Manifest
De volgende sleutels moeten in het manifest worden gedeclareerd om deze API te kunnen gebruiken.
"devtools_page"
Zie het overzicht van DevTools API's voor een algemene inleiding tot het gebruik van Developer Tools API's.
Overzicht
Informatie over netwerkverzoeken wordt weergegeven in het HTTP Archive-formaat ( HAR ). De beschrijving van HAR valt buiten het bestek van dit document. Raadpleeg de HAR v1.2-specificatie .
In termen van HAR retourneert de methode chrome.devtools.network.getHAR()
het volledige HAR log , terwijl de gebeurtenis chrome.devtools.network.onRequestFinished
HAR-invoer levert als argument voor de gebeurteniscallback.
Houd er rekening mee dat de inhoud van verzoeken om efficiëntieredenen niet wordt verstrekt als onderdeel van HAR. U kunt getContent()
methode van het verzoek aanroepen om inhoud op te halen.
Als het venster Developer Tools wordt geopend nadat de pagina is geladen, ontbreken mogelijk enkele verzoeken in de reeks items die worden geretourneerd door getHAR()
. Laad de pagina opnieuw om alle verzoeken te ontvangen. Over het algemeen zou de lijst met verzoeken die door getHAR()
worden geretourneerd, moeten overeenkomen met de lijst die wordt weergegeven in het paneel Netwerk.
Voorbeelden
De volgende code registreert URL's van alle afbeeldingen die groter zijn dan 40 KB terwijl ze worden geladen:
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) + '"))');
}
}
);
Als u deze API wilt uitproberen, installeert u de devtools API-voorbeelden uit de chrome-extension-samples- repository.
Soorten
Request
Vertegenwoordigt een netwerkverzoek voor een documentbron (script, afbeelding enzovoort). Zie HAR-specificatie voor referentie.
Eigenschappen
- krijg inhoud
leegte
Retourneert de inhoud van de antwoordtekst.
De
getContent
functie ziet er als volgt uit:(callback: function) => {...}
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(content: string, encoding: string) => void
- inhoud
snaar
Inhoud van de antwoordtekst (mogelijk gecodeerd).
- codering
snaar
Leeg als de inhoud niet is gecodeerd, anders codeert de naam. Momenteel wordt alleen base64 ondersteund.
Methoden
getHAR()
chrome.devtools.network.getHAR(
callback: function,
)
Retourneert een HAR-logboek dat alle bekende netwerkverzoeken bevat.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(harLog: object) => void
- harLog
voorwerp
Een HAR-logboek. Zie HAR-specificatie voor details.
Evenementen
onNavigated
chrome.devtools.network.onNavigated.addListener(
callback: function,
)
Wordt geactiveerd wanneer het geïnspecteerde venster naar een nieuwe pagina navigeert.
Parameters
functie
De
callback
parameter ziet er als volgt uit:(url: string) => void
snaar
onRequestFinished
chrome.devtools.network.onRequestFinished.addListener(
callback: function,
)
Wordt geactiveerd wanneer een netwerkverzoek is voltooid en alle verzoekgegevens beschikbaar zijn.