Skip to content

Exceptions

exceptions

Exception hierarchy for wavexis.

WavexisError

Bases: Exception

Base exception for all wavexis errors.

Source code in wavexis/exceptions.py 
16
17
class WavexisError(Exception):
    """Base exception for all wavexis errors."""

BackendNotAvailableError

Bases: WavexisError

Raised when no backend (cdpwave/bidiwave) is installed.

Source code in wavexis/exceptions.py 
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
class BackendNotAvailableError(WavexisError):
    """Raised when no backend (cdpwave/bidiwave) is installed."""

    def __init__(self, backend: str | None = None) -> None:
        """Initialize the error.

        Args:
            backend: Optional backend name that was requested but not available.
        """
        if backend:
            super().__init__(
                f"Backend '{backend}' is not installed. "
                f"Run: pip install wavexis[{backend}]"
            )
        else:
            super().__init__(
                "No backend available. Install cdpwave or bidiwave."
            )

__init__ 

__init__(backend: str | None = None) -> None

Initialize the error.

Parameters:

Name Type Description Default
backend str | None

Optional backend name that was requested but not available.

 None
Source code in wavexis/exceptions.py 
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
def __init__(self, backend: str | None = None) -> None:
    """Initialize the error.

    Args:
        backend: Optional backend name that was requested but not available.
    """
    if backend:
        super().__init__(
            f"Backend '{backend}' is not installed. "
            f"Run: pip install wavexis[{backend}]"
        )
    else:
        super().__init__(
            "No backend available. Install cdpwave or bidiwave."
        )

BackendNotSupportedError

Bases: WavexisError

Raised when a backend doesn't support a method.

Source code in wavexis/exceptions.py 
40
41
42
43
44
45
46
47
48
49
50
class BackendNotSupportedError(WavexisError):
    """Raised when a backend doesn't support a method."""

    def __init__(self, method: str, backend: str) -> None:
        """Initialize the error.

        Args:
            method: The unsupported method name.
            backend: The backend name that doesn't support the method.
        """
        super().__init__(f"Method '{method}' is not supported by {backend} backend.")

__init__ 

__init__(method: str, backend: str) -> None

Initialize the error.

Parameters:

Name Type Description Default
method str

The unsupported method name.

 required
backend str

The backend name that doesn't support the method.

 required
Source code in wavexis/exceptions.py 
43
44
45
46
47
48
49
50
def __init__(self, method: str, backend: str) -> None:
    """Initialize the error.

    Args:
        method: The unsupported method name.
        backend: The backend name that doesn't support the method.
    """
    super().__init__(f"Method '{method}' is not supported by {backend} backend.")

SessionNotInitializedError

Bases: WavexisError

Raised when a backend method is called before launch().

Source code in wavexis/exceptions.py 
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
class SessionNotInitializedError(WavexisError):
    """Raised when a backend method is called before launch()."""

    def __init__(self, msg: str | None = None) -> None:
        """Initialize the error.

        Args:
            msg: Optional custom message.
        """
        if msg:
            super().__init__(msg)
        else:
            super().__init__(
                "Browser session not initialized. Call launch() first.\n"
                "Hint: This usually means the browser failed to start. "
                "Try --headed to see the browser window, or check if Chromium is installed."
            )

__init__ 

__init__(msg: str | None = None) -> None

Initialize the error.

Parameters:

Name Type Description Default
msg str | None

Optional custom message.

 None
Source code in wavexis/exceptions.py 
56
57
58
59
60
61
62
63
64
65
66
67
68
69
def __init__(self, msg: str | None = None) -> None:
    """Initialize the error.

    Args:
        msg: Optional custom message.
    """
    if msg:
        super().__init__(msg)
    else:
        super().__init__(
            "Browser session not initialized. Call launch() first.\n"
            "Hint: This usually means the browser failed to start. "
            "Try --headed to see the browser window, or check if Chromium is installed."
        )

NavigationError

Bases: WavexisError

Raised when navigation fails or times out.

Source code in wavexis/exceptions.py 
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
class NavigationError(WavexisError):
    """Raised when navigation fails or times out."""

    def __init__(self, url: str, reason: str) -> None:
        """Initialize the error.

        Args:
            url: The URL that failed to navigate to.
            reason: The failure reason.
        """
        super().__init__(
            f"Navigation to '{url}' failed: {reason}\n"
            f"Hint: Check the URL is reachable, try --timeout 60000, "
            f"or use --proxy if behind a firewall."
        )

__init__ 

__init__(url: str, reason: str) -> None

Initialize the error.

Parameters:

