View as markdown
Copy for LLM Open in ChatGPT Open in Claude Open in Perplexity

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.

Dependencies: Debugger, Runtime, Security

Commands

Network.setAcceptedEncodings

Experimental

Sets a list of content encodings that will be accepted. Empty list means no encoding is accepted.

Parameters
Name Type Description
encodings array<ContentEncoding> List of accepted content encodings.

Network.clearAcceptedEncodingsOverride

Experimental

Clears accepted encodings set by setAcceptedEncodings

Network.canClearBrowserCache

Deprecated

Tells whether clearing browser cache is supported.

Return Object
Name Type Description
result boolean True if browser cache can be cleared.

Network.canClearBrowserCookies

Deprecated

Tells whether clearing browser cookies is supported.

Return Object
Name Type Description
result boolean True if browser cookies can be cleared.

Network.canEmulateNetworkConditions

Deprecated

Tells whether emulation of network conditions is supported.

Return Object
Name Type Description
result boolean True if emulation of network conditions is supported.

Network.clearBrowserCache

Clears browser cache.

Network.clearBrowserCookies

Clears browser cookies.

Network.continueInterceptedRequest

Experimental 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
Name Type Description
interceptionId InterceptionId
errorReason (optional) 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 (optional) binary 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 (optional) string 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 (optional) string If set this allows the request method to be overridden. Must not be set in response to an
authChallenge.
postData (optional) string If set this allows postData to be set. Must not be set in response to an authChallenge.
headers (optional) Headers If set this allows the request headers to be changed. Must not be set in response to an
authChallenge.
authChallengeResponse (optional) AuthChallengeResponse Response to a requestIntercepted with an authChallenge. Must not be set otherwise.

Network.deleteCookies

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

Parameters
Name Type Description
name string Name of the cookies to remove.
url (optional) string If specified, deletes all the cookies with the given name where domain and path match
provided URL.
domain (optional) string If specified, deletes only cookies with the exact domain.
path (optional) string If specified, deletes only cookies with the exact path.
partitionKey (optional) Experimental CookiePartitionKey If specified, deletes only cookies with the the given name and partitionKey where
all partition key attributes match the cookie partition key attribute.

Network.disable

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

Network.emulateNetworkConditions

Deprecated

Activates emulation of network conditions. This command is deprecated in favor of the emulateNetworkConditionsByRule
and overrideNetworkState commands, which can be used together to the same effect.

Parameters
Name Type Description
offline boolean True to emulate internet disconnection.
latency number Minimum latency from request sent to response headers received (ms).
downloadThroughput number Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
uploadThroughput number Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.
connectionType (optional) ConnectionType Connection type if known.
packetLoss (optional) Experimental number WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.
packetQueueLength (optional) Experimental integer WebRTC packet queue length (packet). 0 removes any queue length limitations.
packetReordering (optional) Experimental boolean WebRTC packetReordering feature.

Network.emulateNetworkConditionsByRule

Experimental

Activates emulation of network conditions for individual requests using URL match patterns. Unlike the deprecated
Network.emulateNetworkConditions this method does not affect `navigator` state. Use Network.overrideNetworkState to
explicitly modify `navigator` behavior.

Parameters
Name Type Description
offline boolean True to emulate internet disconnection.
matchedNetworkConditions array<NetworkConditions> Configure conditions for matching requests. If multiple entries match a request, the first entry wins. Global
conditions can be configured by leaving the urlPattern for the conditions empty. These global conditions are
also applied for throttling of p2p connections.
Return Object
Name Type Description
ruleIds array<string> An id for each entry in matchedNetworkConditions. The id will be included in the requestWillBeSentExtraInfo for
requests affected by a rule.

Network.overrideNetworkState

Experimental

Override the state of navigator.onLine and navigator.connection.

Parameters
Name Type Description
offline boolean True to emulate internet disconnection.
latency number Minimum latency from request sent to response headers received (ms).
downloadThroughput number Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
uploadThroughput number Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.
connectionType (optional) ConnectionType Connection type if known.

Network.enable

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

Parameters
Name Type Description
maxTotalBufferSize (optional) Experimental integer Buffer size in bytes to use when preserving network payloads (XHRs, etc).
This is the maximum number of bytes that will be collected by this
DevTools session.
maxResourceBufferSize (optional) Experimental integer Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).
maxPostDataSize (optional) integer Longest post body size (in bytes) that would be included in requestWillBeSent notification
reportDirectSocketTraffic (optional) Experimental boolean Whether DirectSocket chunk send/receive events should be reported.
enableDurableMessages (optional) Experimental boolean Enable storing response bodies outside of renderer, so that these survive
a cross-process navigation. Requires maxTotalBufferSize to be set.
Currently defaults to false. This field is being deprecated in favor of the dedicated
configureDurableMessages command, due to the possibility of deadlocks when awaiting
Network.enable before issuing Runtime.runIfWaitingForDebugger.

Network.configureDurableMessages

Experimental

Configures storing response bodies outside of renderer, so that these survive
a cross-process navigation.
If maxTotalBufferSize is not set, durable messages are disabled.

Parameters
Name Type Description
maxTotalBufferSize (optional) integer Buffer size in bytes to use when preserving network payloads (XHRs, etc).
maxResourceBufferSize (optional) integer Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).

Network.getAllCookies

Deprecated

Returns all browser cookies. Depending on the backend support, will return detailed cookie
information in the `cookies` field.
Deprecated. Use Storage.getCookies instead.

Return Object
Name Type Description
cookies array<Cookie> Array of cookie objects.

Network.getCertificate

Experimental

Returns the DER-encoded certificate.

Parameters
Name Type Description
origin string Origin to get certificate for.
Return Object
Name Type Description
tableNames array<string>

Network.getCookies

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

Parameters
Name Type Description
urls (optional) array<string> The list of URLs for which applicable cookies will be fetched.
If not specified, it's assumed to be set to the list containing
the URLs of the page and all of its subframes.
Return Object
Name Type Description
cookies array<Cookie> Array of cookie objects.

Network.getResponseBody

Returns content served for the given request.

Parameters
Name Type Description
requestId RequestId Identifier of the network request to get content for.
Return Object
Name Type Description
body string Response body.
base64Encoded boolean True, if content was sent as base64.

Network.getRequestPostData

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

Parameters
Name Type Description
requestId RequestId Identifier of the network request to get content for.
Return Object
Name Type Description
postData string Request body string, omitting files from multipart requests
base64Encoded boolean True, if content was sent as base64.

Network.getResponseBodyForInterception

Experimental

Returns content served for the given currently intercepted request.

Parameters
Name Type Description
interceptionId InterceptionId Identifier for the intercepted request to get body for.
Return Object
Name Type Description
body string Response body.
base64Encoded boolean True, if content was sent as base64.

Network.takeResponseBodyForInterceptionAsStream

Experimental

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
Name Type Description
interceptionId InterceptionId
Return Object
Name Type Description
stream IO.StreamHandle

Network.replayXHR

Experimental

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
Name Type Description
requestId RequestId Identifier of XHR to replay.

Network.searchInResponseBody

Experimental

Searches for given string in response content.

Parameters
Name Type Description
requestId RequestId Identifier of the network response to search.
query string String to search for.
caseSensitive (optional) boolean If true, search is case sensitive.
isRegex (optional) boolean If true, treats string parameter as regex.
Return Object
Name Type Description
result array<Debugger.SearchMatch> List of search matches.

Network.setBlockedURLs

Experimental

Blocks URLs from loading.

Parameters
Name Type Description
urlPatterns (optional) array<BlockPattern> Patterns to match in the order in which they are given. These patterns
also take precedence over any wildcard patterns defined in `urls`.
urls (optional) Deprecated array<string> URL patterns to block. Wildcards ('*') are allowed.

Network.setBypassServiceWorker

Toggles ignoring of service worker for each request.

Parameters
Name Type Description
bypass boolean Bypass service worker and load from network.

Network.setCacheDisabled

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

