com.qeagle.devtools.protocol.commands

Interface Network

public interface Network

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.

Method Summary

Modifier and Type	Method and Description
Boolean	canClearBrowserCache() Deprecated.
Boolean	canClearBrowserCookies() Deprecated.
Boolean	canEmulateNetworkConditions() Deprecated.
void	clearBrowserCache() Clears browser cache.
void	clearBrowserCookies() Clears browser cookies.
void	continueInterceptedRequest(String interceptionId) Deprecated.
void	continueInterceptedRequest(String interceptionId, ErrorReason errorReason, String rawResponse, String url, String method, String postData, Map<String,Object> headers, AuthChallengeResponse authChallengeResponse) Deprecated.
void	deleteCookies(String name) Deletes browser cookies with matching name and url or domain/path pair.
void	deleteCookies(String name, String url, String domain, String path) Deletes browser cookies with matching name and url or domain/path pair.
void	disable() Disables network tracking, prevents network events from being sent to the client.
void	emulateNetworkConditions(Boolean offline, Double latency, Double downloadThroughput, Double uploadThroughput) Activates emulation of network conditions.
void	emulateNetworkConditions(Boolean offline, Double latency, Double downloadThroughput, Double uploadThroughput, ConnectionType connectionType) Activates emulation of network conditions.
void	enable() Enables network tracking, network events will now be delivered to the client.
void	enable(Integer maxTotalBufferSize, Integer maxResourceBufferSize, Integer maxPostDataSize) Enables network tracking, network events will now be delivered to the client.
List<Cookie>	getAllCookies() Returns all browser cookies.
List<String>	getCertificate(String origin) Returns the DER-encoded certificate.
List<Cookie>	getCookies() Returns all browser cookies for the current URL.
List<Cookie>	getCookies(List<String> urls) Returns all browser cookies for the current URL.
String	getRequestPostData(String requestId) Returns post data sent with the request.
ResponseBody	getResponseBody(String requestId) Returns content served for the given request.
ResponseBodyForInterception	getResponseBodyForInterception(String interceptionId) Returns content served for the given currently intercepted request.
EventListener	onDataReceived(EventHandler<DataReceived> eventListener) Fired when data chunk was received over the network.
EventListener	onEventSourceMessageReceived(EventHandler<EventSourceMessageReceived> eventListener) Fired when EventSource message is received.
EventListener	onLoadingFailed(EventHandler<LoadingFailed> eventListener) Fired when HTTP request has failed to load.
EventListener	onLoadingFinished(EventHandler<LoadingFinished> eventListener) Fired when HTTP request has finished loading.
EventListener	onRequestIntercepted(EventHandler<RequestIntercepted> eventListener) Deprecated.
EventListener	onRequestServedFromCache(EventHandler<RequestServedFromCache> eventListener) Fired if request ended up loading from cache.
EventListener	onRequestWillBeSent(EventHandler<RequestWillBeSent> eventListener) Fired when page is about to send HTTP request.
EventListener	onRequestWillBeSentExtraInfo(EventHandler<RequestWillBeSentExtraInfo> eventListener) Fired when additional information about a requestWillBeSent event is available from the network stack.
EventListener	onResourceChangedPriority(EventHandler<ResourceChangedPriority> eventListener) Fired when resource loading priority is changed
EventListener	onResponseReceived(EventHandler<ResponseReceived> eventListener) Fired when HTTP response is available.
EventListener	onResponseReceivedExtraInfo(EventHandler<ResponseReceivedExtraInfo> eventListener) Fired when additional information about a responseReceived event is available from the network stack.
EventListener	onSignedExchangeReceived(EventHandler<SignedExchangeReceived> eventListener) Fired when a signed exchange was received over the network
EventListener	onWebSocketClosed(EventHandler<WebSocketClosed> eventListener) Fired when WebSocket is closed.
EventListener	onWebSocketCreated(EventHandler<WebSocketCreated> eventListener) Fired upon WebSocket creation.
EventListener	onWebSocketFrameError(EventHandler<WebSocketFrameError> eventListener) Fired when WebSocket message error occurs.
EventListener	onWebSocketFrameReceived(EventHandler<WebSocketFrameReceived> eventListener) Fired when WebSocket message is received.
EventListener	onWebSocketFrameSent(EventHandler<WebSocketFrameSent> eventListener) Fired when WebSocket message is sent.
EventListener	onWebSocketHandshakeResponseReceived(EventHandler<WebSocketHandshakeResponseReceived> eventListener) Fired when WebSocket handshake response becomes available.
EventListener	onWebSocketWillSendHandshakeRequest(EventHandler<WebSocketWillSendHandshakeRequest> eventListener) Fired when WebSocket is about to initiate handshake.
void	replayXHR(String requestId) This method sends a new XMLHttpRequest which is identical to the original one.
List<SearchMatch>	searchInResponseBody(String requestId, String query) Searches for given string in response content.
List<SearchMatch>	searchInResponseBody(String requestId, String query, Boolean caseSensitive, Boolean isRegex) Searches for given string in response content.
void	setBlockedURLs(List<String> urls) Blocks URLs from loading.
void	setBypassServiceWorker(Boolean bypass) Toggles ignoring of service worker for each request.
void	setCacheDisabled(Boolean cacheDisabled) Toggles ignoring cache for each request.
Boolean	setCookie(String name, String value) Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
Boolean	setCookie(String name, String value, String url, String domain, String path, Boolean secure, Boolean httpOnly, CookieSameSite sameSite, Double expires) Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
void	setCookies(List<CookieParam> cookies) Sets given cookies.
void	setDataSizeLimitsForTest(Integer maxTotalSize, Integer maxResourceSize) For testing.
void	setExtraHTTPHeaders(Map<String,Object> headers) Specifies whether to always send extra HTTP headers with the requests from this page.
void	setRequestInterception(List<RequestPattern> patterns) Deprecated.
String	takeResponseBodyForInterceptionAsStream(String interceptionId) Returns a handle to the stream representing the response body.

