@nw-cfg/bridge
v0.1.4
Published
封装基于 Penpal 的 iframe RPC 连接,负责握手、来源校验、超时与重连控制。
Readme
@nw-cfg/bridge
封装基于 Penpal 的 iframe RPC 连接,负责握手、来源校验、超时与重连控制。
导出能力
createHostBridge(iframe, { hostApi, ...options }):宿主侧建立高阶连接,返回带有getConfigMeta/setConfig/validateConfig等封装方法的桥接句柄,并暴露自身hostApi给子窗口。createGuestBridge(childApi, options):子窗口注册自身 API,校验宿主暴露的方法是否完备,返回带host引用与disconnect()的句柄。connectToChild(iframe, options, hostApi)/exposeChild(childApi, options):底层包装,保留对 Penpal 原始能力的直接访问。validateEnvelope():辅助校验基础消息信封结构,用于低层调试。
options.timeoutMs 默认复用 DEFAULT_TIMEOUT_MS,options.targetOrigin/parentOrigin 用于限定通信域。所有方法返回 Promise,内部基于 Penpal 的 postMessage 信道,可安全处理异步函数。
