chrome.devtools.network

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

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit:

    (url: string) => void

    • URL

      snaar

onRequestFinished

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

Wordt geactiveerd wanneer een netwerkverzoek is voltooid en alle verzoekgegevens beschikbaar zijn.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit:

    (request: Request) => void