Parameters
Name Type Description
cacheDisabled boolean Cache disabled state.

Network.setCookie

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

Parameters
Name Type Description
name string Cookie name.
value string Cookie value.
url (optional) string The request-URI to associate with the setting of the cookie. This value can affect the
default domain, path, source port, and source scheme values of the created cookie.
domain (optional) string Cookie domain.
path (optional) string Cookie path.
secure (optional) boolean True if cookie is secure.
httpOnly (optional) boolean True if cookie is http-only.
sameSite (optional) CookieSameSite Cookie SameSite type.
expires (optional) TimeSinceEpoch Cookie expiration date, session cookie if not set
priority (optional) Experimental CookiePriority Cookie Priority type.
sourceScheme (optional) Experimental CookieSourceScheme Cookie source scheme type.
sourcePort (optional) Experimental integer Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
This is a temporary ability and it will be removed in the future.
partitionKey (optional) Experimental CookiePartitionKey Cookie partition key. If not set, the cookie will be set as not partitioned.
Return Object
Name Type Description
success Deprecated boolean Always set to true. If an error occurs, the response indicates protocol error.

Network.setCookies

Sets given cookies.

Parameters
Name Type Description
cookies array<CookieParam> Cookies to be set.

Network.setExtraHTTPHeaders

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

Parameters
Name Type Description
headers Headers Map with extra HTTP headers.

Network.setAttachDebugStack

Experimental

Specifies whether to attach a page script stack id in requests

Parameters
Name Type Description
enabled boolean Whether to attach a page script stack for debugging purpose.

Network.setRequestInterception

Experimental Deprecated

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

Parameters
Name Type Description
patterns array<RequestPattern> Requests matching any of these patterns will be forwarded and wait for the corresponding
continueInterceptedRequest call.

Network.setUserAgentOverride

Allows overriding user agent with the given string.

Redirects to: Emulation

Parameters
Name Type Description
userAgent string User agent to use.
acceptLanguage (optional) string Browser language to emulate.
platform (optional) string The platform navigator.platform should return.
userAgentMetadata (optional) Experimental Emulation.UserAgentMetadata To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData

Network.streamResourceContent

Experimental

Enables streaming of the response for the given requestId.
If enabled, the dataReceived event contains the data that was received during streaming.

Parameters
Name Type Description
requestId RequestId Identifier of the request to stream.
Return Object
Name Type Description
bufferedData binary Data that has been buffered until streaming is enabled.

Network.getSecurityIsolationStatus

Experimental

Returns information about the COEP/COOP isolation status.

Parameters
Name Type Description
frameId (optional) Page.FrameId If no frameId is provided, the status of the target is provided.
Return Object
Name Type Description
status SecurityIsolationStatus

Network.enableReportingApi

Experimental

Enables tracking for the Reporting API, events generated by the Reporting API will now be delivered to the client.
Enabling triggers 'reportingApiReportAdded' for all existing reports.

Parameters
Name Type Description
enable boolean Whether to enable or disable events for the Reporting API

Network.enableDeviceBoundSessions

Experimental

Sets up tracking device bound sessions and fetching of initial set of sessions.

Parameters
Name Type Description
enable boolean Whether to enable or disable events.

Network.fetchSchemefulSite

Experimental

Fetches the schemeful site for a specific origin.

Parameters
Name Type Description
origin string The URL origin.
Return Object
Name Type Description
schemefulSite string The corresponding schemeful site.

Network.loadNetworkResource

Experimental

Fetches the resource and returns the content.

Parameters
Name Type Description
frameId (optional) Page.FrameId Frame id to get the resource for. Mandatory for frame targets, and
should be omitted for worker targets.
url string URL of the resource to get content for.
options LoadNetworkResourceOptions Options for the request.
Return Object
Name Type Description
resource LoadNetworkResourcePageResult

Network.setCookieControls

Experimental

Sets Controls for third-party cookie access
Page reload is required before the new cookie behavior will be observed

Parameters
Name Type Description
enableThirdPartyCookieRestriction boolean Whether 3pc restriction is enabled.
disableThirdPartyCookieMetadata boolean Whether 3pc grace period exception should be enabled; false by default.
disableThirdPartyCookieHeuristics boolean Whether 3pc heuristics exceptions should be enabled; false by default.

Network.setResolvedDNS

Experimental

Sets pre-resolved DNS entries for a hostname.
These entries take priority over profile-based and system DNS resolution.
Call with empty entries array to remove a hostname's override.

Parameters
Name Type Description
hostname string
entries array<DnsEntry>

Network.getResolvedDNS

Experimental

Returns all dynamically set DNS resolution entries.

Return Object
Name Type Description
entries array<ResolvedDNSHost>

Events

Network.dataReceived

Fired when data chunk was received over the network.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
dataLength integer Data chunk length.
encodedDataLength integer Actual bytes received (might be less than dataLength for compressed encodings).
data (optional) Experimental binary Data that was received.

Network.eventSourceMessageReceived

Fired when EventSource message is received.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
eventName string Message type.
eventId string Message identifier.
data string Message content.

Network.loadingFailed

Fired when HTTP request has failed to load.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
type ResourceType Resource type.
errorText string Error message. List of network errors: https://cs.chromium.org/chromium/src/net/base/net_error_list.h
canceled (optional) boolean True if loading was canceled.
blockedReason (optional) BlockedReason The reason why loading was blocked, if any.
corsErrorStatus (optional) CorsErrorStatus The reason why loading was blocked by CORS, if any.

Network.loadingFinished

Fired when HTTP request has finished loading.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
encodedDataLength number Total number of bytes received for this request.

Network.requestIntercepted

Experimental Deprecated

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

Parameters
Name Type Description
interceptionId InterceptionId Each request the page makes will have a unique id, however if any redirects are encountered
while processing that fetch, they will be reported with the same id as the original fetch.
Likewise if HTTP authentication is needed then the same fetch id will be used.
request Request
frameId Page.FrameId The id of the frame that initiated the request.
resourceType ResourceType How the requested resource will be used.
isNavigationRequest boolean Whether this is a navigation request, which can abort the navigation completely.
isDownload (optional) boolean Set if the request is a navigation that will result in a download.
Only present after response is received from the server (i.e. HeadersReceived stage).
redirectUrl (optional) string Redirect location, only sent if a redirect was intercepted.
authChallenge (optional) AuthChallenge Details of the Authorization Challenge encountered. If this is set then
continueInterceptedRequest must contain an authChallengeResponse.
responseErrorReason (optional) ErrorReason Response error if intercepted at response stage or if redirect occurred while intercepting
request.
responseStatusCode (optional) integer Response code if intercepted at response stage or if redirect occurred while intercepting
request or auth retry occurred.
responseHeaders (optional) Headers Response headers if intercepted at the response stage or if redirect occurred while
intercepting request or auth retry occurred.
requestId (optional) RequestId If the intercepted request had a corresponding requestWillBeSent event fired for it, then
this requestId will be the same as the requestId present in the requestWillBeSent event.

Network.requestServedFromCache

Fired if request ended up loading from cache.

Parameters
Name Type Description
requestId RequestId Request identifier.

Network.requestWillBeSent

Fired when page is about to send HTTP request.

Parameters
Name Type Description
requestId RequestId Request identifier.
loaderId LoaderId Loader identifier. Empty string if the request is fetched from worker.
documentURL string URL of the document this request is loaded for.
request Request Request data.
timestamp MonotonicTime Timestamp.
wallTime TimeSinceEpoch Timestamp.
initiator Initiator Request initiator.
redirectHasExtraInfo Experimental boolean In the case that redirectResponse is populated, this flag indicates whether
requestWillBeSentExtraInfo and responseReceivedExtraInfo events will be or were emitted
for the request which was just redirected.
redirectResponse (optional) Response Redirect response data.
type (optional) ResourceType Type of this resource.
frameId (optional) Page.FrameId Frame identifier.
hasUserGesture (optional) boolean Whether the request is initiated by a user gesture. Defaults to false.
renderBlockingBehavior (optional) Experimental RenderBlockingBehavior The render-blocking behavior of the request.

