gF  ddlZddlZddlZddlmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZddlmZddlmZddlm Z!ddl"m#Z#m$Z$m%Z%m&Z&dd l'm(Z)dd l*m+Z,dd l-m.Z/dd l0m1Z2dd l3m4Z5ddl6m7Z8ddl9m:Z;ddlddl?m@ZAddlBmCZCddlDmEZFddlDmGZHddlDmIZJddlKmLZMddlNmOZPddlQmRZSddlQmTZUddlQmVZWddlXmYZZddl[m\Z]ddl[m^Z_ddl`maZbddl`mcZddd l`meZfdd!l`mgZhdd"l`miZjdd#lkmlZmdd$lkmnZodd%lpmqZrdd&lsmtZudd'lvmwZxdd(lymzZ{dd)l|m}Z~Gd*d+e#Zae&jebeaGd,d-e#Zce&jedecGd.d/e#Zee&jefeeGd0d1e#Zge&jehegGd2d3e#Zie&jejeiGd4d5e#ZRe&jeSeRGd6d7e#ZTe&jeUeTGd8d9e#ZVe&jeWeVGd:d;e#ZYe&jeZeYGd<d=eYZ@e&jeAe@Gd>d?e#Ze&jeeGd@dAe#ZLe&jeMeLGdBdCe#ZOe&jePeOGdDdEe#Z\e&je]e\GdFdGe#Zne&jeoenGdHdIe#Zte&jeuetGdJdKe#Z4e&je5e4GdLdMe#Z7e&je8e7GdNdOe#Z:e&je;e:GdPdQe#Z=e&je>e=GdRdSe#Zze&je{ezGdTdUe$Zle&jemelGdVdWe#Z}e&je~e}GdXdYe$Z+e&je,e+GdZd[e#Z1e&je2e1Gd\d]e$Z(e&je)e(Gd^d_e#Z.e&je/e.Gd`dae#Zqe&jereqGdbdce#Zwe&jexewGdddee#Z^e&je_e^Gdfdge#ZIe&jeJeIGdhdie#ZGe&jeHeGGdjdke#ZEe&jeFeEGdldme#Z e&je!e Gdndoe#Ze&jeeGdpdqe#Ze&jeey)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)WebErrorceZdZedefdZedefdZedefdZedejefdZ edejejfdZ edeje fdZeddZedejdfd Zedejdfd Zedejefd Zedefd Zedej*eeffd ZdefdZdejdfdZdefdZdej*eeffdZdej:efdZdedejefdZ y)r4returncTtj|jjS)z^Request.url URL of the request. Returns ------- str rfrom_maybe_impl _impl_objurlselfs T/var/www/openai/venv/lib/python3.12/site-packages/playwright/async_api/_generated.pyrFz Request.url[&&t~~'9'9::cTtj|jjS)amRequest.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 )rrDrE resource_typerGs rIrMzRequest.resource_typegs&&t~~'C'CDDrKcTtj|jjS)zpRequest.method Request's method (GET, POST, etc.) Returns ------- str )rrDrEmethodrGs rIrOzRequest.methodu&&t~~'<'<==rKcTtj|jjS)zzRequest.post_data Request's post body, if any. Returns ------- Union[str, None] )rrDrE post_datarGs rIrRzRequest.post_datas&&t~~'?'?@@rKcTtj|jjS)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] )rrDrEpost_data_jsonrGs rIrTzRequest.post_data_jsons&&t~~'D'DEErKcTtj|jjS)zRequest.post_data_buffer Request's post body in a binary form, if any. Returns ------- Union[bytes, None] )rrDrEpost_data_bufferrGs rIrVzRequest.post_data_buffers&&t~~'F'FGGrKcTtj|jjS)aRequest.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_implrEframerGs rIrZz Request.frames2  !5!566rKcTtj|jjS)aRequest.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_nullablerEredirected_fromrGs rIr]zRequest.redirected_froms<))$..*H*HIIrKcTtj|jjS)aaRequest.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] )rr\rE redirected_torGs rIr_zRequest.redirected_tos$))$..*F*FGGrKcTtj|jjS)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] rrDrEfailurerGs rIrbzRequest.failures$&&t~~'='=>>rKcTtj|jjS)a=Request.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} )rrYrEtimingrGs rIrdzRequest.timing s*  !6!677rKcTtj|jjS)awRequest.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] rrDrEheadersrGs rIrgzRequest.headers"&&t~~'='=>>rKcxKtj|jjd{S7w)zRequest.sizes Returns resource size information for given request. Returns ------- {requestBodySize: int, requestHeadersSize: int, responseBodySize: int, responseHeadersSize: int} N)rrYrEsizesrGs rIrjz Request.sizes0s,  t~~';';'=!=>>!= -:8 :r5cxKtj|jjd{S7w)zRequest.response Returns the matching `Response` object, or `null` if the response was not received due to error. Returns ------- Union[Response, None] N)rr\rEresponserGs rIrmzRequest.response<s,))0G0G0I*IJJ*Irkc\tj|jjS)a(Request.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 )rrDrEis_navigation_requestrGs rIrozRequest.is_navigation_requestHs"&&t~~'K'K'MNNrKcxKtj|jjd{S7w)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] NrrDrE all_headersrGs rIrrzRequest.all_headersW,&&T^^-G-G-I'IJJ'IrkcxKtj|jjd{S7w)abRequest.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_listrE headers_arrayrGs rIrwzRequest.headers_arrayc,%%DNN,H,H,J&JKK&Jrknamec|Ktj|jj|d{S7w)a Request.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] ryNrrDrE header_valuerHrys rIr}zRequest.header_valueqs1&&T^^-H-Hd-H-S'STT'S /<: <NrAr-)!__name__ __module__ __qualname__propertystrrFrMrOtypingOptionalrRAnyrTbytesrVrZr]r_rbrrdDictrgrrjrmboolrorrListr rwr}rKrIr4r4Ys  ;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/CUrKr4ceZdZedefdZedefdZedefdZ edefdZ ede jeeffdZ edefdZeddZedd Zde jeeffd Zde j$efd Zd ede j*efd Zd ede j$efdZde j*efdZde j*efdZddZdefdZdefdZde j@fdZ!y)r5rAcTtj|jjS)zmResponse.url Contains the URL of the response. Returns ------- str rCrGs rIrFz Response.urlrJrKcTtj|jjS)zResponse.ok Contains a boolean stating whether the response was successful (status in the range 200-299) or not. Returns ------- bool rrDrEokrGs rIrz Response.ok&&t~~'8'899rKcTtj|jjS)zResponse.status Contains the status code of the response (e.g., 200 for a success). Returns ------- int rrDrEstatusrGs rIrzResponse.statusrPrKcTtj|jjS)zResponse.status_text Contains the status text of the response (e.g. usually an "OK" for a success). Returns ------- str rrDrE status_textrGs rIrzResponse.status_text&&t~~'A'ABBrKcTtj|jjS)azResponse.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] rfrGs rIrgzResponse.headersrhrKcTtj|jjS)a$Response.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 )rrDrEfrom_service_workerrGs rIrzResponse.from_service_workers&&t~~'I'IJJrKcTtj|jjS)zzResponse.request Returns the matching `Request` object. Returns ------- Request rrYrErequestrGs rIrzResponse.request  !7!788rKcTtj|jjS)zResponse.frame Returns the `Frame` that initiated this response. Returns ------- Frame rXrGs rIrZzResponse.frame  !5!566rKcxKtj|jjd{S7w)zResponse.all_headers An object with all the response HTTP headers associated with this response. Returns ------- Dict[str, str] NrqrGs rIrrzResponse.all_headersrsrkcxKtj|jjd{S7w)aeResponse.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}] NrurGs rIrwzResponse.headers_arrayrxrkryc|Ktj|jj|d{S7w)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] r{Nr|r~s rIr}zResponse.header_values1"&&T^^-H-Hd-H-S'STT'Src|Ktj|jj|d{S7w)a"Response.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] r{N)rrDrE header_valuesr~s rIrzResponse.header_values1&&T^^-I-It-I-T'TUU'TrcxKtj|jjd{S7w)zResponse.server_addr Returns the IP address and port of the server. Returns ------- Union[{ipAddress: str, port: int}, None] N)rr\rE server_addrrGs rIrzResponse.server_addr),))0J0J0L*LMM*LrkcxKtj|jjd{S7w)aResponse.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)rr\rEsecurity_detailsrGs rIrzResponse.security_details5s,))0O0O0Q*QRR*QrkNcxKtj|jjd{S7w)z]Response.finished Waits for this response to finish, returns always `null`. N)rrDrEfinishedrGs rIrzResponse.finishedAs, &&T^^-D-D-F'FGG'FrkcxKtj|jjd{S7w)zuResponse.body Returns the buffer with response body. Returns ------- bytes NrrDrEbodyrGs rIrz Response.bodyI,&&T^^-@-@-B'BCC'BrkcxKtj|jjd{S7w)z~Response.text Returns the text representation of response body. Returns ------- str NrrDrEtextrGs rIrz Response.textUrrkcxKtj|jjd{S7w)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 NrrDrEjsonrGs rIrz Response.jsona,&&T^^-@-@-B'BCC'BrkrAr4rrAN)"rrrrrrFrrintrrrrrgrrrZrrrr rwrr}rrrrrrrrrrrrrKrIr5r5s  ;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 DrKr5ceZdZeddZddej eddfdZdddddddddej e dej ejeefd ej ejee fd ej ejd ej ejeejfd ej ed ej dddfdZdddddddddej edej edej ejeefdej ejejee fdej e dej e dej eddfdZddddddej edej edej ejeefdej ejejee fddf dZddddddej edej edej ejeefdej ejejee fddf dZy)r6rAcTtj|jjS)zhRoute.request A request to be routed. Returns ------- Request rrGs rIrz Route.requesturrKN error_codec|Ktj|jj|d{S7w)aRoute.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)rrDrEabort)rHrs rIrz Route.aborts16&&T^^-A-AJ-A-W'WXX'Wr)rrgrrpath content_typermrrgrrrrrmr+c Ktj|jj|tj||tj||||r |jndd{S7w)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)rrgrrr contentTyperm)rrDrEfulfillto_impl)rHrrgrrrrrms rIrz Route.fulfillsnh&&..((0__T*(/7++T)    sA)A6+A4, A6)rFrOrgrR max_redirects max_retriestimeoutrFrOrRrrrc Ktj|jj||tj|tj||||d{S7w)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 )rFrOrgpostData maxRedirects maxRetriesrNrrYrEfetchr)rHrFrOrgrRrrrs rIrz Route.fetchsdx  ..&&0 3*&'    sAA(A& A()rFrOrgrRc Ktj|jj||tj|tj|d{S7w)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. rFrOrgrN)rrDrEfallbackrrHrFrOrgrRs rIrzRoute.fallback&s[d&&..))0 3 *    AA%A# A%c Ktj|jj||tj|tj|d{S7w)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. 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)rrDrE continue_rrs rIrzRoute.continue_s[^&&..**0 3 +    rrN)rrrrrrrrrrrUnionrrpathlibPathrfloatrrrrrKrIr6r6ss  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 6 __S !6 $ 6 S#X!67 6 ??6<< C0F#GH 6  6 rKr6c eZdZejdeddej dgdfddfdZejdeddej d gdfddfd Zejded dej d gdfddfd Zejded dej dgdfddfdZdedej dejejddffddffd Zejdeddej dgdfddfdZ ejdeddej d gdfddfdZ ejded dej d gdfddfdZ ejded dej dgdfddfdZ dedej dejejddffddffd Z e defdZ ddddedejej dejedefdZ ddddedejej dejedej$fdZdefdZxZS)r7eventclosef*typing.Union[typing.Awaitable[None], None]rANcyz) Fired when the websocket closes.NrrHrrs rIonz WebSocket.onrK framereceivedztyping.Union[bytes, str]cyz3 Fired when the websocket receives a frame.Nrrs rIrz WebSocket.onrrK framesentcyz0 Fired when the websocket sends a frame.Nrrs rIrz WebSocket.onrrK socketerrorrcyz/ Fired when the websocket has an error.Nrrs rIrz WebSocket.onrrK.c&t|||SNrrsuperrrHrr __class__s rIrz WebSocket.on wzz++rKcyrrrs rIoncezWebSocket.oncerrKcyrrrs rIrzWebSocket.oncerrKcyrrrs rIrzWebSocket.oncerrKcyrrrs rIrzWebSocket.once rrKc&t|||Srrrrs rIrzWebSocket.once w|%1|--rKcTtj|jjS)zoWebSocket.url Contains the URL of the WebSocket. Returns ------- str rCrGs rIrFz WebSocket.urlrJrKr predicaterct|jj||j||jS)a\WebSocket.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 rrrrrE expect_event _wrap_handlerfuturerHrrrs rIr zWebSocket.expect_event)s?6( NN ' 't'9'9)'Dg ( f  rKcKtj|jj||j ||d{S7w)aWebSocket.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 rNrrDrEwait_for_eventr r s rIrzWebSocket.wait_for_eventJN<&&..//t'9'9)'Dg0    AA A  A c\tj|jjS)zWebSocket.is_closed Indicates that the web socket has been closed. Returns ------- bool rrDrE is_closedrGs rIrzWebSocket.is_closedn"&&t~~'?'?'ABBrKr)rrrroverloadrCallablerrr AwaitablerrrFrrrr rrrr __classcell__rs@rIr7r7s __,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 CrKr7ceZdZedefdZddddejedejeddfdZ ddZ d ejee fddfd Z d ejejee fgejfddfd Zd ejejeejegejfddfd Zy)r8rAcTtj|jjS)z{WebSocketRoute.url URL of the WebSocket created in the page. Returns ------- str rCrGs rIrFzWebSocketRoute.urlrJrKNcodereasonrrc~Ktj|jj||d{S7w)aWebSocketRoute.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). rNrrDrEr)rHrrs rIrzWebSocketRoute.closes8&&..&&D&@ @  @ 0=; =c\tj|jjS)aWebSocketRoute.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 )rrYrEconnect_to_serverrGs rIr$z WebSocketRoute.connect_to_servers"*  !A!A!CDDrKmessagec`tj|jj|S)aWebSocketRoute.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. )r%)rrDrEsend)rHr%s rIr'zWebSocketRoute.sends'&&t~~':':7':'KLLrKhandlerc~tj|jj|j |S)aWebSocketRoute.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()rrDrE on_messager rHr(s rIr+zWebSocketRoute.on_messages7,&& NN % %d.@.@.I % J  rKc~tj|jj|j |S)a<WebSocketRoute.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*)rrDrEon_closer r,s rIr.zWebSocketRoute.on_closes7,&& NN # #D,>,>w,G # H  rK)rAr8)rrrrrrFrrrrr$rrr'rrr+r.rrKrIr8r8~s  ;S ; ;/3SW s+ ->3->-G'GHH'Grrc|Ktj|jj|d{S7w)uKeyboard.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)rrDrE insert_text)rHrs rIr:zKeyboard.insert_text3s1(&&T^^-G-GT-G-R'RSS'Rr)delayr;c~Ktj|jj||d{S7w)a$Keyboard.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. )rr;NrrDrEtype)rHrr;s rIr>z Keyboard.typeIs8:&&..%%4u%= =  =r"c~Ktj|jj||d{S7w)aKeyboard.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. )r0r;NrrDrEpress)rHr0r;s rIrAzKeyboard.pressjs5b&&T^^-A-AcQV-A-W'WXX'Wr") rrrrr4r8r:rrrr>rArrKrIr.r.s%Kc%Kd%KN IC ID ITcTdT,HL s fooe.D PT BHL1Ys1Yfooe.D1YPT1YrKr.c eZdZdddededej eddfdZdddd ej ed d ej eddfd Z dddd ej ed d ej eddfd Z dddddededej ed ej ed d ej eddf dZ ddddededej ed ej ed ddf dZ dededdfdZ y)r/N)stepsxyrCrAcKtj|jj|||d{S7w)aMouse.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. )rDrErCN)rrDrEmove)rHrDrErCs rIrGz Mouse.moves6"&&T^^-@-@1QV-@-W'WXX'W 1>< >)button click_countrIleftmiddlerightrJc~Ktj|jj||d{S7w)aMouse.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]. rI clickCountNr3rHrIrJs rIr4z Mouse.downs8$&&..%%V %L L  Lr"c~Ktj|jj||d{S7w)aMouse.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]. rPNr7rRs rIr8zMouse.ups8$&&..##6k#J J  Jr")r;rIrJr;c Ktj|jj|||||d{S7w)amMouse.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]. )rDrEr;rIrQN)rrDrEclick)rHrDrEr;rIrJs rIrUz Mouse.clicksG6&&..&&qf'    3A> A)r;rIcKtj|jj||||d{S7w)aAMouse.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`. )rDrEr;rIN)rrDrEdblclick)rHrDrEr;rIs rIrXzMouse.dblclicks<2&&..))A%)O O  O 2?= ?delta_xdelta_yc~Ktj|jj||d{S7w)a)Mouse.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)rrDrEwheel)rHrZr[s rIr_z Mouse.wheel s8"&&..&&gg&F F  Fr")rrrrrrrrGrr4r8rUrXr_rrKrIr/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 rKr/c eZdZdededdfdZy)r0rDrErANc~Ktj|jj||d{S7w)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. )rDrEN)rrDrEtap)rHrDrEs rIrbzTouchscreen.tap;s3&&T^^-?-?!q-?-I'IJJ'Ir")rrrrrbrrKrIr0r09s K5KUKtKrKr0c4eZdZ ddedej ej dej fdZ ddedej ej ddfdZdeddfdZ dejedffd Z dej d fd Z dd Z dej fd Zy)r1N expressionargrAcKtj|jj|tj|d{S7w)aYJSHandle.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 rdreNrrDrEevaluaterrHrdres rIrizJSHandle.evaluateRsK@&&..))%7??3+?*    AAA AcKtj|jj|tj|d{S7w)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 rgNrrYrEevaluate_handlerrjs rIrnzJSHandle.evaluate_handlexsJ<  ..00%7??3+?1    rk property_namec|Ktj|jj|d{S7w)zJSHandle.get_property Fetches a single property from the referenced object. Parameters ---------- property_name : str property to get Returns ------- JSHandle ) propertyNameN)rrYrE get_property)rHros rIrrzJSHandle.get_propertys6  ..--=-I I  IrcxKtj|jjd{S7w)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_dictrEget_propertiesrGs rIruzJSHandle.get_propertiess,(%%DNN,I,I,K&KLL&Krkr'c\tj|jjS)zJSHandle.as_element Returns either `null` or the object handle itself, if the object handle is an instance of `ElementHandle`. Returns ------- Union[ElementHandle, None] rr\rE as_elementrGs rIrxzJSHandle.as_element"))$..*C*C*EFFrKcxKtj|jjd{S7w)zfJSHandle.dispose The `jsHandle.dispose` method stops referencing the element handle. NrrDrEdisposerGs rIr|zJSHandle.dispose, &&T^^-C-C-E'EFF'ErkcxKtj|jjd{S7w)atJSHandle.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)rrDrE json_valuerGs rIrzJSHandle.json_values,&&T^^-F-F-H'HII'Hrkrr)rrrrrrrrirnrrrrurxr|rrrKrIr1r1PsCG$ $ $*OOFJJ$?$ $ NCG" " $*OOFJJ$?" " H   &Mfkk#z/&BM, GFOOO< GG J&** JrKr1ceZdZdejdfdZdejdfdZdejdfdZdedejefdZ dejefdZ defd Z defd Z de fd Zde fd Zde fd Zde fdZde fdZde fdZ dbdedejej(ddfdZdddejeddfdZddddddddejej0eddejedejedeje deje deje ddfdZdddddddddd dejej0eddejed!ejed"ejed#d$ejedejedeje deje deje ddfd%Zddddddddd&dejej0eddejed!ejed"ejed#dejedeje deje deje ddfd'Z dbddddddd(d)ejej>eej0efd*ejej>eej0efd+ejej>eej0efd,ejej>dej0dfdejedeje deje dej@efd-Z!ddddddd.dejej0eddejedejedeje deje deje ddfd/Z"dddd0d)edejedeje deje ddf d1Z#ddd2deje dejeddfd3Z$dddejedefd4Z%ddd5d6ej>ee&jNe(ej0ej>ee&jNfej0e(fdejedeje ddfd7Z)dcd8Z*dddd9d:ed!ejedejedeje ddf d;Z+dddd9dd?e dejedejedeje deje deje ddfd@Z-dddddd>dejedejedeje deje deje ddf dAZ.dddddd>dejedejedeje deje deje ddf dBZ/deje0fdCZ1ddddddddddddD dejedejedEdFejej>ee&jNfdGejedHeje dIejedJdKejedLdMejedNdOejej0dPdQejedRejede2fdSZ3dTedejdfdUZ4dTedej@dfdVZ5 dbdTedWedXejejldejlfdYZ7 dbdTedWedXejejldejlfdZZ8ddd[ed\dejeddfd]Z9dddd^dTed[ejed_dejed`eje dejdf daZ:y)dr'rAc\tj|jjS)zElementHandle.as_element Returns either `null` or the object handle itself, if the object handle is an instance of `ElementHandle`. Returns ------- Union[ElementHandle, None] rwrGs rIrxzElementHandle.as_elementryrKr-cxKtj|jjd{S7w)zElementHandle.owner_frame Returns the frame containing the given element. Returns ------- Union[Frame, None] N)rr\rE owner_framerGs rIrzElementHandle.owner_framerrkcxKtj|jjd{S7w)zElementHandle.content_frame Returns the content frame for element handles referencing iframe nodes, or `null` otherwise Returns ------- Union[Frame, None] N)rr\rE content_framerGs rIrzElementHandle.content_frames,))0L0L0N*NOO*Nrkryc|Ktj|jj|d{S7w)zElementHandle.get_attribute Returns element attribute value. Parameters ---------- name : str Attribute name to get the value for. Returns ------- Union[str, None] r{NrrDrE get_attributer~s rIrzElementHandle.get_attributerrcxKtj|jjd{S7w)zElementHandle.text_content Returns the `node.textContent`. Returns ------- Union[str, None] NrrDrE text_contentrGs rIrzElementHandle.text_content#s,&&T^^-H-H-J'JKK'JrkcxKtj|jjd{S7w)zxElementHandle.inner_text Returns the `element.innerText`. Returns ------- str NrrDrE inner_textrGs rIrzElementHandle.inner_text/,&&T^^-F-F-H'HII'HrkcxKtj|jjd{S7w)zxElementHandle.inner_html Returns the `element.innerHTML`. Returns ------- str NrrDrE inner_htmlrGs rIrzElementHandle.inner_html;rrkcxKtj|jjd{S7w)zElementHandle.is_checked Returns whether the element is checked. Throws if the element is not a checkbox or radio input. Returns ------- bool NrrDrE is_checkedrGs rIrzElementHandle.is_checkedGrrkcxKtj|jjd{S7w)zElementHandle.is_disabled Returns whether the element is disabled, the opposite of [enabled](https://playwright.dev/python/docs/actionability#enabled). Returns ------- bool NrrDrE is_disabledrGs rIrzElementHandle.is_disabledSrsrkcxKtj|jjd{S7w)zElementHandle.is_editable Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable). Returns ------- bool NrrDrE is_editablerGs rIrzElementHandle.is_editable_rsrkcxKtj|jjd{S7w)zElementHandle.is_enabled Returns whether the element is [enabled](https://playwright.dev/python/docs/actionability#enabled). Returns ------- bool NrrDrE is_enabledrGs rIrzElementHandle.is_enabledkrrkcxKtj|jjd{S7w)zElementHandle.is_hidden Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible). Returns ------- bool NrrDrE is_hiddenrGs rIrzElementHandle.is_hiddenws,&&T^^-E-E-G'GHH'GrkcxKtj|jjd{S7w)zElementHandle.is_visible Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). Returns ------- bool NrrDrE is_visiblerGs rIrzElementHandle.is_visiblerrkNr> event_initcKtj|jj|tj|d{S7w)aP ElementHandle.dispatch_event The snippet below dispatches the `click` event on the element. Regardless of the visibility state of the element, `click` is dispatched. This is equivalent to calling [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click). **Usage** ```py await element_handle.dispatch_event("click") ``` Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default. Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties: - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent) - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent) - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent) - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event) - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent) - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent) - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent) - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent) - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent) - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent) You can also specify `JSHandle` as the property value if you want live objects to be passed into the event: ```py # note you can only create data_transfer in chromium and firefox data_transfer = await page.evaluate_handle("new DataTransfer()") await element_handle.dispatch_event("#source", "dragstart", {"dataTransfer": data_transfer}) ``` Parameters ---------- type : str DOM event type: `"click"`, `"dragstart"`, etc. event_init : Union[Dict, None] Optional event-specific initialization properties. )r> eventInitNrrDrEdispatch_eventr)rHr>rs rIrzElementHandle.dispatch_eventsK\&&..//W__Z%@0    rkrrc|Ktj|jj|d{S7w)aElementHandle.scroll_into_view_if_needed This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless it is completely visible as defined by [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`. Throws when `elementHandle` does not point to an element [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot. See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll. Parameters ---------- timeout : Union[float, None] Maximum time 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()` or `page.set_default_timeout()` methods. rNrrDrEscroll_into_view_if_neededrHrs rIrz(ElementHandle.scroll_into_view_if_neededs6*&&..;;G;L L  Lr modifierspositionr no_wait_afterforcetrialrAltControl ControlOrMetaMetaShiftrrrrc Ktj|jjtj||||||d{S7w)aQElementHandle.hover This method hovers over the element by performing the following steps: 1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set. 1. Scroll the element into view if needed. 1. Use `page.mouse` to hover over the center of the element, or the specified `position`. If the element is detached from the DOM at any moment during the action, this method throws. When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing zero timeout disables this. Parameters ---------- modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None] Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows and Linux and to "Meta" on macOS. position : Union[{x: float, y: float}, None] A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the element. timeout : Union[float, None] Maximum time 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()` or `page.set_default_timeout()` methods. no_wait_after : Union[bool, None] This option has no effect. Deprecated: This option has no effect. force : Union[bool, None] Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`. trial : Union[bool, None] When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults to `false`. Useful to wait until the element is ready for the action without performing it. rrr noWaitAfterrrNrrDrEhoverrrHrrrrrrs rIrzElementHandle.hoversX\&&..&&!//)4!) '    AA A A rrr;rIrJrrrrr;rIrKrJc Ktj|jjtj|||||||||  d{S7w)a ElementHandle.click This method clicks the element by performing the following steps: 1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set. 1. Scroll the element into view if needed. 1. Use `page.mouse` to click in the center of the element, or the specified `position`. 1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. If the element is detached from the DOM at any moment during the action, this method throws. When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing zero timeout disables this. Parameters ---------- modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None] Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows and Linux and to "Meta" on macOS. position : Union[{x: float, y: float}, None] A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the element. 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]. timeout : Union[float, None] Maximum time 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()` or `page.set_default_timeout()` methods. force : Union[bool, None] Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`. no_wait_after : Union[bool, None] Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to inaccessible pages. Defaults to `false`. Deprecated: This option will default to `true` in the future. trial : Union[bool, None] When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults to `false`. Useful to wait until the element is ready for the action without performing it. rrr;rIrQrrrrNrrDrErUr rHrrr;rIrJrrrrs rIrUzElementHandle.clicksat&&..&&!//)4!&)'     A A A Arrr;rIrrrrc Ktj|jjtj||||||||d{S7w)a ElementHandle.dblclick This method double clicks the element by performing the following steps: 1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set. 1. Scroll the element into view if needed. 1. Use `page.mouse` to double click in the center of the element, or the specified `position`. If the element is detached from the DOM at any moment during the action, this method throws. When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing zero timeout disables this. **NOTE** `elementHandle.dblclick()` dispatches two `click` events and a single `dblclick` event. Parameters ---------- modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None] Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows and Linux and to "Meta" on macOS. position : Union[{x: float, y: float}, None] A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the element. 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`. timeout : Union[float, None] Maximum time 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()` or `page.set_default_timeout()` methods. force : Union[bool, None] Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`. no_wait_after : Union[bool, None] This option has no effect. Deprecated: This option has no effect. trial : Union[bool, None] When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults to `false`. Useful to wait until the element is ready for the action without performing it. rrr;rIrrrrNrrDrErXr rHrrr;rIrrrrs rIrXzElementHandle.dblclick]s^l&&..))!//)4!)*     A A A A)indexlabelelementrrrvaluerrrc Ktj|jjtj|tj|tj|tj||||d{S7w)a ElementHandle.select_option This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in the `` element, this method throws an error. However, if the element is inside the `