Method Detail

canClearBrowserCache

@Deprecated
Boolean canClearBrowserCache()

Deprecated.

Tells whether clearing browser cache is supported.

canClearBrowserCookies

@Deprecated
Boolean canClearBrowserCookies()

Deprecated.

Tells whether clearing browser cookies is supported.

canEmulateNetworkConditions

@Deprecated
Boolean canEmulateNetworkConditions()

Deprecated.

Tells whether emulation of network conditions is supported.

clearBrowserCache

void clearBrowserCache()

Clears browser cache.

clearBrowserCookies

void clearBrowserCookies()

Clears browser cookies.

continueInterceptedRequest

@Deprecated
void continueInterceptedRequest(String interceptionId)

Deprecated.

Response to Network.requestIntercepted which either modifies the request to continue with any modifications, or blocks it, or completes it with the provided response bytes. If a network fetch occurs as a result which encounters a redirect an additional Network.requestIntercepted event will be sent with the same InterceptionId. Deprecated, use Fetch.continueRequest, Fetch.fulfillRequest and Fetch.failRequest instead.

Parameters:

interceptionId -

continueInterceptedRequest

@Deprecated
void continueInterceptedRequest(String interceptionId,
                                             ErrorReason errorReason,
                                             String rawResponse,
                                             String url,
                                             String method,
                                             String postData,
                                             Map<String,Object> headers,
                                             AuthChallengeResponse authChallengeResponse)

Deprecated.

Response to Network.requestIntercepted which either modifies the request to continue with any modifications, or blocks it, or completes it with the provided response bytes. If a network fetch occurs as a result which encounters a redirect an additional Network.requestIntercepted event will be sent with the same InterceptionId. Deprecated, use Fetch.continueRequest, Fetch.fulfillRequest and Fetch.failRequest instead.

Parameters:

interceptionId -

errorReason - If set this causes the request to fail with the given reason. Passing `Aborted` for requests marked with `isNavigationRequest` also cancels the navigation. Must not be set in response to an authChallenge.

rawResponse - If set the requests completes using with the provided base64 encoded raw response, including HTTP status line and headers etc... Must not be set in response to an authChallenge.

url - If set the request url will be modified in a way that's not observable by page. Must not be set in response to an authChallenge.

method - If set this allows the request method to be overridden. Must not be set in response to an authChallenge.

postData - If set this allows postData to be set. Must not be set in response to an authChallenge.

headers - If set this allows the request headers to be changed. Must not be set in response to an authChallenge.

authChallengeResponse - Response to a requestIntercepted with an authChallenge. Must not be set otherwise.

deleteCookies

void deleteCookies(String name)

Deletes browser cookies with matching name and url or domain/path pair.

Parameters:

name - Name of the cookies to remove.

deleteCookies

void deleteCookies(String name,
                   String url,
                   String domain,
                   String path)

Deletes browser cookies with matching name and url or domain/path pair.

Parameters:

name - Name of the cookies to remove.

url - If specified, deletes all the cookies with the given name where domain and path match provided URL.

domain - If specified, deletes only cookies with the exact domain.

path - If specified, deletes only cookies with the exact path.

disable

void disable()

Disables network tracking, prevents network events from being sent to the client.

emulateNetworkConditions

void emulateNetworkConditions(Boolean offline,
                              Double latency,
                              Double downloadThroughput,
                              Double uploadThroughput)

Activates emulation of network conditions.

Parameters:

