U
|
[ ±dTH ã
|
@ sj d dl mZ ddlmZmZ d dlmZ d dlZd dlZddl m
|
Z
|
G dd de Z G d d
|
d
|
e Z eG d d d ZeG d d dZdddddZdbddddddZddddZdddd d Zdcdd dd d d!Zdddd d d"d#d$d%Zd&dd'd(Zded)d*d*d+dddd,d-d.d/Zdfd0d1dd2d3d4Zd5dd6d7d8Zdgd1d9dd:d;Zd<dd=d>Zdhd)d0d1dd?d@dAZ didBdBdddCdDdEZ dBddFdGdHZ dIddJdKdLZ edMeG dNdO dOZ edPeG dQdR dRZ!edSeG dTdU dUZ"edVeG dWdX dXZ#edYeG dZd[ d[Z$ed\eG d]d^ d^Z%ed_eG d`da daZ&dS )jé )Ú annotationsé )Ú event_classÚ T_JSON_DICT)Ú dataclassN)Úbrowserc s> e Zd ZddddZedd dddZ fdd Z ZS )
|
ÚTargetIDÚstr©Úreturnc C s | S ©N© ©Úselfr r údd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/common/devtools/v85/target.pyÚto_json s zTargetID.to_json©Újsonr c C s | |S r r ©Úclsr r r r Ú from_json s zTargetID.from_jsonc s d t ¡ ¡S )Nz TargetID({})©ÚformatÚsuperÚ__repr__r ©Ú __class__r r r s zTargetID.__repr__)Ú__name__Ú
|
__module__Ú __qualname__r Ú classmethodr r Ú __classcell__r r r r r s r c sB e Zd ZdZddddZedd dddZ fd d
|
Z ZS ) Ú SessionIDz:
|
Unique identifier of attached debugging session.
|
r r
|
c C s | S r r r r r r r s zSessionID.to_jsonr c C s | |S r r r r r r r " s zSessionID.from_jsonc s d t ¡ ¡S )Nz SessionID({})r r r r r r & s zSessionID.__repr__) r r r Ú__doc__r r r r r! r r r r r" s
|
r" c @ sb e Zd ZU ded< ded< ded< ded< ded< d Zd
|
ed < d Zd ed < dd Zedd Zd S )Ú
|
TargetInfor Ú target_idr Útype_ÚtitleÚurlÚboolÚattachedNútyping.Optional[TargetID]Ú opener_idú)typing.Optional[browser.BrowserContextID]Úbrowser_context_idc C sp t }| j ¡ |d< | j|d< | j|d< | j|d< | j|d< | jd k rT| j ¡ |d< | jd k rl| j ¡ |d< |S )NÚtargetIdÚtyper' r( r* ÚopenerIdÚbrowserContextId) Údictr% r r& r' r( r* r, r. ©r r r r r r < s
|
|
|
|
|
|
zTargetInfo.to_jsonc C sn | t |d ¡t|d t|d t|d t|d d|krLt |d ¡nd d|krftj |d ¡nd dS ) Nr/ r0 r' r( r* r1 r2 )r% r& r' r( r* r, r. )r r r r) r ÚBrowserContextIDr r r r r I s
|
|
|
|
ùzTargetInfo.from_json) r r r Ú__annotations__r, r. r r r r r r r r$ * s
|
r$ c @ s2 e Zd ZU ded< ded< dd Zedd Zd S )
|
ÚRemoteLocationr ÚhostÚintÚportc C s t }| j|d< | j|d< |S )Nr8 r: )r3 r8 r: r4 r r r r \ s
|
|
zRemoteLocation.to_jsonc C s | t |d t|d dS )Nr8 r: )r8 r: )r r9 r r r r r b s
|
|
þzRemoteLocation.from_jsonN)r r r r6 r r r r r r r r7 V s
|
|
r7 z0typing.Generator[T_JSON_DICT, T_JSON_DICT, None])r% r c c s& t }| ¡ |d< d|d}|V }dS )z@
|
Activates (focuses) the target.
|
|
:param target_id:
|
r/ zTarget.activateTarget©ÚmethodÚparamsN©r3 r ©r% r= Úcmd_dictr r r r Úactivate_targetj s þrA ztyping.Optional[bool]z5typing.Generator[T_JSON_DICT, T_JSON_DICT, SessionID])r% Úflattenr c c s@ t }| ¡ |d< |dk r"||d< d|d}|V }t |d ¡S )aZ
|
Attaches to the target with given id.
|
|
:param target_id:
|
:param flatten: *(Optional)* Enables "flat" access to the session via specifying sessionId attribute in the commands. We plan to make this the default, deprecate non-flattened mode, and eventually retire it. See crbug.com/991325.
|
:returns: Id assigned to the session.
|
r/ NrB zTarget.attachToTargetr; Ú sessionId)r3 r r" r )r% rB r= r@ r r r r Úattach_to_target{ s þrD r
|
c c s ddi} | V }t |d ¡S )z
|
Attaches to the browser target, only uses flat sessionId mode.
|
|
**EXPERIMENTAL**
|
|
:returns: Id assigned to the session.
|
r< z Target.attachToBrowserTargetrC )r" r ©r@ r r r r Úattach_to_browser_target s
|
ÿrF z0typing.Generator[T_JSON_DICT, T_JSON_DICT, bool]c c s. t }| ¡ |d< d|d}|V }t|d S )zp
|
Closes the target. If the target is a page that gets closed too.
|
|
:param target_id:
|
:returns:
|
r/ zTarget.closeTargetr; Úsuccess)r3 r r) r? r r r Ú close_target¡ s þrH ztyping.Optional[str])r% Ú binding_namer c c s6 t }| ¡ |d< |dk r"||d< d|d}|V }dS )a@
|
Inject object to the target's main frame that provides a communication
|
channel with browser target.
|
|
Injected object will be available as ``window[bindingName]``.
|
|
The object has the follwing API:
|
- ``binding.send(json)`` - a method to send messages over the remote debugging protocol
|
- ``binding.onmessage = json => handleMessage(json)`` - a callback that will be called for the protocol notifications and command responses.
|
|
**EXPERIMENTAL**
|
|
:param target_id:
|
:param binding_name: *(Optional)* Binding name, 'cdp' if not specified.
|
r/ NZ bindingNamez Target.exposeDevToolsProtocolr; r> )r% rI r= r@ r r r r Úexpose_dev_tools_protocol´ s þrJ zDtyping.Generator[T_JSON_DICT, T_JSON_DICT, browser.BrowserContextID])Údispose_on_detachÚ proxy_serverÚproxy_bypass_listr c c sV t }| dk r| |d< |dk r&||d< |dk r6||d< d|d}|V }tj |d ¡S )a÷
|
Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than
|
one.
|
|
**EXPERIMENTAL**
|
|
:param dispose_on_detach: *(Optional)* If specified, disposes this context when debugging session disconnects.
|
:param proxy_server: *(Optional)* Proxy server, similar to the one passed to --proxy-server
|
:param proxy_bypass_list: *(Optional)* Proxy bypass list, similar to the one passed to --proxy-bypass-list
|
:returns: The id of the context created.
|
NZdisposeOnDetachÚ proxyServerZproxyBypassListzTarget.createBrowserContextr; r2 )r3 r r5 r )rK rL rM r= r@ r r r r Úcreate_browser_contextÒ s þrO zQtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.List[browser.BrowserContextID]]c c s ddi} | V }dd |d D S )z¡
|
Returns all browser contexts created with ``Target.createBrowserContext`` method.
|
|
**EXPERIMENTAL**
|
|
:returns: An array of browser context ids.
|
r< zTarget.getBrowserContextsc S s g | ]}t j |¡qS r )r r5 r ©Ú.0Úir r r Ú
|
<listcomp>ý s z(get_browser_contexts.<locals>.<listcomp>ZbrowserContextIdsr rE r r r Úget_browser_contextsñ s
|
ÿrT r ztyping.Optional[int]r- z4typing.Generator[T_JSON_DICT, T_JSON_DICT, TargetID])r( ÚwidthÚheightr. Úenable_begin_frame_controlÚ
|
new_windowÚ
|
backgroundr c
|
c s t }| |d< |dk r ||d< |dk r.||d< |dk rB| ¡ |d< |dk rR||d< |dk rb||d< |dk rr||d< d |d
|
}|V } t | d ¡S ) a-
|
Creates a new page.
|
|
:param url: The initial URL the page will be navigated to.
|
:param width: *(Optional)* Frame width in DIP (headless chrome only).
|
:param height: *(Optional)* Frame height in DIP (headless chrome only).
|
:param browser_context_id: *(Optional)* The browser context to create the page in.
|
:param enable_begin_frame_control: **(EXPERIMENTAL)** *(Optional)* Whether BeginFrames for this target will be controlled via DevTools (headless chrome only, not supported on MacOS yet, false by default).
|
:param new_window: *(Optional)* Whether to create a new Window or Tab (chrome-only, false by default).
|
:param background: *(Optional)* Whether to create the target in background or foreground (chrome-only, false by default).
|
:returns: The id of the page opened.
|
r( NrU rV r2 ZenableBeginFrameControlZ newWindowrY zTarget.createTargetr; r/ )r3 r r r )
|
r( rU rV r. rW rX rY r= r@ r r r r Ú create_target s& þrZ ztyping.Optional[SessionID]r+ )Ú
|
session_idr% r c c sB t }| dk r| ¡ |d< |dk r.| ¡ |d< d|d}|V }dS )z
|
Detaches session with given id.
|
|
:param session_id: *(Optional)* Session to detach.
|
:param target_id: *(Optional)* Deprecated.
|
NrC r/ zTarget.detachFromTargetr; r> )r[ r% r= r@ r r r r Údetach_from_target+ s
|
þr\ zbrowser.BrowserContextID)r. r c c s& t }| ¡ |d< d|d}|V }dS )z®
|
Deletes a BrowserContext. All the belonging pages will be closed without calling their
|
beforeunload hooks.
|
|
**EXPERIMENTAL**
|
|
:param browser_context_id:
|
r2 z Target.disposeBrowserContextr; Nr> )r. r= r@ r r r r Údispose_browser_contextA s þr] z6typing.Generator[T_JSON_DICT, T_JSON_DICT, TargetInfo]c c s8 t }| dk r| ¡ |d< d|d}|V }t |d ¡S )zv
|
Returns information about a target.
|
|
**EXPERIMENTAL**
|
|
:param target_id: *(Optional)*
|
:returns:
|
Nr/ zTarget.getTargetInfor; Ú
|
targetInfo)r3 r r$ r r? r r r Úget_target_infoU s þr_ zCtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.List[TargetInfo]]c c s ddi} | V }dd |d D S )zT
|
Retrieves a list of available targets.
|
|
:returns: The list of targets.
|
r< zTarget.getTargetsc S s g | ]}t |¡qS r ©r$ r rP r r r rS u s z get_targets.<locals>.<listcomp>Z targetInfosr rE r r r Ú get_targetsk s
|
ÿra )Úmessager[ r% r c c sJ t }| |d< |dk r"| ¡ |d< |dk r6| ¡ |d< d|d}|V }dS )a+
|
Sends protocol message over session with given id.
|
Consider using flat mode instead; see commands attachToTarget, setAutoAttach,
|
and crbug.com/991325.
|
|
:param message:
|
:param session_id: *(Optional)* Identifier of the session.
|
:param target_id: *(Optional)* Deprecated.
|
rb NrC r/ zTarget.sendMessageToTargetr; r> )rb r[ r% r= r@ r r r r Úsend_message_to_targetx s þrc r) )Ú auto_attachÚwait_for_debugger_on_startrB r c c s: t }| |d< ||d< |dk r&||d< d|d}|V }dS )aé
|
Controls whether to automatically attach to new targets which are considered to be related to
|
this one. When turned on, attaches to all existing related targets as well. When turned off,
|
automatically detaches from all currently attached targets.
|
|
**EXPERIMENTAL**
|
|
:param auto_attach: Whether to auto-attach to related targets.
|
:param wait_for_debugger_on_start: Whether to pause new targets when attaching to them. Use ```Runtime.runIfWaitingForDebugger``` to run paused targets.
|
:param flatten: *(Optional)* Enables "flat" access to the session via specifying sessionId attribute in the commands. We plan to make this the default, deprecate non-flattened mode, and eventually retire it. See crbug.com/991325.
|
Z
|
autoAttachZwaitForDebuggerOnStartNrB zTarget.setAutoAttachr; ©r3 )rd re rB r= r@ r r r r Úset_auto_attach s þrg )Údiscoverr c c s" t }| |d< d|d}|V }dS )zÄ
|
Controls whether to discover available targets and notify via
|
``targetCreated/targetInfoChanged/targetDestroyed`` events.
|
|
:param discover: Whether to discover available targets.
|
rh zTarget.setDiscoverTargetsr; Nrf )rh r= r@ r r r r Úset_discover_targets¯ s þri ztyping.List[RemoteLocation])Ú locationsr c c s, t }dd | D |d< d|d}|V }dS )z»
|
Enables target discovery for the specified locations, when ``setDiscoverTargets`` was set to
|
``true``.
|
|
**EXPERIMENTAL**
|
|
:param locations: List of remote locations.
|
c S s g | ] }| ¡ qS r )r rP r r r rS Í s z(set_remote_locations.<locals>.<listcomp>rj zTarget.setRemoteLocationsr; Nrf )rj r= r@ r r r r Úset_remote_locationsÁ s þrk zTarget.attachedToTargetc @ s> e Zd ZU dZded< ded< ded< edd d d
|
d Zd S ) ÚAttachedToTargetzt
|
**EXPERIMENTAL**
|
|
Issued when attached to target because of auto-attach or ``attachToTarget`` command.
|
r" r[ r$ Ú target_infor) Úwaiting_for_debuggerr r c C s* | t |d ¡t |d ¡t|d dS )NrC r^ ZwaitingForDebugger)r[ rm rn )r" r r$ r) r r r r r â s
|
|
ýzAttachedToTarget.from_jsonN©r r r r# r6 r r r r r r rl Õ s
|
rl zTarget.detachedFromTargetc @ s6 e Zd ZU dZded< ded< edd ddd Zd
|
S ) ÚDetachedFromTargetzÔ
|
**EXPERIMENTAL**
|
|
Issued when detached from target for any reason (including ``detachFromTarget`` command). Can be
|
issued multiple times per target if multiple sessions have been attached to it.
|
r" r[ r+ r% r r c C s, | t |d ¡d|kr$t |d ¡nd dS )NrC r/ )r[ r% )r" r r r r r r r ù s þz DetachedFromTarget.from_jsonNro r r r r rp ë s
|
|
rp z Target.receivedMessageFromTargetc @ s> e Zd ZU dZded< ded< ded< edd d d
|
d Zd S ) ÚReceivedMessageFromTargetzz
|
Notifies about a new protocol message received from the session (as reported in
|
``attachedToTarget`` event).
|
r" r[ r rb r+ r% r r c C s6 | t |d ¡t|d d|kr.t |d ¡nd dS )NrC rb r/ )r[ rb r% )r" r r r r r r r r s
|
|
ýz#ReceivedMessageFromTarget.from_jsonNro r r r r rq s
|
rq zTarget.targetCreatedc @ s. e Zd ZU dZded< edd dddZdS ) Ú TargetCreatedz>
|
Issued when a possible inspection target is created.
|
r$ rm r r c C s | t |d ¡dS ©Nr^ )rm r` r r r r r s ÿzTargetCreated.from_jsonNro r r r r rr s
|
rr zTarget.targetDestroyedc @ s. e Zd ZU dZded< edd dddZdS ) ÚTargetDestroyedz,
|
Issued when a target is destroyed.
|
r r% r r c C s | t |d ¡dS )Nr/ )r% )r r r r r r r . s ÿzTargetDestroyed.from_jsonNro r r r r rt & s
|
rt zTarget.targetCrashedc @ s> e Zd ZU dZded< ded< ded< edd d d
|
d Zd S ) Ú TargetCrashedz+
|
Issued when a target has crashed.
|
r r% r Ústatusr9 Ú
|
error_coder r c C s( | t |d ¡t|d t|d dS )Nr/ rv Z errorCode)r% rv rw )r r r r9 r r r r r A s
|
|
|
ýzTargetCrashed.from_jsonNro r r r r ru 5 s
|
ru zTarget.targetInfoChangedc @ s. e Zd ZU dZded< edd dddZdS ) ÚTargetInfoChangedz
|
Issued when some information about a target has changed. This only happens between
|
``targetCreated`` and ``targetDestroyed``.
|
r$ rm r r c C s | t |d ¡dS rs r` r r r r r S s ÿzTargetInfoChanged.from_jsonNro r r r r rx J s
|
rx )N)N)NNN)NNNNNN)NN)N)NN)N)'Ú
|
__future__r Úutilr r Z dataclassesr ÚenumÚtypingÚ r r r r" r$ r7 rA rD rF rH rJ rO rT rZ r\ r] r_ ra rc rg ri rk rl rp rq rr rt ru rx r r r r Ú<module> s + þ þ ý ù , þ ÿ ý ý
|
