chrome.devtools.network

refresh date: 2026-09-25 robots: noindex

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.

Manifest

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

"devtools_page"

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

Overzicht

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 chrome.devtools.network.getHAR() het hele HAR-logboek, terwijl de gebeurtenis chrome.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.

Voorbeelden

De volgende code registreert URL's van alle afbeeldingen die groter zijn dan 40 KB wanneer 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 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

    Promise

    Retourneert de content van de hoofdtekst van de reactie.

    De functie getContent ziet er zo uit: 

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

    • callback

      functie optioneel

      De parameter callback ziet er zo uit: 

      (response: object) => void

      • reactie

        object

        Chrome 151+

        Een object met de hoofdtekst van de reactie en de codering ervan.

        • content

          tekenreeks

          Content van de reactietekst (mogelijk gecodeerd).

        • codering

          tekenreeks

          Leeg als de content niet is gecodeerd, anders de naam van de codering. Op dit moment wordt alleen base64 ondersteund.

    • returns

      Promise<object>

      Chrome 151+

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

      Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Methoden

getHAR()

Promise 
chrome.devtools.network.getHAR(
  callback?: function,
): Promise<object>

Retourneert een HAR-logboek met alle bekende netwerkverzoeken.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (harLog: object) => void

    • harLog

      object

      Een HAR-logboek. Ga naar de HAR-specificatie voor meer informatie.

Retourzendingen

  • Promise<object>

    Chrome 151+

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

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onNavigated

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

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