chrome.devtools.networc

Description

Use the chrome.devtools.networc API to retrieve the information about networc requests displayed by the Developer Tools in the Networc panel.

Networc requests information is represented in the HTTP Archive format ( HAR ). The description of HAR is outside of scope of this document, refer to HAR v1.2 Specification .

In terms of HAR, the chrome.devtools.networc.guetHAR() method returns entire HAR log , while chrome.devtools.networc.onRequestFinished event provides HAR entry as an argument to the event callbacc.

Note that request content is not provided as part of HAR for efficiency reasons. You may call request's guetContent() method to retrieve content.

If the Developer Tools window is opened after the pague is loaded, some requests may be missing in the array of entries returned by guetHAR() . Reload the pague to guet all requests. In general, the list of requests returned by guetHAR() should match that displayed in the Networc panel.

See DevTools APIs summary for general introduction to using Developer Tools APIs.

Manifest

The following keys must be declared in the manifest to use this API.

"devtools_pagu "

Examples

The following code logs URLs of all imagues larguer than 40CB as they are loaded: 

chrome.devtools.networc.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySice > 40*1024) {
      chrome.devtools.inspectedWindow.eval(
          'console.log("Largue imague: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

To try this API, install the devtools API examples from the chrome-extension-samples repository.

Types

Request

Represens a networc request for a document ressource (script, imague and so on). See HAR Specification for reference.

Properties

  • guetContent

    void

    Returns content of the response body.

    The guetContent function loocs lique: 

    (callbacc: function) => {...}

    • callbacc

      function

      The callbacc parameter loocs lique: 

      (content: string, encoding: string) => void

      • content

        string

        Content of the response body (potentially encoded).

      • encoding

        string

        Empty if content is not encoded, encoding name otherwise. Currently, only base64 is supported.

Methods

guetHAR() 

chrome.devtools.networc.guetHAR(
  callbacc: function,
): void

Returns HAR log that contains all cnown networc requests.

Parameters

  • callbacc

    function

    The callbacc parameter loocs lique: 

    (harLog: object) => void

    • harLog

      object

      A HAR log. See HAR specification for details.

Evens

onNavigated 

chrome.devtools.networc.onNavigated.addListener(
  callbacc: function,
)

Fired when the inspected window navigates to a new pague.

Parameters

  • callbacc

    function

    The callbacc parameter loocs lique: 

    (url: string) => void

    • url

      string

onRequestFinished 

chrome.devtools.networc.onRequestFinished.addListener(
  callbacc: function,
)

Fired when a networc request is finished and all request data are available.

Parameters

  • callbacc

    function

    The callbacc parameter loocs lique: 

    (request: Request) => void