Yh  SSKrSSKrSSKrSSKJr SSKJr SSKJrJ r J r J r J r J r JrJrJrJrJrJrJrJrJrJrJrJrJr SSKJr SSKJr SSKJ r! SSK"J#r#J$r$J%r%J&r& SS K'J(r) SS K*J+r, SS K-J.r/ SS K0J1r2 SS K3J4r5 SSK6J7r8 SSK9J:r; SSK SSK?J@rA SSKBJCrC SSKDJErF SSKDJGrH SSKDJIrJ SSKKJLrM SSKNJOrP SSKQJRrS SSKQJTrU SSKQJVrW SSKXJYrZ SSK[J\r] SSK[J^r_ SSK`Jarb SSK`Jcrd SS K`Jerf SS!K`Jgrh SS"K`Jirj SS#KkJlrm SS$KkJnro SS%KpJqrr SS&KsJtru SS'KvJwrx SS(KyJzr{ SS)K|J}r~ "S*S+\#5ra\&R"\b\a5 "S,S-\#5rc\&R"\d\c5 "S.S/\#5re\&R"\f\e5 "S0S1\#5rg\&R"\h\g5 "S2S3\#5ri\&R"\j\i5 "S4S5\#5rR\&R"\S\R5 "S6S7\#5rT\&R"\U\T5 "S8S9\#5rV\&R"\W\V5 "S:S;\#5rY\&R"\Z\Y5 "S<S=\Y5r@\&R"\A\@5 "S>S?\#5r\&R"\\5 "S@SA\#5rL\&R"\M\L5 "SBSC\#5rO\&R"\P\O5 "SDSE\#5r\\&R"\]\\5 "SFSG\#5rn\&R"\o\n5 "SHSI\#5rt\&R"\u\t5 "SJSK\#5r4\&R"\5\45 "SLSM\#5r7\&R"\8\75 "SNSO\#5r:\&R"\;\:5 "SPSQ\#5r=\&R"\>\=5 "SRSS\#5rz\&R"\{\z5 "STSU\$5rl\&R"\m\l5 "SVSW\#5r}\&R"\~\}5 "SXSY\$5r+\&R"\,\+5 "SZS[\#5r1\&R"\2\15 "S\S]\$5r(\&R"\)\(5 "S^S_\#5r.\&R"\/\.5 "S`Sa\#5rq\&R"\r\q5 "SbSc\#5rw\&R"\x\w5 "SdSe\#5r^\&R"\_\^5 "SfSg\#5rI\&R"\J\I5 "ShSi\#5rG\&R"\H\G5 "SjSk\#5rE\&R"\F\E5 "SlSm\#5r \&R"\!\ 5 "SnSo\#5r\&R"\\5 "SpSq\#5r\&R"\\5 g)rN)Literal) Accessibility)ClientCertificateCookie FilePayload FloatRect GeolocationHttpCredentials NameValue PdfMarginsPosition ProxySettings RemoteAddr RequestSizesResourceTimingSecurityDetailsSetCookieParamSourceLocation StorageStateTracingGroupLocation ViewportSize)APIResponseAssertions)LocatorAssertions)PageAssertions) AsyncBaseAsyncContextManagerAsyncEventContextManagermapping)Browser)BrowserContext) BrowserType) CDPSession)Clock)ConsoleMessage)Dialog)Download) ElementHandle)Error) APIRequest)APIRequestContext) APIResponse) FileChooser)Frame)Keyboard)Mouse) Touchscreen)JSHandle) FrameLocator)Locator)Request)Response)Route) WebSocket)WebSocketRoute)Page)Worker) Playwright) Selectors)Tracing)Video)WebErrorc\rSrSr\S\4Sj5r\S\4Sj5r\S\4Sj5r\S\ R\4Sj5r \S\ R\ R4Sj5r \S\ R\4Sj5r\SS j5r\S\ RS4S j5r\S\ RS4S j5r\S\ R\4S j5r\S\4S j5r\S\ R,\\44Sj5rS\4SjrS\ RS4SjrS\4SjrS\ R,\\44SjrS\ R<\4Sjr S\S\ R\4Sjr!Sr"g)r4YreturncV[R"URR5$)z6Request.url URL of the request. Returns ------- str rfrom_maybe_impl _impl_objurlselfs Q/var/www/html/env/lib/python3.13/site-packages/playwright/async_api/_generated.pyrG Request.url[&&t~~'9'9::cV[R"URR5$)a5Request.resource_type Contains 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`. Returns ------- str )rrErF resource_typerHs rJrORequest.resource_typegs&&t~~'C'CDDrMcV[R"URR5$)zHRequest.method Request's method (GET, POST, etc.) Returns ------- str )rrErFmethodrHs rJrRRequest.methodu&&t~~'<'<==rMcV[R"URR5$)zRRequest.post_data Request's post body, if any. Returns ------- Union[str, None] )rrErF post_datarHs rJrVRequest.post_datas&&t~~'?'?@@rMcV[R"URR5$)a$Request.post_data_json Returns 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 ------- Union[Any, None] )rrErFpost_data_jsonrHs rJrYRequest.post_data_jsons&&t~~'D'DEErMcV[R"URR5$)zlRequest.post_data_buffer Request's post body in a binary form, if any. Returns ------- Union[bytes, None] )rrErFpost_data_bufferrHs rJr\Request.post_data_buffers&&t~~'F'FGGrMcV[R"URR5$)a Request.frame Returns the `Frame` that initiated this request. **Usage** ```py frame_url = request.frame.url ``` **Details** Note that in some cases the frame is not available, and this method will throw. - When request originates in the Service Worker. You can use `request.serviceWorker()` to check that. - When navigation request is issued before the corresponding frame is created. You can use `request.is_navigation_request()` to check that. Here is an example that handles all the cases: Returns ------- Frame r from_implrFframerHs rJra Request.frames2  !5!566rMcV[R"URR5$)a5Request.redirected_from Request 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`: ```py response = await page.goto("http://example.com") print(response.request.redirected_from.url) # "http://example.com" ``` If the website `https://google.com` has no redirects: ```py response = await page.goto("https://google.com") print(response.request.redirected_from) # None ``` Returns ------- Union[Request, None] )rfrom_impl_nullablerFredirected_fromrHs rJreRequest.redirected_froms<))$..*H*HIIrMcV[R"URR5$)aRequest.redirected_to New request issued by the browser if the server responded with redirect. **Usage** This method is the opposite of `request.redirected_from()`: ```py assert request.redirected_from.redirected_to == request ``` Returns ------- Union[Request, None] )rrdrF redirected_torHs rJrhRequest.redirected_tos$))$..*F*FGGrMcV[R"URR5$)a.Request.failure The method returns `null` unless this request has failed, as reported by `requestfailed` event. **Usage** Example of logging of all the failed requests: ```py page.on("requestfailed", lambda request: print(request.url + " " + request.failure)) ``` Returns ------- Union[str, None] rrErFfailurerHs rJrlRequest.failures$&&t~~'='=>>rMcV[R"URR5$)aRequest.timing Returns 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](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming). **Usage** ```py 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, domainLookupStart: float, domainLookupEnd: float, connectStart: float, secureConnectionStart: float, connectEnd: float, requestStart: float, responseStart: float, responseEnd: float} )rr`rFtimingrHs rJroRequest.timing s*  !6!677rMcV[R"URR5$)a?Request.headers An 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 ------- Dict[str, str] rrErFheadersrHs rJrsRequest.headers"&&t~~'='=>>rMcz# [R"URR5IShvN 5$N7f)zRequest.sizes Returns resource size information for given request. Returns ------- {requestBodySize: int, requestHeadersSize: int, responseBodySize: int, responseHeadersSize: int} N)rr`rFsizesrHs rJrw Request.sizes0s+  t~~';';'=!=>>!= .;9 ;r5cz# [R"URR5IShvN 5$N7f)zRequest.response Returns the matching `Response` object, or `null` if the response was not received due to error. Returns ------- Union[Response, None] N)rrdrFresponserHs rJr{Request.response<s+))0G0G0I*IJJ*Iryc^[R"URR55$)zRequest.is_navigation_request Whether 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 ------- bool )rrErFis_navigation_requestrHs rJr~Request.is_navigation_requestHs"&&t~~'K'K'MNNrMcz# [R"URR5IShvN 5$N7f)zRequest.all_headers An object with all the request HTTP headers associated with this request. The header names are lower-cased. Returns ------- Dict[str, str] NrrErF all_headersrHs rJrRequest.all_headersW+&&T^^-G-G-I'IJJ'Irycz# [R"URR5IShvN 5$N7f)a*Request.headers_array 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 ------- List[{name: str, value: str}] Nrfrom_impl_listrF headers_arrayrHs rJrRequest.headers_arrayc+%%DNN,H,H,J&JKK&Jrynamecx# [R"URRUS9IShvN 5$N7f)zRequest.header_value Returns the value of the header matching the name. The name is case-insensitive. Parameters ---------- name : str Name of the header. Returns ------- Union[str, None] rNrrErF header_valuerIrs rJrRequest.header_valueqs0&&T^^-H-Hd-H-S'STT'S -:8 :NrBr-)#__name__ __module__ __qualname____firstlineno__propertystrrGrOrRtypingOptionalrVAnyrYbytesr\rarerhrlrroDictrsrrwr{boolr~rListr rr__static_attributes__rrMrJr4r4Ys  ;S ; ; Es E E > > > A6??3/ A A F ; F F H&//%"8 H H774J!;JJ>Hvy9HH&?-??&888, ?S#X. ? ? ?\ ? K ; K Ot O K6;;sCx#8 K LV[[%; LUsUvs/CUrMr4c.\rSrSr\S\4Sj5r\S\4Sj5r\S\ 4Sj5r \S\4Sj5r \S\ R\\44Sj5r\S\4Sj5r\SS j5r\SS j5rS\ R\\44S jrS\ R&\4S jrS \S\ R,\4SjrS \S\ R&\4SjrS\ R,\4SjrS\ R,\4SjrSSjrS\4SjrS\4Sjr S\ RB4Sjr"Sr#g)r5irBcV[R"URR5$)zEResponse.url Contains the URL of the response. Returns ------- str rDrHs rJrG Response.urlrLrMcV[R"URR5$)zResponse.ok Contains a boolean stating whether the response was successful (status in the range 200-299) or not. Returns ------- bool rrErFokrHs rJr Response.ok&&t~~'8'899rMcV[R"URR5$)zjResponse.status Contains the status code of the response (e.g., 200 for a success). Returns ------- int rrErFstatusrHs rJrResponse.statusrTrMcV[R"URR5$)zzResponse.status_text Contains the status text of the response (e.g. usually an "OK" for a success). Returns ------- str rrErF status_textrHs rJrResponse.status_text&&t~~'A'ABBrMcV[R"URR5$)aBResponse.headers An object with the response 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 `response.all_headers()` for complete list of headers that include `cookie` information. Returns ------- Dict[str, str] rrrHs rJrsResponse.headersrurMcV[R"URR5$)zResponse.from_service_worker Indicates whether this Response was fulfilled by a Service Worker's Fetch Handler (i.e. via [FetchEvent.respondWith](https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent/respondWith)). Returns ------- bool )rrErFfrom_service_workerrHs rJrResponse.from_service_workers&&t~~'I'IJJrMcV[R"URR5$)zRResponse.request Returns the matching `Request` object. Returns ------- Request rr`rFrequestrHs rJrResponse.request  !7!788rMcV[R"URR5$)zYResponse.frame Returns the `Frame` that initiated this response. Returns ------- Frame r_rHs rJraResponse.frame  !5!566rMcz# [R"URR5IShvN 5$N7f)zResponse.all_headers An object with all the response HTTP headers associated with this response. Returns ------- Dict[str, str] NrrHs rJrResponse.all_headersrrycz# [R"URR5IShvN 5$N7f)a-Response.headers_array An array with all the request HTTP headers associated with this response. Unlike `response.all_headers()`, header names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times. Returns ------- List[{name: str, value: str}] NrrHs rJrResponse.headers_arrayrryrcx# [R"URRUS9IShvN 5$N7f)aResponse.header_value Returns the value of the header matching the name. The name is case-insensitive. If multiple headers have the same name (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\n` separator is used. If no headers are found, `null` is returned. Parameters ---------- name : str Name of the header. Returns ------- Union[str, None] rNrrs rJrResponse.header_values0"&&T^^-H-Hd-H-S'STT'Srcx# [R"URRUS9IShvN 5$N7f)zResponse.header_values Returns all values of the headers matching the name, for example `set-cookie`. The name is case-insensitive. Parameters ---------- name : str Name of the header. Returns ------- List[str] rN)rrErF header_valuesrs rJrResponse.header_values0&&T^^-I-It-I-T'TUU'Trcz# [R"URR5IShvN 5$N7f)zResponse.server_addr Returns the IP address and port of the server. Returns ------- Union[{ipAddress: str, port: int}, None] N)rrdrF server_addrrHs rJrResponse.server_addr)+))0J0J0L*LMM*Lrycz# [R"URR5IShvN 5$N7f)zResponse.security_details Returns SSL and other security information. Returns ------- Union[{issuer: Union[str, None], protocol: Union[str, None], subjectName: Union[str, None], validFrom: Union[float, None], validTo: Union[float, None]}, None] N)rrdrFsecurity_detailsrHs rJrResponse.security_details5s+))0O0O0Q*QRR*QryNcz# [R"URR5IShvN 5$N7f)zMResponse.finished Waits for this response to finish, returns always `null`. N)rrErFfinishedrHs rJrResponse.finishedAs+ &&T^^-D-D-F'FGG'Frycz# [R"URR5IShvN 5$N7f)zMResponse.body Returns the buffer with response body. Returns ------- bytes NrrErFbodyrHs rJr Response.bodyI+&&T^^-@-@-B'BCC'Brycz# [R"URR5IShvN 5$N7f)zVResponse.text Returns the text representation of response body. Returns ------- str NrrErFtextrHs rJr Response.textUrrycz# [R"URR5IShvN 5$N7f)zResponse.json Returns the JSON representation of response body. This method will throw if the response body is not parsable via `JSON.parse`. Returns ------- Any NrrErFjsonrHs rJr Response.jsona+&&T^^-@-@-B'BCC'BryrrBr4rrBN)$rrrrrrrGrrintrrrrrsrrrarrr rrrrrrrrrrrrrrrrrMrJr5r5s  ;S ; ; :D : : > > > CS C C ?S#X. ? ? KT K K 9 9 7 7 K6;;sCx#8 K LV[[%; LUsUvs/CU&VV C0@V" N6??:#> N S(H SH DE D DC D DFJJ DrMr5c\rSrSr\SSj5rSS\R\SS4Sjjr SSSSSSSS.S\R\ S \R\R\\4S \R\R\\ 4S \R\RS \R\R\\R 4S \R\S\RSSS4SjjrSSSSSSSS.S\R\S\R\S \R\R\\4S\R\R\R\\ 4S\R\ S\R\ S\R\SS4SjjrSSSSS.S\R\S\R\S \R\R\\4S\R\R\R\\ 4SS4 SjjrSSSSS.S\R\S\R\S \R\R\\4S\R\R\R\\ 4SS4 SjjrSrg)r6isrBcV[R"URR5$)z@Route.request A request to be routed. Returns ------- Request rrHs rJr Route.requesturrMN error_codecx# [R"URRUS9IShvN 5$N7f)a^Route.abort Aborts the route's request. Parameters ---------- error_code : Union[str, None] Optional error code. Defaults to `failed`, could be one of the following: - `'aborted'` - An operation was aborted (due to user action) - `'accessdenied'` - Permission to access a resource, other than the network, was denied - `'addressunreachable'` - The IP address is unreachable. This usually means that there is no route to the specified host or network. - `'blockedbyclient'` - The client chose to block the request. - `'blockedbyresponse'` - The request failed because the response was delivered along with requirements which are not met ('X-Frame-Options' and 'Content-Security-Policy' ancestor checks, for instance). - `'connectionaborted'` - A connection timed out as a result of not receiving an ACK for data sent. - `'connectionclosed'` - A connection was closed (corresponding to a TCP FIN). - `'connectionfailed'` - A connection attempt failed. - `'connectionrefused'` - A connection attempt was refused. - `'connectionreset'` - A connection was reset (corresponding to a TCP RST). - `'internetdisconnected'` - The Internet connection has been lost. - `'namenotresolved'` - The host name could not be resolved. - `'timedout'` - An operation timed out. - `'failed'` - A generic failure occurred. ) errorCodeN)rrErFabort)rIrs rJr Route.aborts06&&T^^-A-AJ-A-W'WXX'Wr)rrsrrpath content_typer{rrsrrrrr{r+c # [R"URRU[R"U5U[R"U5UUU(a UROSS9IShvN 5$N7f)aRoute.fulfill Fulfills route's request with given response. **Usage** An example of fulfilling all requests with 404 responses: ```py await page.route("**/*", lambda route: route.fulfill( status=404, content_type="text/plain", body="not found!")) ``` An example of serving static file: ```py await page.route("**/xhr_endpoint", lambda route: route.fulfill(path="mock_data.json")) ``` Parameters ---------- status : Union[int, None] Response status code, defaults to `200`. headers : Union[Dict[str, str], None] Response headers. Header values will be converted to a string. body : Union[bytes, str, None] Response body. json : Union[Any, None] JSON response. This method will set the content type to `application/json` if not set. path : Union[pathlib.Path, str, None] File path to respond with. The content type will be inferred from file extension. If `path` is a relative path, then it is resolved relative to the current working directory. content_type : Union[str, None] If set, equals to setting `Content-Type` response header. response : Union[APIResponse, None] `APIResponse` to fulfill route's request with. Individual fields of the response (such as headers) can be overridden using fulfill options. N)rrsrrr contentTyper{)rrErFfulfillto_impl)rIrrsrrrrr{s rJr Route.fulfillsmh&&..((0__T*(/7++T)    sA.A;0A91 A;)rGrRrsrV max_redirects max_retriestimeoutrGrRrVrrrc # [R"URRUU[R"U5[R"U5UUUS9IShvN 5$N7f)aRoute.fetch Performs the request and fetches result without fulfilling it, so that the response could be modified and then fulfilled. **Usage** ```py async def handle(route): response = await route.fetch() json = await response.json() json["message"]["big_red_dog"] = [] await route.fulfill(response=response, json=json) await page.route("https://dog.ceo/api/breeds/list/all", handle) ``` **Details** Note that `headers` option will apply to the fetched request as well as any redirects initiated by it. If you want to only apply `headers` to the original request, but not to redirects, look into `route.continue_()` instead. Parameters ---------- url : Union[str, None] If set changes the request URL. New URL must have same protocol as original one. method : Union[str, None] If set changes the request method (e.g. GET or POST). headers : Union[Dict[str, str], None] If set changes the request HTTP headers. Header values will be converted to a string. post_data : Union[Any, bytes, str, None] Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set. max_redirects : Union[int, None] Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is exceeded. Defaults to `20`. Pass `0` to not follow redirects. max_retries : Union[int, None] Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries. timeout : Union[float, None] Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. Returns ------- APIResponse )rGrRrspostData maxRedirects maxRetriesrNrr`rFfetchr)rIrGrRrsrVrrrs rJr Route.fetchscx  ..&&0 3*&'    sAA(A& A()rGrRrsrVc # [R"URRUU[R"U5[R"U5S9IShvN 5$N7f)a Route.fallback Continues route's request with optional overrides. The method is similar to `route.continue_()` with the difference that other matching handlers will be invoked before sending the request. **Usage** When several routes match the given pattern, they run in the order opposite to their registration. That way the last registered route can always override all the previous ones. In the example below, request will be handled by the bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first registered route. ```py await page.route("**/*", lambda route: route.abort()) # Runs last. await page.route("**/*", lambda route: route.fallback()) # Runs second. await page.route("**/*", lambda route: route.fallback()) # Runs first. ``` Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for example API calls vs page resources or GET requests vs POST requests as in the example below. ```py # Handle GET requests. async def handle_get(route): if route.request.method != "GET": await route.fallback() return # Handling GET only. # ... # Handle POST requests. async def handle_post(route): if route.request.method != "POST": await route.fallback() return # Handling POST only. # ... await page.route("**/*", handle_get) await page.route("**/*", handle_post) ``` One can also modify request while falling back to the subsequent handler, that way intermediate route handler can modify url, method, headers and postData of the request. ```py async def handle(route, request): # override headers headers = { **request.headers, "foo": "foo-value", # set "foo" header "bar": None # remove "bar" header } await route.fallback(headers=headers) await page.route("**/*", handle) ``` Use `route.continue_()` to immediately send the request to the network, other matching handlers won't be invoked in that case. Parameters ---------- url : Union[str, None] If set changes the request URL. New URL must have same protocol as original one. Changing the URL won't affect the route matching, all the routes are matched using the original request URL. method : Union[str, None] If set changes the request method (e.g. GET or POST). headers : Union[Dict[str, str], None] If set changes the request HTTP headers. Header values will be converted to a string. post_data : Union[Any, bytes, str, None] If set changes the post data of request. rGrRrsrN)rrErFfallbackrrIrGrRrsrVs rJrRoute.fallback&sZd&&..))0 3 *    AA%A# A%c # [R"URRUU[R"U5[R"U5S9IShvN 5$N7f)aRoute.continue_ Sends route's request to the network with optional overrides. **Usage** ```py async def handle(route, request): # override headers headers = { **request.headers, "foo": "foo-value", # set "foo" header "bar": None # remove "bar" header } await route.continue_(headers=headers) await page.route("**/*", handle) ``` **Details** The `headers` option applies to both the routed request and any redirects it initiates. However, `url`, `method`, and `postData` only apply to the original request and are not carried over to redirected requests. `route.continue_()` will immediately send the request to the network, other matching handlers won't be invoked. Use `route.fallback()` If you want next matching handler in the chain to be invoked. **NOTE** The `Cookie` header cannot be overridden using this method. If a value is provided, it will be ignored, and the cookie will be loaded from the browser's cookie store. To set custom cookies, use `browser_context.add_cookies()`. Parameters ---------- url : Union[str, None] If set changes the request URL. New URL must have same protocol as original one. method : Union[str, None] If set changes the request method (e.g. GET or POST). headers : Union[Dict[str, str], None] If set changes the request HTTP headers. Header values will be converted to a string. post_data : Union[Any, bytes, str, None] If set changes the post data of request. rN)rrErF continue_rrs rJrRoute.continue_sZf&&..**0 3 +    rrrN)rrrrrrrrrrrrUnionrrpathlibPathrfloatrrrrrrMrJr6r6ss  9 9Yfooc&:YdY@(,:>:>,0AE-137> $> S#X!67 > oofll3:67 > oofjj) > oofll3 +<=>> ooc*> //-0>  > F%)'+:>KO.2,0*.F __S !F $ F S#X!67 F ??6<< C0F#GH F s+F __S)F 'F  F V%)'+:>KO Y __S !Y $ Y S#X!67 Y ??6<< C0F#GH Y  Y |%)'+:>KO : __S !: $ : S#X!67 : ??6<< C0F#GH :  : : rMr6c ^\rSrSr\R S\SS\RS/S4SS4Sj5r\R S\S S\RS /S4SS4S j5r\R S\S S\RS /S4SS4S j5r\R S\SS\RS/S4SS4Sj5rS\ S\RS\R\RSS44SS4U4Sjjr\R S\SS\RS/S4SS4Sj5r \R S\S S\RS /S4SS4Sj5r \R S\S S\RS /S4SS4Sj5r \R S\SS\RS/S4SS4Sj5r S\ S\RS\R\RSS44SS4U4Sjjr \ S\ 4Sj5rS SS.S\ S\R\RS\R\S\4SjjjrS SS.S\ S\R\RS\R\S\R&4SjjjrS\4SjrSrU=r$)!r7ieventclosef*typing.Union[typing.Awaitable[None], None]rBNcgz! Fired when the websocket closes.NrrIrrs rJon WebSocket.onrM framereceivedztyping.Union[bytes, str]cgz+ Fired when the websocket receives a frame.Nrrs rJrrrrM framesentcgz( Fired when the websocket sends a frame.Nrrs rJrrrrM socketerrorrcgz' Fired when the websocket has an error.Nrrs rJrrrrM.c>[TU]XS9$NrrsuperrrIrr __class__s rJrr wzz++rMcgrrrs rJonceWebSocket.oncerrMcgrrrs rJr*r+rrMcgrrrs rJr*r+rrMcgr rrs rJr*r+rrMc>[TU]XS9$r"r%r*r&s rJr*r+ w|%|--rMcV[R"URR5$)zGWebSocket.url Contains the URL of the WebSocket. Returns ------- str rDrHs rJrG WebSocket.url!rLrMr predicatercz[URRXRU5US9R5$)aWebSocket.expect_event Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy value. Will throw an error if the webSocket is closed before the event is fired. Returns the event data value. Parameters ---------- event : str Event name, same one would pass into `webSocket.on(event)`. predicate : Union[Callable, None] Receives the event data and resolves to truthy value when the waiting should resolve. timeout : Union[float, None] Maximum time to wait for in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can be changed by using the `browser_context.set_default_timeout()`. Returns ------- EventContextManager rr5rrrF expect_event _wrap_handlerfuturerIrr5rs rJr9WebSocket.expect_event-s=6( NN ' ''9'9)'Dg ( f  rMc# [R"URRXR U5US9IShvN 5$N7f)a+WebSocket.wait_for_event **NOTE** In most cases, you should use `web_socket.expect_event()`. Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and waits for `predicate(event)` to return a truthy value. Will throw an error if the socket is closed before the `event` is fired. Parameters ---------- event : str Event name, same one typically passed into `*.on(event)`. predicate : Union[Callable, None] Receives the event data and resolves to truthy value when the waiting should resolve. timeout : Union[float, None] Maximum time to wait for in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can be changed by using the `browser_context.set_default_timeout()`. Returns ------- Any r7NrrErFwait_for_eventr:r<s rJr@WebSocket.wait_for_eventNK<&&..//'9'9)'Dg0    =A A A c^[R"URR55$)zZWebSocket.is_closed Indicates that the web socket has been closed. Returns ------- bool rrErF is_closedrHs rJrFWebSocket.is_closedr"&&t~~'?'?'ABBrMrr)rrrrroverloadrCallablerrr  Awaitabler*rrGrr rr9rr@rrFr __classcell__r's@rJr7r7s __,w, ??K=*VV W,  ,, __6'6 ?? ' (*V V 6  66 __3{#3 ?? ' (*V V 3  33 __2}%2 ??E7$PP Q2  22,, ??3 V-=-=d-CT-I JJ K,  , __,w, ??K=*VV W,  ,, __6'6 ?? ' (*V V 6  66 __3{#3 ?? ' (*V V 3  33 __2}%2 ??E7$PP Q2  22.. ??3 V-=-=d-CT-I JJ K.  . ;S ; ;7; +/   ??6??3 '  "  H7;" +/ " " ??6??3" ' "  " H C4 C CrMr7c\rSrSr\S\4Sj5rSSS.S\R\ S\R\SS4Sjjr SS jr S \R\\ 4SS4S jrS \R\R\\ 4/\R 4SS4S jrS \R\R\ \R\/\R 4SS4SjrSrg)r8irBcV[R"URR5$)zSWebSocketRoute.url URL of the WebSocket created in the page. Returns ------- str rDrHs rJrGWebSocketRoute.urlrLrMNcodereasonrRrScx# [R"URRXS9IShvN 5$N7f)aTWebSocketRoute.close Closes one side of the WebSocket connection. Parameters ---------- code : Union[int, None] Optional [close code](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#code). reason : Union[str, None] Optional [close reason](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#reason). rQNrrErFr)rIrRrSs rJrWebSocketRoute.closes5&&..&&D&@ @  @rc^[R"URR55$)alWebSocketRoute.connect_to_server By default, routed WebSocket does not connect to the server, so you can mock entire WebSocket communication. This method connects to the actual WebSocket server, and returns the server-side `WebSocketRoute` instance, giving the ability to send and receive messages from the server. Once connected to the server: - Messages received from the server will be **automatically forwarded** to the WebSocket in the page, unless `web_socket_route.on_message()` is called on the server-side `WebSocketRoute`. - Messages sent by the [`WebSocket.send()`](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/send) call in the page will be **automatically forwarded** to the server, unless `web_socket_route.on_message()` is called on the original `WebSocketRoute`. See examples at the top for more details. Returns ------- WebSocketRoute )rr`rFconnect_to_serverrHs rJrX WebSocketRoute.connect_to_servers"*  !A!A!CDDrMmessagec\[R"URRUS95$)aUWebSocketRoute.send Sends a message to the WebSocket. When called on the original WebSocket, sends the message to the page. When called on the result of `web_socket_route.connect_to_server()`, sends the message to the server. See examples at the top for more details. Parameters ---------- message : Union[bytes, str] Message to send. )rZ)rrErFsend)rIrZs rJr\WebSocketRoute.sends'&&t~~':':7':'KLLrMhandlercz[R"URRUR U5S95$)a5WebSocketRoute.on_message This method allows to handle messages that are sent by the WebSocket, either from the page or from the server. When called on the original WebSocket route, this method handles messages sent from the page. You can handle this messages by responding to them with `web_socket_route.send()`, forwarding them to the server-side connection returned by `web_socket_route.connect_to_server()` or do something else. Once this method is called, messages are not automatically forwarded to the server or to the page - you should do that manually by calling `web_socket_route.send()`. See examples at the top for more details. Calling this method again will override the handler with a new one. Parameters ---------- handler : Callable[[Union[bytes, str]], Any] Function that will handle messages. r^)rrErF on_messager:rIr^s rJraWebSocketRoute.on_messages7,&& NN % %d.@.@.I % J  rMcz[R"URRUR U5S95$)aWebSocketRoute.on_close Allows to handle [`WebSocket.close`](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close). By default, closing one side of the connection, either in the page or on the server, will close the other side. However, when `web_socket_route.on_close()` handler is set up, the default forwarding of closure is disabled, and handler should take care of it. Parameters ---------- handler : Callable[[Union[int, None], Union[str, None]], Any] Function that will handle WebSocket closure. Received an optional [close code](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#code) and an optional [close reason](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#reason). r`)rrErFon_closer:rbs rJreWebSocketRoute.on_closes7,&& NN # #D,>,>w,G # H  rMr)rBr8)rrrrrrrGrrrrrXr rr\rJrrarerrrMrJr8r8s  ;S ; ;/3SW s+ ->3->-G'GHH'Grrcx# [R"URRUS9IShvN 5$N7f)usKeyboard.insert_text Dispatches only `input` event, does not emit the `keydown`, `keyup` or `keypress` events. **Usage** ```py await page.keyboard.insert_text("嗨") ``` **NOTE** Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper case. Parameters ---------- text : str Sets input to the specified text value. )rN)rrErF insert_text)rIrs rJrtKeyboard.insert_text7s0(&&T^^-G-GT-G-R'RSS'Rr)delayrvcx# [R"URRXS9IShvN 5$N7f)aKeyboard.type **NOTE** In most cases, you should use `locator.fill()` instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use `locator.press_sequentially()`. Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`. **Usage** ```py await page.keyboard.type("Hello") # types instantly await page.keyboard.type("World", delay=100) # types slower, like a user ``` **NOTE** Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case. **NOTE** For characters that are not on a US keyboard, only an `input` event will be sent. Parameters ---------- text : str A text to type into a focused element. delay : Union[float, None] Time to wait between key presses in milliseconds. Defaults to 0. )rrvNrrErFtype)rIrrvs rJry Keyboard.typeMs5:&&..%%4%= =  =rcx# [R"URRXS9IShvN 5$N7f)akKeyboard.press **NOTE** In most cases, you should use `locator.press()` instead. `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character to generate the text for. A superset of the `key` values can be found [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are: `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`, `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc. Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`, `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS. Holding down `Shift` will type the text that corresponds to the `key` in the upper case. If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective texts. Shortcuts such as `key: "Control+o"`, `key: "Control++` or `key: "Control+Shift+T"` are supported as well. When specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed. **Usage** ```py page = await browser.new_page() await page.goto("https://keycode.info") await page.keyboard.press("a") await page.screenshot(path="a.png") await page.keyboard.press("ArrowLeft") await page.screenshot(path="arrow_left.png") await page.keyboard.press("Shift+O") await page.screenshot(path="o.png") await browser.close() ``` Shortcut for `keyboard.down()` and `keyboard.up()`. Parameters ---------- key : str Name of the key to press or a character to generate, such as `ArrowLeft` or `a`. delay : Union[float, None] Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0. )rhrvNrrErFpress)rIrhrvs rJr}Keyboard.pressns1b&&T^^-A-Ac-A-W'WXX'Wrr)rrrrrrlrqrtrrr ryr}rrrMrJr.r.s%Kc%Kd%KN IC ID ITcTdT,HL s fooe.D PT BHL1Ys1Yfooe.D1YPT1Y1YrMr.c \rSrSrSS.S\S\S\R \SS4SjjrSSS .S \R \ S S \R \SS4S jjr SSS .S \R \ S S \R \SS4Sjjr SSSS.S\S\S\R \S \R \ S S \R \SS4 Sjjr SSS.S\S\S\R \S \R \ S SS4 Sjjr S\S\SS4SjrSrg)r/iN)stepsxyrrBcz# [R"URRXUS9IShvN 5$N7f)a6Mouse.move Dispatches a `mousemove` event. Parameters ---------- x : float X coordinate relative to the main frame's viewport in CSS pixels. y : float Y coordinate relative to the main frame's viewport in CSS pixels. steps : Union[int, None] Defaults to 1. Sends intermediate `mousemove` events. )rrrN)rrErFmove)rIrrrs rJr Mouse.moves3"&&T^^-@-@1QV-@-W'WXX'Wry)button click_countrleftmiddlerightrcx# [R"URRXS9IShvN 5$N7f)zMouse.down Dispatches a `mousedown` event. Parameters ---------- button : Union["left", "middle", "right", None] Defaults to `left`. click_count : Union[int, None] defaults to 1. See [UIEvent.detail]. r clickCountNrkrIrrs rJrl Mouse.downs5$&&..%%V%L L  Lrcx# [R"URRXS9IShvN 5$N7f)zMouse.up Dispatches a `mouseup` event. Parameters ---------- button : Union["left", "middle", "right", None] Defaults to `left`. click_count : Union[int, None] defaults to 1. See [UIEvent.detail]. rNrprs rJrqMouse.ups5$&&..##6#J J  Jr)rvrrrvc |# [R"URRXX4US9IShvN 5$N7f)aMouse.click Shortcut for `mouse.move()`, `mouse.down()`, `mouse.up()`. Parameters ---------- x : float X coordinate relative to the main frame's viewport in CSS pixels. y : float Y coordinate relative to the main frame's viewport in CSS pixels. delay : Union[float, None] Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0. button : Union["left", "middle", "right", None] Defaults to `left`. click_count : Union[int, None] defaults to 1. See [UIEvent.detail]. )rrrvrrN)rrErFclick)rIrrrvrrs rJr Mouse.clicksB6&&..&&'     /<: <)rvrc z# [R"URRXX4S9IShvN 5$N7f)aMouse.dblclick Shortcut for `mouse.move()`, `mouse.down()`, `mouse.up()`, `mouse.down()` and `mouse.up()`. Parameters ---------- x : float X coordinate relative to the main frame's viewport in CSS pixels. y : float Y coordinate relative to the main frame's viewport in CSS pixels. delay : Union[float, None] Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0. button : Union["left", "middle", "right", None] Defaults to `left`. )rrrvrN)rrErFdblclick)rIrrrvrs rJrMouse.dblclicks72&&..))A%)O O  Orydelta_xdelta_ycx# [R"URRXS9IShvN 5$N7f)aMouse.wheel Dispatches a `wheel` event. This method is usually used to manually scroll the page. See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll. **NOTE** Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling to finish before returning. Parameters ---------- delta_x : float Pixels to scroll horizontally. delta_y : float Pixels to scroll vertically. )deltaXdeltaYN)rrErFwheel)rIrrs rJr Mouse.wheel$s5"&&..&&g&F F  Frr)rrrrr rrrrrrlrqrrrrrrMrJr/r/sDHYY Y,2OOC,@Y Y,GK,0  (A BC __S)    2GK,0  (A BC __S)    6)-FJ,0    u%  (A BC  __S)   L)-FJ     u%  (A BC    : 5 5 T rMr/c*\rSrSrS\S\SS4SjrSrg)r0i=rrrBNcx# [R"URRXS9IShvN 5$N7f)aTouchscreen.tap Dispatches a `touchstart` and `touchend` event with a single touch at the position (`x`,`y`). **NOTE** `page.tap()` the method will throw if `hasTouch` option of the browser context is false. Parameters ---------- x : float X coordinate relative to the main frame's viewport in CSS pixels. y : float Y coordinate relative to the main frame's viewport in CSS pixels. )rrN)rrErFtap)rIrrs rJrTouchscreen.tap?s0&&T^^-?-?!-?-I'IJJ'Irr)rrrrr rrrrMrJr0r0=s K5KUKtKrMr0cN\rSrSrSS\S\R \RS\R4SjjrSS\S\R \RSS4Sjjr S\SS4S jr S\R\S44S jr S\R S 4S jr SS jrS\R4SjrSrg)r1iTN expressionargrBc# [R"URRU[R"U5S9IShvN 5$N7f)aJSHandle.evaluate Returns the return value of `expression`. This method passes this handle as the first argument to `expression`. If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its value. **Usage** ```py tweet_handle = await page.query_selector(".tweet .retweets") assert await tweet_handle.evaluate("node => node.innerText") == "10 retweets" ``` Parameters ---------- expression : str JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is automatically invoked. arg : Union[Any, None] Optional argument to pass to `expression`. Returns ------- Any rrNrrErFevaluaterrIrrs rJrJSHandle.evaluateVsJ@&&..))%7??3+?*    AAA  Ac# [R"URRU[R"U5S9IShvN 5$N7f)aJSHandle.evaluate_handle Returns the return value of `expression` as a `JSHandle`. This method passes this handle as the first argument to `expression`. The only difference between `jsHandle.evaluate` and `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle` returns `JSHandle`. If the function passed to the `jsHandle.evaluateHandle` returns a [Promise], then `jsHandle.evaluateHandle` would wait for the promise to resolve and return its value. See `page.evaluate_handle()` for more details. Parameters ---------- expression : str JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is automatically invoked. arg : Union[Any, None] Optional argument to pass to `expression`. Returns ------- JSHandle rNrr`rFevaluate_handlerrs rJrJSHandle.evaluate_handle|sI<  ..00%7??3+?1    r property_namecx# [R"URRUS9IShvN 5$N7f)zJSHandle.get_property Fetches a single property from the referenced object. Parameters ---------- property_name : str property to get Returns ------- JSHandle ) propertyNameN)rr`rF get_property)rIrs rJrJSHandle.get_propertys5  ..--=-I I  Ircz# [R"URR5IShvN 5$N7f)aJSHandle.get_properties The method returns a map with **own property names** as keys and JSHandle instances for the property values. **Usage** ```py handle = await page.evaluate_handle("({ window, document })") properties = await handle.get_properties() window_handle = properties.get("window") document_handle = properties.get("document") await handle.dispose() ``` Returns ------- Dict[str, JSHandle] N)rfrom_impl_dictrFget_propertiesrHs rJrJSHandle.get_propertiess+(%%DNN,I,I,K&KLL&Kryr'c^[R"URR55$)zJSHandle.as_element Returns either `null` or the object handle itself, if the object handle is an instance of `ElementHandle`. Returns ------- Union[ElementHandle, None] rrdrF as_elementrHs rJrJSHandle.as_element"))$..*C*C*EFFrMcz# [R"URR5IShvN 5$N7f)zVJSHandle.dispose The `jsHandle.dispose` method stops referencing the element handle. NrrErFdisposerHs rJrJSHandle.dispose+ &&T^^-C-C-E'EFF'Erycz# [R"URR5IShvN 5$N7f)a<JSHandle.json_value Returns a JSON representation of the object. If the object has a `toJSON` function, it **will not be called**. **NOTE** The method will return an empty JSON object if the referenced object is not stringifiable. It will throw an error if the object has circular references. Returns ------- Any N)rrErF json_valuerHs rJrJSHandle.json_values+&&T^^-F-F-H'HII'Hryrrr)rrrrrrrrrrrrrrrrrrrMrJr1r1TsCG$ $ $*OOFJJ$?$ $ NCG" " $*OOFJJ$?" " H   &Mfkk#z/&BM, GFOOO< GG J&** JrMr1c>\rSrSrS\R S4SjrS\R S4SjrS\R S4SjrS\ S\R \ 4Sjr S\R \ 4S jr S\ 4S jr S\ 4S jr S\4S jrS\4S jrS\4SjrS\4SjrS\4SjrS\4SjrSdS\ S\R \R*SS4SjjrSS.S\R \SS4SjjrSSSSSSS.S\R \R2\SS\R \S\R \S\R \S\R \S\R \SS4S jjrSSSSSSSSSS!. S\R \R2\SS\R \S"\R \S#\R \S$S%\R \S\R \S\R \S\R \S\R \SS4S&jjrSSSSSSSSS'.S\R \R2\SS\R \S"\R \S#\R \S$S\R \S\R \S\R \S\R \SS4S(jjrSdSSSSSSS).S*\R \R@\ \R2\ 4S+\R \R@\\R2\4S,\R \R@\ \R2\ 4S-\R \R@S\R2S4S\R \S\R \S\R \S\RB\ 4S.jjjr"SSSSSSS/.S\R \R2\SS\R \S\R \S\R \S\R \S\R \SS4S0jjr#SSSS1.S*\ S\R \S\R \S\R \SS4 S2jjr$SSS3.S\R \S\R \SS4S4jjr%SS.S\R \S\ 4S5jjr&SSS6.S7\R@\ \'RP\)\R2\R@\ \'RP4\R2\)4S\R \S\R \SS4S8jjr*SeS9jr+SSSS:.S;\ S"\R \S\R \S\R \SS4 S<jjr,SSSS:.S=\ S"\R \S\R \S\R \SS4 S>jjr-SSSSSS?.S@\S\R \S\R \S\R \S\R \S\R \SS4SAjjr.SSSSSS?.S\R \S\R \S\R \S\R \S\R \SS4 SBjjr/SSSSSS?.S\R \S\R \S\R \S\R \S\R \SS4 SCjjr0S\R \14SDjr2SSSSSSSSSSSSE. S\R \S\R \SFSG\R \R@\ \'RP4SH\R \SI\R \SJ\R \SKSL\R \SMSN\R \SOSP\R \R2SQSR\R \ SS\R \ S\34STjjr4SU\ S\R S4SVjr5SU\ S\RBS4SWjr6SdSU\ SX\ SY\R \RnS\Rn4SZjjr8SdSU\ SX\ SY\R \RnS\Rn4S[jjr9SS.S\\S]S\R \SS4S^jjr:SSSS_.SU\ S\\R \S`S\R \Sa\R \S\R S4 Sbjjr;Scr` element and selects these options. If the target element is not a `` has the `multiple` attribute, all given options are selected, otherwise only the first option matching one of the passed options is selected. Optional. index : Union[Sequence[int], int, None] Options to select by index. Optional. label : Union[Sequence[str], str, None] Options to select by label. If the ``, `