Whenever the page sends a request for a network resource the following sequence of events are emitted by Page:
If request fails at some point, then instead of 'requestfinished' event (and possibly instead of 'response' event), the page.on("requestfailed") event is emitted.
note
HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will complete with 'requestfinished' event.
If request gets a 'redirect' response, the request is successfully finished with the requestfinished event, and a new request is issued to a redirected url.
An object with all the request HTTP headers associated with this request. The header names are lower-cased.
Usage
Returns
Added in: v1.15 request.header_valueReturns the value of the header matching the name. The name is case-insensitive.
Usage
request.header_value(name)
Arguments
Returns
Added in: v1.15 request.headers_arrayAn array with all the request HTTP headers associated with this request. Unlike request.all_headers(), header names are NOT lower-cased. Headers with multiple entries, such as Set-Cookie, appear in the array multiple times.
Usage
Returns
responseAdded before v1.9 request.responseReturns the matching Response object, or null if the response was not received due to error.
Usage
Returns
sizesAdded in: v1.15 request.sizesReturns resource size information for given request.
Usage
Returns
requestBodySize int
Size of the request body (POST data payload) in bytes. Set to 0 if there was no body.
requestHeadersSize int
Total number of bytes from the start of the HTTP request message until (and including) the double CRLF before the body.
responseBodySize int
Size of the received response body (encoded) in bytes.
responseHeadersSize int
Total number of bytes from the start of the HTTP response message until (and including) the double CRLF before the body.
The method returns null unless this request has failed, as reported by requestfailed event.
Usage
Example of logging of all the failed requests:
page.on("requestfailed", lambda request: print(request.url + " " + request.failure))
Returns
frameAdded before v1.9 request.frameReturns the Frame that initiated this request.
Usage
frame_url = request.frame.url
Returns
Details
Note that in some cases the frame is not available, and this method will throw.
request.serviceWorker() to check that.Here is an example that handles all the cases:
Added before v1.9 request.headersAn object with the request HTTP headers. The header names are lower-cased. Note that this method does not return security-related headers, including cookie-related ones. You can use request.all_headers() for complete list of headers that include cookie information.
Usage
Returns
is_navigation_requestAdded before v1.9 request.is_navigation_requestWhether this request is driving frame's navigation.
Some navigation requests are issued before the corresponding frame is created, and therefore do not have request.frame available.
Usage
request.is_navigation_request()
Returns
methodAdded before v1.9 request.methodRequest's method (GET, POST, etc.)
Usage
Returns
post_dataAdded before v1.9 request.post_dataRequest's post body, if any.
Usage
Returns
post_data_bufferAdded before v1.9 request.post_data_bufferRequest's post body in a binary form, if any.
Usage
Returns
post_data_jsonAdded before v1.9 request.post_data_jsonReturns parsed request's body for form-urlencoded and JSON as a fallback if any.
When the response is application/x-www-form-urlencoded then a key/value object of the values will be returned. Otherwise it will be parsed as JSON.
Usage
Returns
redirected_fromAdded before v1.9 request.redirected_fromRequest that was redirected by the server to this one, if any.
When the server responds with a redirect, Playwright creates a new Request object. The two requests are connected by redirectedFrom() and redirectedTo() methods. When multiple server redirects has happened, it is possible to construct the whole redirect chain by repeatedly calling redirectedFrom().
Usage
For example, if the website http://example.com redirects to https://example.com:
response = page.goto("http://example.com")
print(response.request.redirected_from.url)
response = await page.goto("http://example.com")
print(response.request.redirected_from.url)
If the website https://google.com has no redirects:
response = page.goto("https://google.com")
print(response.request.redirected_from)
response = await page.goto("https://google.com")
print(response.request.redirected_from)
Returns
redirected_toAdded before v1.9 request.redirected_toNew request issued by the browser if the server responded with redirect.
Usage
This method is the opposite of request.redirected_from:
assert request.redirected_from.redirected_to == request
Returns
resource_typeAdded before v1.9 request.resource_typeContains the request's resource type as it was perceived by the rendering engine. ResourceType will be one of the following: document, stylesheet, image, media, font, script, texttrack, xhr, fetch, eventsource, websocket, manifest, other.
Usage
Returns
timingAdded before v1.9 request.timingReturns resource timing information for given request. Most of the timing values become available upon the response, responseEnd becomes available when request finishes. Find more information at Resource Timing API.
Usage
with page.expect_event("requestfinished") as request_info:
page.goto("http://example.com")
request = request_info.value
print(request.timing)
async with page.expect_event("requestfinished") as request_info:
await page.goto("http://example.com")
request = await request_info.value
print(request.timing)
Returns
startTime float
Request start time in milliseconds elapsed since January 1, 1970 00:00:00 UTC
domainLookupStart float
Time immediately before the browser starts the domain name lookup for the resource. The value is given in milliseconds relative to startTime, -1 if not available.
domainLookupEnd float
Time immediately after the browser starts the domain name lookup for the resource. The value is given in milliseconds relative to startTime, -1 if not available.
connectStart float
Time immediately before the user agent starts establishing the connection to the server to retrieve the resource. The value is given in milliseconds relative to startTime, -1 if not available.
secureConnectionStart float
Time immediately before the browser starts the handshake process to secure the current connection. The value is given in milliseconds relative to startTime, -1 if not available.
connectEnd float
Time immediately before the user agent starts establishing the connection to the server to retrieve the resource. The value is given in milliseconds relative to startTime, -1 if not available.
requestStart float
Time immediately before the browser starts requesting the resource from the server, cache, or local resource. The value is given in milliseconds relative to startTime, -1 if not available.
responseStart float
Time immediately after the browser receives the first byte of the response from the server, cache, or local resource. The value is given in milliseconds relative to startTime, -1 if not available.
responseEnd float
Time immediately after the browser receives the last byte of the resource or immediately before the transport connection is closed, whichever comes first. The value is given in milliseconds relative to startTime, -1 if not available.
URL of the request.
Usage
Returns
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4