Network.resourceChangedPriority

Experimental

Fired when resource loading priority is changed

Parameters
Name Type Description
requestId RequestId Request identifier.
newPriority ResourcePriority New priority
timestamp MonotonicTime Timestamp.

Network.signedExchangeReceived

Experimental

Fired when a signed exchange was received over the network

Parameters
Name Type Description
requestId RequestId Request identifier.
info SignedExchangeInfo Information about the signed exchange response.

Network.responseReceived

Fired when HTTP response is available.

Parameters
Name Type Description
requestId RequestId Request identifier.
loaderId LoaderId Loader identifier. Empty string if the request is fetched from worker.
timestamp MonotonicTime Timestamp.
type ResourceType Resource type.
response Response Response data.
hasExtraInfo Experimental boolean Indicates whether requestWillBeSentExtraInfo and responseReceivedExtraInfo events will be
or were emitted for this request.
frameId (optional) Page.FrameId Frame identifier.

Network.webSocketClosed

Fired when WebSocket is closed.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.

Network.webSocketCreated

Fired upon WebSocket creation.

Parameters
Name Type Description
requestId RequestId Request identifier.
url string WebSocket request URL.
initiator (optional) Initiator Request initiator.

Network.webSocketFrameError

Fired when WebSocket message error occurs.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
errorMessage string WebSocket error message.

Network.webSocketFrameReceived

Fired when WebSocket message is received.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
response WebSocketFrame WebSocket response data.

Network.webSocketFrameSent

Fired when WebSocket message is sent.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
response WebSocketFrame WebSocket response data.

Network.webSocketHandshakeResponseReceived

Fired when WebSocket handshake response becomes available.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
response WebSocketResponse WebSocket response data.

Network.webSocketWillSendHandshakeRequest

Fired when WebSocket is about to initiate handshake.

Parameters
Name Type Description
requestId RequestId Request identifier.
timestamp MonotonicTime Timestamp.
wallTime TimeSinceEpoch UTC Timestamp.
request WebSocketRequest WebSocket request data.

Network.webTransportCreated

Fired upon WebTransport creation.

Parameters
Name Type Description
transportId RequestId WebTransport identifier.
url string WebTransport request URL.
timestamp MonotonicTime Timestamp.
initiator (optional) Initiator Request initiator.

Network.webTransportConnectionEstablished

Fired when WebTransport handshake is finished.

Parameters
Name Type Description
transportId RequestId WebTransport identifier.
timestamp MonotonicTime Timestamp.

Network.webTransportClosed

Fired when WebTransport is disposed.

Parameters
Name Type Description
transportId RequestId WebTransport identifier.
timestamp MonotonicTime Timestamp.

Network.directTCPSocketCreated

Experimental

Fired upon direct_socket.TCPSocket creation.

Parameters
Name Type Description
identifier RequestId
remoteAddr string
remotePort integer Unsigned int 16.
options DirectTCPSocketOptions
timestamp MonotonicTime
initiator (optional) Initiator

Network.directTCPSocketOpened

Experimental

Fired when direct_socket.TCPSocket connection is opened.

Parameters
Name Type Description
identifier RequestId
remoteAddr string
remotePort integer Expected to be unsigned integer.
timestamp MonotonicTime
localAddr (optional) string
localPort (optional) integer Expected to be unsigned integer.

Network.directTCPSocketAborted

Experimental

Fired when direct_socket.TCPSocket is aborted.

Parameters
Name Type Description
identifier RequestId
errorMessage string
timestamp MonotonicTime

Network.directTCPSocketClosed

Experimental

Fired when direct_socket.TCPSocket is closed.

Parameters
Name Type Description
identifier RequestId
timestamp MonotonicTime

Network.directTCPSocketChunkSent

Experimental

Fired when data is sent to tcp direct socket stream.

Parameters
Name Type Description
identifier RequestId
data binary
timestamp MonotonicTime

Network.directTCPSocketChunkReceived

Experimental

Fired when data is received from tcp direct socket stream.

Parameters
Name Type Description
identifier RequestId
data binary
timestamp MonotonicTime

Network.directUDPSocketJoinedMulticastGroup

Experimental
Parameters
Name Type Description
identifier RequestId
IPAddress string

Network.directUDPSocketLeftMulticastGroup

Experimental
Parameters
Name Type Description
identifier RequestId
IPAddress string

Network.directUDPSocketCreated

Experimental

Fired upon direct_socket.UDPSocket creation.

Parameters
Name Type Description
identifier RequestId
options DirectUDPSocketOptions
timestamp MonotonicTime
initiator (optional) Initiator

Network.directUDPSocketOpened

Experimental

Fired when direct_socket.UDPSocket connection is opened.

Parameters
Name Type Description
identifier RequestId
localAddr string
localPort integer Expected to be unsigned integer.
timestamp MonotonicTime
remoteAddr (optional) string
remotePort (optional) integer Expected to be unsigned integer.

Network.directUDPSocketAborted

Experimental

Fired when direct_socket.UDPSocket is aborted.

Parameters
Name Type Description
identifier RequestId
errorMessage string
timestamp MonotonicTime

Network.directUDPSocketClosed

Experimental

Fired when direct_socket.UDPSocket is closed.

Parameters
Name Type Description
identifier RequestId
timestamp MonotonicTime

Network.directUDPSocketChunkSent

Experimental

Fired when message is sent to udp direct socket stream.

Parameters
Name Type Description
identifier RequestId
message DirectUDPMessage
timestamp MonotonicTime

Network.directUDPSocketChunkReceived

Experimental

Fired when message is received from udp direct socket stream.

Parameters
Name Type Description
identifier RequestId
message DirectUDPMessage
timestamp MonotonicTime

Network.requestWillBeSentExtraInfo

Experimental

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.

Parameters
Name Type Description
requestId RequestId Request identifier. Used to match this information to an existing requestWillBeSent event.
associatedCookies array<AssociatedCookie> A list of cookies potentially associated to the requested URL. This includes both cookies sent with
the request and the ones not sent; the latter are distinguished by having blockedReasons field set.
headers Headers Raw request headers as they will be sent over the wire.
connectTiming Experimental ConnectTiming Connection timing information for the request.
deviceBoundSessionUsages (optional) array<DeviceBoundSessionWithUsage> How the request site's device bound sessions were used during this request.
clientSecurityState (optional) ClientSecurityState The client security state set for the request.
siteHasCookieInOtherPartition (optional) boolean Whether the site has partitioned cookies stored in a partition different than the current one.
appliedNetworkConditionsId (optional) string The network conditions id if this request was affected by network conditions configured via
emulateNetworkConditionsByRule.

Network.responseReceivedExtraInfo

Experimental

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.

Parameters
Name Type Description
requestId RequestId Request identifier. Used to match this information to another responseReceived event.
blockedCookies array<BlockedSetCookieWithReason> A list of cookies which were not stored from the response along with the corresponding
reasons for blocking. The cookies here may not be valid due to syntax errors, which
are represented by the invalid cookie line string instead of a proper cookie.
headers Headers Raw response headers as they were received over the wire.
Duplicate headers in the response are represented as a single key with their values
concatentated using `\n` as the separator.
See also `headersText` that contains verbatim text for HTTP/1.*.
resourceIPAddressSpace IPAddressSpace The IP address space of the resource. The address space can only be determined once the transport
established the connection, so we can't send it in `requestWillBeSentExtraInfo`.
statusCode integer The status code of the response. This is useful in cases the request failed and no responseReceived
event is triggered, which is the case for, e.g., CORS errors. This is also the correct status code
for cached requests, where the status in responseReceived is a 200 and this will be 304.
headersText (optional) string Raw response header text as it was received over the wire. The raw text may not always be
available, such as in the case of HTTP/2 or QUIC.
cookiePartitionKey (optional) Experimental CookiePartitionKey The cookie partition key that will be used to store partitioned cookies set in this response.
Only sent when partitioned cookies are enabled.
cookiePartitionKeyOpaque (optional) boolean True if partitioned cookies are enabled, but the partition key is not serializable to string.
exemptedCookies (optional) array<ExemptedSetCookieWithReason> A list of cookies which should have been blocked by 3PCD but are exempted and stored from
the response with the corresponding reason.

