Struct Frame 

pub struct Frame { /* private fields */ }

Frame 树节点。

持有 frame ID / name / URL / parent/children / ExecutionContext / page 弱引用。

@trace REQ-BAO-API-006 [class:Frame]

Implementations

impl Frame

pub fn new(id: impl Into<String>, is_main: bool, page: Weak<Page>) -> Frame

构造 Frame。is_main=true 表示主 frame。

@trace REQ-BAO-API-006 [class:Frame]

pub fn id(&self) -> &str

Frame ID。

@trace REQ-BAO-API-006 [class:Frame]

pub fn is_main_frame(&self) -> bool

是否主 frame。

@trace REQ-BAO-API-006 [class:Frame]

pub fn name(&self) -> String

Frame name(本地缓存)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn set_name(&self, name: impl Into<String>)

设置 Frame name(Page.frameNavigated 等事件填入)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn url(&self) -> String

当前 URL(本地缓存)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn set_url(&self, url: impl Into<String>)

设置 URL(frameNavigated 事件填入)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn parent_frame(&self) -> Option<Rc<Frame>>

父 Frame(根 frame 返回 None)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn add_child(&self, child: Rc<Frame>, self_ref: Weak<Frame>)

添加子 Frame。同步设置 child 的 parent 为自身弱引用。

@trace REQ-BAO-API-006 [class:Frame]

pub fn remove_child(&self, child_id: &str)

移除子 Frame。

@trace REQ-BAO-API-006 [class:Frame]

pub fn child_frames(&self) -> Vec<Rc<Frame>>

子 Frame 列表(克隆,本地树)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn execution_context(&self) -> Option<Rc<ExecutionContext>>

所属 ExecutionContext(本地缓存)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn set_execution_context(&self, ctx: Rc<ExecutionContext>)

设置 ExecutionContext(executionContextCreated 事件填入)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn is_detached(&self) -> bool

是否已 detached(本地标记)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn set_detached(&self, detached: bool)

标记 detached(frameDetached 事件填入)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn page(&self) -> Option<Rc<Page>>

所属 Page(Weak::upgrade 失败时返回 None)。

@trace REQ-BAO-API-006 [class:Frame]

pub fn events(&self) -> &Rc<EventEmitterInner>

EventEmitter inner 引用(供 Page 上层转发)。

@trace REQ-BAO-API-006 [class:Frame]

Trait Implementations

impl Debug for Frame

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

Formats the value using the given formatter.

impl EventEmitter for Frame

fn on(&self, event: &str, handler: Arc<dyn Fn(&[Value])>) -> u64

注册持久 handler,返回 HandlerId(可用于 off)。

fn once(&self, event: &str, handler: Arc<dyn Fn(&[Value])>) -> u64

注册一次性 handler(emit 后自动移除)。

fn off(&self, event: &str, handler_id: u64) -> SubscriptionResult

按 ID 移除 handler。返回 NotFound 时表示 ID 不存在。

fn remove_all_listeners(&self, event: Option<&str>)

移除指定事件的所有 handler;event=None 时清空所有事件的所有 handler。

fn listener_count(&self, event: &str) -> usize

返回指定事件的 handler 数量。

fn emit(&self, event: &str, args: &[Value])

同步触发事件,按注册顺序调用所有 handler。