>i_HddlmZddlmZmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZddlmZmZer@ddlmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/ddlm0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6Gdd Z7y ) ) annotations) TYPE_CHECKINGOptional)Command)+AddPrivacySandboxCoordinatorKeyConfigParams)AddPrivacySandboxEnrollmentOverrideParams BrowserMethodCancelDownloadParamsExecuteBrowserCommandParamsGetHistogramParamsGetHistogramsParamsGetWindowBoundsParamsGetWindowForTargetParamsGrantPermissionsParamsResetPermissionsParamsSetContentsSizeParamsSetDockTileParamsSetDownloadBehaviorParamsSetPermissionParamsSetWindowBoundsParams)Bounds WindowState),AddPrivacySandboxCoordinatorKeyConfigCommand*AddPrivacySandboxEnrollmentOverrideCommandCancelDownloadCommand CloseCommand CrashCommandCrashGpuProcessCommandDownloadBehaviorExecuteBrowserCommandCommandGetBrowserCommandLineCommandGetHistogramCommandGetHistogramsCommandGetVersionCommandGetWindowBoundsCommandGetWindowForTargetCommandGrantPermissionsCommandResetPermissionsCommandSetContentsSizeCommandSetDockTileCommandSetDownloadBehaviorCommandSetPermissionCommandSetWindowBoundsCommand)BrowserCommandIdBrowserContextIDPermissionDescriptorPermissionSettingPermissionTypePrivacySandboxAPIWindowIDceZdZdZeddZeddZe d ddZe d d dZed!dZ e d" d#dZ ed$d Z e d% d&d Z e d% d'd Z ed(d Ze d)d Ze d" d*dZe d% d+dZe d% d,dZe d" d-dZe d. d/dZe d" d0dZed1dZed2dZed3dZed4dZed4dZed4dZed4dZy)5BrowserCommandsa BrowserCommands class provides a set of commands to interact with the browser's main functionality based on CDP. These commands allow for managing browser windows, such as closing windows, retrieving window IDs, and adjusting window bounds (size and state). The commands defined in this class provide functionality for: - Managing browser windows and targets. - Setting permissions and download behavior. - Controlling browser windows (size, state). - Retrieving browser information and versioning. c6ttjS)a Generates a command to get browser version information. Returns: GetVersionCommand: The CDP command that returns browser version details including protocol version, product name, revision, and user agent. method)rr GET_VERSIONf/var/www/python/tenders/Scrapper/venv/lib/python3.12/site-packages/pydoll/commands/browser_commands.py get_versionzBrowserCommands.get_versionNsm7788r<c6ttjS)a Returns the command line switches for the browser process. Returns: GetBrowserCommandLineCommand: The CDP command that returns command line arguments. Note: Only works if --enable-automation is on the command line. r8)rr GET_BROWSER_COMMAND_LINEr;r<r=get_browser_command_linez(BrowserCommands.get_browser_command_lineYsmDDEEr<Ncht}|||d<|r||d<ttj|S)a Get Chrome histograms. Args: query: 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. delta: If true, retrieve delta since last delta call. Returns: GetHistogramsCommand: The CDP command that returns histogram data. querydeltar9params)r rr GET_HISTOGRAMS)rCrDrFs r=get_histogramszBrowserCommands.get_histogramses:"%&  #F7O #F7Om::6JJr<c^t|}|r||d<ttj|S)a Get a Chrome histogram by name. Args: name: Requested histogram name. delta: If true, retrieve delta since last delta call. Returns: GetHistogramCommand: The CDP command that returns histogram data. )namerDrE)r rr GET_HISTOGRAM)rJrDrFs r= get_histogramzBrowserCommands.get_histogram}s-$. #F7Om99&IIr<cPt|}ttj|S)z Get position and size of the browser window. Args: window_id: Browser window id. Returns: GetWindowBoundsCommand: The CDP command that returns window bounds information. windowIdrE)rrr GET_WINDOW_BOUNDS) window_idrFs r=get_window_boundsz!BrowserCommands.get_window_boundss!' :m==fMMr<cZt}|||d<ttj|S)ax Get the browser window that contains the devtools target. Args: target_id: Devtools agent host id. If called as a part of the session, associated targetId is used. Returns: GetWindowForTargetCommand: The CDP command that returns window information including windowId and bounds. targetIdrE)rrr GET_WINDOW_FOR_TARGET) target_idrFs r=get_window_for_targetz%BrowserCommands.get_window_for_targets/*+  !*F: mAA&QQr<cRt||}ttj|S)a Set position and/or size of the browser window. Args: window_id: Browser window id. bounds: New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged. Returns: SetWindowBoundsCommand: The CDP command that sets window bounds. )rOboundsrE)rrr SET_WINDOW_BOUNDS)rQrYrFs r=set_window_boundsz!BrowserCommands.set_window_boundss#' &Im==fMMr<clt|}|||d<|||d<ttj|S)a  Set size of the browser contents resizing browser window as necessary. Args: window_id: Browser window id. width: The window contents width in DIP. Assumes current width if omitted. Must be specified if 'height' is omitted. height: The window contents height in DIP. Assumes current height if omitted. Must be specified if 'width' is omitted. Returns: SetContentsSizeCommand: The CDP command that sets window contents size. rNwidthheightrE)rrr SET_CONTENTS_SIZE)rQr]r^rFs r=set_contents_sizez!BrowserCommands.set_contents_sizes@&' :  #F7O  %F8 m==fMMr<cht}|||d<|||d<ttj|S)a$ Set dock tile details, platform-specific. Args: badge_label: Optional badge label. image: Png encoded image (base64 string when passed over JSON). Returns: SetDockTileCommand: The CDP command that sets dock tile details. badgeLabelimagerE)rrr SET_DOCK_TILE) badge_labelrcrFs r= set_dock_tilezBrowserCommands.set_dock_tiles>#$  "#.F<  #F7Om99&IIr<cPt|}ttj|S)z Invoke custom browser commands used by telemetry. Args: command_id: Browser command identifier. Returns: ExecuteBrowserCommandCommand: The CDP command that executes browser command. ) commandIdrE)r rr EXECUTE_BROWSER_COMMAND) command_idrFs r=execute_browser_commandz'BrowserCommands.execute_browser_commands!-zBmCCFSSr<cPt|}ttj|S)aX Allows a site to use privacy sandbox features that require enrollment without the site actually being enrolled. Only supported on page targets. Args: url: Site URL. Returns: AddPrivacySandboxEnrollmentOverrideCommand: The CDP command that adds enrollment override. )urlrE)rrr 'ADD_PRIVACY_SANDBOX_ENROLLMENT_OVERRIDE)rmrFs r='add_privacy_sandbox_enrollment_overridez7BrowserCommands.add_privacy_sandbox_enrollment_overrides";sCmSS\bccr<cbt|||}|||d<ttj|S)a Configures encryption keys used with a given privacy sandbox API to talk to a trusted coordinator. Since this is intended for test automation only, coordinatorOrigin must be a .test domain. No existing coordinator configuration for the origin may exist. Args: api: Privacy Sandbox API type. coordinator_origin: Coordinator origin (must be .test domain). key_config: Key configuration string. browser_context_id: BrowserContext to perform the action in. When omitted, default browser context is used. Returns: AddPrivacySandboxCoordinatorKeyConfigCommand: The CDP command that adds key config. )apicoordinatorOrigin keyConfigbrowserContextIdrE)rrr *ADD_PRIVACY_SANDBOX_COORDINATOR_KEY_CONFIG)rqcoordinator_origin key_configbrowser_context_idrFs r=*add_privacy_sandbox_coordinator_key_configz:BrowserCommands.add_privacy_sandbox_coordinator_key_configsC.=0    ));F% & KKTZ  r<cnt||}|||d<|||d<ttj|S)a Set permission settings for given origin. Args: permission: Descriptor of permission to override. setting: Setting of the permission. origin: Origin the permission applies to, all origins if not specified. browser_context_id: Context to override. When omitted, default browser context is used. Returns: SetPermissionCommand: The CDP command that sets permission. ) permissionsettingoriginrtrE)rrr SET_PERMISSION)r{r|r}rxrFs r=set_permissionzBrowserCommands.set_permission6sD&% GL  %F8   ));F% &m::6JJr<clt|}|||d<|||d<ttj|S)a Grant specific permissions to the given origin and reject all others. Args: permissions: List of permissions to grant. origin: Origin the permission applies to, all origins if not specified. browser_context_id: BrowserContext to override permissions. When omitted, default browser context is used. Returns: GrantPermissionsCommand: The CDP command that grants permissions. ) permissionsr}rtrE)rrr GRANT_PERMISSIONS)rr}rxrFs r=grant_permissionsz!BrowserCommands.grant_permissionsPsB$(K@  %F8   ));F% &m==fMMr<cZt}|||d<ttj|S)aD Reset all permission management for all origins. Args: browser_context_id: BrowserContext to reset permissions. When omitted, default browser context is used. Returns: ResetPermissionsCommand: The CDP command that resets permissions. rtrE)rrr RESET_PERMISSIONS)rxrFs r=reset_permissionsz!BrowserCommands.reset_permissionsis0()  ));F% &m==fMMr<czt|}|||d<|||d<|||d<ttj|S)a@ Set the behavior when downloading a file. Args: 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. browser_context_id: BrowserContext to set download behavior. When omitted, default browser context is used. download_path: The default path to save downloaded files to. This is required if behavior is set to 'allow' or 'allowAndName'. events_enabled: Whether to emit download events (defaults to false). Returns: SetDownloadBehaviorCommand: The CDP command that sets download behavior. )behaviorrt downloadPath eventsEnabledrE)rrr SET_DOWNLOAD_BEHAVIOR)rrx download_pathevents_enabledrFs r=set_download_behaviorz%BrowserCommands.set_download_behavior|sR.+H=  ));F% &  $%2F> "  %&4F? #mAA&QQr<c^t|}|||d<ttj|S)aq Cancel a download if in progress. Args: guid: Global unique identifier of the download. browser_context_id: BrowserContext to perform the action in. When omitted, default browser context is used. Returns: CancelDownloadCommand: The CDP command that cancels download. )guidrtrE)r rr CANCEL_DOWNLOAD)rrxrFs r=cancel_downloadzBrowserCommands.cancel_downloads2 &40  ));F% &m;;FKKr<c6ttjS)z Close browser gracefully. Returns: CloseCommand: The CDP command that closes the browser. r8)rr CLOSEr;r<r=closezBrowserCommands.closem1122r<c6ttjS)z Crashes browser on the main thread. Returns: CrashCommand: The CDP command that crashes the browser. r8)rr CRASHr;r<r=crashzBrowserCommands.crashrr<c6ttjS)z Crashes GPU process. Returns: CrashGpuProcessCommand: The CDP command that crashes the GPU process. r8)rr CRASH_GPU_PROCESSr;r<r=crash_gpu_processz!BrowserCommands.crash_gpu_processsm==>>r<cbttj}tj ||S)z Maximize a browser window. Args: window_id: Browser window id. Returns: SetWindowBoundsCommand: The CDP command that maximizes the window.  windowState)rr MAXIMIZEDr6r[rQrYs r=set_window_maximizedz$BrowserCommands.set_window_maximized'K$9$9:00FCCr<cbttj}tj ||S)z Minimize a browser window. Args: window_id: Browser window id. Returns: SetWindowBoundsCommand: The CDP command that minimizes the window. r)rr MINIMIZEDr6r[rs r=set_window_minimizedz$BrowserCommands.set_window_minimizedrr<cbttj}tj ||S)z Set a browser window to fullscreen. Args: window_id: Browser window id. Returns: SetWindowBoundsCommand: The CDP command that sets window to fullscreen. r)rr FULLSCREENr6r[rs r=set_window_fullscreenz%BrowserCommands.set_window_fullscreens'K$:$:;00FCCr<cbttj}tj ||S)z Set a browser window to normal state. Args: window_id: Browser window id. Returns: SetWindowBoundsCommand: The CDP command that sets window to normal state. r)rrNORMALr6r[rs r=set_window_normalz!BrowserCommands.set_window_normals'K$6$6700FCCr<)returnr$)rr!)NF)rC Optional[str]rDboolrr#)F)rJstrrDrrr")rQr4rr%)N)rVrrr&)rQr4rYrrr-)NN)rQr4r] Optional[int]r^rrr))rerrcrrr*)rjr.rr )rmrrr) rqr3rvrrwrrxOptional[BrowserContextID]rr) r{r0r|r1r}rrxrrr,)rzlist['PermissionType']r}rrxOptional['BrowserContextID']rr')rxrrr()NNF) rrrxrrrrrrr+)rrrxrrr)rr)rr)rr)rQr4rr-)__name__ __module__ __qualname____doc__ staticmethodr>rArHrLrRrWr[r`rfrkroryrrrrrrrrrrrrr;r<r=r6r6@s 99 F F#KKK KK.JJJ JJ& N N#'R R "RR&NN  $ $NNNN NN2%)#J"JJ JJ* T Td d 3dd" :>     7  6   B!%9= K(K"KK7 K  KK2!%;?N+NN9N ! NN0;?N8N NN$<@'+$ R"R8R%R R $ RR><@LL8L LL(3333?? D D D D D D D Dr<r6N)8 __future__rtypingrrpydoll.protocol.baserpydoll.protocol.browser.methodsrrr r r r r rrrrrrrrrpydoll.protocol.browser.typesrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r6r;r<r=rsl"*($ .FDFDr<