Network.responseReceivedEarlyHints

Experimental

Fired when 103 Early Hints headers is received in addition to the common response.
Not every responseReceived event will have an responseReceivedEarlyHints fired.
Only one responseReceivedEarlyHints may be fired for eached responseReceived event.

Parameters
Name Type Description
requestId RequestId Request identifier. Used to match this information to another responseReceived event.
headers Headers Raw response headers as they were received over the wire.
Duplicate headers in the response are represented as a single key with their values
concatentated using `\n` as the separator.
See also `headersText` that contains verbatim text for HTTP/1.*.

Network.trustTokenOperationDone

Experimental

Fired exactly once for each Trust Token operation. Depending on
the type of the operation and whether the operation succeeded or
failed, the event is fired before the corresponding request was sent
or after the response was received.

Parameters
Name Type Description
status string Detailed success or error status of the operation.
'AlreadyExists' also signifies a successful operation, as the result
of the operation already exists und thus, the operation was abort
preemptively (e.g. a cache hit).
type TrustTokenOperationType
requestId RequestId
topLevelOrigin (optional) string Top level origin. The context in which the operation was attempted.
issuerOrigin (optional) string Origin of the issuer in case of a "Issuance" or "Redemption" operation.
issuedTokenCount (optional) integer The number of obtained Trust Tokens on a successful "Issuance" operation.

Network.policyUpdated

Experimental

Fired once security policy has been updated.

Network.reportingApiReportAdded

Experimental

Is sent whenever a new report is added.
And after 'enableReportingApi' for all existing reports.

Parameters
Name Type Description
report ReportingApiReport

Network.reportingApiReportUpdated

Experimental
Parameters
Name Type Description
report ReportingApiReport

Network.reportingApiEndpointsChangedForOrigin

Experimental
Parameters
Name Type Description
origin string Origin of the document(s) which configured the endpoints.
endpoints array<ReportingApiEndpoint>

Network.deviceBoundSessionsAdded

Experimental

Triggered when the initial set of device bound sessions is added.

Parameters
Name Type Description
sessions array<DeviceBoundSession> The device bound sessions.

Network.deviceBoundSessionEventOccurred

Experimental

Triggered when a device bound session event occurs.

Parameters
Name Type Description
eventId DeviceBoundSessionEventId A unique identifier for this session event.
site string The site this session event is associated with.
succeeded boolean Whether this event was considered successful.
sessionId (optional) string The session ID this event is associated with. May not be populated for
failed events.
creationEventDetails (optional) CreationEventDetails The below are the different session event type details. Exactly one is populated.
refreshEventDetails (optional) RefreshEventDetails
terminationEventDetails (optional) TerminationEventDetails
challengeEventDetails (optional) ChallengeEventDetails

Types

ResourceType

(string)

Resource type as it was perceived by the rendering engine.

Allowed Values
  • Document
  • Stylesheet
  • Image
  • Media
  • Font
  • Script
  • TextTrack
  • XHR
  • Fetch
  • Prefetch
  • EventSource
  • WebSocket
  • Manifest
  • SignedExchange
  • Ping
  • CSPViolationReport
  • Preflight
  • FedCM
  • Other

LoaderId

(string)

Unique loader identifier.

RequestId

(string)

Unique network request identifier.
Note that this does not identify individual HTTP requests that are part of
a network request.

InterceptionId

(string)

Unique intercepted request identifier.

ErrorReason

(string)

Network level fetch failure reason.

Allowed Values
  • Failed
  • Aborted
  • TimedOut
  • AccessDenied
  • ConnectionClosed
  • ConnectionReset
  • ConnectionRefused
  • ConnectionAborted
  • ConnectionFailed
  • NameNotResolved
  • InternetDisconnected
  • AddressUnreachable
  • BlockedByClient
  • BlockedByResponse

TimeSinceEpoch

(number)

UTC time in seconds, counted from January 1, 1970.

MonotonicTime

(number)

Monotonically increasing time in seconds since an arbitrary point in the past.

Headers

(object)

Request / response headers as keys / values of JSON object.

ConnectionType

(string)

The underlying connection technology that the browser is supposedly using.

Allowed Values
  • none
  • cellular2g
  • cellular3g
  • cellular4g
  • bluetooth
  • ethernet
  • wifi
  • wimax
  • other

CookieSameSite

(string)

Represents the cookie's 'SameSite' status:
https://tools.ietf.org/html/draft-west-first-party-cookies

Allowed Values
  • Strict
  • Lax
  • None

CookiePriority

(string) Experimental

Represents the cookie's 'Priority' status:
https://tools.ietf.org/html/draft-west-cookie-priority-00

Allowed Values
  • Low
  • Medium
  • High

CookieSourceScheme

(string) Experimental

Represents the source scheme of the origin that originally set the cookie.
A value of "Unset" allows protocol clients to emulate legacy cookie scope for the scheme.
This is a temporary ability and it will be removed in the future.

Allowed Values
  • Unset
  • NonSecure
  • Secure

ResourceTiming

(object)

Timing information for the request.

Properties
Name Type Description
requestTime number Timing's requestTime is a baseline in seconds, while the other numbers are ticks in
milliseconds relatively to this requestTime.
proxyStart number Started resolving proxy.
proxyEnd number Finished resolving proxy.
dnsStart number Started DNS address resolve.
dnsEnd number Finished DNS address resolve.
connectStart number Started connecting to the remote host.
connectEnd number Connected to the remote host.
sslStart number Started SSL handshake.
sslEnd number Finished SSL handshake.
workerStart Experimental number Started running ServiceWorker.
workerReady Experimental number Finished Starting ServiceWorker.
workerFetchStart Experimental number Started fetch event.
workerRespondWithSettled Experimental number Settled fetch event respondWith promise.
workerRouterEvaluationStart (optional) Experimental number Started ServiceWorker static routing source evaluation.
workerCacheLookupStart (optional) Experimental number Started cache lookup when the source was evaluated to `cache`.
sendStart number Started sending request.
sendEnd number Finished sending request.
pushStart Experimental number Time the server started pushing request.
pushEnd Experimental number Time the server finished pushing request.
receiveHeadersStart Experimental number Started receiving response headers.
receiveHeadersEnd number Finished receiving response headers.

ResourcePriority

(string)

Loading priority of a resource request.

Allowed Values
  • VeryLow
  • Low
  • Medium
  • High
  • VeryHigh

RenderBlockingBehavior

(string) Experimental

The render-blocking behavior of a resource request.

Allowed Values
  • Blocking
  • InBodyParserBlocking
  • NonBlocking
  • NonBlockingDynamic
  • PotentiallyBlocking

PostDataEntry

(object)

Post data entry for HTTP request

Properties
Name Type Description
bytes (optional) binary

Request

(object)

HTTP request data.

Properties
Name Type Description
url string Request URL (without fragment).
urlFragment (optional) string Fragment of the requested URL starting with hash, if present.
method string HTTP request method.
headers Headers HTTP request headers.
postData (optional) Deprecated string HTTP POST request data.
Use postDataEntries instead.
hasPostData (optional) boolean True when the request has POST data. Note that postData might still be omitted when this flag is true when the data is too long.
postDataEntries (optional) Experimental array<PostDataEntry> Request body elements (post data broken into individual entries).
mixedContentType (optional) Security.MixedContentType The mixed content type of the request.
initialPriority ResourcePriority Priority of the resource request at the time request is sent.
referrerPolicy string The referrer policy of the request, as defined in https://www.w3.org/TR/referrer-policy/
isLinkPreload (optional) boolean Whether is loaded via link preload.
trustTokenParams (optional) Experimental TrustTokenParams Set for requests when the TrustToken API is used. Contains the parameters
passed by the developer (e.g. via "fetch") as understood by the backend.
isSameSite (optional) Experimental boolean True if this resource request is considered to be the 'same site' as the
request corresponding to the main frame.
isAdRelated (optional) Experimental boolean True when the resource request is ad-related.

