# Scrapfly Documentation ## Table of Contents ### Dashboard - [Intro](https://scrapfly.io/docs) - [Project](https://scrapfly.io/docs/project) - [Account](https://scrapfly.io/docs/account) - [Workspace & Team](https://scrapfly.io/docs/workspace-and-team) - [Billing](https://scrapfly.io/docs/billing) ### Products #### MCP Server - [Getting Started](https://scrapfly.io/docs/mcp/getting-started) - [Tools & API Spec](https://scrapfly.io/docs/mcp/tools) - [Authentication](https://scrapfly.io/docs/mcp/authentication) - [Examples & Use Cases](https://scrapfly.io/docs/mcp/examples) - [FAQ](https://scrapfly.io/docs/mcp/faq) ##### Integrations - [Overview](https://scrapfly.io/docs/mcp/integrations) - [Claude Desktop](https://scrapfly.io/docs/mcp/integrations/claude-desktop) - [Claude Code](https://scrapfly.io/docs/mcp/integrations/claude-code) - [ChatGPT](https://scrapfly.io/docs/mcp/integrations/chatgpt) - [Cursor](https://scrapfly.io/docs/mcp/integrations/cursor) - [Cline](https://scrapfly.io/docs/mcp/integrations/cline) - [Windsurf](https://scrapfly.io/docs/mcp/integrations/windsurf) - [Zed](https://scrapfly.io/docs/mcp/integrations/zed) - [Roo Code](https://scrapfly.io/docs/mcp/integrations/roo-code) - [VS Code](https://scrapfly.io/docs/mcp/integrations/vscode) - [LangChain](https://scrapfly.io/docs/mcp/integrations/langchain) - [LlamaIndex](https://scrapfly.io/docs/mcp/integrations/llamaindex) - [CrewAI](https://scrapfly.io/docs/mcp/integrations/crewai) - [OpenAI](https://scrapfly.io/docs/mcp/integrations/openai) - [n8n](https://scrapfly.io/docs/mcp/integrations/n8n) - [Make](https://scrapfly.io/docs/mcp/integrations/make) - [Zapier](https://scrapfly.io/docs/mcp/integrations/zapier) - [Vapi AI](https://scrapfly.io/docs/mcp/integrations/vapi) - [Agent Builder](https://scrapfly.io/docs/mcp/integrations/agent-builder) - [Custom Client](https://scrapfly.io/docs/mcp/integrations/custom-client) #### Web Scraping API - [Getting Started](https://scrapfly.io/docs/scrape-api/getting-started) - [API Specification]() - [Monitoring](https://scrapfly.io/docs/monitoring) - [Customize Request](https://scrapfly.io/docs/scrape-api/custom) - [Debug](https://scrapfly.io/docs/scrape-api/debug) - [Anti Scraping Protection](https://scrapfly.io/docs/scrape-api/anti-scraping-protection) - [Proxy](https://scrapfly.io/docs/scrape-api/proxy) - [Proxy Mode](https://scrapfly.io/docs/scrape-api/proxy-mode) - [Proxy Mode - Screaming Frog](https://scrapfly.io/docs/scrape-api/proxy-mode/screaming-frog) - [Proxy Mode - Apify](https://scrapfly.io/docs/scrape-api/proxy-mode/apify) - [(Auto) Data Extraction](https://scrapfly.io/docs/scrape-api/extraction) - [Javascript Rendering](https://scrapfly.io/docs/scrape-api/javascript-rendering) - [Javascript Scenario](https://scrapfly.io/docs/scrape-api/javascript-scenario) - [SSL](https://scrapfly.io/docs/scrape-api/ssl) - [DNS](https://scrapfly.io/docs/scrape-api/dns) - [Cache](https://scrapfly.io/docs/scrape-api/cache) - [Session](https://scrapfly.io/docs/scrape-api/session) - [Webhook](https://scrapfly.io/docs/scrape-api/webhook) - [Screenshot](https://scrapfly.io/docs/scrape-api/screenshot) - [Errors](https://scrapfly.io/docs/scrape-api/errors) - [Timeout](https://scrapfly.io/docs/scrape-api/understand-timeout) - [Throttling](https://scrapfly.io/docs/throttling) - [Troubleshoot](https://scrapfly.io/docs/scrape-api/troubleshoot) - [Billing](https://scrapfly.io/docs/scrape-api/billing) - [FAQ](https://scrapfly.io/docs/scrape-api/faq) #### Crawler API - [Getting Started](https://scrapfly.io/docs/crawler-api/getting-started) - [API Specification]() - [Retrieving Results](https://scrapfly.io/docs/crawler-api/results) - [WARC Format](https://scrapfly.io/docs/crawler-api/warc-format) - [Data Extraction](https://scrapfly.io/docs/crawler-api/extraction-rules) - [Webhook](https://scrapfly.io/docs/crawler-api/webhook) - [Billing](https://scrapfly.io/docs/crawler-api/billing) - [Errors](https://scrapfly.io/docs/crawler-api/errors) - [Troubleshoot](https://scrapfly.io/docs/crawler-api/troubleshoot) - [FAQ](https://scrapfly.io/docs/crawler-api/faq) #### Screenshot API - [Getting Started](https://scrapfly.io/docs/screenshot-api/getting-started) - [API Specification]() - [Accessibility Testing](https://scrapfly.io/docs/screenshot-api/accessibility) - [Webhook](https://scrapfly.io/docs/screenshot-api/webhook) - [Billing](https://scrapfly.io/docs/screenshot-api/billing) - [Errors](https://scrapfly.io/docs/screenshot-api/errors) #### Extraction API - [Getting Started](https://scrapfly.io/docs/extraction-api/getting-started) - [API Specification]() - [Rules Template](https://scrapfly.io/docs/extraction-api/rules-and-template) - [LLM Extraction](https://scrapfly.io/docs/extraction-api/llm-prompt) - [AI Auto Extraction](https://scrapfly.io/docs/extraction-api/automatic-ai) - [Webhook](https://scrapfly.io/docs/extraction-api/webhook) - [Billing](https://scrapfly.io/docs/extraction-api/billing) - [Errors](https://scrapfly.io/docs/extraction-api/errors) - [FAQ](https://scrapfly.io/docs/extraction-api/faq) #### Proxy Saver - [Getting Started](https://scrapfly.io/docs/proxy-saver/getting-started) - [Fingerprints](https://scrapfly.io/docs/proxy-saver/fingerprints) - [Optimizations](https://scrapfly.io/docs/proxy-saver/optimizations) - [SSL Certificates](https://scrapfly.io/docs/proxy-saver/certificates) - [Protocols](https://scrapfly.io/docs/proxy-saver/protocols) - [Pacfile](https://scrapfly.io/docs/proxy-saver/pacfile) - [Secure Credentials](https://scrapfly.io/docs/proxy-saver/security) - [Billing](https://scrapfly.io/docs/proxy-saver/billing) #### Cloud Browser API - [Getting Started](https://scrapfly.io/docs/cloud-browser-api/getting-started) - [Proxy & Geo-Targeting](https://scrapfly.io/docs/cloud-browser-api/proxy) - [Unblock API](https://scrapfly.io/docs/cloud-browser-api/unblock) - [File Downloads](https://scrapfly.io/docs/cloud-browser-api/file-downloads) - [Session Resume](https://scrapfly.io/docs/cloud-browser-api/session-resume) - [Human-in-the-Loop](https://scrapfly.io/docs/cloud-browser-api/human-in-the-loop) - [Debug Mode](https://scrapfly.io/docs/cloud-browser-api/debug-mode) - [Bring Your Own Proxy](https://scrapfly.io/docs/cloud-browser-api/bring-your-own-proxy) - [Browser Extensions](https://scrapfly.io/docs/cloud-browser-api/extensions) - [Native Browser MCP](https://scrapfly.io/docs/cloud-browser-api/mcp) - [DevTools Protocol](https://scrapfly.io/docs/cloud-browser-api/cdp-reference) ##### Integrations - [Puppeteer](https://scrapfly.io/docs/cloud-browser-api/puppeteer) - [Playwright](https://scrapfly.io/docs/cloud-browser-api/playwright) - [Selenium](https://scrapfly.io/docs/cloud-browser-api/selenium) - [Vercel Agent Browser](https://scrapfly.io/docs/cloud-browser-api/agent-browser) - [Browser Use](https://scrapfly.io/docs/cloud-browser-api/browser-use) - [Stagehand](https://scrapfly.io/docs/cloud-browser-api/stagehand) - [Billing](https://scrapfly.io/docs/cloud-browser-api/billing) - [Errors](https://scrapfly.io/docs/cloud-browser-api/errors) ### Tools - [Antibot Detector](https://scrapfly.io/docs/tools/antibot-detector) ### SDK - [Golang](https://scrapfly.io/docs/sdk/golang) - [Python](https://scrapfly.io/docs/sdk/python) - [Rust](https://scrapfly.io/docs/sdk/rust) - [TypeScript](https://scrapfly.io/docs/sdk/typescript) - [Scrapy](https://scrapfly.io/docs/sdk/scrapy) ### Integrations - [Getting Started](https://scrapfly.io/docs/integration/getting-started) - [LangChain](https://scrapfly.io/docs/integration/langchain) - [LlamaIndex](https://scrapfly.io/docs/integration/llamaindex) - [CrewAI](https://scrapfly.io/docs/integration/crewai) - [Zapier](https://scrapfly.io/docs/integration/zapier) - [Make](https://scrapfly.io/docs/integration/make) - [n8n](https://scrapfly.io/docs/integration/n8n) ### Academy - [Overview](https://scrapfly.io/academy) - [Web Scraping Overview](https://scrapfly.io/academy/scraping-overview) - [Tools](https://scrapfly.io/academy/tools-overview) - [Reverse Engineering](https://scrapfly.io/academy/reverse-engineering) - [Static Scraping](https://scrapfly.io/academy/static-scraping) - [HTML Parsing](https://scrapfly.io/academy/html-parsing) - [Dynamic Scraping](https://scrapfly.io/academy/dynamic-scraping) - [Hidden API Scraping](https://scrapfly.io/academy/hidden-api-scraping) - [Headless Browsers](https://scrapfly.io/academy/headless-browsers) - [Hidden Web Data](https://scrapfly.io/academy/hidden-web-data) - [JSON Parsing](https://scrapfly.io/academy/json-parsing) - [Data Processing](https://scrapfly.io/academy/data-processing) - [Scaling](https://scrapfly.io/academy/scaling) - [Walkthrough Summary](https://scrapfly.io/academy/walkthrough-summary) - [Scraper Blocking](https://scrapfly.io/academy/scraper-blocking) - [Proxies](https://scrapfly.io/academy/proxies) --- 1. [DevTools Protocol](https://scrapfly.io/docs/cloud-browser-api/cdp-reference) 2. Network # 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](https://scrapfly.io/docs/cloud-browser-api/cdp-reference/Debugger), [Runtime](https://scrapfly.io/docs/cloud-browser-api/cdp-reference/Runtime), [Security](https://scrapfly.io/docs/cloud-browser-api/cdp-reference/Security) - [Commands (42)](#commands) - [Events (44)](#events) - [Types (92)](#types) No symbols match your filter. ## 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. | #### `Cookie` (object) Cookie object ###### Properties | Name | Type | Description | |---|---|---| | `name` | `string` | Cookie name. | | `value` | `string` | Cookie value. | | `domain` | `string` | Cookie domain. | | `path` | `string` | Cookie path. | | `expires` | `number` | Cookie expiration date as the number of seconds since the UNIX epoch. The value is set to -1 if the expiry date is not set. The value can be null for values that cannot be represented in JSON (±Inf). | | `size` | `integer` | Cookie size. | | `httpOnly` | `boolean` | True if cookie is http-only. | | `secure` | `boolean` | True if cookie is secure. | | `session` | `boolean` | True in case of session cookie. | | `sameSite` (optional) | `CookieSameSite` | Cookie SameSite type. | | `priority` Experimental | `CookiePriority` | Cookie Priority | | `sourceScheme` Experimental | `CookieSourceScheme` | Cookie source scheme type. | | `sourcePort` 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. | | `partitionKeyOpaque` (optional) Experimental | `boolean` | True if cookie partition key is opaque. | #### `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>` | |