Struct Browser 

pub struct Browser { /* private fields */ }

CDP Browser 实例。

代表一次成功的 connect —— 持有解析后的 URL、Connection 和 transport 类型。

@trace REQ-BAO-API-001 [level:library]

Implementations

impl Browser

pub fn connect(url: &str) -> Result<Browser, ConnectError>

连接到 CDP 目标(解析 URL,按需创建 Connection)。

根据输入 URL 的 scheme 自动路由到三种 transport 模式:

Scheme	行为
memory://	解析 URL,返回 Browser(无 Connection,需 connect_with_bridge 接入)
ws:///wss://	解析 URL,返回 Browser(无 Connection,需 connect_with_discovered_ws 接入)
http:///https://	解析 URL,返回 Browser(无 Connection,同 ws://)

这是 lazy connect 模式:不触发网络 I/O,不阻塞,瞬时返回。 实际的 Transport 建立通过 connect_with_bridge(memory://) 或 connect_with_discovered_ws(ws://) 完成。

错误

• ConnectError::InvalidUrl: 空 URL 或无 ://
• ConnectError::InvalidScheme: scheme 不在支持列表(如 ftp)

@trace REQ-BAO-API-001 [level:library]

pub fn connect_with_bridge( url: &str, bridge: Arc<dyn InMemoryBridge>, ) -> Result<Browser, ConnectError>

连接到 CDP 目标并传入 InMemoryBridge(memory:// 模式)。

与 connect 类似,但立即为 memory:// 创建 Connection。 其他 scheme 仍返回 Browser(无 Connection)。

@trace REQ-BAO-API-001 [level:library]

pub fn connect_with_discovered_ws(ws_url: &str) -> Result<Browser, ConnectError>

HTTP 发现完成后,用发现的 ws URL 创建 Connection。

触发实际的 WebSocket 连接(会阻塞直到 TCP+WS 握手完成或超时)。

@trace REQ-BAO-API-001 [level:library]

pub fn send_command( &mut self, method: &str, params: Value, ) -> Result<Value, CdpError>

发送 CDP 命令(通过 Connection)。

@trace REQ-BAO-API-001 [level:library]

pub fn send_command_with_session( &mut self, method: &str, params: Value, session_id: &str, ) -> Result<Value, CdpError>

发送 CDP 命令(带 session_id)。

@trace REQ-BAO-API-001 [level:library]

pub fn version(&mut self) -> Result<Value, CdpError>

获取 Browser 版本信息(CDP Browser.getVersion)。

@trace REQ-BAO-API-001 [level:library]

pub fn pages(&mut self) -> Result<Value, CdpError>

获取所有 target 列表(CDP Target.getTargets)。

@trace REQ-BAO-API-001 [level:library]

pub fn new_page(&mut self, url: &str) -> Result<Value, CdpError>

创建新 page/tab(CDP Target.createTarget)。

@trace REQ-BAO-API-001 [level:library]

pub fn recv_event(&mut self) -> Result<Option<CdpEvent>, CdpError>

接收一个 CDP 事件。

@trace REQ-BAO-API-001 [level:library]

pub fn on_event( &mut self, method: &str, handler: Arc<dyn Fn(CdpEvent) + Sync + Send>, ) -> u64

注册事件 handler。

@trace REQ-BAO-API-001 [level:library]

pub fn off_event(&mut self, method: &str, listener_id: u64) -> bool

移除事件 handler。

@trace REQ-BAO-API-001 [level:library]

pub fn close_connection(&mut self) -> Result<(), CdpError>

关闭 Connection。

@trace REQ-BAO-API-001 [level:library]

pub fn url(&self) -> &str

原 URL。

@trace REQ-BAO-API-001 [level:library]

pub fn scheme(&self) -> &str

已解析的 scheme(memory / ws / wss / http / https)。

@trace REQ-BAO-API-001 [level:library]

pub fn transport_kind(&self) -> TransportKind

Transport 类型。

@trace REQ-BAO-API-001 [level:library]

pub fn is_in_memory(&self) -> bool

是否 InMemory 连接。

@trace REQ-BAO-API-001 [level:library]

pub fn is_websocket(&self) -> bool

是否 WebSocket 连接(包括 ws/wss/http/https — 后者会先 discover)。

@trace REQ-BAO-API-001 [level:library]

pub fn has_connection(&self) -> bool

是否有 Connection(即 transport 已建立)。

pub fn connection_mut(&mut self) -> Option<&mut Connection>

获取 Connection 的可变引用。

@trace REQ-BAO-API-001 [level:library]

pub fn build_transport(&self) -> Result<Box<dyn Transport>, ConnectError>

根据 URL scheme 构造对应 Transport。

• InMemory URL(memory://)需要调用方传入 servo bridge → 调 [build_in_memory_transport]
• WebSocket URL(ws://)→ 调 [build_websocket_transport] 触发 TCP + WebSocket 握手

返回 Box<dyn Transport> 便于上层 Connection 持有 trait 对象。

@trace REQ-BAO-API-002 [interface:Transport]

pub fn build_in_memory_transport( &self, bridge: Arc<dyn InMemoryBridge>, ) -> Result<InMemoryTransport, ConnectError>

构造 InMemory transport(同进程 servo)。

@trace REQ-BAO-API-002 [interface:Transport]

pub fn build_websocket_transport( &self, ) -> Result<WebSocketTransport, ConnectError>

构造 WebSocket transport(外部 Chrome)。

@trace REQ-BAO-API-002 [interface:Transport]

Trait Implementations

impl Debug for Browser

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for Browser

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.