U
|
[ ±d ^ ã @ s¼ d dl mZ ddlmZmZ d dlmZ d dlZd dlZddl m
|
Z
|
ddl m Z G dd d e Z G d
|
d d e ZeG d d d ZeG dd dZG dd deZeG dd dZd ddddZdmd ddddd Zdd d d Zd d dd!d"Zdnd d#dd$d%d&Zdodd#d#d'd(d)d*d+Zd,d d-d.Zdpd/d0d0d1ddddd2d3 d4d5Zdqd6d7dd8d9d:Z d;dd<d=d>Z drd7d?dd@dAZ dsdBdCdDdEdFZ dtd/d6d7ddGdHdIZ dudJdJddBddKdLdMZ!dvd dJdBddNdOdPZ"dwdJdBddQdRdSZ#dTddUdVdWZ$edXeG dYdZ dZZ%ed[eG d\d] d]Z&ed^eG d_d` d`Z'edaeG dbdc dcZ(eddeG dedf dfZ)edgeG dhdi diZ*edjeG dkdl dlZ+dS )xé )Ú annotationsé )Ú event_classÚ T_JSON_DICT)Ú dataclassN)Úbrowser)Úpagec s> e Zd ZddddZedd dddZ fdd Z ZS )
|
ÚTargetIDÚstr©Úreturnc C s | S ©N© ©Úselfr r úed:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/common/devtools/v112/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 @ s e Zd ZU ded< ded< ded< ded< ded< ded < d
|
Zd ed < d
|
Zd ed< d
|
Zded< d
|
Zded< dd Ze dd Z
|
d
|
S )Ú
|
TargetInfor Ú target_idr
|
Útype_ÚtitleÚurlÚboolÚattachedÚcan_access_openerNútyping.Optional[TargetID]Ú opener_idz typing.Optional[page.FrameId]Úopener_frame_idú)typing.Optional[browser.BrowserContextID]Úbrowser_context_idútyping.Optional[str]Úsubtypec C s¦ t }| j ¡ |d< | j|d< | j|d< | j|d< | j|d< | j|d< | jd k r^| j ¡ |d< | j d k rv| j ¡ |d< | j
|
d k r| j
|
¡ |d < | j d k r¢| j |d
|
< |S ) NÚtargetIdÚtyper) r* r, ÚcanAccessOpenerÚopenerIdÚ openerFrameIdÚbrowserContextIdr4 ) Údictr' r r( r) r* r, r- r/ r0 r2 r4 ©r r r r r r G s
|
|
|
|
|
|
|
|
|
|
zTargetInfo.to_jsonc C s¨ | t |d ¡t|d t|d t|d t|d t|d d|krVt |d ¡nd d|krptj |d ¡nd d |krtj |d ¡nd d
|
|kr t|d
|
nd d
|
S ) Nr5 r6 r) r* r, r7 r8 r9 r: r4 )
|
r' r( r) r* r, r- r/ r0 r2 r4 )r r r
|
r+ r ZFrameIdr ÚBrowserContextIDr r r r r Y s
|
|
|
|
|
özTargetInfo.from_json) r r r Ú__annotations__r/ r0 r2 r4 r r! r r r r r r& + s
|
r& c @ s> e Zd ZU dZdZded< dZded< dd Zed d
|
Z dS ) Ú FilterEntryzI
|
A filter used by target query/discovery/auto-attach operations.
|
Nútyping.Optional[bool]Úexcluder3 r( c C s2 t }| jd k r| j|d< | jd k r.| j|d< |S )NrA r6 )r; rA r( r< r r r r t s
|
|
|
|
zFilterEntry.to_jsonc C s4 | d|krt |d nd d|kr,t|d nd dS )NrA r6 )rA r( )r+ r
|
r r r r r | s þzFilterEntry.from_json)
|
r r r r% rA r> r( r r! r r r r r r? i s
|
r? c sB e Zd ZdZddddZedd dddZ fd d
|
Z ZS ) Ú TargetFiltera
|
The entries in TargetFilter are matched sequentially against targets and
|
the first entry that matches determines if the target is included or not,
|
depending on the value of ``exclude`` field in the entry.
|
If filter is not specified, the one assumed is
|
[{type: "browser", exclude: true}, {type: "tab", exclude: true}, {}]
|
(i.e. include everything but ``browser`` and ``tab``).
|
ztyping.List[FilterEntry]r c C s | S r r r r r r r s zTargetFilter.to_jsonr c C s | |S r r r r r r r s zTargetFilter.from_jsonc s d t ¡ ¡S )NzTargetFilter({})r r r r r r s zTargetFilter.__repr__r$ r r r r rB s
|
rB c @ s2 e Zd ZU ded< ded< dd Zedd Zd S )
|
ÚRemoteLocationr
|
ÚhostÚintÚportc C s t }| j|d< | j|d< |S )NrD rF )r; rD rF r< r r r r s
|
|
zRemoteLocation.to_jsonc C s | t |d t|d dS )NrD rF )rD rF )r
|
rE r r r r r ¤ s
|
|
þzRemoteLocation.from_jsonN)r r r r> r r! r r r r r rC s
|
|
rC 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:
|
r5 zTarget.activateTarget©ÚmethodÚparamsN©r; r ©r' rI Úcmd_dictr r r r Úactivate_target¬ s þrM r@ 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.
|
r5 NrN zTarget.attachToTargetrG Ú sessionId)r; r r# r )r' rN rI rL r r r r Úattach_to_target½ s þrP 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.
|
rH z Target.attachToBrowserTargetrO )r# r ©rL r r r r Úattach_to_browser_targetÔ s
|
ÿrR z0typing.Generator[T_JSON_DICT, T_JSON_DICT, bool]c c s. t }| ¡ |d< d|d}|V }t|d S )z¾
|
Closes the target. If the target is a page that gets closed too.
|
|
:param target_id:
|
:returns: Always set to true. If an error occurs, the response indicates protocol error.
|
r5 zTarget.closeTargetrG Úsuccess)r; r r+ rK r r r Ú close_targetã s þrT r3 )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.
|
r5 NZ bindingNamez Target.exposeDevToolsProtocolrG rJ )r' rU rI rL r r r r Úexpose_dev_tools_protocolö s þrV z!typing.Optional[typing.List[str]]zDtyping.Generator[T_JSON_DICT, T_JSON_DICT, browser.BrowserContextID])Údispose_on_detachÚ proxy_serverÚproxy_bypass_listÚ%origins_with_universal_network_accessr c c sp t }| dk r| |d< |dk r&||d< |dk r6||d< |dk rPdd |D |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
|
:param origins_with_universal_network_access: *(Optional)* An optional list of origins to grant unlimited cross-origin access to. Parts of the URL other than those constituting origin are ignored.
|
:returns: The id of the context created.
|
NZdisposeOnDetachÚ proxyServerZproxyBypassListc S s g | ]}|qS r r ©Ú.0Úir r r Ú
|
<listcomp>. s z*create_browser_context.<locals>.<listcomp>Z!originsWithUniversalNetworkAccesszTarget.createBrowserContextrG r: )r; r r= r )rW rX rY rZ rI rL r r r r Úcreate_browser_context s þr` 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.
|
rH zTarget.getBrowserContextsc S s g | ]}t j |¡qS r )r r= r r\ r r r r_ C s z(get_browser_contexts.<locals>.<listcomp>ZbrowserContextIdsr rQ r r r Úget_browser_contexts7 s
|
ÿra r
|
ztyping.Optional[int]r1 z4typing.Generator[T_JSON_DICT, T_JSON_DICT, TargetID]) r* ÚwidthÚheightr2 Úenable_begin_frame_controlÚ
|
new_windowÚ
|
backgroundÚfor_tabr c c s t }| |d< |dk r ||d< |dk r.||d< |dk rB| ¡ |d< |dk rR||d< |dk rb||d< |dk rr||d< |dk r||d < d
|
|d } | V }
|
t |
|
d ¡S ) aÇ
|
Creates a new page.
|
|
:param url: The initial URL the page will be navigated to. An empty string indicates about:blank.
|
:param width: *(Optional)* Frame width in DIP (headless chrome only).
|
:param height: *(Optional)* Frame height in DIP (headless chrome only).
|
:param browser_context_id: **(EXPERIMENTAL)** *(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).
|
:param for_tab: **(EXPERIMENTAL)** *(Optional)* Whether to create the target of type "tab".
|
:returns: The id of the page opened.
|
r* Nrb rc r: ZenableBeginFrameControlZ newWindowrf ZforTabzTarget.createTargetrG r5 )r; r r r ) r* rb rc r2 rd re rf rg rI rL r r r r Ú create_targetF s* þrh 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.
|
NrO r5 zTarget.detachFromTargetrG rJ )ri r' rI rL r r r r Údetach_from_targetu s
|
þrj zbrowser.BrowserContextID)r2 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:
|
r: z Target.disposeBrowserContextrG NrJ )r2 rI rL r r r r Údispose_browser_context s þrk 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:
|
Nr5 zTarget.getTargetInforG Ú
|
targetInfo)r; r r& r rK r r r Úget_target_info s þrm z typing.Optional[TargetFilter]zCtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.List[TargetInfo]])Úfilter_r c c s< t }| dk r| ¡ |d< d|d}|V }dd |d D S )a9
|
Retrieves a list of available targets.
|
|
:param filter_: **(EXPERIMENTAL)** *(Optional)* Only targets matching filter will be reported. If filter is not specified and target discovery is currently enabled, a filter used for target discovery is used for consistency.
|
:returns: The list of targets.
|
NÚfilterzTarget.getTargetsrG c S s g | ]}t |¡qS r ©r& r r\ r r r r_ Æ s z get_targets.<locals>.<listcomp>Z targetInfosrJ )rn rI rL r r r r Ú get_targetsµ s þrq )Úmessageri 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.
|
rr NrO r5 zTarget.sendMessageToTargetrG rJ )rr ri r' rI rL r r r r Úsend_message_to_targetÉ s þrs r+ )Ú auto_attachÚwait_for_debugger_on_startrN rn r c c sN t }| |d< ||d< |dk r&||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.
|
This also clears all targets added by ``autoAttachRelated`` from the list of targets to watch
|
for creation of related 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.
|
:param filter_: **(EXPERIMENTAL)** *(Optional)* Only targets matching filter will be attached.
|
Z
|
autoAttachÚwaitForDebuggerOnStartNrN ro zTarget.setAutoAttachrG rJ )rt ru rN rn rI rL r r r r Úset_auto_attachä s þrw )r' ru rn r c c sB t }| ¡ |d< ||d< |dk r.| ¡ |d< d|d}|V }dS )aå
|
Adds the specified target to the list of targets that will be monitored for any related target
|
creation (such as child frames, child workers and new versions of service worker) and reported
|
through ``attachedToTarget``. The specified target is also auto-attached.
|
This cancels the effect of any previous ``setAutoAttach`` and is also cancelled by subsequent
|
``setAutoAttach``. Only available at the Browser target.
|
|
**EXPERIMENTAL**
|
|
:param target_id:
|
:param wait_for_debugger_on_start: Whether to pause new targets when attaching to them. Use ```Runtime.runIfWaitingForDebugger``` to run paused targets.
|
:param filter_: **(EXPERIMENTAL)** *(Optional)* Only targets matching filter will be attached.
|
r5 rv Nro zTarget.autoAttachRelatedrG rJ )r' ru rn rI rL r r r r Úauto_attach_related s þrx )Údiscoverrn r c c s6 t }| |d< |dk r"| ¡ |d< d|d}|V }dS )al
|
Controls whether to discover available targets and notify via
|
``targetCreated/targetInfoChanged/targetDestroyed`` events.
|
|
:param discover: Whether to discover available targets.
|
:param filter_: **(EXPERIMENTAL)** *(Optional)* Only targets matching filter will be attached. If ```discover```` is false, ````filter``` must be omitted or empty.
|
ry Nro zTarget.setDiscoverTargetsrG rJ )ry rn rI rL r r r r Úset_discover_targets$ s þrz 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 r\ r r r r_ F s z(set_remote_locations.<locals>.<listcomp>r{ zTarget.setRemoteLocationsrG N)r; )r{ rI rL r r r r Úset_remote_locations: s þr| 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# ri r& Ú target_infor+ Úwaiting_for_debuggerr r c C s* | t |d ¡t |d ¡t|d dS )NrO rl ZwaitingForDebugger)ri r~ r )r# r r& r+ r r r r r [ s
|
|
ýzAttachedToTarget.from_jsonN©r r r r% r> r! r r r r r r} N s
|
r} 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# ri r. r' r r c C s, | t |d ¡d|kr$t |d ¡nd dS )NrO r5 )ri r' )r# r r r r r r r r s þz DetachedFromTarget.from_jsonNr r r r r r d s
|
|
r 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# ri r
|
rr r. r' r r c C s6 | t |d ¡t|d d|kr.t |d ¡nd dS )NrO rr r5 )ri rr r' )r# r r
|
r r r r r r s
|
|
ýz#ReceivedMessageFromTarget.from_jsonNr r r r r r z s
|
r zTarget.targetCreatedc @ s. e Zd ZU dZded< edd dddZdS ) Ú TargetCreatedz>
|
Issued when a possible inspection target is created.
|
r& r~ r r c C s | t |d ¡dS ©Nrl )r~ rp r r r r r s ÿzTargetCreated.from_jsonNr r r r r r s
|
r 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 )Nr5 )r' )r r r r r r r § s ÿzTargetDestroyed.from_jsonNr r r r r r
s
|
r
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
|
ÚstatusrE Ú
|
error_coder r c C s( | t |d ¡t|d t|d dS )Nr5 r Z errorCode)r' r r )r r r
|
rE r r r r r º s
|
|
|
ýzTargetCrashed.from_jsonNr r r r r r ® s
|
r 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& r~ r r c C s | t |d ¡dS r rp r r r r r Ì s ÿzTargetInfoChanged.from_jsonNr r r r r r à s
|
r )N)N)NNNN)NNNNNNN)NN)N)N)NN)NN)N)N),Ú
|
__future__r Úutilr r Z dataclassesr ÚenumÚtypingÚ r r r
|
r r# r& r? ÚlistrB rC rM rP rR rT rV r` ra rh rj rk rm rq rs rw rx rz r| r} r r r r
r r r r r r Ú<module> s = þ þ ü# ø 0 þ ÿ ÿ ý ü% ý þ
|
