fetch

Fetch Commands

Fetch commands provide advanced network request handling and interception capabilities using the Fetch API domain.

Overview

The fetch commands module enables sophisticated network request management, including request modification, response interception, and authentication handling.

::: pydoll.commands.fetch_commands options: show_root_heading: true show_source: false heading_level: 2 filters: - "!^_" - "!^__"

Usage

Fetch commands are used for advanced network interception and request handling:

from pydoll.commands.fetch_commands import enable, request_paused, continue_request
from pydoll.connection.connection_handler import ConnectionHandler

# Enable fetch domain
connection = ConnectionHandler()
await enable(connection, patterns=[{
    "urlPattern": "*",
    "requestStage": "Request"
}])

# Handle paused requests
async def handle_paused_request(request_id, request):
    # Modify request or continue as-is
    await continue_request(connection, request_id=request_id)

Key Functionality

The fetch commands module provides functions for:

Request Interception

• enable() - Enable fetch domain with patterns
• disable() - Disable fetch domain
• continue_request() - Continue intercepted requests
• fail_request() - Fail requests with specific errors

Request Modification

• Modify request headers
• Change request URLs
• Alter request methods (GET, POST, etc.)
• Modify request bodies

Response Handling

• fulfill_request() - Provide custom responses
• get_response_body() - Get response content
• Response header modification
• Response status code control

Authentication

• continue_with_auth() - Handle authentication challenges
• Basic authentication support
• Custom authentication flows

Advanced Features

Pattern-Based Interception

# Intercept specific URL patterns
patterns = [
    {"urlPattern": "*/api/*", "requestStage": "Request"},
    {"urlPattern": "*.js", "requestStage": "Response"},
    {"urlPattern": "https://example.com/*", "requestStage": "Request"}
]

await enable(connection, patterns=patterns)