English · Python
Appearance
English · Python
Appearance
Whenever the page sends a request for a network resource the following sequence of events are emitted by Page:
page.on("request") emitted when the request is issued by the page.page.on("response") emitted when/if the response status and headers are received for the request.page.on("requestFinished") emitted when the response body is downloaded and the request is complete.If request fails at some point, then instead of 'requestfinished' event (and possibly instead of 'response' event), the page.on("requestFailed") event is emitted.
INFO
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.
Returns
Object<string, string>Returns the Response object if the response has already been received, null otherwise.
Unlike request.response(), this method does not wait for the response to arrive. It returns immediately with the response object if the response has been received, or null if the response has not been received yet.
Returns
null | ResponseThe 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
null | stringReturns the Frame that initiated this request.
Usage
frame_url = request.frame.urlDetails
Note that in some cases the frame is not available, and this method will throw.
request.serviceWorker() to check that.request.is_navigation_request() to check that.Here is an example that handles all the cases:
Returns
FrameAn 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.
Returns
Object<string, string>An 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.
Returns
Array<Object>Returns the value of the header matching the name. The name is case-insensitive.
Arguments
Returns
null | stringWhether 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.
Returns
booleanRequest's method (GET, POST, etc.)
Returns
stringRequest's post body, if any.
Returns
null | stringRequest's post body in a binary form, if any.
Returns
null | BufferReturns 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.
Returns
null | SerializableRequest 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 = await page.goto("http://example.com")
print(response.request.redirected_from.url) # "http://example.com"response = page.goto("http://example.com")
print(response.request.redirected_from.url) # "http://example.com"If the website https://google.com has no redirects:
response = await page.goto("https://google.com")
print(response.request.redirected_from) # Noneresponse = page.goto("https://google.com")
print(response.request.redirected_from) # NoneReturns
null | RequestNew 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 == requestReturns
null | RequestContains 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, beacon, ping, cspreport, other.
Returns
stringReturns the matching Response object, or null if the response was not received due to error.
Returns
null | ResponseThe Service Worker that is performing the request.
Details
This method is Chromium only. It's safe to call when using other browsers, but it will always be null.
Requests originated in a Service Worker do not have a request.frame() available.
Returns
null | WorkerReturns resource size information for given request.
Returns
ObjectReturns 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
async with page.expect_event("requestfinished") as request_info:
await page.goto("http://example.com")
request = await request_info.value
print(request.timing)with page.expect_event("requestfinished") as request_info:
page.goto("http://example.com")
request = request_info.value
print(request.timing)Returns
ObjectURL of the request.
Returns
string