SignedCertificateTimestamp

(object)

Details of a signed certificate timestamp (SCT).

Properties
Name Type Description
status string Validation status.
origin string Origin.
logDescription string Log name / description.
logId string Log ID.
timestamp number Issuance date. Unlike TimeSinceEpoch, this contains the number of
milliseconds since January 1, 1970, UTC, not the number of seconds.
hashAlgorithm string Hash algorithm.
signatureAlgorithm string Signature algorithm.
signatureData string Signature data.

SecurityDetails

(object)

Security details about a request.

Properties
Name Type Description
protocol string Protocol name (e.g. "TLS 1.2" or "QUIC").
keyExchange string Key Exchange used by the connection, or the empty string if not applicable.
keyExchangeGroup (optional) string (EC)DH group used by the connection, if applicable.
cipher string Cipher name.
mac (optional) string TLS MAC. Note that AEAD ciphers do not have separate MACs.
certificateId Security.CertificateId Certificate ID value.
subjectName string Certificate subject name.
sanList array<string> Subject Alternative Name (SAN) DNS names and IP addresses.
issuer string Name of the issuing CA.
validFrom TimeSinceEpoch Certificate valid from date.
validTo TimeSinceEpoch Certificate valid to (expiration) date
signedCertificateTimestampList array<SignedCertificateTimestamp> List of signed certificate timestamps (SCTs).
certificateTransparencyCompliance CertificateTransparencyCompliance Whether the request complied with Certificate Transparency policy
serverSignatureAlgorithm (optional) integer The signature algorithm used by the server in the TLS server signature,
represented as a TLS SignatureScheme code point. Omitted if not
applicable or not known.
encryptedClientHello boolean Whether the connection used Encrypted ClientHello

CertificateTransparencyCompliance

(string)

Whether the request complied with Certificate Transparency policy.

Allowed Values
  • unknown
  • not-compliant
  • compliant

BlockedReason

(string)

The reason why request was blocked.

Allowed Values
  • other
  • csp
  • mixed-content
  • origin
  • inspector
  • integrity
  • subresource-filter
  • content-type
  • coep-frame-resource-needs-coep-header
  • coop-sandboxed-iframe-cannot-navigate-to-coop-page
  • corp-not-same-origin
  • corp-not-same-origin-after-defaulted-to-same-origin-by-coep
  • corp-not-same-origin-after-defaulted-to-same-origin-by-dip
  • corp-not-same-origin-after-defaulted-to-same-origin-by-coep-and-dip
  • corp-not-same-site
  • sri-message-signature-mismatch

CorsError

(string)

The reason why request was blocked.

Allowed Values
  • DisallowedByMode
  • InvalidResponse
  • WildcardOriginNotAllowed
  • MissingAllowOriginHeader
  • MultipleAllowOriginValues
  • InvalidAllowOriginValue
  • AllowOriginMismatch
  • InvalidAllowCredentials
  • CorsDisabledScheme
  • PreflightInvalidStatus
  • PreflightDisallowedRedirect
  • PreflightWildcardOriginNotAllowed
  • PreflightMissingAllowOriginHeader
  • PreflightMultipleAllowOriginValues
  • PreflightInvalidAllowOriginValue
  • PreflightAllowOriginMismatch
  • PreflightInvalidAllowCredentials
  • PreflightMissingAllowExternal
  • PreflightInvalidAllowExternal
  • InvalidAllowMethodsPreflightResponse
  • InvalidAllowHeadersPreflightResponse
  • MethodDisallowedByPreflightResponse
  • HeaderDisallowedByPreflightResponse
  • RedirectContainsCredentials
  • InsecureLocalNetwork
  • InvalidLocalNetworkAccess
  • NoCorsRedirectModeNotFollow
  • LocalNetworkAccessPermissionDenied

CorsErrorStatus

(object)
Properties
Name Type Description
corsError CorsError
failedParameter string

ServiceWorkerResponseSource

(string)

Source of serviceworker response.

Allowed Values
  • cache-storage
  • http-cache
  • fallback-code
  • network

TrustTokenParams

(object) Experimental

Determines what type of Trust Token operation is executed and
depending on the type, some additional parameters. The values
are specified in third_party/blink/renderer/core/fetch/trust_token.idl.

Properties
Name Type Description
operation TrustTokenOperationType
refreshPolicy string Only set for "token-redemption" operation and determine whether
to request a fresh SRR or use a still valid cached SRR.
issuers (optional) array<string> Origins of issuers from whom to request tokens or redemption
records.

TrustTokenOperationType

(string) Experimental
Allowed Values
  • Issuance
  • Redemption
  • Signing

AlternateProtocolUsage

(string) Experimental

The reason why Chrome uses a specific transport protocol for HTTP semantics.

Allowed Values
  • alternativeJobWonWithoutRace
  • alternativeJobWonRace
  • mainJobWonRace
  • mappingMissing
  • broken
  • dnsAlpnH3JobWonWithoutRace
  • dnsAlpnH3JobWonRace
  • unspecifiedReason

ServiceWorkerRouterSource

(string)

Source of service worker router.

Allowed Values
  • network
  • cache
  • fetch-event
  • race-network-and-fetch-handler
  • race-network-and-cache

ServiceWorkerRouterInfo

(object) Experimental
Properties
Name Type Description
ruleIdMatched (optional) integer ID of the rule matched. If there is a matched rule, this field will
be set, otherwiser no value will be set.
matchedSourceType (optional) ServiceWorkerRouterSource The router source of the matched rule. If there is a matched rule, this
field will be set, otherwise no value will be set.
actualSourceType (optional) ServiceWorkerRouterSource The actual router source used.

Response

(object)

HTTP response data.

Properties
Name Type Description
url string Response URL. This URL can be different from CachedResource.url in case of redirect.
status integer HTTP response status code.
statusText string HTTP response status text.
headers Headers HTTP response headers.
headersText (optional) Deprecated string HTTP response headers text. This has been replaced by the headers in Network.responseReceivedExtraInfo.
mimeType string Resource mimeType as determined by the browser.
charset string Resource charset as determined by the browser (if applicable).
requestHeaders (optional) Headers Refined HTTP request headers that were actually transmitted over the network.
requestHeadersText (optional) Deprecated string HTTP request headers text. This has been replaced by the headers in Network.requestWillBeSentExtraInfo.
connectionReused boolean Specifies whether physical connection was actually reused for this request.
connectionId number Physical connection id that was actually used for this request.
remoteIPAddress (optional) string Remote IP address.
remotePort (optional) integer Remote port.
fromDiskCache (optional) boolean Specifies that the request was served from the disk cache.
fromServiceWorker (optional) boolean Specifies that the request was served from the ServiceWorker.
fromPrefetchCache (optional) boolean Specifies that the request was served from the prefetch cache.
fromEarlyHints (optional) boolean Specifies that the request was served from the prefetch cache.
serviceWorkerRouterInfo (optional) Experimental ServiceWorkerRouterInfo Information about how ServiceWorker Static Router API was used. If this
field is set with `matchedSourceType` field, a matching rule is found.
If this field is set without `matchedSource`, no matching rule is found.
Otherwise, the API is not used.
encodedDataLength number Total number of bytes received for this request so far.
timing (optional) ResourceTiming Timing information for the given request.
serviceWorkerResponseSource (optional) ServiceWorkerResponseSource Response source of response from ServiceWorker.
responseTime (optional) TimeSinceEpoch The time at which the returned response was generated.
cacheStorageCacheName (optional) string Cache Storage Cache Name.
protocol (optional) string Protocol used to fetch this request.
alternateProtocolUsage (optional) Experimental AlternateProtocolUsage The reason why Chrome uses a specific transport protocol for HTTP semantics.
securityState Security.SecurityState Security state of the request resource.
securityDetails (optional) SecurityDetails Security details for the request.

