运行时契约
包管理器入口为纯 ESM;CDN 入口为单独压缩的 IIFE。
面向 ES2022 现代浏览器与 WebView。
Vue 3.5.11 及以上版本通过必须安装的 Peer Dependency 接入。
调用时检查并直接使用
uni.xxx;App-Plus 直接通过typeof plus判断。导入阶段不访问
window、Storage 或uni;不支持的调用明确失败。不注入 Web Crypto、URL、Intl、TextEncoder 等 Polyfill。
文本编解码统一使用内部 UTF-8 实现,不依赖 TextEncoder / TextDecoder,不安装全局 Polyfill。非法 UTF-8 仍抛出 TypeError;解码移除开头的一个 BOM,编码将孤立代理项替换为 U+FFFD。
产物使用 ES2022 语法目标,不承诺 Chrome 83 / Safari 12 语法兼容;App、H5 和小程序的平台 API 仍按调用能力检查。
不依赖
Object.hasOwn、数组/字符串.at()或必需的globalThis。查询参数直接使用encodeURIComponent/decodeURIComponent,不要求URLSearchParams;非法百分号编码、非法 UTF-8,以及编码时的孤立代理项抛出URIError。formatBytes默认数字格式和formatRelativeTime默认简体中文文本使用内部实现,不要求 Intl。显式传入locale时分别使用Intl.NumberFormat和Intl.RelativeTimeFormat,保留任意语言与选项支持;对应能力缺失时明确抛出 Error。truncateGraphemes仍要求Intl.Segmenter,以保留完整字素分割语义。Web Crypto、DOM、Storage 和剪贴板能力按实际运行环境检查。useBreakpoints兼容旧式MediaQueryList.addListener/removeListener,并随 Vue 作用域清理监听。错误原因使用原生 ErrorOptions 的
cause;旧运行时可能忽略该诊断信息,不额外注入兼容实现。加密操作仅检查自身需要的 SubtleCrypto 方法;例如摘要不要求密钥生成或签名能力。算法支持仍由平台决定,缺失时保留错误;
hasWebCrypto()仍检查完整能力。
