io.webfolder.cdp.command

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() Tells whether clearing browser cache is supported.
Boolean	canClearBrowserCookies() Tells whether clearing browser cookies is supported.
Boolean	canEmulateNetworkConditions() Tells whether emulation of network conditions is supported.
void	clearBrowserCache() Clears browser cache.
void	clearBrowserCookies() Clears browser cookies.
void	deleteCookie(String cookieName, String url) Deletes browser cookie with given name, domain and path.
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) 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.
GetResponseBodyResult	getResponseBody(String requestId) Returns content served for the given request.
void	replayXHR(String requestId) This method sends a new XMLHttpRequest which is identical to the original one.
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 url, String name, String value) Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
Boolean	setCookie(String url, String name, String value, String domain, String path, Boolean secure, Boolean httpOnly, CookieSameSite sameSite, Double expirationDate) Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
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	setUserAgentOverride(String userAgent) Allows overriding user agent with the given string.

Method Detail

enable

void enable(Integer maxTotalBufferSize,
            Integer maxResourceBufferSize)

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).

disable

void disable()

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

setUserAgentOverride

void setUserAgentOverride(String userAgent)

Allows overriding user agent with the given string.

Parameters:

userAgent - User agent to use.

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.

getResponseBody

GetResponseBodyResult getResponseBody(String requestId)

Returns content served for the given request.

Parameters:

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

Returns:

GetResponseBodyResult

setBlockedURLs

void setBlockedURLs(List<String> urls)

Blocks URLs from loading.

Parameters:

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

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.

canClearBrowserCache

Boolean canClearBrowserCache()

Tells whether clearing browser cache is supported.

Returns:

True if browser cache can be cleared.

clearBrowserCache

void clearBrowserCache()

Clears browser cache.

canClearBrowserCookies

Boolean canClearBrowserCookies()

Tells whether clearing browser cookies is supported.

Returns:

True if browser cookies can be cleared.

clearBrowserCookies

void clearBrowserCookies()

Clears browser cookies.

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

Returns:

Array of cookie objects.

getAllCookies

List<Cookie> getAllCookies()

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

Returns:

Array of cookie objects.

deleteCookie

void deleteCookie(String cookieName,
                  String url)

Deletes browser cookie with given name, domain and path.

Parameters:

cookieName - Name of the cookie to remove.

url - URL to match cooke domain and path.

setCookie

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

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

Parameters:

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.

name - The name of the cookie.

value - The value of the cookie.

domain - If omitted, the cookie becomes a host-only cookie.

path - Defaults to the path portion of the url parameter.

secure - Defaults ot false.

httpOnly - Defaults to false.

sameSite - Defaults to browser default behavior.

expirationDate - If omitted, the cookie becomes a session cookie.

Returns:

True if successfully set cookie.

canEmulateNetworkConditions

Boolean canEmulateNetworkConditions()

Tells whether emulation of network conditions is supported.

Returns:

True if emulation of network conditions is supported.

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 - Additional latency (ms).

downloadThroughput - Maximal aggregated download throughput.

uploadThroughput - Maximal aggregated upload throughput.

connectionType - Connection type if known.

setCacheDisabled

void setCacheDisabled(Boolean cacheDisabled)

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

Parameters:

cacheDisabled - Cache disabled state.

setBypassServiceWorker

void setBypassServiceWorker(Boolean bypass)

Toggles ignoring of service worker for each request.

Parameters:

bypass - Bypass service worker and load from network.

setDataSizeLimitsForTest

void setDataSizeLimitsForTest(Integer maxTotalSize,
                              Integer maxResourceSize)

For testing.

Parameters:

maxTotalSize - Maximum total buffer size.

maxResourceSize - Maximum per-resource size.

getCertificate

List<String> getCertificate(String origin)

Returns the DER-encoded certificate.

Parameters:

origin - Origin to get certificate for.

enable

void enable()

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

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.

Returns:

Array of cookie objects.

setCookie

Boolean setCookie(String url,
                  String name,
                  String value)

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

Parameters:

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.

name - The name of the cookie.

value - The value of the cookie.

Returns:

True if successfully set cookie.

emulateNetworkConditions

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

Activates emulation of network conditions.

Parameters:

offline - True to emulate internet disconnection.

latency - Additional latency (ms).

downloadThroughput - Maximal aggregated download throughput.

uploadThroughput - Maximal aggregated upload throughput.