WebSocketRequest

(object)

WebSocket request data.

Properties
Name Type Description
headers Headers HTTP request headers.

WebSocketResponse

(object)

WebSocket response data.

Properties
Name Type Description
status integer HTTP response status code.
statusText string HTTP response status text.
headers Headers HTTP response headers.
headersText (optional) string HTTP response headers text.
requestHeaders (optional) Headers HTTP request headers.
requestHeadersText (optional) string HTTP request headers text.

WebSocketFrame

(object)

WebSocket message data. This represents an entire WebSocket message, not just a fragmented frame as the name suggests.

Properties
Name Type Description
opcode number WebSocket message opcode.
mask boolean WebSocket message mask.
payloadData string WebSocket message payload data.
If the opcode is 1, this is a text message and payloadData is a UTF-8 string.
If the opcode isn't 1, then payloadData is a base64 encoded string representing binary data.

CachedResource

(object)

Information about the cached resource.

Properties
Name Type Description
url string Resource URL. This is the url of the original network request.
type ResourceType Type of this resource.
response (optional) Response Cached response data.
bodySize number Cached response body size.

Initiator

(object)

Information about the request initiator.

Properties
Name Type Description
type string Type of this initiator.
stack (optional) Runtime.StackTrace Initiator JavaScript stack trace, set for Script only.
Requires the Debugger domain to be enabled.
url (optional) string Initiator URL, set for Parser type or for Script type (when script is importing module) or for SignedExchange type.
lineNumber (optional) number Initiator line number, set for Parser type or for Script type (when script is importing
module) (0-based).
columnNumber (optional) number Initiator column number, set for Parser type or for Script type (when script is importing
module) (0-based).
requestId (optional) RequestId Set if another request triggered this request (e.g. preflight).

CookiePartitionKey

(object) Experimental

cookiePartitionKey object
The representation of the components of the key that are created by the cookiePartitionKey class contained in net/cookies/cookie_partition_key.h.

Properties
Name Type Description
topLevelSite string The site of the top-level URL the browser was visiting at the start
of the request to the endpoint that set the cookie.
hasCrossSiteAncestor boolean Indicates if the cookie has any ancestors that are cross-site to the topLevelSite.

SetCookieBlockedReason

(string) Experimental

Types of reasons why a cookie may not be stored from a response.

Allowed Values
  • SecureOnly
  • SameSiteStrict
  • SameSiteLax
  • SameSiteUnspecifiedTreatedAsLax
  • SameSiteNoneInsecure
  • UserPreferences
  • ThirdPartyPhaseout
  • ThirdPartyBlockedInFirstPartySet
  • SyntaxError
  • SchemeNotSupported
  • OverwriteSecure
  • InvalidDomain
  • InvalidPrefix
  • UnknownError
  • SchemefulSameSiteStrict
  • SchemefulSameSiteLax
  • SchemefulSameSiteUnspecifiedTreatedAsLax
  • NameValuePairExceedsMaxSize
  • DisallowedCharacter
  • NoCookieContent

CookieBlockedReason

(string) Experimental

Types of reasons why a cookie may not be sent with a request.

Allowed Values
  • SecureOnly
  • NotOnPath
  • DomainMismatch
  • SameSiteStrict
  • SameSiteLax
  • SameSiteUnspecifiedTreatedAsLax
  • SameSiteNoneInsecure
  • UserPreferences
  • ThirdPartyPhaseout
  • ThirdPartyBlockedInFirstPartySet
  • UnknownError
  • SchemefulSameSiteStrict
  • SchemefulSameSiteLax
  • SchemefulSameSiteUnspecifiedTreatedAsLax
  • NameValuePairExceedsMaxSize
  • PortMismatch
  • SchemeMismatch
  • AnonymousContext

CookieExemptionReason

(string) Experimental

Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.

Allowed Values
  • None
  • UserSetting
  • TPCDMetadata
  • TPCDDeprecationTrial
  • TopLevelTPCDDeprecationTrial
  • TPCDHeuristics
  • EnterprisePolicy
  • StorageAccess
  • TopLevelStorageAccess
  • Scheme
  • SameSiteNoneCookiesInSandbox

BlockedSetCookieWithReason

(object) Experimental

A cookie which was not stored from a response with the corresponding reason.

Properties
Name Type Description
blockedReasons array<SetCookieBlockedReason> The reason(s) this cookie was blocked.
cookieLine string The string representing this individual cookie as it would appear in the header.
This is not the entire "cookie" or "set-cookie" header which could have multiple cookies.
cookie (optional) Cookie The cookie object which represents the cookie which was not stored. It is optional because
sometimes complete cookie information is not available, such as in the case of parsing
errors.

ExemptedSetCookieWithReason

(object) Experimental

A cookie should have been blocked by 3PCD but is exempted and stored from a response with the
corresponding reason. A cookie could only have at most one exemption reason.

Properties
Name Type Description
exemptionReason CookieExemptionReason The reason the cookie was exempted.
cookieLine string The string representing this individual cookie as it would appear in the header.
cookie Cookie The cookie object representing the cookie.

AssociatedCookie

(object) Experimental

A cookie associated with the request which may or may not be sent with it.
Includes the cookies itself and reasons for blocking or exemption.

Properties
Name Type Description
cookie Cookie The cookie object representing the cookie which was not sent.
blockedReasons array<CookieBlockedReason> The reason(s) the cookie was blocked. If empty means the cookie is included.
exemptionReason (optional) CookieExemptionReason The reason the cookie should have been blocked by 3PCD but is exempted. A cookie could
only have at most one exemption reason.

CookieParam

(object)

Cookie parameter object

Properties
Name Type Description
name string Cookie name.
value string Cookie value.
url (optional) string The request-URI to associate with the setting of the cookie. This value can affect the
default domain, path, source port, and source scheme values of the created cookie.
domain (optional) string Cookie domain.
path (optional) string Cookie path.
secure (optional) boolean True if cookie is secure.
httpOnly (optional) boolean True if cookie is http-only.
sameSite (optional) CookieSameSite Cookie SameSite type.
expires (optional) TimeSinceEpoch Cookie expiration date, session cookie if not set
priority (optional) Experimental CookiePriority Cookie Priority.
sourceScheme (optional) Experimental CookieSourceScheme Cookie source scheme type.
sourcePort (optional) Experimental integer Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
This is a temporary ability and it will be removed in the future.
partitionKey (optional) Experimental CookiePartitionKey Cookie partition key. If not set, the cookie will be set as not partitioned.

AuthChallenge

(object) Experimental

Authorization challenge for HTTP status code 401 or 407.

Properties
Name Type Description
source (optional) string Source of the authentication challenge.
origin string Origin of the challenger.
scheme string The authentication scheme used, such as basic or digest
realm string The realm of the challenge. May be empty.

AuthChallengeResponse

(object) Experimental

Response to an AuthChallenge.

Properties
Name Type Description
response string The decision on what to do in response to the authorization challenge. Default means
deferring to the default behavior of the net stack, which will likely either the Cancel
authentication or display a popup dialog box.
username (optional) string The username to provide, possibly empty. Should only be set if response is
ProvideCredentials.
password (optional) string The password to provide, possibly empty. Should only be set if response is
ProvideCredentials.

InterceptionStage

(string) Experimental

Stages of the interception to begin intercepting. Request will intercept before the request is
sent. Response will intercept after the response is received.

Allowed Values
  • Request
  • HeadersReceived

RequestPattern

(object) Experimental

Request pattern for interception.

Properties
Name Type Description
urlPattern (optional) string Wildcards (`'*'` -> zero or more, `'?'` -> exactly one) are allowed. Escape character is
backslash. Omitting is equivalent to `"*"`.
resourceType (optional) ResourceType If set, only requests for matching resource types will be intercepted.
interceptionStage (optional) InterceptionStage Stage at which to begin intercepting requests. Default is Request.