offline - True to emulate internet disconnection.

latency - Minimum latency from request sent to response headers received (ms).

downloadThroughput - Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.

uploadThroughput - Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.

emulateNetworkConditions

void emulateNetworkConditions(Boolean offline,
                              Double latency,
                              Double downloadThroughput,
                              Double uploadThroughput,
                              ConnectionType connectionType)

Activates emulation of network conditions.

Parameters:

offline - True to emulate internet disconnection.

latency - Minimum latency from request sent to response headers received (ms).

downloadThroughput - Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.

uploadThroughput - Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.

connectionType - Connection type if known.

enable

void enable()

Enables network tracking, network events will now be delivered to the client.

enable

void enable(Integer maxTotalBufferSize,
            Integer maxResourceBufferSize,
            Integer maxPostDataSize)

Enables network tracking, network events will now be delivered to the client.

Parameters:

maxTotalBufferSize - Buffer size in bytes to use when preserving network payloads (XHRs, etc).

maxResourceBufferSize - Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).

maxPostDataSize - Longest post body size (in bytes) that would be included in requestWillBeSent notification

getAllCookies

List<Cookie> getAllCookies()

Returns all browser cookies. Depending on the backend support, will return detailed cookie information in the `cookies` field.

getCertificate

List<String> getCertificate(String origin)

Returns the DER-encoded certificate.

Parameters:

origin - Origin to get certificate for.

getCookies

List<Cookie> getCookies()

Returns all browser cookies for the current URL. Depending on the backend support, will return detailed cookie information in the `cookies` field.

getCookies

List<Cookie> getCookies(List<String> urls)

Returns all browser cookies for the current URL. Depending on the backend support, will return detailed cookie information in the `cookies` field.

Parameters:

urls - The list of URLs for which applicable cookies will be fetched

getResponseBody

ResponseBody getResponseBody(String requestId)

Returns content served for the given request.

Parameters:

requestId - Identifier of the network request to get content for.

getRequestPostData

String getRequestPostData(String requestId)

Returns post data sent with the request. Returns an error when no data was sent with the request.

Parameters:

requestId - Identifier of the network request to get content for.

getResponseBodyForInterception

ResponseBodyForInterception getResponseBodyForInterception(String interceptionId)

Returns content served for the given currently intercepted request.

Parameters:

interceptionId - Identifier for the intercepted request to get body for.

takeResponseBodyForInterceptionAsStream

String takeResponseBodyForInterceptionAsStream(String interceptionId)

Returns a handle to the stream representing the response body. Note that after this command, the intercepted request can't be continued as is -- you either need to cancel it or to provide the response body. The stream only supports sequential read, IO.read will fail if the position is specified.

Parameters:

interceptionId -

replayXHR

void replayXHR(String requestId)

This method sends a new XMLHttpRequest which is identical to the original one. The following parameters should be identical: method, url, async, request body, extra headers, withCredentials attribute, user, password.

Parameters:

requestId - Identifier of XHR to replay.

searchInResponseBody

List<SearchMatch> searchInResponseBody(String requestId,
                                       String query)

Searches for given string in response content.

Parameters:

requestId - Identifier of the network response to search.

query - String to search for.

searchInResponseBody

List<SearchMatch> searchInResponseBody(String requestId,
                                       String query,
                                       Boolean caseSensitive,
                                       Boolean isRegex)

Searches for given string in response content.

Parameters:

requestId - Identifier of the network response to search.

query - String to search for.

caseSensitive - If true, search is case sensitive.

isRegex - If true, treats string parameter as regex.

setBlockedURLs

void setBlockedURLs(List<String> urls)

Blocks URLs from loading.

Parameters:

urls - URL patterns to block. Wildcards ('*') are allowed.

setBypassServiceWorker

void setBypassServiceWorker(Boolean bypass)

Toggles ignoring of service worker for each request.

Parameters:

bypass - Bypass service worker and load from network.

setCacheDisabled

void setCacheDisabled(Boolean cacheDisabled)

Toggles ignoring cache for each request. If `true`, cache will not be used.

Parameters:

cacheDisabled - Cache disabled state.

setCookie

Boolean setCookie(String name,
                  String value)

Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.

Parameters:

name - Cookie name.

value - Cookie value.

setCookie

Boolean setCookie(String name,
                  String value,
                  String url,
                  String domain,
                  String path,
                  Boolean secure,
                  Boolean httpOnly,
                  CookieSameSite sameSite,
                  Double expires)

Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.

Parameters:

name - Cookie name.

value - Cookie value.

url - The request-URI to associate with the setting of the cookie. This value can affect the default domain and path values of the created cookie.

domain - Cookie domain.

path - Cookie path.

secure - True if cookie is secure.

httpOnly - True if cookie is http-only.

