drission 0.6.2

Rust 里用 CDP 控 Chrome。Context / 磁盘 Profile / XHR 监听与 mock。同仓库有 drs CLI 和 MCP。
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

//! **Chromium 后端**(Chrome / Edge / Brave / Electron 应用),经 **CDP**(Chrome DevTools Protocol)。
//!
//! 与默认的 Camoufox/Juggler 后端并行:用于**驱动或接管 Chromium 系浏览器**,以及**控制 Electron 桌面
//! 应用**(它们都内置 CDP)。CDP 线消息格式(`id`/`method`/`params`/`sessionId` + `result`/`error`/事件)
//! 与 Juggler 高度一致,故**复用** [`crate::protocol::Connection`] 的请求/响应/事件机制,只换方法名与目标管理。
//!
//! ```no_run
//! use drission::prelude::*;
//! # async fn f() -> drission::Result<()> {
//! // 启动 Chrome(headless),或 connect("http://127.0.0.1:9222") 接管已开的 Chrome / Electron
//! let browser = ChromiumBrowser::launch(ChromiumOptions::new().headless(true)).await?;
//! let tab = browser.new_tab(Some("https://example.com")).await?;
//! // 元素句柄 + 原生可信点击 + 拟人输入
//! let h1 = tab.ele("h1").await?;
//! println!("{}", h1.text().await?);
//! // 网络监听(原生 Network 域 + getResponseBody)
//! let listen = tab.listen();
//! listen.start_xhr(&["/api/"]).await?;
//! // ... 触发请求 ...
//! if let Some(pkt) = listen.wait(None).await? { println!("{}", pkt.url); }
//! browser.quit().await?;
//! # Ok(()) }
//! ```
//!
//! 能力(与 Juggler 后端对齐):
//! - 启动/接管(`launch`/`connect`)、新标签、导航、`run_js`、标题/URL、整页/区域截图;
//! - **浏览器自动下载** [`fetch`]:找不到系统 Chrome 时,自动从 **Chrome for Testing** 下载并缓存
//!   (`mac-arm64`/`mac-x64`/`win64`/`win32`/`linux64`,对标 CloakBrowser 首次运行自动下载);
//! - **元素句柄** [`ChromiumElement`]:`ele`/`eles`/相对定位 + 读文本/属性 + **原生可信点击**
//!   (`Input.dispatchMouseEvent`)+ **拟人逐字符输入**(`input_human`)+ 表单填充 + 元素截图;
//! - **网络监听** [`CdpListen`]:原生 `Network` 域事件 + `Network.getResponseBody`;
//! - **请求拦截** [`CdpIntercept`]:`Fetch` 域 `requestPaused` + `continue`/`fulfill`/`fail`。

mod a11y;
mod actions;
mod attach;
mod browser;
mod cloudflare;
mod console;
mod container;
mod context;
mod core;
mod debugger;
mod download;
mod dump_env;
pub mod element;
mod extras;
pub mod fetch;
mod fingerprint;
pub mod frame;
mod handles;
mod hook;
pub mod interceptor;
pub mod listener;
pub mod locate;
mod network;
mod oopif;
mod options;
mod page;
mod pool;
mod profile;
mod recorder;
mod screencast;
mod scripts;
mod shadow;
// 滑块求解:cdp `ChromiumTab` 的后端适配(只含 impl,类型在后端无关的 `crate::slider`)。
mod capture;
mod schedule;
#[cfg(feature = "slider")]
mod slider;
mod stealth;
mod storage;
mod tab;
mod types;
mod wait_flow;
mod websocket;

pub use actions::ChromiumActions;
pub use browser::ChromiumBrowser;
pub use capture::PageCapture;
pub use console::{ChromiumConsole, ConsoleData, ConsoleFilter};
pub use context::{ChromiumBrowserContext, ContextSpec};
pub use debugger::{CallFrame, ChromiumDebugger, PausedStack};
pub use download::{ChromiumDownloads, DownloadMission, DownloadState};
pub use dump_env::{ChromiumEnvDumper, ChromiumEnvProbe};
pub use element::{ChromiumElement, ChromiumElementWait, ElementRect as ChromiumElementRect};
pub use extras::{
    Device, ExposedFunction, HarLog, HarNotFound, HarPlayer, HarRecorder, HarReplayOptions,
    NetworkConditions, PdfOptions,
};
pub use fetch::{cft_platform, download_chrome_for, download_chrome_milestone, ensure_chrome};
pub use fingerprint::{CdpFingerprint, CdpFingerprintPool, CdpOs};
pub use frame::ChromiumFrame;
pub use handles::{ChromiumScroll, ChromiumSetTab, ChromiumWait, ChromiumWindow};
pub use hook::{ChromiumHook, HookHit, HookSession};
pub use interceptor::{CdpIntercept, CdpInterceptedRequest};
pub use listener::CdpListen;
pub use locate::chrome_path;
pub use network::{NetworkHandle, NetworkRoute};
pub use oopif::ChildTarget;
pub use options::{ChromiumContextOverride, ChromiumOptions};
pub use page::ChromiumPage;
pub use pool::{
    ChromiumPool, ChromiumPoolOptions, ContextLease, PoolLease, ProcStat, RecycleReport, TabLease,
    WorkerResource, proc_stat,
};
pub use profile::{ManagedProfile, ProfileLease, ProfileManager, ProfileManifest};
pub use recorder::{ChromiumRecorder, RECORDER_JS};
pub use schedule::TaskScheduler;
pub use screencast::ChromiumScreencast;
pub use scripts::{ChromiumScripts, ScriptInfo, ScriptMatch, beautify_js};
pub use shadow::ChromiumShadowRoot;
pub use storage::{OriginStorage, StorageState};
pub use tab::ChromiumTab;
pub use types::{
    Cookie, CookieParam, DialogInfo, DownloadInfo, GetOptions, ImageFormat, LoadMode, PageRect,
    ShotOpts,
};
pub use wait_flow::{WaitDownload, WaitElement, WaitNetwork, WaitPopup, WaitText};
pub use websocket::{ChromiumWsListener, WsDirection, WsFilter, WsMessage};