SignedExchangeSignature

(object) Experimental

Information about a signed exchange signature.
https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#rfc.section.3.1

Properties
Name Type Description
label string Signed exchange signature label.
signature string The hex string of signed exchange signature.
integrity string Signed exchange signature integrity.
certUrl (optional) string Signed exchange signature cert Url.
certSha256 (optional) string The hex string of signed exchange signature cert sha256.
validityUrl string Signed exchange signature validity Url.
date integer Signed exchange signature date.
expires integer Signed exchange signature expires.
certificates (optional) array<string> The encoded certificates.

SignedExchangeHeader

(object) Experimental

Information about a signed exchange header.
https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#cbor-representation

Properties
Name Type Description
requestUrl string Signed exchange request URL.
responseCode integer Signed exchange response code.
responseHeaders Headers Signed exchange response headers.
signatures array<SignedExchangeSignature> Signed exchange response signature.
headerIntegrity string Signed exchange header integrity hash in the form of `sha256-<base64-hash-value>`.

SignedExchangeErrorField

(string) Experimental

Field type for a signed exchange related error.

Allowed Values
  • signatureSig
  • signatureIntegrity
  • signatureCertUrl
  • signatureCertSha256
  • signatureValidityUrl
  • signatureTimestamps

SignedExchangeError

(object) Experimental

Information about a signed exchange response.

Properties
Name Type Description
message string Error message.
signatureIndex (optional) integer The index of the signature which caused the error.
errorField (optional) SignedExchangeErrorField The field which caused the error.

SignedExchangeInfo

(object) Experimental

Information about a signed exchange response.

Properties
Name Type Description
outerResponse Response The outer response of signed HTTP exchange which was received from network.
hasExtraInfo boolean Whether network response for the signed exchange was accompanied by
extra headers.
header (optional) SignedExchangeHeader Information about the signed exchange header.
securityDetails (optional) SecurityDetails Security details for the signed exchange header.
errors (optional) array<SignedExchangeError> Errors occurred while handling the signed exchange.

ContentEncoding

(string) Experimental

List of content encodings supported by the backend.

Allowed Values
  • deflate
  • gzip
  • br
  • zstd

NetworkConditions

