> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/D4Vinci/Scrapling/llms.txt
> Use this file to discover all available pages before exploring further.

# StealthyFetcher

> Completely stealthy browser-based fetcher built on Chromium

## StealthyFetcher

A `Fetcher` class that uses a completely stealthy browser built on top of Chromium. It works as real browsers, passing almost all online tests and protections with many customization options.

```python theme={null}
from scrapling import StealthyFetcher

response = StealthyFetcher.fetch(
    'https://example.com',
    headless=True,
    solve_cloudflare=True
)
print(response.status)
```

<Note>
  StealthyFetcher uses a real Chromium browser with stealth modifications to bypass bot detection and pass anti-bot tests.
</Note>

### Methods

#### fetch()

Opens up a browser and performs your request based on your chosen options.

```python theme={null}
StealthyFetcher.fetch(url: str, **kwargs) -> Response
```

<ParamField path="url" type="str" required>
  Target URL to fetch
</ParamField>

<ParamField path="headless" type="bool" default="True">
  Run the browser in headless/hidden (default) or headful/visible mode
</ParamField>

<ParamField path="disable_resources" type="bool" default="False">
  Drop requests for unnecessary resources for a speed boost. Requests dropped are of type: `font`, `image`, `media`, `beacon`, `object`, `imageset`, `texttrack`, `websocket`, `csp_report`, and `stylesheet`
</ParamField>

<ParamField path="blocked_domains" type="set">
  A set of domain names to block requests to. Subdomains are also matched (e.g., `"example.com"` blocks `"sub.example.com"` too)
</ParamField>

<ParamField path="useragent" type="str">
  Pass a useragent string to be used. Otherwise the fetcher will generate a real Useragent of the same browser and use it
</ParamField>

<ParamField path="cookies" type="dict">
  Set cookies for the next request
</ParamField>

<ParamField path="network_idle" type="bool" default="False">
  Wait for the page until there are no network connections for at least 500 ms
</ParamField>

<ParamField path="timeout" type="int" default="30000">
  The timeout in milliseconds that is used in all operations and waits through the page
</ParamField>

<ParamField path="wait" type="int" default="0">
  The time (milliseconds) the fetcher will wait after everything finishes before closing the page and returning the Response object
</ParamField>

<ParamField path="page_action" type="Callable">
  Added for automation. A function that takes the `page` object and does the automation you need
</ParamField>

<ParamField path="wait_selector" type="str">
  Wait for a specific CSS selector to be in a specific state
</ParamField>

<ParamField path="wait_selector_state" type="str" default="attached">
  The state to wait for the selector given with `wait_selector`. Options: `attached`, `detached`, `visible`, `hidden`
</ParamField>

<ParamField path="init_script" type="str">
  An absolute path to a JavaScript file to be executed on page creation for all pages in this session
</ParamField>

<ParamField path="locale" type="str">
  Specify user locale, for example, `en-GB`, `de-DE`, etc. Locale will affect navigator.language value, Accept-Language request header value as well as number and date formatting rules. Defaults to the system default locale
</ParamField>

<ParamField path="timezone_id" type="str">
  Changes the timezone of the browser. Defaults to the system timezone
</ParamField>

<ParamField path="solve_cloudflare" type="bool" default="False">
  Solves all types of Cloudflare's Turnstile/Interstitial challenges before returning the response to you
</ParamField>

<ParamField path="real_chrome" type="bool" default="False">
  If you have a Chrome browser installed on your device, enable this, and the Fetcher will launch an instance of your browser and use it
</ParamField>

<ParamField path="hide_canvas" type="bool" default="False">
  Add random noise to canvas operations to prevent fingerprinting
</ParamField>

<ParamField path="block_webrtc" type="bool" default="False">
  Forces WebRTC to respect proxy settings to prevent local IP address leak
</ParamField>

<ParamField path="allow_webgl" type="bool" default="True">
  Enabled by default. Disabling it disables WebGL and WebGL 2.0 support entirely. Disabling WebGL is not recommended as many WAFs now check if WebGL is enabled
</ParamField>

<ParamField path="load_dom" type="bool" default="True">
  Enabled by default, wait for all JavaScript on page(s) to fully load and execute
</ParamField>

<ParamField path="cdp_url" type="str">
  Instead of launching a new browser instance, connect to this CDP URL to control real browsers through CDP
</ParamField>

<ParamField path="google_search" type="bool" default="True">
  Enabled by default, Scrapling will set the referer header to be as if this request came from a Google search of this website's domain name
</ParamField>

<ParamField path="extra_headers" type="dict">
  A dictionary of extra headers to add to the request. The referer set by the `google_search` argument takes priority over the referer set here if used together
</ParamField>

<ParamField path="proxy" type="str | dict">
  The proxy to be used with requests. It can be a string or a dictionary with the keys 'server', 'username', and 'password' only
</ParamField>

<ParamField path="user_data_dir" type="str">
  Path to a User Data Directory, which stores browser session data like cookies and local storage. The default is to create a temporary directory
</ParamField>

<ParamField path="extra_flags" type="list">
  A list of additional browser flags to pass to the browser on launch
</ParamField>

<ParamField path="selector_config" type="dict">
  The arguments that will be passed in the end while creating the final Selector's class
</ParamField>

<ParamField path="additional_args" type="dict">
  Additional arguments to be passed to Playwright's context as additional settings, and it takes higher priority than Scrapling's settings
</ParamField>

<ResponseField name="Response" type="Response">
  A Response object containing the fetched page data
</ResponseField>

#### async\_fetch()

Asynchronous version of `fetch()`. Opens up a browser and performs your request.

```python theme={null}
import asyncio
from scrapling import StealthyFetcher

async def main():
    response = await StealthyFetcher.async_fetch(
        'https://example.com',
        solve_cloudflare=True
    )
    print(response.status)

asyncio.run(main())
```

```python theme={null}
StealthyFetcher.async_fetch(url: str, **kwargs) -> Response
```

All parameters are identical to `fetch()`.

<ResponseField name="Response" type="Response">
  An awaitable Response object containing the fetched page data
</ResponseField>

***

## Usage Examples

### Basic Stealth Request

```python theme={null}
from scrapling import StealthyFetcher

response = StealthyFetcher.fetch('https://example.com')
print(response.text)
```

### Solve Cloudflare Challenge

```python theme={null}
response = StealthyFetcher.fetch(
    'https://protected-site.com',
    solve_cloudflare=True,
    timeout=60000  # Longer timeout for challenge solving
)
```

### Custom Page Automation

```python theme={null}
def click_button(page):
    page.click('#submit-button')
    page.wait_for_selector('.results')

response = StealthyFetcher.fetch(
    'https://example.com',
    page_action=click_button,
    wait_selector='.results',
    wait_selector_state='visible'
)
```

### With Proxy

```python theme={null}
response = StealthyFetcher.fetch(
    'https://example.com',
    proxy='http://username:password@proxy.example.com:8080'
)
```

### Performance Optimization

```python theme={null}
response = StealthyFetcher.fetch(
    'https://example.com',
    disable_resources=True,  # Block images, fonts, etc.
    blocked_domains={'ads.example.com', 'tracking.example.com'}
)
```