cadrumo.adapters.outbound.aeat.browser.evasion module

Anti-bot evasion strategies for Playwright contexts.

adapters.outbound.aeat.browser.session.BrowserSession applies an EvasionStrategy after creating each Playwright BrowserContext and before returning it to auth providers or Sede readers. The default PlaywrightStealthEvasion delegates to the optional playwright-stealth package and raises BrowserEvasionError with a typed terminal outcome when that package is unavailable.

See also

adapters.outbound.aeat.browser.session.BrowserSession.create_context()

Applies the configured evasion strategy during context preparation.

adapters.outbound.aeat.browser.errors.BrowserFailureMode

Carries EVASION_FAILED when strategy application fails inside the central session wrapper.

class EvasionStrategy(*args, **kwargs)

Bases: Protocol

Protocol for applying evasion techniques to a Playwright context.

Custom implementations can be supplied to BrowserSession tests or adapter callers; production code defaults to PlaywrightStealthEvasion.

async apply(context)

Apply anti-bot evasion techniques to the given context.

Parameters:

context (BrowserContext) – The Playwright BrowserContext to patch.

Return type:

None

class PlaywrightStealthEvasion

Bases: object

Evasion strategy backed by the playwright-stealth package.

Targets the playwright-stealth 2.x class-based API (Stealth().apply_stealth_async). The 1.x module-level stealth_async helper was removed upstream.

async apply(context)

Apply playwright-stealth patches to context.

Parameters:

context (BrowserContext) – The Playwright BrowserContext to patch.

Raises:

BrowserEvasionError – If the playwright-stealth package is not installed.

Return type:

None