外观
浏览器支持
包产物目标语法为 ES2018,并依赖基础 DOM API。
Environment 可以只读探测当前运行环境和基础 Web API 是否存在。environment.supports() 不表示权限已经授予,也不保证具体调用成功;业务仍应处理 capability 的失败结果。
Storage 能力依赖 localStorage / sessionStorage。DB 能力依赖 IndexedDB。Clipboard 能力优先依赖 navigator.clipboard.writeText,并在可行时 fallback 到 document.execCommand('copy')。HTTP 能力内部使用 axios 的浏览器 HTTP 适配能力,依赖当前环境可发起 HTTP 请求;取消请求依赖 AbortController。
受限 WebView、隐私模式、非安全上下文、SSR 环境或宿主网络策略限制下,这些能力可能不可用,业务应根据返回值或 Promise reject 做降级。Clipboard 写入还可能依赖用户手势、浏览器权限和宿主策略,最终应以 clipboard.writeText() 的 Promise 结果为准。HTTP 请求是否成功还取决于 CORS、Cookie 策略、证书、离线状态、代理和宿主容器网络能力。
Bridge 默认适配 App 的 DSBridge 3 原生通信通道,内部使用 Proxy、Map 和 WeakMap 管理回调与事件。未处于 App 时调用会明确报 unavailable,浏览器测试可注入自定义 adapter。
本库不内置全局 polyfill。业务应用需要根据自己的 WebView 或浏览器矩阵统一处理 polyfill。