U
|
[ ±d}Q ã @ sj d dl mZ ddlmZmZ d dlmZ d dlZd dlZddl m
|
Z
|
ddl m Z G dd d e Z G d
|
d d eZG d d d ejZeG dd dZG dd dejZG dd dejZeG dd dZG dd dejZeG dd dZeG dd dZd^ddd d d d d d!Zd_d"d d d d#d$d%Zd`d d d&d'd(Zdad)d d d*d d+d,d-Z dbd)d d d.d/d0Z d d1d2d3Z d d1d4d5Z d d1d6d7Z d8d1d9d:Z!d;d1d<d=Z"dcd d*d>d?d@dAZ#ddd)d*dBdCdDdEZ$d dFdGdHdIZ%dedJdKdLdMdNZ&d dd dOdPdQZ'dfd d d dRdSdTZ(dd dUdVdWZ)edXeG dYdZ dZZ*ed[eG d\d] d]Z+dS )gé )Ú annotationsé )Ú event_classÚ T_JSON_DICT)Ú dataclassN)Úpage)Útargetc s> e Zd ZddddZedd dddZ fdd Z ZS )
|
ÚBrowserContextIDÚstr©Úreturnc C s | S ©N© ©Úselfr r úfd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/common/devtools/v111/browser.pyÚto_json s zBrowserContextID.to_json©Újsonr c C s | |S r r ©Úclsr r r r Ú from_json s zBrowserContextID.from_jsonc s d t ¡ ¡S )NzBrowserContextID({})©ÚformatÚsuperÚ__repr__r ©Ú __class__r r r s zBrowserContextID.__repr__©Ú__name__Ú
|
__module__Ú __qualname__r Ú classmethodr r Ú __classcell__r r r r r s r c s> e Zd ZddddZedd dddZ fdd Z ZS )
|
ÚWindowIDÚintr c C s | S r r r r r r r s zWindowID.to_jsonr c C s | |S r r r r r r r s zWindowID.from_jsonc s d t ¡ ¡S )Nz WindowID({})r r r r r r $ s zWindowID.__repr__r r r r r r$ s r$ c @ s4 e Zd ZdZdZdZdZdZdd Ze dd Z
|
d
|
S ) Ú WindowStatez*
|
The state of the browser window.
|
ÚnormalZ minimizedZ maximizedZ
|
fullscreenc C s | j S r ©Úvaluer r r r r 1 s zWindowState.to_jsonc C s | |S r r r r r r r 4 s zWindowState.from_jsonN) r r r! Ú__doc__ÚNORMALZ MINIMIZEDZ MAXIMIZEDZ
|
FULLSCREENr r" r r r r r r& ( s r& c @ sb e Zd ZU dZdZded< dZded< dZded< dZded< dZ ded < d
|
d Z
|
e d d Z dS )ÚBoundsz+
|
Browser window bounds information
|
Nztyping.Optional[int]ÚleftÚtopÚwidthÚheightz typing.Optional[WindowState]Ú window_statec C sr t }| jd k r| j|d< | jd k r.| j|d< | jd k rB| j|d< | jd k rV| j|d< | jd k rn| j ¡ |d< |S )Nr- r. r/ r0 Ú windowState)Údictr- r. r/ r0 r1 r ©r r r r r r M s
|
|
|
|
|
|
|
|
|
zBounds.to_jsonc C sx | d|krt |d nd d|kr,t |d nd d|krBt |d nd d|krXt |d nd d|krpt |d ¡nd dS )Nr- r. r/ r0 r2 )r- r. r/ r0 r1 )r% r& r r r r r r [ s ûzBounds.from_json) r r r! r* r- Ú__annotations__r. r/ r0 r1 r r" r r r r r r, 9 s
|
r, c @ s e Zd ZdZdZdZdZdZdZdZ dZ
|
d Z d
|
Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ d d Z e d d Z d S )!ÚPermissionTypeZaccessibilityEventsZ audioCaptureZbackgroundSyncZbackgroundFetchZclipboardReadWriteZclipboardSanitizedWriteZdisplayCaptureZdurableStorageZflashZ geolocationZ idleDetectionZ
|
localFontsZmidiZ midiSysexZnfcZ notificationsZpaymentHandlerZperiodicBackgroundSyncZprotectedMediaIdentifierZsensorsZ storageAccessZtopLevelStorageAccessZ videoCaptureZvideoCapturePanTiltZoomZwakeLockScreenZwakeLockSystemZwindowManagementc C s | j S r r( r r r r r s zPermissionType.to_jsonc C s | |S r r r r r r r s zPermissionType.from_jsonN)!r r r! ZACCESSIBILITY_EVENTSZ AUDIO_CAPTUREZBACKGROUND_SYNCZBACKGROUND_FETCHZCLIPBOARD_READ_WRITEZCLIPBOARD_SANITIZED_WRITEZDISPLAY_CAPTUREZDURABLE_STORAGEZFLASHZ GEOLOCATIONZIDLE_DETECTIONZ LOCAL_FONTSZMIDIZ
|
MIDI_SYSEXÚNFCZ NOTIFICATIONSZPAYMENT_HANDLERZPERIODIC_BACKGROUND_SYNCZPROTECTED_MEDIA_IDENTIFIERZSENSORSZSTORAGE_ACCESSZTOP_LEVEL_STORAGE_ACCESSZ VIDEO_CAPTUREZVIDEO_CAPTURE_PAN_TILT_ZOOMZWAKE_LOCK_SCREENZWAKE_LOCK_SYSTEMZWINDOW_MANAGEMENTr r" r r r r r r6 f s< r6 c @ s, e Zd ZdZdZdZdd Zedd ZdS ) ÚPermissionSettingZgrantedZdeniedÚpromptc C s | j S r r( r r r r r s zPermissionSetting.to_jsonc C s | |S r r r r r r r s zPermissionSetting.from_jsonN) r r r! ZGRANTEDZDENIEDZPROMPTr r" r r r r r r8 s r8 c @ s^ e Zd ZU dZded< dZded< dZded< dZded< dZded < d
|
d Z e
|
d d Z dS )ÚPermissionDescriptorz
|
Definition of PermissionDescriptor defined in the Permissions API:
|
https://w3c.github.io/permissions/#dictdef-permissiondescriptor.
|
r
|
ÚnameNútyping.Optional[bool]ÚsysexÚuser_visible_onlyÚallow_without_sanitizationÚ pan_tilt_zoomc C sd t }| j|d< | jd k r$| j|d< | jd k r8| j|d< | jd k rL| j|d< | jd k r`| j|d< |S )Nr; r= ÚuserVisibleOnlyÚallowWithoutSanitizationÚ panTiltZoom)r3 r; r= r> r? r@ r4 r r r r ¯ s
|
|
|
|
|
|
|
|
|
z PermissionDescriptor.to_jsonc C sj | t |d d|kr t|d nd d|kr6t|d nd d|krLt|d nd d|krbt|d nd dS )Nr; r= rA rB rC )r; r= r> r? r@ )r
|
Úboolr r r r r ¼ s
|
ûz PermissionDescriptor.from_json) r r r! r* r5 r= r> r? r@ r r" r r r r r r: s
|
r: c @ s, e Zd ZdZdZdZdd Zedd ZdS ) ÚBrowserCommandIdz<
|
Browser command ids used by executeBrowserCommand.
|
Z openTabSearchZcloseTabSearchc C s | j S r r( r r r r r Î s zBrowserCommandId.to_jsonc C s | |S r r r r r r r Ñ s zBrowserCommandId.from_jsonN) r r r! r* ZOPEN_TAB_SEARCHZCLOSE_TAB_SEARCHr r" r r r r r rE Ç s rE c @ s> e Zd ZU dZded< ded< ded< dd Zedd Zd
|
S ) ÚBucketz"
|
Chrome histogram bucket.
|
r% ÚlowÚhighÚcountc C s( t }| j|d< | j|d< | j|d< |S )NrG rH rI )r3 rG rH rI r4 r r r r ä s
|
|
|
|
zBucket.to_jsonc C s& | t |d t |d t |d dS )NrG rH rI )rG rH rI )r% r r r r r ë s
|
|
|
|
ýzBucket.from_jsonN©r r r! r* r5 r r" r r r r r rF Ö s
|
rF c @ sF e Zd ZU dZded< ded< ded< ded< d d
|
Zed d Zd S )Ú Histogramz
|
Chrome histogram.
|
r
|
r; r% Úsum_rI ztyping.List[Bucket]Úbucketsc C s< t }| j|d< | j|d< | j|d< dd | jD |d< |S )Nr; ÚsumrI c S s g | ] }| ¡ qS r ©r ©Ú.0Úir r r Ú
|
<listcomp>
|
s z%Histogram.to_json.<locals>.<listcomp>rM )r3 r; rL rI rM r4 r r r r s
|
|
|
zHistogram.to_jsonc C s6 | t |d t|d t|d dd |d D dS )Nr; rN rI c S s g | ]}t |¡qS r )rF r rP r r r rS s z'Histogram.from_json.<locals>.<listcomp>rM )r; rL rI rM )r
|
r% r r r r r s
|
|
|
üzHistogram.from_jsonNrJ r r r r rK ô s
|
rK ztyping.Optional[str]z!typing.Optional[BrowserContextID]z0typing.Generator[T_JSON_DICT, T_JSON_DICT, None])Ú
|
permissionÚsettingÚoriginÚbrowser_context_idr c c sV t }| ¡ |d< | ¡ |d< |dk r.||d< |dk rB| ¡ |d< d|d}|V }dS )a
|
Set permission settings for given origin.
|
|
**EXPERIMENTAL**
|
|
:param permission: Descriptor of permission to override.
|
:param setting: Setting of the permission.
|
:param origin: *(Optional)* Origin the permission applies to, all origins if not specified.
|
:param browser_context_id: *(Optional)* Context to override. When omitted, default browser context is used.
|
rT rU NrV ÚbrowserContextIdzBrowser.setPermission©ÚmethodÚparams©r3 r )rT rU rV rW r[ Úcmd_dictr r r r Úset_permission s þr^ ztyping.List[PermissionType])Ú permissionsrV rW r c c sP t }dd | D |d< |dk r(||d< |dk r<| ¡ |d< d|d}|V }dS ) aa
|
Grant specific permissions to the given origin and reject all others.
|
|
**EXPERIMENTAL**
|
|
:param permissions:
|
:param origin: *(Optional)* Origin the permission applies to, all origins if not specified.
|
:param browser_context_id: *(Optional)* BrowserContext to override permissions. When omitted, default browser context is used.
|
c S s g | ] }| ¡ qS r rO rP r r r rS D s z%grant_permissions.<locals>.<listcomp>r_ NrV rX zBrowser.grantPermissionsrY r\ )r_ rV rW r[ r] r r r r Úgrant_permissions5 s þr` )rW r c c s. t }| dk r| ¡ |d< d|d}|V }dS )zÑ
|
Reset all permission management for all origins.
|
|
**EXPERIMENTAL**
|
|
:param browser_context_id: *(Optional)* BrowserContext to reset permissions. When omitted, default browser context is used.
|
NrX zBrowser.resetPermissionsrY r\ )rW r[ r] r r r r Úreset_permissionsP s
|
þra r
|
r< )ÚbehaviorrW Ú download_pathÚevents_enabledr c c sV t }| |d< |dk r"| ¡ |d< |dk r2||d< |dk rB||d< d|d}|V }dS )a
|
Set the behavior when downloading a file.
|
|
**EXPERIMENTAL**
|
|
:param behavior: Whether to allow all or deny all download requests, or use default Chrome behavior if available (otherwise deny). ``allowAndName`` allows download and names files according to their dowmload guids.
|
:param browser_context_id: *(Optional)* BrowserContext to set download behavior. When omitted, default browser context is used.
|
:param download_path: *(Optional)* The default path to save downloaded files to. This is required if behavior is set to 'allow' or 'allowAndName'.
|
:param events_enabled: *(Optional)* Whether to emit download events (defaults to false).
|
rb NrX Z downloadPathZ eventsEnabledzBrowser.setDownloadBehaviorrY r\ )rb rW rc rd r[ r] r r r r Úset_download_behaviord s þre )ÚguidrW r c c s6 t }| |d< |dk r"| ¡ |d< d|d}|V }dS )a
|
Cancel a download if in progress
|
|
**EXPERIMENTAL**
|
|
:param guid: Global unique identifier of the download.
|
:param browser_context_id: *(Optional)* BrowserContext to perform the action in. When omitted, default browser context is used.
|
rf NrX zBrowser.cancelDownloadrY r\ )rf rW r[ r] r r r r Úcancel_download s þrg r c c s ddi} | V }dS )z#
|
Close browser gracefully.
|
rZ z Browser.closeNr ©r] r r r r Úclose s ÿri c c s ddi} | V }dS )zC
|
Crashes browser on the main thread.
|
|
**EXPERIMENTAL**
|
rZ z Browser.crashNr rh r r r Úcrash¤ s ÿrj c c s ddi} | V }dS )z4
|
Crashes GPU process.
|
|
**EXPERIMENTAL**
|
rZ zBrowser.crashGpuProcessNr rh r r r Úcrash_gpu_process° s ÿrk zQtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.Tuple[str, str, str, str, str]]c c sD ddi} | V }t |d t |d t |d t |d t |d fS )a,
|
Returns version information.
|
|
:returns: A tuple with the following items:
|
|
0. **protocolVersion** - Protocol version.
|
1. **product** - Product name.
|
2. **revision** - Product revision.
|
3. **userAgent** - User-Agent.
|
4. **jsVersion** - V8 version.
|
rZ zBrowser.getVersionZprotocolVersionÚproductÚrevisionZ userAgentZ jsVersion©r
|
rh r r r Ú get_version¼ s ÿ
|
|
|
|
|
ûro z<typing.Generator[T_JSON_DICT, T_JSON_DICT, typing.List[str]]c c s ddi} | V }dd |d D S )z¾
|
Returns the command line switches for the browser process if, and only if
|
--enable-automation is on the commandline.
|
|
**EXPERIMENTAL**
|
|
:returns: Commandline parameters
|
rZ z Browser.getBrowserCommandLinec S s g | ] }t |qS r rn rP r r r rS â s z,get_browser_command_line.<locals>.<listcomp>Ú argumentsr rh r r r Úget_browser_command_lineÕ s
|
|
ÿrq zBtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.List[Histogram]])ÚqueryÚdeltar c c sH t }| dk r| |d< |dk r&||d< d|d}|V }dd |d D S ) aY
|
Get Chrome histograms.
|
|
**EXPERIMENTAL**
|
|
:param query: *(Optional)* Requested substring in name. Only histograms which have query as a substring in their name are extracted. An empty or absent query returns all histograms.
|
:param delta: *(Optional)* If true, retrieve delta since last delta call.
|
:returns: Histograms.
|
Nrr rs zBrowser.getHistogramsrY c S s g | ]}t |¡qS r )rK r rP r r r rS ü s z"get_histograms.<locals>.<listcomp>Z
|
histograms©r3 )rr rs r[ r] r r r r Úget_histogramså s þru z5typing.Generator[T_JSON_DICT, T_JSON_DICT, Histogram])r; rs r c c s< t }| |d< |dk r ||d< d|d}|V }t |d ¡S )zÒ
|
Get a Chrome histogram by name.
|
|
**EXPERIMENTAL**
|
|
:param name: Requested histogram name.
|
:param delta: *(Optional)* If true, retrieve delta since last delta call.
|
:returns: Histogram.
|
r; Nrs zBrowser.getHistogramrY Z histogram)r3 rK r )r; rs r[ r] r r r r Ú get_histogramÿ s þrv z2typing.Generator[T_JSON_DICT, T_JSON_DICT, Bounds])Ú window_idr c c s0 t }| ¡ |d< d|d}|V }t |d ¡S )zü
|
Get position and size of the browser window.
|
|
**EXPERIMENTAL**
|
|
:param window_id: Browser window id.
|
:returns: Bounds information of the window. When window state is 'minimized', the restored window position and size are returned.
|
ÚwindowIdzBrowser.getWindowBoundsrY Úbounds)r3 r r, r )rw r[ r] r r r r Úget_window_bounds s þrz z typing.Optional[target.TargetID]zJtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.Tuple[WindowID, Bounds]])Ú target_idr c c sF t }| dk r| ¡ |d< d|d}|V }t |d ¡t |d ¡fS )aÄ
|
Get the browser window that contains the devtools target.
|
|
**EXPERIMENTAL**
|
|
:param target_id: *(Optional)* Devtools agent host id. If called as a part of the session, associated targetId is used.
|
:returns: A tuple with the following items:
|
|
0. **windowId** - Browser window id.
|
1. **bounds** - Bounds information of the window. When window state is 'minimized', the restored window position and size are returned.
|
NZtargetIdzBrowser.getWindowForTargetrY rx ry )r3 r r$ r r, )r{ r[ r] r r r r Úget_window_for_target- s þ þr| )rw ry r c c s2 t }| ¡ |d< | ¡ |d< d|d}|V }dS )a5
|
Set position and/or size of the browser window.
|
|
**EXPERIMENTAL**
|
|
:param window_id: Browser window id.
|
:param bounds: New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
|
rx ry zBrowser.setWindowBoundsrY Nr\ )rw ry r[ r] r r r r Úset_window_boundsI s þr} )Ú badge_labelÚimager c c s: t }| dk r| |d< |dk r&||d< d|d}|V }dS )z¡
|
Set dock tile details, platform-specific.
|
|
**EXPERIMENTAL**
|
|
:param badge_label: *(Optional)*
|
:param image: *(Optional)* Png encoded image.
|
NZ
|
badgeLabelr zBrowser.setDockTilerY rt )r~ r r[ r] r r r r Ú set_dock_tile_ s þr )Ú
|
command_idr c c s& t }| ¡ |d< d|d}|V }dS )zi
|
Invoke custom browser commands used by telemetry.
|
|
**EXPERIMENTAL**
|
|
:param command_id:
|
Z commandIdz Browser.executeBrowserCommandrY Nr\ )r r[ r] r r r r Úexecute_browser_commandw s
|
þr zBrowser.downloadWillBeginc @ sF e Zd ZU dZded< ded< ded< ded< edd d d
|
d Zd S ) ÚDownloadWillBeginzM
|
**EXPERIMENTAL**
|
|
Fired when page is about to start a download.
|
z page.FrameIdÚframe_idr
|
rf ÚurlÚsuggested_filenamer r c C s4 | t j |d ¡t|d t|d t|d dS )NZframeIdrf r
ZsuggestedFilename)r rf r
r )r ZFrameIdr r
|
r r r r r s
|
|
|
üzDownloadWillBegin.from_jsonN©r r r! r* r5 r" r r r r r r s
|
r zBrowser.downloadProgressc @ sF e Zd ZU dZded< ded< ded< ded< edd d d
|
d Zd S ) ÚDownloadProgresszc
|
**EXPERIMENTAL**
|
|
Fired when download makes progress. Last call has ``done`` == true.
|
r
|
rf ÚfloatÚ total_bytesÚreceived_bytesÚstater r c C s0 | t |d t|d t|d t |d dS )Nrf Z
|
totalBytesZ receivedBytesr )rf r r r )r
|
r r r r r r ¶ s
|
|
|
|
üzDownloadProgress.from_jsonNr r r r r r ¥ s
|
r )NN)NN)N)NNN)N)NN)N)N)NN),Ú
|
__future__r Úutilr r Z dataclassesr ÚenumÚtypingÚ r r r
|
r r% r$ ÚEnumr& r, r6 r8 r: rE rF rK r^ r` ra re rg ri rj rk ro rq ru rv rz r| r} r r r r r r r r Ú<module> st ,% . % ü ý ÿ ü! þ
|
þ þ ÿ þ
|
