drission 0.3.0

Rust 反检测浏览器自动化 + 内置验证码识别:ddddocr 离线 OCR 与图片滑块缺口距离(极验/顶象),默认 Camoufox/Firefox、自动过 Cloudflare 盾、高并发爬虫与 XHR 监听拦截,DrissionPage 风格 API。Anti-detect browser automation in Rust with built-in ddddocr captcha OCR + slider-gap (GeeTest) solving, Camoufox, Cloudflare bypass — a Rust DrissionPage.
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

//! 统一错误类型。
//!
//! 整个 crate 对外只暴露 [`Error`] 与 [`Result`],方便上层用 `?` 串联。

use std::time::Duration;

/// crate 级别的 `Result` 别名。
pub type Result<T> = std::result::Result<T, Error>;

/// drission 的统一错误枚举。
#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("IO 错误: {0}")]
    Io(#[from] std::io::Error),

    #[error("JSON 序列化/反序列化错误: {0}")]
    Json(#[from] serde_json::Error),

    #[error("HTTP 请求错误: {0}")]
    Http(#[from] reqwest::Error),

    /// 指纹 HTTP 客户端(`wreq`,`impersonate` feature)的请求错误。
    #[cfg(feature = "impersonate")]
    #[error("HTTP(指纹)请求错误: {0}")]
    Impersonate(#[from] wreq::Error),

    #[error("解压错误: {0}")]
    Zip(#[from] zip::result::ZipError),

    /// 来自浏览器(Juggler 服务端)的协议错误,内容为 `error.message`。
    #[error("协议错误: {0}")]
    Protocol(String),

    /// 协议帧/会话路由相关的传输层错误。
    #[error("传输层错误: {0}")]
    Transport(String),

    #[error("操作超时(超过 {0:?})")]
    Timeout(Duration),

    #[error("未找到 Camoufox 浏览器: {0}")]
    BrowserNotFound(String),

    #[error("未找到元素: {0}")]
    ElementNotFound(String),

    #[error("元素已失效或脱离文档: {0}")]
    StaleElement(String),

    #[error("不支持的平台: {0}")]
    UnsupportedPlatform(String),

    #[error("功能尚未实现: {0}")]
    NotImplemented(&'static str),

    #[error("{0}")]
    Other(String),
}

impl Error {
    /// 便捷构造一个 `Other` 错误。
    pub fn msg(s: impl Into<String>) -> Self {
        Error::Other(s.into())
    }
}