chrome.devtools.network
Description: |
Use the chrome.devtools.network API to retrieve the information about network requests displayed by the Developer Tools in the Network panel.
|
Availability: |
Since Chrome 35.
|
See DevTools APIs summary for general introduction to using Developer Tools APIs.
Overview
Network requests information is represented in the HTTP Archive format (HAR). The description of HAR is outside of scope of this document, please refer to HAR v1.2 Specification.
In terms of HAR, the
chrome.devtools.network.getHAR()
method returns
entire HAR log, while
chrome.devtools.network.onRequestFinished
event
provides HAR entry as an argument to the event callback.
Note that request content is not provided as part of HAR for efficieny
reasons. You may call request's getContent()
method to retrieve
content.
If the Developer Tools window is opened after the page is loaded,
some requests may be missing
in the array of entries returned by getHAR()
.
Reload the page to get all requests.
In general, the list of
requests returned by getHAR()
should match that displayed in
the Network panel.
Examples
The following code logs URLs of all images larger than 40KB as they are loaded:
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) + '"))'); } });
You can find more examples that use this API in Samples.
Summary
Types | |
---|---|
Request | |
Methods | |
getHAR −
chrome.devtools.network.getHAR(function callback)
| |
Events | |
onRequestFinished | |
onNavigated |
Types
Request
methods | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getContent
Request.getContent(function callback)
Returns content of the response body.
|
Methods
getHAR
chrome.devtools.network.getHAR(function callback)
Returns HAR log that contains all known network requests.
Parameters | |||||
---|---|---|---|---|---|
function | callback |
A function that receives the HAR log when the request completes. The callback parameter should be a function that looks like this: function(object harLog) {...};
|
Events
onRequestFinished
Fired when a network request is finished and all request data are available.
addListener
chrome.devtools.network.onRequestFinished.addListener(function callback)
onNavigated
Fired when the inspected window navigates to a new page.
addListener
chrome.devtools.network.onNavigated.addListener(function callback)
Parameters | |||||
---|---|---|---|---|---|
function | callback |
The callback parameter should be a function that looks like this: function(string url) {...};
|