Name Type Description Default
url str

The URL that failed to navigate to.

 required
reason str

The failure reason.

 required
Source code in wavexis/exceptions.py 
75
76
77
78
79
80
81
82
83
84
85
86
def __init__(self, url: str, reason: str) -> None:
    """Initialize the error.

    Args:
        url: The URL that failed to navigate to.
        reason: The failure reason.
    """
    super().__init__(
        f"Navigation to '{url}' failed: {reason}\n"
        f"Hint: Check the URL is reachable, try --timeout 60000, "
        f"or use --proxy if behind a firewall."
    )

WaitTimeoutError

Bases: WavexisError

Raised when a wait strategy times out.

Source code in wavexis/exceptions.py 
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
class WaitTimeoutError(WavexisError):
    """Raised when a wait strategy times out."""

    def __init__(self, strategy: str, timeout_ms: int) -> None:
        """Initialize the error.

        Args:
            strategy: The wait strategy name that timed out.
            timeout_ms: The timeout duration in milliseconds.
        """
        super().__init__(
            f"Wait strategy '{strategy}' timed out after {timeout_ms}ms\n"
            f"Hint: Increase timeout with --timeout {max(timeout_ms * 2, 60000)}, "
            f"or use a different wait strategy (load, domcontentloaded, networkidle)."
        )

__init__ 

__init__(strategy: str, timeout_ms: int) -> None

Initialize the error.

Parameters:

Name Type Description Default
strategy str

The wait strategy name that timed out.

 required
timeout_ms int

The timeout duration in milliseconds.

 required
Source code in wavexis/exceptions.py 
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
def __init__(self, strategy: str, timeout_ms: int) -> None:
    """Initialize the error.

    Args:
        strategy: The wait strategy name that timed out.
        timeout_ms: The timeout duration in milliseconds.
    """
    super().__init__(
        f"Wait strategy '{strategy}' timed out after {timeout_ms}ms\n"
        f"Hint: Increase timeout with --timeout {max(timeout_ms * 2, 60000)}, "
        f"or use a different wait strategy (load, domcontentloaded, networkidle)."
    )

ElementNotFoundError

Bases: WavexisError

Raised when a CSS selector matches no elements.

Source code in wavexis/exceptions.py 
106
107
108
109
110
111
112
113
114
115
116
117
118
119
class ElementNotFoundError(WavexisError):
    """Raised when a CSS selector matches no elements."""

    def __init__(self, selector: str) -> None:
        """Initialize the error.

        Args:
            selector: The CSS selector that matched no elements.
        """
        super().__init__(
            f"No element found matching selector: {selector}\n"
            f"Hint: Verify the selector with `wavexis dom --selector '{selector}'`, "
            f"or use `wavexis screenshot` to inspect the page visually."
        )

__init__ 

__init__(selector: str) -> None

Initialize the error.

Parameters:

Name Type Description Default
selector str

The CSS selector that matched no elements.

 required
Source code in wavexis/exceptions.py 
109
110
111
112
113
114
115
116
117
118
119
def __init__(self, selector: str) -> None:
    """Initialize the error.

    Args:
        selector: The CSS selector that matched no elements.
    """
    super().__init__(
        f"No element found matching selector: {selector}\n"
        f"Hint: Verify the selector with `wavexis dom --selector '{selector}'`, "
        f"or use `wavexis screenshot` to inspect the page visually."
    )

ActionError

Bases: WavexisError

Raised when an action fails during execution.

Source code in wavexis/exceptions.py 
122
123
class ActionError(WavexisError):
    """Raised when an action fails during execution."""

MultiConfigError

Bases: WavexisError

Raised when a multi YAML config is invalid.

Source code in wavexis/exceptions.py 
126
127
128
129
130
131
132
133
134
135
136
class MultiConfigError(WavexisError):
    """Raised when a multi YAML config is invalid."""

    def __init__(self, field: str, reason: str) -> None:
        """Initialize the error.

        Args:
            field: The invalid config field name.
            reason: The validation failure reason.
        """
        super().__init__(f"Invalid multi config field '{field}': {reason}")

__init__ 

__init__(field: str, reason: str) -> None

Initialize the error.

Parameters:

Name Type Description Default
field str

The invalid config field name.

 required
reason str

The validation failure reason.

 required
Source code in wavexis/exceptions.py 
129
130
131
132
133
134
135
136
def __init__(self, field: str, reason: str) -> None:
    """Initialize the error.

    Args:
        field: The invalid config field name.
        reason: The validation failure reason.
    """
    super().__init__(f"Invalid multi config field '{field}': {reason}")