browser.devtools.network

Beschrijving

Gebruik de chrome.devtools.network API om de informatie over netwerkverzoeken op te halen die door de tools voor ontwikkelaars wordt getoond in het deelvenster Netwerk.

Informatie over netwerkverzoeken wordt weergegeven in de HTTP-archiefindeling (HAR). De beschrijving van HAR valt buiten het bereik van dit document. Ga naar de HAR v1.2-specificatie.

In termen van HAR retourneert de methode browser.devtools.network.getHAR() het hele HAR-logboek, terwijl de gebeurtenis browser.devtools.network.onRequestFinished de HAR-vermelding als argument levert voor de callback van de gebeurtenis.

De content van het verzoek wordt om efficiëntieredenen niet verstrekt als onderdeel van HAR. Je kunt de methode getContent() van het verzoek aanroepen om content op te halen.

Als het venster Tools voor ontwikkelaars wordt geopend nadat de pagina is geladen, ontbreken er misschien bepaalde verzoeken in de matrix met vermeldingen die worden geretourneerd door getHAR(). Laad de pagina opnieuw om alle verzoeken te krijgen. Over het algemeen moet de lijst met verzoeken die door getHAR() worden geretourneerd, overeenkomen met de lijst die wordt getoond in het deelvenster Netwerk.

Ga naar Overzicht van DevTools API's voor een algemene inleiding over het gebruik van API's voor ontwikkelaarstools.

Manifest

De volgende sleutels moeten in het manifest worden gedefinieerd om deze API te gebruiken.

"devtools_page"

Voorbeelden

De volgende code registreert URL's van alle afbeeldingen die groter zijn dan 40 KB wanneer ze worden geladen:

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

Als je deze API wilt proberen, installeer je de API-voorbeelden voor devtools uit de repository chrome-extension-samples.

Typen

Request

Vertegenwoordigt een netwerkverzoek voor een documentbron (script, afbeelding, enzovoort). Zie de HAR-specificatie voor referentie.

Eigenschappen

  • getContent

    ongeldig

    Retourneert de content van de hoofdtekst van de reactie.

    De functie getContent ziet er zo uit: 

    () => {...}

    • returns

      Promise<object>

      Chrome 151+ browser.* sinds Chrome 152

      Een functie die de hoofdtekst van de reactie krijgt als het verzoek is afgerond.

Methoden

getHAR()

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

Retourneert een HAR-logboek met alle bekende netwerkverzoeken.

Retourzendingen

  • Promise<object>

    Chrome 151+ browser.* sinds Chrome 152

    Een functie die het HAR-logboek krijgt als het verzoek is afgerond.

Evenementen

onNavigated

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

Wordt geactiveerd als het geïnspecteerde venster naar een nieuwe pagina navigeert.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (url: string) => void

    • url

      tekenreeks

onRequestFinished

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

Wordt geactiveerd als een netwerkverzoek is afgerond en alle verzoekgegevens beschikbaar zijn.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (request: Request) => void