Skip to content

Exceptions

All Silkweb exceptions inherit from SilkwebError.

exceptions

SilkwebError dataclass

SilkwebError(message: str = 'Silkweb error', context: dict[str, Any] | None = None)

Bases: Exception

Base error for all Silkweb exceptions.

SilkwebFetchError dataclass

SilkwebFetchError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None)

Bases: SilkwebError

Base error for fetch failures.

SilkwebHTTPError dataclass

SilkwebHTTPError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None, status_code: int | None = None)

Bases: SilkwebFetchError

Non-2xx HTTP response.

SilkwebTimeoutError dataclass

SilkwebTimeoutError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None, timeout_ms: int | None = None)

Bases: SilkwebFetchError

Request timed out.

SilkwebBlockedError dataclass

SilkwebBlockedError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None, status_code: int | None = None, tier_tried: int | None = None, challenge_type: str | None = None, html_snippet: str | None = None)

Bases: SilkwebFetchError

Bot detection confirmed / challenge page encountered.

SilkwebRenderError dataclass

SilkwebRenderError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None, tier_tried: int | None = None)

Bases: SilkwebFetchError

JavaScript rendering failed.

SilkwebExtractionError dataclass

SilkwebExtractionError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None)

Bases: SilkwebError

Base error for extraction failures.

SilkwebSchemaError dataclass

SilkwebSchemaError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None, validation_errors: Any | None = None)

Bases: SilkwebExtractionError

Pydantic validation failed.

SilkwebLLMError dataclass

SilkwebLLMError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None, provider: str | None = None, model: str | None = None, raw_output: str | None = None)

Bases: SilkwebExtractionError

LLM call failed or returned invalid JSON.

SilkwebSelectorError dataclass

SilkwebSelectorError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, url: str | None = None, selector: str | None = None)

Bases: SilkwebExtractionError

No elements matched selector.

SilkwebCacheError dataclass

SilkwebCacheError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, backend: str | None = None)

Bases: SilkwebError

Cache backend failure.

SilkwebConfigError dataclass

SilkwebConfigError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, key: str | None = None, value: Any | None = None)

Bases: SilkwebError

Invalid configuration.

SilkwebSessionError dataclass

SilkwebSessionError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, name: str | None = None)

Bases: SilkwebError

Base error for session/recording failures.

SilkwebSessionExpiredError dataclass

SilkwebSessionExpiredError(message: str = 'Silkweb error', context: dict[str, Any] | None = None, name: str | None = None, expired_cookies: list[str] | None = None)

Bases: SilkwebSessionError

Session has expired (auth cookies likely stale).