>i|dddlmZddlmZmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!erXddl"m#Z#ddlm$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAddlBmCZCmDZDmEZEmFZFmGZGmHZHmIZIGdd ZJy ) ) annotations) TYPE_CHECKINGOptional)Command)DeleteCookiesParamsEmulateNetworkConditionsParamsEnableReportingApiParamsGetCertificateParamsGetCookiesParamsGetRequestPostDataParams$GetResponseBodyForInterceptionParamsGetResponseBodyParams GetSecurityIsolationStatusParamsLoadNetworkResourceParamsNetworkEnableParams NetworkMethodReplayXHRParamsSearchInResponseBodyParamsSetAcceptedEncodingsParamsSetAttachDebugStackParamsSetBlockedURLsParamsSetBypassServiceWorkerParamsSetCacheDisabledParamsSetCookieControlsParamsSetCookieParamsSetCookiesParamsSetExtraHTTPHeadersParamsSetUserAgentOverrideParamsStreamResourceContentParams-TakeResponseBodyForInterceptionAsStreamParams)UserAgentMetadata)%ClearAcceptedEncodingsOverrideCommandClearBrowserCacheCommandClearBrowserCookiesCommandClearCookiesCommandDisableCommandEmulateNetworkConditionsCommand EnableCommandEnableReportingApiCommandGetCertificateCommandGetCookiesCommandGetRequestPostDataCommandGetResponseBodyCommand%GetResponseBodyForInterceptionCommand!GetSecurityIsolationStatusCommand HeaderEntryLoadNetworkResourceCommandReplayXHRCommandSearchInResponseBodyCommandSetAcceptedEncodingsCommandSetAttachDebugStackCommandSetBlockedURLsCommandSetBypassServiceWorkerCommandSetCacheDisabledCommandSetCookieCommandSetCookieControlsCommandSetCookiesCommandSetExtraHTTPHeadersCommandSetUserAgentOverrideCommandStreamResourceContentCommand.TakeResponseBodyForInterceptionAsStreamCommand)ConnectionTypeContentEncodingCookiePartitionKeyCookiePriorityCookieSameSiteCookieSourceSchemeLoadNetworkResourceOptionsceZdZdZed dZed!dZe d" d#dZed$dZe d% d&dZ e d' d(dZ e d)d Z e d*d Z ed+d Z e d, d-d Zed.d Ze d/dZe d% d0dZed1dZe d2dZe d3 d4dZed5dZe d6dZed7dZe d8dZe d9dZed:dZe d; ddZe d" d?dZe d' d@dZe d' dAdZ e dBdZ!y)CNetworkCommandsa Implementation of Chrome DevTools Protocol for the Network domain. This class provides commands for monitoring and manipulating network activities, enabling detailed inspection and control over HTTP requests and responses. The Network domain exposes comprehensive network-related information including: - Request/response headers and bodies - Resource timing and caching behavior - Cookie management and security details - Network conditions emulation - Traffic interception and modification The commands allow developers to analyze performance, debug network issues, and test application behavior under various network conditions. c6ttjS)a) Clears browser cache storage. This command is essential for testing cache behavior and ensuring fresh resource loading. It affects all cached resources including: - CSS/JavaScript files - Images and media assets - API response caching Use cases: - Testing cache invalidation strategies - Reproducing issues with stale content - Performance benchmarking without cache influence Returns: Command: CDP command to clear the entire browser cache method)rrCLEAR_BROWSER_CACHEf/var/www/python/tenders/Scrapper/venv/lib/python3.12/site-packages/pydoll/commands/network_commands.pyclear_browser_cachez#NetworkCommands.clear_browser_cacheas&m??@@rNc6ttjS)ao Command to clear all cookies stored in the browser. This can be beneficial for testing scenarios where you need to simulate a fresh user session without any previously stored cookies that might affect the application's behavior. Returns: Command[Response]: A command to clear all cookies in the browser. rJ)rrCLEAR_BROWSER_COOKIESrMrNrOclear_browser_cookiesz%NetworkCommands.clear_browser_cookiesvsmAABBrNNct|}|||d<|||d<|||d<|||d<ttj|S)a Deletes browser cookies with matching criteria. Provides granular control over cookie removal through multiple parameters: - Delete by name only (affects all matching cookies) - Scope deletion using URL, domain, or path - Handle partitioned cookies for privacy-aware applications Args: name: Name of the cookies to remove (required) url: Delete cookies for specific URL (domain/path must match) domain: Exact domain for cookie deletion path: Exact path for cookie deletion partition_key: Partition key attributes for cookie isolation Returns: Command: CDP command to execute selective cookie deletion )nameurldomainpath partitionKeyrKparams)rrrDELETE_COOKIES)rUrVrWrX partition_keyr[s rOdelete_cookieszNetworkCommands.delete_cookiess^4%$/ ?F5M  %F8   !F6N  $%2F> "m::6JJrNc6ttjS)a Stops network monitoring and event reporting. Preserves network state but stops: - Request/response events - WebSocket message tracking - Loading progress notifications Use when: - Reducing overhead during non-network operations - Pausing monitoring temporarily - Finalizing network-related tests Returns: Command: CDP command to disable network monitoring rJ)rrDISABLErMrNrOdisablezNetworkCommands.disables$m3344rNcvt}|||d<|||d<|||d<ttj|S)a7 Enables network monitoring with configurable buffers. Args: max_total_buffer_size: Total memory buffer for network data (bytes) max_resource_buffer_size: Per-resource buffer limit (bytes) max_post_data_size: Maximum POST payload to capture (bytes) Recommended settings: - Increase buffers for long-running sessions - Adjust post size for API testing - Monitor memory usage with large buffers Returns: Command: CDP command to enable network monitoring maxTotalBufferSizemaxResourceBufferSizemaxPostDataSizerZ)rrrENABLE)max_total_buffer_sizemax_resource_buffer_sizemax_post_data_sizer[s rOenablezNetworkCommands.enablesR,%& ,+@F' ( # /.FF* +  )(:F$ %m226BBrNcZt}|||d<ttj|S)a Retrieves cookies matching specified URLs. Args: urls: list of URLs to scope cookie retrieval Returns: Command: CDP command returning cookie details including: - Name, value, and attributes - Security and scope parameters - Expiration and size information Usage notes: - Empty URL list returns all cookies - Includes HTTP-only and secure cookies - Shows partitioned cookie status urlsrZ)r rr GET_COOKIESrlr[s rO get_cookieszNetworkCommands.get_cookiess.*"#  !F6Nm77GGrNcPt|}ttj|S)aQ Retrieves POST data from a specific network request. Essential for: - Form submission analysis - API request debugging - File upload monitoring - Security testing Args: request_id: Unique identifier for the network request Returns: Command: CDP command that returns: - Raw POST data content - Multipart form data (excluding file contents) - Content encoding information Note: Large POST bodies may be truncated based on buffer settings  requestIdrZ)r rrGET_REQUEST_POST_DATA request_idr[s rOget_request_post_dataz%NetworkCommands.get_request_post_datas!0*J?mAA&QQrNcPt|}ttj|S)as Retrieves the full content of a network response. Supports various content types: - Text-based resources (HTML, CSS, JSON) - Base64-encoded binary content (images, media) - Gzip/deflate compressed responses Args: request_id: Unique network request identifier Important considerations: - Response must be available in browser memory - Large responses may require streaming approaches - Sensitive data should be handled securely Returns: Command: CDP command returning response body and encoding details rqrZ)rrrGET_RESPONSE_BODYrts rOget_response_bodyz!NetworkCommands.get_response_bodys!.'<m==fMMrNcPt|}ttj|S)a Controls browser's cache mechanism. Use cases: - Testing resource update behavior - Forcing fresh content loading - Performance impact analysis - Cache-busting scenarios Args: cache_disabled: True to disable caching, False to enable Returns: Command: CDP command to modify cache behavior Note: Affects all requests until re-enabled ) cacheDisabledrZ)rrrSET_CACHE_DISABLED)cache_disabledr[s rOset_cache_disabledz"NetworkCommands.set_cache_disabled+s!&(nEm>>vNNrNct||}|||d<|||d<|||d<|||d<|||d<|||d<|||d<| | |d <| | |d <| | |d <| | |d <| | |d <ttj|S)aw Creates or updates a cookie with specified attributes. Comprehensive cookie control supporting: - Session and persistent cookies - Security attributes (Secure, HttpOnly) - SameSite policies - Cookie partitioning - Priority levels Args: name: Cookie name value: Cookie value url: Target URL for the cookie domain: Cookie domain scope path: Cookie path scope secure: Require HTTPS http_only: Prevent JavaScript access same_site: Cross-site access policy expires: Expiration timestamp priority: Cookie priority level same_party: First-Party Sets flag source_scheme: Cookie source context source_port: Source port restriction partition_key: Storage partition key Returns: Command: CDP command that returns success status Security considerations: - Use secure flag for sensitive data - Consider SameSite policies - Be aware of cross-site implications )rUvaluerVrWrXsecurehttpOnlysameSiteexpirespriority sameParty sourceScheme sourcePortrYrZ)rrr SET_COOKIE)rUrrVrWrXr http_only same_siterr same_party source_scheme source_portr]r[s rO set_cookiezNetworkCommands.set_cookieAsf!d%8 ?F5M  %F8   !F6N  %F8   !*F:   !*F:    'F9   !)F:   !",F;   $%2F> "  "#.F<  $%2F> "m66vFFrNcPt|}ttj|S)a; Sets multiple cookies in a single operation. Efficient for: - Batch cookie operations - Session state restoration - Testing multiple authentication states - Cross-domain cookie setup Args: cookies: list of cookie parameters including name, value, and attributes Returns: Command: CDP command for bulk cookie setting Performance note: - More efficient than multiple set_cookie calls - Consider memory impact with large batches )cookiesrZ)rrr SET_COOKIES)rr[s rO set_cookieszNetworkCommands.set_cookiess!,"'2m77GGrNcPt|}ttj|S)ab Applies custom HTTP headers to all subsequent requests. Enables advanced scenarios: - A/B testing with custom headers - Authentication bypass for testing - Content negotiation simulations - Security header validation Args: headers: list of key-value header pairs Security notes: - Headers are applied browser-wide - Sensitive headers (e.g., Authorization) persist until cleared - Use with caution in shared environments Returns: Command: CDP command to set global HTTP headers )headersrZ)rrrSET_EXTRA_HTTP_HEADERS)rr[s rOset_extra_http_headersz&NetworkCommands.set_extra_http_headerss!0+7;mBB6RRrNczt|}|||d<|||d<|||d<ttj|S)a Overrides the browser's User-Agent string. Use cases: - Device/browser simulation - Compatibility testing - Content negotiation - Bot detection bypass Args: user_agent: Complete User-Agent string accept_language: Language preference header platform: Platform identifier user_agent_metadata: Detailed UA metadata Returns: Command: CDP command to override user agent Testing considerations: - Affects all subsequent requests - May impact server-side behavior - Consider mobile/desktop differences ) userAgentacceptLanguageplatformuserAgentMetadatarZ)rrrSET_USER_AGENT_OVERRIDE) user_agentaccept_languageruser_agent_metadatar[s rOset_useragent_overridez&NetworkCommands.set_useragent_overridesS<,jA  &'6F# $  !)F:   **=F& 'mCCFSSrNc6ttjS)a Restores default content encoding acceptance. Effects: - Resets compression preferences - Restores default Accept-Encoding header - Allows server-chosen encoding Use when: - Testing encoding fallbacks - Debugging compression issues - Resetting after encoding tests Returns: Command: CDP command to clear encoding overrides rJ)rr!CLEAR_ACCEPTED_ENCODINGS_OVERRIDErMrNrO!clear_accepted_encodings_overridez1NetworkCommands.clear_accepted_encodings_overrides$mMMNNrNcPt|}ttj|S)a Controls the Reporting API functionality. Features: - Network error reporting - Deprecation notices - CSP violation reports - CORS issues Args: enabled: True to enable, False to disable Returns: Command: CDP command to configure Reporting API Note: Requires browser support for Reporting API enabledrZ)r rrENABLE_REPORTING_APIrr[s rOenable_reporting_apiz$NetworkCommands.enable_reporting_apis!**':m@@PPrNcnt||}|||d<|||d<ttj|S)a[ Searches for content within response bodies. Powerful for: - Content verification - Security scanning - Data extraction - Response validation Args: request_id: Target response identifier query: Search string or pattern case_sensitive: Match case sensitivity is_regex: Use regular expression matching Returns: Command: CDP command returning match results Performance tip: - Use specific queries for large responses - Consider regex complexity )rrquery caseSensitiveisRegexrZ)rrrSEARCH_IN_RESPONSE_BODY)rurcase_sensitiveis_regexr[s rOsearch_in_response_bodyz'NetworkCommands.search_in_response_bodysC:,jN  %&4F? #   (F9 mCCFSSrNcPt|}ttj|S)aG Blocks specified URLs from loading. Key features: - Pattern-based URL blocking - Resource type filtering - Network request prevention - Error simulation Args: urls: list of URL patterns to block Supports wildcards and pattern matching Returns: Command: CDP command to set URL blocking rules Common applications: - Ad/tracker blocking simulation - Resource loading control - Error handling testing - Network isolation testing )rlrZ)rrrSET_BLOCKED_URLSrns rOset_blocked_urlsz NetworkCommands.set_blocked_urls<s!0&40m<)rrrr?)rrrfloatrrrrrzOptional[ConnectionType]rrrrrrrr')rrrr/)rVrrrFrrrr1)rurrr2)"__name__ __module__ __qualname____doc__ staticmethodrPrSr^rarjrorvryr~rrrrrrrrrrrrrrrrrrrrrMrNrOrHrHPs AA( C C" $"6: "K"K "K"K "K 4 "K  "K"KH55&/326,0C,C"/C*C  CC<$(H!H HH2RR "RR4NN NN2OO*" $"!%$(.2#'-1%)6:%)6:MGMGMGMG MG  MG  MG"MG,MG!MG+MG#MG4MG#MG4MG MGMG^HH0S"S #SS4*."&;? $T$T&$T $T9 $T % $T$TLOO&QQ "QQ. % !T!T!T!T !T % !T!TFMM4VV &VV4LL2__ .__4S(S $SS4SS0?C@D"P/3"P-;"P0>"P " "P"PHTT %TT4  7  : 59'+-1,03W3W3W#3W! 3W 2 3W % 3W+3W*3W )3W3Wj"&ZZ *ZZ:#'R R+R R $ RRBGG GGrNrHN)K __future__rtypingrrpydoll.protocol.baserpydoll.protocol.network.methodsrrr r r r r rrrrrrrrrrrrrrrrrrr pydoll.protocol.emulation.typesr!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?pydoll.protocol.network.typesr@rArBrCrDrErFrHrMrNrOr s"*(:A@y Gy GrN