sameSite - Cookie SameSite type.

expires - Cookie expiration date, session cookie if not set

setCookies

void setCookies(List<CookieParam> cookies)

Sets given cookies.

Parameters:

cookies - Cookies to be set.

setDataSizeLimitsForTest

void setDataSizeLimitsForTest(Integer maxTotalSize,
                              Integer maxResourceSize)

For testing.

Parameters:

maxTotalSize - Maximum total buffer size.

maxResourceSize - Maximum per-resource size.

setExtraHTTPHeaders

void setExtraHTTPHeaders(Map<String,Object> headers)

Specifies whether to always send extra HTTP headers with the requests from this page.

Parameters:

headers - Map with extra HTTP headers.

setRequestInterception

@Deprecated
void setRequestInterception(List<RequestPattern> patterns)

Deprecated.

Sets the requests to intercept that match the provided patterns and optionally resource types. Deprecated, please use Fetch.enable instead.

Parameters:

patterns - Requests matching any of these patterns will be forwarded and wait for the corresponding continueInterceptedRequest call.

onDataReceived

EventListener onDataReceived(EventHandler<DataReceived> eventListener)

Fired when data chunk was received over the network.

onEventSourceMessageReceived

EventListener onEventSourceMessageReceived(EventHandler<EventSourceMessageReceived> eventListener)

Fired when EventSource message is received.

onLoadingFailed

EventListener onLoadingFailed(EventHandler<LoadingFailed> eventListener)

Fired when HTTP request has failed to load.

onLoadingFinished

EventListener onLoadingFinished(EventHandler<LoadingFinished> eventListener)

Fired when HTTP request has finished loading.

onRequestIntercepted

@Deprecated
EventListener onRequestIntercepted(EventHandler<RequestIntercepted> eventListener)

Deprecated.

Details of an intercepted HTTP request, which must be either allowed, blocked, modified or mocked. Deprecated, use Fetch.requestPaused instead.

onRequestServedFromCache

EventListener onRequestServedFromCache(EventHandler<RequestServedFromCache> eventListener)

Fired if request ended up loading from cache.

onRequestWillBeSent

EventListener onRequestWillBeSent(EventHandler<RequestWillBeSent> eventListener)

Fired when page is about to send HTTP request.

onResourceChangedPriority

EventListener onResourceChangedPriority(EventHandler<ResourceChangedPriority> eventListener)

Fired when resource loading priority is changed

onSignedExchangeReceived

EventListener onSignedExchangeReceived(EventHandler<SignedExchangeReceived> eventListener)

Fired when a signed exchange was received over the network

onResponseReceived

EventListener onResponseReceived(EventHandler<ResponseReceived> eventListener)

Fired when HTTP response is available.

onWebSocketClosed

EventListener onWebSocketClosed(EventHandler<WebSocketClosed> eventListener)

Fired when WebSocket is closed.

onWebSocketCreated

EventListener onWebSocketCreated(EventHandler<WebSocketCreated> eventListener)

Fired upon WebSocket creation.

onWebSocketFrameError

EventListener onWebSocketFrameError(EventHandler<WebSocketFrameError> eventListener)

Fired when WebSocket message error occurs.

onWebSocketFrameReceived

EventListener onWebSocketFrameReceived(EventHandler<WebSocketFrameReceived> eventListener)

Fired when WebSocket message is received.

onWebSocketFrameSent

EventListener onWebSocketFrameSent(EventHandler<WebSocketFrameSent> eventListener)

Fired when WebSocket message is sent.

onWebSocketHandshakeResponseReceived

EventListener onWebSocketHandshakeResponseReceived(EventHandler<WebSocketHandshakeResponseReceived> eventListener)

Fired when WebSocket handshake response becomes available.

onWebSocketWillSendHandshakeRequest

EventListener onWebSocketWillSendHandshakeRequest(EventHandler<WebSocketWillSendHandshakeRequest> eventListener)

Fired when WebSocket is about to initiate handshake.

onRequestWillBeSentExtraInfo

EventListener onRequestWillBeSentExtraInfo(EventHandler<RequestWillBeSentExtraInfo> eventListener)

Fired when additional information about a requestWillBeSent event is available from the network stack. Not every requestWillBeSent event will have an additional requestWillBeSentExtraInfo fired for it, and there is no guarantee whether requestWillBeSent or requestWillBeSentExtraInfo will be fired first for the same request.

onResponseReceivedExtraInfo

EventListener onResponseReceivedExtraInfo(EventHandler<ResponseReceivedExtraInfo> eventListener)

Fired when additional information about a responseReceived event is available from the network stack. Not every responseReceived event will have an additional responseReceivedExtraInfo for it, and responseReceivedExtraInfo may be fired before or after responseReceived.