inspector

# Network _Auto generated documentation for WebKit inspector Network domain allows tracking network activities of the page. It exposes information about http, file, data and other requests and responses, their headers, bodies, timing, etc. * Commands * [enable](#networkenablecallback) * [disable](#networkdisablecallback) * [setExtraHTTPHeaders](#networksetextrahttpheadersheaders-callback) * [getResponseBody](#networkgetresponsebodyrequestid-callback) * [canClearBrowserCache](#networkcanclearbrowsercachecallback) * [clearBrowserCache](#networkclearbrowsercachecallback) * [canClearBrowserCookies](#networkcanclearbrowsercookiescallback) * [clearBrowserCookies](#networkclearbrowsercookiescallback) * [setCacheDisabled](#networksetcachedisabledcachedisabled-callback) * [loadResource](#networkloadresourceframeid-url-callback) * Events * [requestWillBeSent](#event-requestwillbesent) * [requestServedFromCache](#event-requestservedfromcache) * [responseReceived](#event-responsereceived) * [dataReceived](#event-datareceived) * [loadingFinished](#event-loadingfinished) * [loadingFailed](#event-loadingfailed) * [requestServedFromMemoryCache](#event-requestservedfrommemorycache) * [webSocketWillSendHandshakeRequest](#event-websocketwillsendhandshakerequest) * [webSocketHandshakeResponseReceived](#event-websockethandshakeresponsereceived) * [webSocketCreated](#event-websocketcreated) * [webSocketClosed](#event-websocketclosed) * [webSocketFrameReceived](#event-websocketframereceived) * [webSocketFrameError](#event-websocketframeerror) * [webSocketFrameSent](#event-websocketframesent) * Types * [LoaderId](#class-loaderid) * [FrameId](#class-frameid) * [RequestId](#class-requestid) * [Timestamp](#class-timestamp) * [Headers](#class-headers) * [ResourceTiming](#class-resourcetiming) * [Request](#class-request) * [Response](#class-response) * [WebSocketRequest](#class-websocketrequest) * [WebSocketResponse](#class-websocketresponse) * [WebSocketFrame](#class-websocketframe) * [CachedResource](#class-cachedresource) * [Initiator](#class-initiator) ## Commands ### Network.enable(callback) Enables network tracking, network events will now be delivered to the client. ### Parameters _**callback ( function )**_ ### Results _**error ( error )**_ ### Network.disable(callback) Disables network tracking, prevents network events from being sent to the client. ### Parameters _**callback ( function )**_ ### Results _**error ( error )**_ ### Network.setExtraHTTPHeaders([Headers](#class-headers), callback) Specifies whether to always send extra HTTP headers with the requests from this page. ### Parameters _**headers ( [Headers](#class-headers) )**_ > Map with extra HTTP headers. _**callback ( function )**_ ### Results _**error ( error )**_ ### Network.getResponseBody([RequestId](#class-requestid), callback) Returns content served for the given request. ### Parameters _**requestId ( [RequestId](#class-requestid) )**_ > Identifier of the network request to get content for. _**callback ( function )**_ ### Results _**error ( error )**_ _**body ( string )**_ > Response body. _**base64Encoded ( boolean )**_ > True, if content was sent as base64. ### Network.canClearBrowserCache(callback) Tells whether clearing browser cache is supported. ### Parameters _**callback ( function )**_ ### Results _**error ( error )**_ _**result ( boolean )**_ > True if browser cache can be cleared. ### Network.clearBrowserCache(callback) Clears browser cache. ### Parameters _**callback ( function )**_ ### Results _**error ( error )**_ ### Network.canClearBrowserCookies(callback) Tells whether clearing browser cookies is supported. ### Parameters _**callback ( function )**_ ### Results _**error ( error )**_ _**result ( boolean )**_ > True if browser cookies can be cleared. ### Network.clearBrowserCookies(callback) Clears browser cookies. ### Parameters _**callback ( function )**_ ### Results _**error ( error )**_ ### Network.setCacheDisabled(cacheDisabled, callback) Toggles ignoring cache for each request. If `true`, cache will not be used. ### Parameters _**cacheDisabled ( boolean )**_ > Cache disabled state. _**callback ( function )**_ ### Results _**error ( error )**_ ### Network.loadResource([FrameId](#class-frameid), url, callback) Loads a resource in the context of a frame on the inspected page without cross origin checks. ### Parameters _**frameId ( [FrameId](#class-frameid) )**_ > Frame to load the resource from. _**url ( string )**_ > URL of the resource to load. _**callback ( function )**_ ### Results _**error ( error )**_ _**content ( string )**_ > Resource content. _**mimeType ( string )**_ > Resource mimeType. _**status ( number )**_ > HTTP response status code. ## Events ### Event: requestWillBeSent Fired when page is about to send HTTP request. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**frameId ( [FrameId](#class-frameid) )**_ > Frame identifier. _**loaderId ( [LoaderId](#class-loaderid) )**_ > Loader identifier. _**documentURL ( string )**_ > URL of the document this request is loaded for. _**request ( [Request](#class-request) )**_ > Request data. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**initiator ( [Initiator](#class-initiator) )**_ > Request initiator. _**redirectResponse ( optional [Response](#class-response) )**_ > Redirect response data. _**type ( optional [Page.ResourceType](Page.md#class-resourcetype) )**_ > Resource type. ### Event: requestServedFromCache Fired if request ended up loading from cache. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. ### Event: responseReceived Fired when HTTP response is available. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**frameId ( [FrameId](#class-frameid) )**_ > Frame identifier. _**loaderId ( [LoaderId](#class-loaderid) )**_ > Loader identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**type ( [Page.ResourceType](Page.md#class-resourcetype) )**_ > Resource type. _**response ( [Response](#class-response) )**_ > Response data. ### Event: dataReceived Fired when data chunk was received over the network. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**dataLength ( integer )**_ > Data chunk length. _**encodedDataLength ( integer )**_ > Actual bytes received (might be less than dataLength for compressed encodings). ### Event: loadingFinished Fired when HTTP request has finished loading. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**sourceMapURL ( optional string )**_ > URL of source map associated with this resource (if any). ### Event: loadingFailed Fired when HTTP request has failed to load. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**errorText ( string )**_ > User friendly error message. _**canceled ( optional boolean )**_ > True if loading was canceled. ### Event: requestServedFromMemoryCache Fired when HTTP request has been served from memory cache. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**frameId ( [FrameId](#class-frameid) )**_ > Frame identifier. _**loaderId ( [LoaderId](#class-loaderid) )**_ > Loader identifier. _**documentURL ( string )**_ > URL of the document this request is loaded for. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**initiator ( [Initiator](#class-initiator) )**_ > Request initiator. _**resource ( [CachedResource](#class-cachedresource) )**_ > Cached resource data. ### Event: webSocketWillSendHandshakeRequest Fired when WebSocket is about to initiate handshake. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**request ( [WebSocketRequest](#class-websocketrequest) )**_ > WebSocket request data. ### Event: webSocketHandshakeResponseReceived Fired when WebSocket handshake response becomes available. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**response ( [WebSocketResponse](#class-websocketresponse) )**_ > WebSocket response data. ### Event: webSocketCreated Fired upon WebSocket creation. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**url ( string )**_ > WebSocket request URL. ### Event: webSocketClosed Fired when WebSocket is closed. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. ### Event: webSocketFrameReceived Fired when WebSocket frame is received. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**response ( [WebSocketFrame](#class-websocketframe) )**_ > WebSocket response data. ### Event: webSocketFrameError Fired when WebSocket frame error occurs. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**errorMessage ( string )**_ > WebSocket frame error message. ### Event: webSocketFrameSent Fired when WebSocket frame is sent. ### Results _**requestId ( [RequestId](#class-requestid) )**_ > Request identifier. _**timestamp ( [Timestamp](#class-timestamp) )**_ > Timestamp. _**response ( [WebSocketFrame](#class-websocketframe) )**_ > WebSocket response data. ## Types ### Class: LoaderId _Type: string_ Unique loader identifier. ### Class: FrameId _Type: string_ Unique frame identifier. ### Class: RequestId _Type: string_ Unique request identifier. ### Class: Timestamp _Type: number_ Number of seconds since epoch. ### Class: Headers _Type: object_ Request / response headers as keys / values of JSON object. ### Class: ResourceTiming _Type: object_ Timing information for the request. ### Properties _**navigationStart ( number )**_ > Timing's navigationStart is a baseline in seconds, while the other numbers are ticks in milliseconds relatively to this navigationStart. _**domainLookupStart ( number )**_ > Started DNS address resolve. _**domainLookupEnd ( number )**_ > Finished DNS address resolve. _**connectStart ( number )**_ > Started connecting to the remote host. _**connectEnd ( number )**_ > Connected to the remote host. _**secureConnectionStart ( number )**_ > Started SSL handshake. _**requestStart ( number )**_ > Started sending request. _**responseStart ( number )**_ > Started receiving response headers. ### Class: Request _Type: object_ HTTP request data. ### Properties _**url ( string )**_ > Request URL. _**method ( string )**_ > HTTP request method. _**headers ( [Headers](#class-headers) )**_ > HTTP request headers. _**postData ( optional string )**_ > HTTP POST request data. ### Class: Response _Type: object_ HTTP response data. ### Properties _**url ( string )**_ > Response URL. This URL can be different from CachedResource.url in case of redirect. _**status ( number )**_ > HTTP response status code. _**statusText ( string )**_ > HTTP response status text. _**headers ( [Headers](#class-headers) )**_ > HTTP response headers. _**headersText ( optional string )**_ > HTTP response headers text. _**mimeType ( string )**_ > Resource mimeType as determined by the browser. _**requestHeaders ( optional [Headers](#class-headers) )**_ > Refined HTTP request headers that were actually transmitted over the network. _**requestHeadersText ( optional string )**_ > HTTP request headers text. _**fromDiskCache ( optional boolean )**_ > Specifies that the request was served from the disk cache. _**timing ( optional [ResourceTiming](#class-resourcetiming) )**_ > Timing information for the given request. ### Class: WebSocketRequest _Type: object_ WebSocket request data. ### Properties _**headers ( [Headers](#class-headers) )**_ > HTTP response headers. ### Class: WebSocketResponse _Type: object_ WebSocket response data. ### Properties _**status ( number )**_ > HTTP response status code. _**statusText ( string )**_ > HTTP response status text. _**headers ( [Headers](#class-headers) )**_ > HTTP response headers. ### Class: WebSocketFrame _Type: object_ WebSocket frame data. ### Properties _**opcode ( number )**_ > WebSocket frame opcode. _**mask ( boolean )**_ > WebSocket frame mask. _**payloadData ( string )**_ > WebSocket frame payload data. ### Class: CachedResource _Type: object_ Information about the cached resource. ### Properties _**url ( string )**_ > Resource URL. This is the url of the original network request. _**type ( [Page.ResourceType](Page.md#class-resourcetype) )**_ > Type of this resource. _**response ( optional [Response](#class-response) )**_ > Cached response data. _**bodySize ( number )**_ > Cached response body size. _**sourceMapURL ( optional string )**_ > URL of source map associated with this resource (if any). ### Class: Initiator _Type: object_ Information about the request initiator. ### Properties _**type ( string enumerated ["parser","script","other"] )**_ > Type of this initiator. _**stackTrace ( optional [Console.StackTrace](Console.md#class-stacktrace) )**_ > Initiator JavaScript stack trace, set for Script only. _**url ( optional string )**_ > Initiator URL, set for Parser type only. _**lineNumber ( optional number )**_ > Initiator line number, set for Parser type only.