h~rddlmZmZmZmZddlmZddlmZGddZ GddZ Gd d Z Gd d Z Gd de Z GddZGddZGddZGddZGddZy))AnyCallableOptionalUnion)command_builder)SessionceZdZdZdZdZdZy)ReadinessStatezSRepresents the stage of document loading at which a navigation command will return.none interactivecompleteN)__name__ __module__ __qualname____doc__NONE INTERACTIVECOMPLETEr/home/bbl/html/w1hd.aprs.trek/venv/lib/python3.12/site-packages/selenium/webdriver/common/bidi/browsing_context.pyr r s] DKHrr c eZdZdZdZdZdZdZy)UserPromptTypez*Represents the possible user prompt types.alert beforeunloadconfirmpromptN)rrrrALERT BEFORE_UNLOADCONFIRMPROMPTrrrrr!s4 E"MG FrrcHeZdZdZdedeededefdZede ddfd Z y ) NavigationInfoz*Provides details of an ongoing navigation.context navigation timestampurlc<||_||_||_||_yN)r%r&r'r()selfr%r&r'r(s r__init__zNavigationInfo.__init__-s  $"rjsonreturnc|jd}|t|ts td|jd}|t|ts td|jd}|t|tr|dkr td|jd}|t|ts td |||||S) a Creates a NavigationInfo instance from a dictionary. Parameters: ----------- json: A dictionary containing the navigation information. Returns: ------- NavigationInfo: A new instance of NavigationInfo. r%(context is required and must be a stringr&navigation must be a stringr'r8timestamp is required and must be a non-negative integerr($url is required and must be a stringget isinstancestr ValueErrorint)clsr-r%r&r'r(s r from_jsonzNavigationInfo.from_json9s((9% ?*Wc":GH HXXl+  !*Z*E:; ;HH[)  Jy#$>)a-WX Xhhuo ;jc2CD D7J 377rN) rrrrr7rr9r, classmethoddictr;rrrr$r$*sW4  SM    8T8&688rr$cleZdZdZ ddededeeddededeed eefd Zed e d dfd Z y)BrowsingContextInfoz)Represents the properties of a navigable.Nr%r(children client_window user_contextparentoriginal_openercf||_||_||_||_||_||_||_yr*)r%r(r@rCrBrDrA)r+r%r(r@rArBrCrDs rr,zBrowsingContextInfo.__init__[s8    (.*rr-r.c Pd}|jd}|ot|ts tdg}|D]M}t|tstdt ||j tj|O|jd}|t|ts td|jd}|t|ts td|jd }|t|ts td |jd }|t|ts td |jd } | t| ts td|jd} | t| ts td||||| ||| S)a!Creates a BrowsingContextInfo instance from a dictionary. Parameters: ----------- json: A dictionary containing the browsing context information. Returns: ------- BrowsingContextInfo: A new instance of BrowsingContextInfo. Nr@z#children must be a list if providedz%Each child must be a dictionary, got r%r0r(r3rCz#parent must be a string if provided userContextz,userContext is required and must be a stringoriginalOpenerz+originalOpener must be a string if provided clientWindowz-clientWindow is required and must be a string)r%r(r@rArBrCrD) r5r6listr8r=typeappendr?r;r7) r:r-r@ raw_childrenchildr%r(rCrBrDrAs rr;zBrowsingContextInfo.from_jsonmsxx +  #lD1 !FGGH% F!%.$'LTRW[M%Z[[ 3 = =e DE F ((9% ?*Wc":GH Hhhuo ;jc2CD D(#  j&=BC Cxx .  z,'DKL L((#34  &z/3/OJK K0  =#(FLM M'%+  rNN) rrrrr7rrJr,r<r=r;rrrr?r?Xs3!%)-+++4 567 +  +  + +"#+$7 T7 &;7 7 rr?c XeZdZdZdedeedededef fd Zede d dfd Z xZ S) DownloadWillBeginParamsz+Parameters for the downloadWillBegin event.r%r&r'r(suggested_filenamec8t|||||||_yr*)superr,rR)r+r%r&r'r(rR __class__s rr,z DownloadWillBeginParams.__init__s  *i="4rr-r.c|jd}|t|ts td|jd}|t|ts td|jd}|t|tr|dkr td|jd}|t|ts td |jd }|t|ts td |||||| S) a$Creates a DownloadWillBeginParams instance from a dictionary. Parameters: ----------- json: A dictionary containing the download parameters. Returns: ------- DownloadWillBeginParams: A new instance of DownloadWillBeginParams. r%r0r&r1r'rr2r(r3suggestedFilenamez2suggestedFilename is required and must be a string)r%r&r'r(rRr4)r:r-r%r&r'r(rRs rr;z!DownloadWillBeginParams.from_jsons((9% ?*Wc":GH HXXl+  !*Z*E:; ;HH[)  Jy#$>)a-WX Xhhuo ;jc2CD D!XX&9:  %Z8JC-PQR R!1   r) rrrrr7rr9r,r<r=r; __classcell__)rUs@rrQrQsb5 5 5SM 5 5  5  5% T% &?% % rrQc PeZdZdZ d dededededeef dZed ed dfd Z y) UserPromptOpenedParamsz*Parameters for the userPromptOpened event.Nr%handlermessagerK default_valuecJ||_||_||_||_||_yr*r%r[r\rKr])r+r%r[r\rKr]s rr,zUserPromptOpenedParams.__init__s(    *rr-r.c|jd}|t|ts td|jd}|t|ts td|jd}|t|ts td|jd}|t|ts td|jd }|t|ts td |||||| S) a$Creates a UserPromptOpenedParams instance from a dictionary. Parameters: ----------- json: A dictionary containing the user prompt parameters. Returns: ------- UserPromptOpenedParams: A new instance of UserPromptOpenedParams. r%r0r[z(handler is required and must be a stringr\z(message is required and must be a stringrK%type is required and must be a string defaultValuez)defaultValue must be a string if providedr_r5r6r7r8)r:r-r%r[r\ type_valuer]s rr;z UserPromptOpenedParams.from_jsons((9% ?*Wc":GH H((9% ?*Wc":GH H((9% ?*Wc":GH HXXf%  Z C%@DE E0  $Z s-KHI I'   rr*) rrrrr7rr,r<r=r;rrrrZrZsf4(, + + + +  +  } +% T% &>% % rrZc LeZdZdZ d dedededeefdZede d dfd Z y) UserPromptClosedParamsz*Parameters for the userPromptClosed event.Nr%acceptedrK user_textc<||_||_||_||_yr*r%rgrKrh)r+r%rgrKrhs rr,zUserPromptClosedParams.__init__s     "rr-r.c|jd}|t|ts td|jd}|t|ts td|jd}|t|ts td|jd}|t|ts td||||| S) a+Creates a UserPromptClosedParams instance from a dictionary. Parameters: ----------- json: A dictionary containing the user prompt closed parameters. Returns: ------- UserPromptClosedParams: A new instance of UserPromptClosedParams. r%r0rgz*accepted is required and must be a booleanrKrauserTextz%userText must be a string if providedrj)r5r6r7r8bool)r:r-r%rgrdrhs rr;z UserPromptClosedParams.from_json(s((9% ?*Wc":GH H88J'  :h#=IJ JXXf%  Z C%@DE EHHZ(  Is)CDE E   rr*) rrrrr7rmrr,r<r=r;rrrrfrfs\4$( # # # # C= #  T  &>    rrfc>eZdZdZdededefdZededdfdZ y ) HistoryUpdatedParamsz(Parameters for the historyUpdated event.r%r'r(c.||_||_||_yr*r%r'r()r+r%r'r(s rr,zHistoryUpdatedParams.__init__Os  "rr-r.c6|jd}|t|ts td|jd}|t|tr|dkr td|jd}|t|ts td||||S) a"Creates a HistoryUpdatedParams instance from a dictionary. Parameters: ----------- json: A dictionary containing the history updated parameters. Returns: ------- HistoryUpdatedParams: A new instance of HistoryUpdatedParams. r%r0r'rr2r(r3rqr4)r:r-r%r'r(s rr;zHistoryUpdatedParams.from_jsonYs((9% ?*Wc":GH HHH[)  Jy#$>)a-WX Xhhuo ;jc2CD D  rN) rrrrr7r9r,r<r=r;rrrroroLsI2  T &<  rroc6eZdZdZdefdZededdfdZy)BrowsingContextEventz'Base class for browsing context events. event_classc ||_||_yr*)ruparams)r+rukwargss rr,zBrowsingContextEvent.__init__{s& rr-r.cr|jd}|t|ts td|dd|i|S)aCreates a BrowsingContextEvent instance from a dictionary. Parameters: ----------- json: A dictionary containing the event information. Returns: ------- BrowsingContextEvent: A new instance of BrowsingContextEvent. ruz,event_class is required and must be a stringrrc)r:r-rus rr;zBrowsingContextEvent.from_jsons@hh}-  jc&BKL L3{3d33rN) rrrrr7r,r<r=r;rrrrtrtxs41C4T4&<44rrtceZdZdZdddddddd d d d d dd ZdZdeddfdZ dFdededee dee def dZ dGdede ddfdZ dHdedeede deedef d Z dId!eed"eedeefd#Z dIded$ee d%eeddfd&Z dJded'e d(eed)ee d*eee dee f d+Z dKded,ed-eede fd.Z dLdede d/ee d0ed1ee d2eeeeefd3ed4e defd5Z dIded6ee d-eede fd7Z dMdeedee d8eed9eeeddf d:Zded;ede fd<Zd=ed>edefd?ZdKd@ed>edAeeedefdBZd@edCeddfdDZdNdEZy)OBrowsingContextz2BiDi implementation of the browsingContext module.zbrowsingContext.contextCreatedz browsingContext.contextDestroyedz browsingContext.domContentLoadedz!browsingContext.downloadWillBeginz!browsingContext.fragmentNavigatedzbrowsingContext.historyUpdatedzbrowsingContext.loadz!browsingContext.navigationAbortedz#browsingContext.navigationCommittedz browsingContext.navigationFailedz!browsingContext.navigationStartedz browsingContext.userPromptClosedz browsingContext.userPromptOpened) context_createdcontext_destroyeddom_content_loadeddownload_will_beginfragment_navigatedhistory_updatedloadnavigation_abortednavigation_committednavigation_failednavigation_starteduser_prompt_closeduser_prompt_openedc.||_i|_i|_yr*)conn subscriptions callbacks)r+rs rr,zBrowsingContext.__init__s rr%r.NcVd|i}|jjtd|y)aActivates and focuses the given top-level traversable. Parameters: ----------- context: The browsing context ID to activate. Raises: ------ Exception: If the browsing context is not a top-level traversable. r%zbrowsingContext.activateNrexecuter)r+r%rws ractivatezBrowsingContext.activates(W% /*DfMNrviewportoriginformatclipc|||d}|||d<|||d<|jjtd|}|dS)aCaptures an image of the given navigable, and returns it as a Base64-encoded string. Parameters: ----------- context: The browsing context ID to capture. origin: The origin of the screenshot, either "viewport" or "document". format: The format of the screenshot. clip: The clip rectangle of the screenshot. Returns: ------- str: The Base64-encoded screenshot. )r%rrrz!browsingContext.captureScreenshotdatar)r+r%rrrrwresults rcapture_screenshotz"BrowsingContext.capture_screenshotsT(.5!G  %F8   !F6N""?3VX^#_`f~r prompt_unloadcX||d}|jjtd|y)a/Closes a top-level traversable. Parameters: ----------- context: The browsing context ID to close. prompt_unload: Whether to prompt to unload. Raises: ------ Exception: If the browsing context is not a top-level traversable. )r% promptUnloadzbrowsingContext.closeNr)r+r%rrws rclosezBrowsingContext.closes(%mD /*A6JKrrKreference_context backgroundrBcd|i}|||d<|||d<|||d<|jjtd|}|dS)aCreates a new navigable, either in a new tab or in a new window, and returns its navigable id. Parameters: ----------- type: The type of the new navigable, either "tab" or "window". reference_context: The reference browsing context ID. background: Whether to create the new navigable in the background. user_context: The user context ID. Returns: ------- str: The browsing context ID of the created navigable. rKreferenceContextrrGzbrowsingContext.creater%r)r+rKrrrBrwrs rcreatezBrowsingContext.createse(#)$  ():F% &  !#-F<  #$0F= !""?3KV#TUi  r max_depthrootci}|||d<|||d<|jjtd|}|dDcgc]}tj |c}Scc}w)aReturns a tree of all descendent navigables including the given parent itself, or all top-level contexts when no parent is provided. Parameters: ----------- max_depth: The maximum depth of the tree. root: The root browsing context ID. Returns: ------- List[BrowsingContextInfo]: A list of browsing context information. maxDepthrzbrowsingContext.getTreecontexts)rrrr?r;)r+rrrwrr%s rget_treezBrowsingContext.get_treesi""$  !*F:   !F6N""?3Lf#UVFLZFXY7#--g6YYYsAacceptrhcrd|i}|||d<|||d<|jjtd|y)zAllows closing an open prompt. Parameters: ----------- context: The browsing context ID. accept: Whether to accept the prompt. user_text: The text to enter in the prompt. r%Nrrlz browsingContext.handleUserPromptr)r+r%rrhrws rhandle_user_promptz"BrowsingContext.handle_user_promptsH#,W!5  %F8   !*F:  /*LfUVrlocatormax_node_countserialization_options start_nodesc||d}|||d<|||d<|||d<|jjtd|}|dS)aReturns a list of all nodes matching the specified locator. Parameters: ----------- context: The browsing context ID. locator: The locator to use. max_node_count: The maximum number of nodes to return. serialization_options: The serialization options. start_nodes: The start nodes. Returns: ------- List[Dict]: A list of nodes. )r%r maxNodeCountserializationOptions startNodeszbrowsingContext.locateNodesnodesr)r+r%rrrrrwrs r locate_nodeszBrowsingContext.locate_nodes3sf,.5!I  %%3F> " ,-BF) *  "#.F< ""?3PRX#YZgrr(waitch||d}|||d<|jjtd|}|S)aFNavigates a navigable to the given URL. Parameters: ----------- context: The browsing context ID. url: The URL to navigate to. wait: The readiness state to wait for. Returns: ------- Dict: A dictionary containing the navigation result. )r%r(rzbrowsingContext.navigater)r+r%r(rrwrs rnavigatezBrowsingContext.navigateTs>$%S1  !F6N""?3Mv#VW rmargin orientationpage page_rangesscale shrink_to_fitc |||||d} ||| d<||| d<||| d<|jjtd| } | dS)aCreates a paginated representation of a document, and returns it as a PDF document represented as a Base64-encoded string. Parameters: ----------- context: The browsing context ID. background: Whether to include the background. margin: The margin parameters. orientation: The orientation, either "portrait" or "landscape". page: The page parameters. page_ranges: The page ranges. scale: The scale. shrink_to_fit: Whether to shrink to fit. Returns: ------- str: The Base64-encoded PDF document. )r%rrr shrinkToFitrr pageRangeszbrowsingContext.printrr) r+r%rrrrrrrrwrs rprintzBrowsingContext.printmsq<$&(    %F8   !F6N  "#.F< ""?3JF#STf~r ignore_cachectd|i}|||d<|||d<|jjtd|}|S)aAReloads a navigable. Parameters: ----------- context: The browsing context ID. ignore_cache: Whether to ignore the cache. wait: The readiness state to wait for. Returns: ------- Dict: A dictionary containing the navigation result. r% ignoreCacherzbrowsingContext.reloadr)r+r%rrrwrs rreloadzBrowsingContext.reloadsN$#,W!5  #$0F= !  !F6N""?3KV#TU rdevice_pixel_ratio user_contextsci}|||d<|||d<|||d<|||d<|jjtd|y)aModifies specific viewport characteristics on the given top-level traversable. Parameters: ----------- context: The browsing context ID. viewport: The viewport parameters. device_pixel_ratio: The device pixel ratio. user_contexts: The user context IDs. Raises: ------ Exception: If the browsing context is not a top-level traversable. Nr%rdevicePixelRatio userContextszbrowsingContext.setViewportr)r+r%rrrrws r set_viewportzBrowsingContext.set_viewportsd("$   'F9   !)F:   ));F% &  $%2F> " /*GPQrdeltacZ||d}|jjtd|}|S)a,Traverses the history of a given navigable by a delta. Parameters: ----------- context: The browsing context ID. delta: The delta to traverse by. Returns: ------- Dict: A dictionary containing the traverse history result. )r%rzbrowsingContext.traverseHistoryr)r+r%rrwrs rtraverse_historyz BrowsingContext.traverse_historys0%u5""?3TV\#]^ r event_namecallbackct}fd}jj||}jvr jj ||S|gj<|S)a%Set a callback function to subscribe to a browsing context event. Parameters: ---------- event_name: The event to subscribe to. callback: The callback function to execute on event. Returns: ------- int: callback id cjdk(sjdk(r(tj|j}|yjdk(r(tj|j}|yjdk(r(t j|j}|yjdk(r(t j|j}|yjdk(r(tj|j}|ytj|j}|y)Nr|r}rrrr) EVENTSr?r;rwrQrZrfror$) event_datainforwrrr+s r _callbackz,BrowsingContext._on_event.._callbacks"T[[):;;zT[[YlMm?m*44Z5F5FGt{{+@AA0:::;L;LM t{{+?@@/99*:K:KL t{{+?@@/99*:K:KL t{{+<==-77 8I8IJ &// 0A0ABr)rtr add_callbackrrL)r+rreventr callback_ids``` r _on_eventzBrowsingContext._on_eventso%Z0 *ii,,UI>  ' NN: & - -k :+6DNN: &rrrc |j|}|j||}||jvr |j|j ||Sd|gi}|||d<t |j}|jj|jdi||g|j|<|S#t$rtd|dwxYw)aLAdd an event handler to the browsing context. Parameters: ---------- event: The event to subscribe to. callback: The callback function to execute on event. contexts: The browsing context IDs to subscribe to. Returns: ------- int: callback id Event not foundeventsbrowsingContextsr) rKeyError ExceptionrrrLr rr subscribe)r+rrrrrrwsessions radd_event_handlerz!BrowsingContext.add_event_handlers 8U+JnnZ: ++ +   z * 1 1+ > -F#-5)*dii(G II  /g//9&9 :.9]D  z * 8fUG:67 7 8s B//Crc |j|}t|}|jj ||||j vr{|j |}||vrg|j||sSd|gi}t|j}|jj|jdi||j |=yyyy#t$rtd|dwxYw)zRemove an event handler from the browsing context. Parameters: ---------- event: The event to unsubscribe from. callback_id: The callback id to remove. rrrNr) rrrrtrremove_callbackrremover r unsubscribe)r+rrr event_objrrwrs rremove_event_handlerz$BrowsingContext.remove_event_handler2s 8U+J)4  !!)[9 ++ +**:6Ii'  - & 5F%dii0GII%%&9g&9&9&CF&CD**:6 !( ,  8fUG:67 7 8s CCc4|jD]}t|}|j|D]}|jj|| d|gi}t |j}|jj |j di|i|_y)z3Clear all event handlers from the browsing context.rNr)rrtrrr rr)r+rrrrwrs rclear_event_handlersz$BrowsingContext.clear_event_handlersLs,, =J(4E#11*= >  ))%= > -Fdii(G II  1g11;F; <  = r)rNN)F)NFNrO)NNNr*)FNportraitNNg?T)NNNN)r.N) rrrrrr,r7rrr=rrmrrr9rJr?rrrrrfloatrrrrrrrrrrrrr{r{s<<?@BA;&A E?A@@F  O O O"!!%#   tn  : LS L L$ L$,0 &* !!$C=! ! sm ! !B$("ZC=ZsmZ ! " Z:"&#' WWWC= W  W4)-04,0 !  (~  d4j)  dJ# sm   8!!%%#7;",,, ,  , tn ,d5c?34,,, ,b(," tnsm   :"&#'.2-1 R#R4.R%UO R  S * R  R@CD *C*8**Xsh(SWX[S\J]il@7#7C7D74  rr{N)typingrrrr%selenium.webdriver.common.bidi.commonrrr r rr$r?rQrZrfrortr{rrrrs$21A+8+8\M M `4 n4 n7 7 t0 0 f) ) X444C C r