(object) Experimental
Properties
Name Type Description
urlPattern string Only matching requests will be affected by these conditions. Patterns use the URLPattern constructor string
syntax (https://urlpattern.spec.whatwg.org/) and must be absolute. If the pattern is empty, all requests are
matched (including p2p connections).
latency number Minimum latency from request sent to response headers received (ms).
downloadThroughput number Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
uploadThroughput number Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.
connectionType (optional) ConnectionType Connection type if known.
packetLoss (optional) number WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.
packetQueueLength (optional) integer WebRTC packet queue length (packet). 0 removes any queue length limitations.
packetReordering (optional) boolean WebRTC packetReordering feature.

BlockPattern

(object) Experimental
Properties
Name Type Description
urlPattern string URL pattern to match. Patterns use the URLPattern constructor string syntax
(https://urlpattern.spec.whatwg.org/) and must be absolute. Example: `*://*:*/*.css`.
block boolean Whether or not to block the pattern. If false, a matching request will not be blocked even if it matches a later
`BlockPattern`.

DirectSocketDnsQueryType

(string) Experimental
Allowed Values
  • ipv4
  • ipv6

DirectTCPSocketOptions

(object) Experimental
Properties
Name Type Description
noDelay boolean TCP_NODELAY option
keepAliveDelay (optional) number Expected to be unsigned integer.
sendBufferSize (optional) number Expected to be unsigned integer.
receiveBufferSize (optional) number Expected to be unsigned integer.
dnsQueryType (optional) DirectSocketDnsQueryType

DirectUDPSocketOptions

(object) Experimental
Properties
Name Type Description
remoteAddr (optional) string
remotePort (optional) integer Unsigned int 16.
localAddr (optional) string
localPort (optional) integer Unsigned int 16.
dnsQueryType (optional) DirectSocketDnsQueryType
sendBufferSize (optional) number Expected to be unsigned integer.
receiveBufferSize (optional) number Expected to be unsigned integer.
multicastLoopback (optional) boolean
multicastTimeToLive (optional) integer Unsigned int 8.
multicastAllowAddressSharing (optional) boolean

DirectUDPMessage

(object) Experimental
Properties
Name Type Description
data binary
remoteAddr (optional) string Null for connected mode.
remotePort (optional) integer Null for connected mode.
Expected to be unsigned integer.

LocalNetworkAccessRequestPolicy

(string) Experimental
Allowed Values
  • Allow
  • BlockFromInsecureToMorePrivate
  • WarnFromInsecureToMorePrivate
  • PermissionBlock
  • PermissionWarn

IPAddressSpace

(string) Experimental
Allowed Values
  • Loopback
  • Local
  • Public
  • Unknown

ConnectTiming

(object) Experimental
Properties
Name Type Description
requestTime number Timing's requestTime is a baseline in seconds, while the other numbers are ticks in
milliseconds relatively to this requestTime. Matches ResourceTiming's requestTime for
the same request (but not for redirected requests).

ClientSecurityState

(object) Experimental
Properties
Name Type Description
initiatorIsSecureContext boolean
initiatorIPAddressSpace IPAddressSpace
localNetworkAccessRequestPolicy LocalNetworkAccessRequestPolicy

CrossOriginOpenerPolicyValue

(string) Experimental
Allowed Values
  • SameOrigin
  • SameOriginAllowPopups
  • RestrictProperties
  • UnsafeNone
  • SameOriginPlusCoep
  • RestrictPropertiesPlusCoep
  • NoopenerAllowPopups

CrossOriginOpenerPolicyStatus

(object) Experimental
Properties
Name Type Description
value CrossOriginOpenerPolicyValue
reportOnlyValue CrossOriginOpenerPolicyValue
reportingEndpoint (optional) string
reportOnlyReportingEndpoint (optional) string

CrossOriginEmbedderPolicyValue

(string) Experimental
Allowed Values
  • None
  • Credentialless
  • RequireCorp

CrossOriginEmbedderPolicyStatus

(object) Experimental
Properties
Name Type Description
value CrossOriginEmbedderPolicyValue
reportOnlyValue CrossOriginEmbedderPolicyValue
reportingEndpoint (optional) string
reportOnlyReportingEndpoint (optional) string

ContentSecurityPolicySource

(string) Experimental
Allowed Values
  • HTTP
  • Meta

ContentSecurityPolicyStatus

(object) Experimental
Properties
Name Type Description
effectiveDirectives string
isEnforced boolean
source ContentSecurityPolicySource

SecurityIsolationStatus

(object) Experimental
Properties
Name Type Description
coop (optional) CrossOriginOpenerPolicyStatus
coep (optional) CrossOriginEmbedderPolicyStatus
csp (optional) array<ContentSecurityPolicyStatus>

ReportStatus

(string) Experimental

The status of a Reporting API report.

Allowed Values
  • Queued
  • Pending
  • MarkedForRemoval
  • Success

ReportId

(string) Experimental

ReportingApiReport

(object) Experimental

An object representing a report generated by the Reporting API.

Properties
Name Type Description
id ReportId
initiatorUrl string The URL of the document that triggered the report.
destination string The name of the endpoint group that should be used to deliver the report.
type string The type of the report (specifies the set of data that is contained in the report body).
timestamp Network.TimeSinceEpoch When the report was generated.
depth integer How many uploads deep the related request was.
completedAttempts integer The number of delivery attempts made so far, not including an active attempt.
body object
status ReportStatus

ReportingApiEndpoint

(object) Experimental
Properties
Name Type Description
url string The URL of the endpoint to which reports may be delivered.
groupName string Name of the endpoint group.

DeviceBoundSessionKey

(object) Experimental

Unique identifier for a device bound session.

Properties
Name Type Description
site string The site the session is set up for.
id string The id of the session.

DeviceBoundSessionWithUsage

(object) Experimental

How a device bound session was used during a request.

Properties
Name Type Description
sessionKey DeviceBoundSessionKey The key for the session.
usage string How the session was used (or not used).

DeviceBoundSessionCookieCraving

(object) Experimental

A device bound session's cookie craving.

Properties
Name Type Description
name string The name of the craving.
domain string The domain of the craving.
path string The path of the craving.
secure boolean The `Secure` attribute of the craving attributes.
httpOnly boolean The `HttpOnly` attribute of the craving attributes.
sameSite (optional) CookieSameSite The `SameSite` attribute of the craving attributes.

DeviceBoundSessionUrlRule

(object) Experimental

A device bound session's inclusion URL rule.

Properties
Name Type Description
ruleType string See comments on `net::device_bound_sessions::SessionInclusionRules::UrlRule::rule_type`.
hostPattern string See comments on `net::device_bound_sessions::SessionInclusionRules::UrlRule::host_pattern`.
pathPrefix string See comments on `net::device_bound_sessions::SessionInclusionRules::UrlRule::path_prefix`.

DeviceBoundSessionInclusionRules

(object) Experimental

A device bound session's inclusion rules.

Properties
Name Type Description
origin string See comments on `net::device_bound_sessions::SessionInclusionRules::origin_`.
includeSite boolean Whether the whole site is included. See comments on
`net::device_bound_sessions::SessionInclusionRules::include_site_` for more
details; this boolean is true if that value is populated.
urlRules array<DeviceBoundSessionUrlRule> See comments on `net::device_bound_sessions::SessionInclusionRules::url_rules_`.

DeviceBoundSession

(object) Experimental

A device bound session.

Properties
Name Type Description
key DeviceBoundSessionKey The site and session ID of the session.
refreshUrl string See comments on `net::device_bound_sessions::Session::refresh_url_`.
inclusionRules DeviceBoundSessionInclusionRules See comments on `net::device_bound_sessions::Session::inclusion_rules_`.
cookieCravings array<DeviceBoundSessionCookieCraving> See comments on `net::device_bound_sessions::Session::cookie_cravings_`.
expiryDate Network.TimeSinceEpoch See comments on `net::device_bound_sessions::Session::expiry_date_`.
cachedChallenge (optional) string See comments on `net::device_bound_sessions::Session::cached_challenge__`.
allowedRefreshInitiators array<string> See comments on `net::device_bound_sessions::Session::allowed_refresh_initiators_`.

DeviceBoundSessionEventId

(string) Experimental

A unique identifier for a device bound session event.

DeviceBoundSessionFetchResult

(string) Experimental

A fetch result for a device bound session creation or refresh.

Allowed Values
  • Success
  • KeyError
  • SigningError
  • ServerRequestedTermination
  • InvalidSessionId
  • InvalidChallenge
  • TooManyChallenges
  • InvalidFetcherUrl
  • InvalidRefreshUrl
  • TransientHttpError
  • ScopeOriginSameSiteMismatch
  • RefreshUrlSameSiteMismatch
  • MismatchedSessionId
  • MissingScope
  • NoCredentials
  • SubdomainRegistrationWellKnownUnavailable
  • SubdomainRegistrationUnauthorized
  • SubdomainRegistrationWellKnownMalformed
  • SessionProviderWellKnownUnavailable
  • RelyingPartyWellKnownUnavailable
  • FederatedKeyThumbprintMismatch
  • InvalidFederatedSessionUrl
  • InvalidFederatedKey
  • TooManyRelyingOriginLabels
  • BoundCookieSetForbidden
  • NetError
  • ProxyError
  • EmptySessionConfig
  • InvalidCredentialsConfig
  • InvalidCredentialsType
  • InvalidCredentialsEmptyName
  • InvalidCredentialsCookie
  • PersistentHttpError
  • RegistrationAttemptedChallenge
  • InvalidScopeOrigin
  • ScopeOriginContainsPath
  • RefreshInitiatorNotString
  • RefreshInitiatorInvalidHostPattern
  • InvalidScopeSpecification
  • MissingScopeSpecificationType
  • EmptyScopeSpecificationDomain
  • EmptyScopeSpecificationPath
  • InvalidScopeSpecificationType
  • InvalidScopeIncludeSite
  • MissingScopeIncludeSite
  • FederatedNotAuthorizedByProvider
  • FederatedNotAuthorizedByRelyingParty
  • SessionProviderWellKnownMalformed
  • SessionProviderWellKnownHasProviderOrigin
  • RelyingPartyWellKnownMalformed
  • RelyingPartyWellKnownHasRelyingOrigins
  • InvalidFederatedSessionProviderSessionMissing
  • InvalidFederatedSessionWrongProviderOrigin
  • InvalidCredentialsCookieCreationTime
  • InvalidCredentialsCookieName
  • InvalidCredentialsCookieParsing
  • InvalidCredentialsCookieUnpermittedAttribute
  • InvalidCredentialsCookieInvalidDomain
  • InvalidCredentialsCookiePrefix
  • InvalidScopeRulePath
  • InvalidScopeRuleHostPattern
  • ScopeRuleOriginScopedHostPatternMismatch
  • ScopeRuleSiteScopedHostPatternMismatch
  • SigningQuotaExceeded
  • InvalidConfigJson
  • InvalidFederatedSessionProviderFailedToRestoreKey
  • FailedToUnwrapKey
  • SessionDeletedDuringRefresh

DeviceBoundSessionFailedRequest

(object) Experimental

Details about a failed device bound session network request.

Properties
Name Type Description
requestUrl string The failed request URL.
netError (optional) string The net error of the response if it was not OK.
responseError (optional) integer The response code if the net error was OK and the response code was not
200.
responseErrorBody (optional) string The body of the response if the net error was OK, the response code was
not 200, and the response body was not empty.

CreationEventDetails

(object) Experimental

Session event details specific to creation.

Properties
Name Type Description
fetchResult DeviceBoundSessionFetchResult The result of the fetch attempt.
newSession (optional) DeviceBoundSession The session if there was a newly created session. This is populated for
all successful creation events.
failedRequest (optional) DeviceBoundSessionFailedRequest Details about a failed device bound session network request if there was
one.

RefreshEventDetails

(object) Experimental

Session event details specific to refresh.

Properties
Name Type Description
refreshResult string The result of a refresh.
fetchResult (optional) DeviceBoundSessionFetchResult If there was a fetch attempt, the result of that.
newSession (optional) DeviceBoundSession The session display if there was a newly created session. This is populated
for any refresh event that modifies the session config.
wasFullyProactiveRefresh boolean See comments on `net::device_bound_sessions::RefreshEventResult::was_fully_proactive_refresh`.
failedRequest (optional) DeviceBoundSessionFailedRequest Details about a failed device bound session network request if there was
one.

TerminationEventDetails

(object) Experimental

Session event details specific to termination.

Properties
Name Type Description
deletionReason string The reason for a session being deleted.

ChallengeEventDetails

(object) Experimental

Session event details specific to challenges.

Properties
Name Type Description
challengeResult string The result of a challenge.
challenge string The challenge set.

LoadNetworkResourcePageResult

(object) Experimental

An object providing the result of a network resource load.

Properties
Name Type Description
success boolean
netError (optional) number Optional values used for error reporting.
netErrorName (optional) string
httpStatusCode (optional) number
stream (optional) IO.StreamHandle If successful, one of the following two fields holds the result.
headers (optional) Network.Headers Response headers.

LoadNetworkResourceOptions

(object) Experimental

An options object that may be extended later to better support CORS,
CORB and streaming.

Properties
Name Type Description
disableCache boolean
includeCredentials boolean

DnsEntry

(object) Experimental

A DNS resolution entry with IP type and address.

Properties
Name Type Description
type string "ipv4" or "ipv6"
ip string IP address

ResolvedDNSHost

(object) Experimental

A hostname with its resolved DNS entries.

Properties
Name Type Description
hostname string
entries array<DnsEntry>

Summary