U gfU@szddlmZddlmZmZddlmZddlZddlZddl m Z ddl m Z Gdd d e Z Gd d d eZGd d d ejZeGdddZGdddejZGdddejZeGdddZGdddejZeGdddZeGdddZdaddddddd d!Zdbd"dddd#d$d%Zdcddd&d'd(Zddd)ddd*dd+d,d-Zded)ddd.d/d0Zdd1d2d3Zdd1d4d5Zdd1d6d7Z d8d1d9d:Z!d;d1dd?d@dAZ#dgd)d*dBdCdDdEZ$d dFdGdHdIZ%dhdJdKdLdMdNZ&d dddOdPdQZ'diddddRdSdTZ(dddUdVdWZ)d)ddXdYdZZ*ed[eGd\d]d]Z+ed^eGd_d`d`Z,dS)j) annotations) event_class T_JSON_DICT) dataclassN)page)targetcs>eZdZddddZedddddZfdd ZZS) BrowserContextIDstrreturncCs|SNselfrrS/tmp/pip-unpacked-wheel-3ysq0mf8/selenium/webdriver/common/devtools/v130/browser.pyto_jsonszBrowserContextID.to_jsonjsonr cCs||Sr rclsrrrr from_jsonszBrowserContextID.from_jsoncsdtS)NzBrowserContextID({})formatsuper__repr__r __class__rrrszBrowserContextID.__repr____name__ __module__ __qualname__r classmethodrr __classcell__rrrrr sr cs>eZdZddddZedddddZfdd ZZS) WindowIDintr cCs|Sr rrrrrrszWindowID.to_jsonrcCs||Sr rrrrrr szWindowID.from_jsoncsdtS)Nz WindowID({})rrrrrr$szWindowID.__repr__rrrrrr$sr$c@s4eZdZdZdZdZdZdZddZe dd Z d S) WindowStatez* The state of the browser window. normalZ minimizedZ maximizedZ fullscreencCs|jSr valuerrrrr1szWindowState.to_jsoncCs||Sr rrrrrr4szWindowState.from_jsonN) rr r!__doc__NORMALZ MINIMIZEDZ MAXIMIZEDZ FULLSCREENrr"rrrrrr&(sr&c@sbeZdZUdZdZded<dZded<dZded<dZded<dZ ded <d d Z e d d Z dS)Boundsz+ Browser window bounds information Nztyping.Optional[int]lefttopwidthheightztyping.Optional[WindowState] window_statecCsrt}|jdk r|j|d<|jdk r.|j|d<|jdk rB|j|d<|jdk rV|j|d<|jdk rn|j|d<|S)Nr-r.r/r0 windowState)dictr-r.r/r0r1rrrrrrrMs         zBounds.to_jsonc Csx|d|krt|dndd|kr,t|dndd|krBt|dndd|krXt|dndd|krpt|dnddS)Nr-r.r/r0r2)r-r.r/r0r1)r%r&rrrrrr[szBounds.from_json) rr r!r*r-__annotations__r.r/r0r1rr"rrrrrr,9s      r,c@seZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dd Z!e"d!d"Z#d#S)$PermissionTypeZaccessibilityEventsZ audioCaptureZbackgroundSyncZbackgroundFetchZcapturedSurfaceControlZclipboardReadWriteZclipboardSanitizedWriteZdisplayCaptureZdurableStorageZflashZ geolocationZ idleDetectionZ localFontsZmidiZ midiSysexZnfcZ notificationsZpaymentHandlerZperiodicBackgroundSyncZprotectedMediaIdentifierZsensorsZ storageAccessZspeakerSelectionZtopLevelStorageAccessZ videoCaptureZvideoCapturePanTiltZoomZwakeLockScreenZwakeLockSystemZwebAppInstallationZwindowManagementcCs|jSr r(rrrrrszPermissionType.to_jsoncCs||Sr rrrrrrszPermissionType.from_jsonN)$rr r!ZACCESSIBILITY_EVENTSZ AUDIO_CAPTUREZBACKGROUND_SYNCZBACKGROUND_FETCHZCAPTURED_SURFACE_CONTROLZCLIPBOARD_READ_WRITEZCLIPBOARD_SANITIZED_WRITEZDISPLAY_CAPTUREZDURABLE_STORAGEZFLASHZ GEOLOCATIONZIDLE_DETECTIONZ LOCAL_FONTSZMIDIZ MIDI_SYSEXNFCZ NOTIFICATIONSZPAYMENT_HANDLERZPERIODIC_BACKGROUND_SYNCZPROTECTED_MEDIA_IDENTIFIERZSENSORSZSTORAGE_ACCESSZSPEAKER_SELECTIONZTOP_LEVEL_STORAGE_ACCESSZ VIDEO_CAPTUREZVIDEO_CAPTURE_PAN_TILT_ZOOMZWAKE_LOCK_SCREENZWAKE_LOCK_SYSTEMZWEB_APP_INSTALLATIONZWINDOW_MANAGEMENTrr"rrrrrr6fsBr6c@s,eZdZdZdZdZddZeddZdS) PermissionSettingZgrantedZdeniedpromptcCs|jSr r(rrrrrszPermissionSetting.to_jsoncCs||Sr rrrrrrszPermissionSetting.from_jsonN) rr r!ZGRANTEDZDENIEDZPROMPTrr"rrrrrr8s r8c@sjeZdZUdZded<dZded<dZded<dZded<dZded <dZ ded <d d Z e d dZ dS)PermissionDescriptorz Definition of PermissionDescriptor defined in the Permissions API: https://w3c.github.io/permissions/#dom-permissiondescriptor. r nameNtyping.Optional[bool]sysexuser_visible_onlyallow_without_sanitizationallow_without_gesture pan_tilt_zoomcCsxt}|j|d<|jdk r$|j|d<|jdk r8|j|d<|jdk rL|j|d<|jdk r`|j|d<|jdk rt|j|d<|S)Nr;r=userVisibleOnlyallowWithoutSanitizationallowWithoutGesture panTiltZoom)r3r;r=r>r?r@rAr4rrrrs           zPermissionDescriptor.to_jsonc Cs|t|dd|kr t|dndd|kr6t|dndd|krLt|dndd|krbt|dndd|krxt|dnddS)Nr;r=rBrCrDrE)r;r=r>r?r@rA)r boolrrrrrs zPermissionDescriptor.from_json) rr r!r*r5r=r>r?r@rArr"rrrrrr:s      r:c@s,eZdZdZdZdZddZeddZdS) BrowserCommandIdz< Browser command ids used by executeBrowserCommand. Z openTabSearchZcloseTabSearchcCs|jSr r(rrrrrszBrowserCommandId.to_jsoncCs||Sr rrrrrrszBrowserCommandId.from_jsonN) rr r!r*ZOPEN_TAB_SEARCHZCLOSE_TAB_SEARCHrr"rrrrrrGs rGc@s>eZdZUdZded<ded<ded<ddZedd Zd S) Bucketz" Chrome histogram bucket. r%lowhighcountcCs(t}|j|d<|j|d<|j|d<|S)NrIrJrK)r3rIrJrKr4rrrrs    zBucket.to_jsoncCs&|t|dt|dt|ddS)NrIrJrK)rIrJrK)r%rrrrrs    zBucket.from_jsonNrr r!r*r5rr"rrrrrrHs rHc@sFeZdZUdZded<ded<ded<ded<d d Zed d Zd S) Histogramz Chrome histogram. r r;r%sum_rKztyping.List[Bucket]bucketscCs<t}|j|d<|j|d<|j|d<dd|jD|d<|S)Nr;sumrKcSsg|] }|qSrr.0irrr sz%Histogram.to_json..rO)r3r;rNrKrOr4rrrrs    zHistogram.to_jsoncCs6|t|dt|dt|ddd|dDdS)Nr;rPrKcSsg|]}t|qSr)rHrrRrrrrUsz'Histogram.from_json..rO)r;rNrKrO)r r%rrrrrs    zHistogram.from_jsonNrLrrrrrMs rMztyping.Optional[str]z!typing.Optional[BrowserContextID]z0typing.Generator[T_JSON_DICT, T_JSON_DICT, None]) permissionsettingoriginbrowser_context_idr ccsVt}||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. rVrWNrXbrowserContextIdzBrowser.setPermissionmethodparamsr3r)rVrWrXrYr]cmd_dictrrrrset_permission s   r`ztyping.List[PermissionType]) permissionsrXrYr ccsPt}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. cSsg|] }|qSrrQrRrrrrUMsz%grant_permissions..raNrXrZzBrowser.grantPermissionsr[r^)rarXrYr]r_rrrrgrant_permissions>s rb)rYr ccs.t}|dk r||d<d|d}|V}dS)z Reset all permission management for all origins. :param browser_context_id: *(Optional)* BrowserContext to reset permissions. When omitted, default browser context is used. NrZzBrowser.resetPermissionsr[r^)rYr]r_rrrrreset_permissionsYs rcr r<)behaviorrY download_pathevents_enabledr ccsVt}||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 download 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). rdNrZZ downloadPathZ eventsEnabledzBrowser.setDownloadBehaviorr[r^)rdrYrerfr]r_rrrrset_download_behaviorks rg)guidrYr ccs6t}||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. rhNrZzBrowser.cancelDownloadr[r^)rhrYr]r_rrrrcancel_downloads  rir ccsddi}|V}dS)z# Close browser gracefully. r\z Browser.closeNrr_rrrrclosesrkccsddi}|V}dS)zC Crashes browser on the main thread. **EXPERIMENTAL** r\z Browser.crashNrrjrrrcrashsrlccsddi}|V}dS)z4 Crashes GPU process. **EXPERIMENTAL** r\zBrowser.crashGpuProcessNrrjrrrcrash_gpu_processsrmzQtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.Tuple[str, str, str, str, str]]ccsDddi}|V}t|dt|dt|dt|dt|dfS)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. r\zBrowser.getVersionZprotocolVersionproductrevisionZ userAgentZ jsVersionr rjrrr get_versions      rqz. argumentsrrjrrrget_browser_command_lines rszBtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.List[Histogram]])querydeltar ccsHt}|dk r||d<|dk r&||d<d|d}|V}dd|dDS) 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. NrtruzBrowser.getHistogramsr[cSsg|]}t|qSr)rMrrRrrrrUsz"get_histograms..Z histogramsr3)rtrur]r_rrrrget_histogramss rwz5typing.Generator[T_JSON_DICT, T_JSON_DICT, Histogram])r;rur ccs<t}||d<|dk r||d<d|d}|V}t|dS)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;NruzBrowser.getHistogramr[Z histogram)r3rMr)r;rur]r_rrrr get_histograms rxz2typing.Generator[T_JSON_DICT, T_JSON_DICT, Bounds]) window_idr ccs0t}||d<d|d}|V}t|dS)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.getWindowBoundsr[bounds)r3rr,r)ryr]r_rrrrget_window_boundss  r|z typing.Optional[target.TargetID]zJtyping.Generator[T_JSON_DICT, T_JSON_DICT, typing.Tuple[WindowID, Bounds]]) target_idr ccsFt}|dk r||d<d|d}|V}t|dt|dfS)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.getWindowForTargetr[rzr{)r3rr$rr,)r}r]r_rrrrget_window_for_target4s   r~)ryr{r ccs2t}||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. rzr{zBrowser.setWindowBoundsr[Nr^)ryr{r]r_rrrrset_window_boundsPs   r) badge_labelimager ccs: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 badgeLabelrzBrowser.setDockTiler[rv)rrr]r_rrrr set_dock_tilefs r) command_idr ccs&t}||d<d|d}|V}dS)zi Invoke custom browser commands used by telemetry. **EXPERIMENTAL** :param command_id: Z commandIdzBrowser.executeBrowserCommandr[Nr^)rr]r_rrrrexecute_browser_command~s  r)urlr ccs"t}||d<d|d}|V}dS)z Allows a site to use privacy sandbox features that require enrollment without the site actually being enrolled. Only supported on page targets. :param url: rz+Browser.addPrivacySandboxEnrollmentOverrider[Nrv)rr]r_rrrr'add_privacy_sandbox_enrollment_overrides rzBrowser.downloadWillBeginc@sFeZdZUdZded<ded<ded<ded<eddd d d Zd S) DownloadWillBeginzM **EXPERIMENTAL** Fired when page is about to start a download. z page.FrameIdframe_idr rhrsuggested_filenamerrcCs4|tj|dt|dt|dt|ddS)NZframeIdrhrZsuggestedFilename)rrhrr)rZFrameIdrr rrrrrs    zDownloadWillBegin.from_jsonNrr r!r*r5r"rrrrrrs rzBrowser.downloadProgressc@sFeZdZUdZded<ded<ded<ded<eddd d d Zd S) DownloadProgresszc **EXPERIMENTAL** Fired when download makes progress. Last call has ``done`` == true. r rhfloat total_bytesreceived_bytesstaterrcCs0|t|dt|dt|dt|ddS)NrhZ totalBytesZ receivedBytesr)rhrrr)r rrrrrrs     zDownloadProgress.from_jsonNrrrrrrs r)NN)NN)N)NNN)N)NN)N)N)NN)- __future__rutilrrZ dataclassesrenumtypingrrr r r%r$Enumr&r,r6r8r:rGrHrMr`rbrcrgrirkrlrmrqrsrwrxr|r~rrrrrrrrrrsv      ,( 4% !