跳到正文

运行时契约 ​

  • 包管理器入口为纯 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() 仍检查完整能力。