stealthscraper-rs 0.4.0

A stealthy web scraping library providing TLS JA4 fingerprint impersonation and headless browser automation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! The crate's error type, covering the browser, proxy, challenge, and state layers.

use thiserror::Error;

/// The main error type for the `stealthscraper-rs` library.
#[derive(Error, Debug)]
pub enum Error {
    /// An error occurred while generating or interacting with the underlying stealth browser.
    #[error("Browser automation error: {0}")]
    BrowserError(String),

    /// An error during realistic mouse/keyboard interaction emulation.
    #[error("Interaction emulation error: {0}")]
    InteractionError(String),

    /// An error occurred setting up or running the local TLS proxy.
    #[error("Proxy initialization failed: {0}")]
    ProxyBindFailed(#[from] std::io::Error),

    /// An error occurred within the HTTP/TLS impersonation client.
    #[error("HTTP client error: {0}")]
    HttpClientError(#[from] wreq::Error),

    /// A bot-protection challenge was detected but could not be solved.
    #[error("Unsolved challenge: {0}")]
    Challenge(String),

    /// The persistent state store failed to read or write.
    #[error("State store error: {0}")]
    StateStore(String),

    /// Missing or invalid configuration state.
    #[error("Configuration error: {0}")]
    ConfigError(String),

    /// An error occurred while spawning or joining background tasks.
    #[error("Internal join error: {0}")]
    JoinError(String),

    /// An error occurred during TLS configuration or handshake.
    #[error("TLS error: {0}")]
    TlsError(String),

    /// A generic internal error.
    #[error("Internal error: {0}")]
    Internal(String),
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_error_display_formatting() {
        let err = Error::BrowserError("Failed to launch".to_string());
        assert_eq!(
            err.to_string(),
            "Browser automation error: Failed to launch"
        );

        let err2 = Error::ConfigError("Missing timeout".to_string());
        assert_eq!(err2.to_string(), "Configuration error: Missing timeout");

        let err3 = Error::Internal("Crash".to_string());
        assert_eq!(err3.to_string(), "Internal error: Crash");

        let err4 = Error::TlsError("handshake timeout".to_string());
        assert_eq!(err4.to_string(), "TLS error: handshake timeout");
    }
}