@wevu/web-apis 1.2.3 → 1.2.6

package/README.md

@@ -2,11 +2,11 @@
 
 ## 1. 简介
 
-`@wevu/web-apis` 为小程序运行时提供一组 Web API 兼容层，重点解决第三方请求库在小程序环境中缺失 `fetch`、`Request`、`Response`、`AbortController`、`XMLHttpRequest`、`URL`、`WebSocket` 等全局对象的问题。
+`@wevu/web-apis` 为小程序运行时提供一组 Web API 兼容层，重点解决第三方库在小程序环境中缺失 `fetch`、`Request`、`Response`、`AbortController`、`XMLHttpRequest`、`URL`、`WebSocket`、`TextEncoder`、`TextDecoder`、`atob`、`btoa`、`queueMicrotask`、`performance.now`、`crypto.getRandomValues`、`Event`、`CustomEvent` 等全局对象的问题。
 
 它主要服务于：
 
-- `weapp-vite` 的请求全局注入能力
+- `weapp-vite` 的 Web Runtime 全局注入能力
 - `wevu` 运行时对 Web 风格请求库的兼容
 - `axios`、`graphql-request` 等依赖 Web API 的第三方库
 
@@ -15,6 +15,7 @@
 - 按需安装 `fetch`、`Headers`、`Request`、`Response`
 - 提供 `AbortController` / `AbortSignal` 兼容层
 - 提供 `XMLHttpRequest`、`URL`、`URLSearchParams`、`Blob`、`FormData`、`WebSocket` 兼容层
+- 提供 `atob`、`btoa`、`queueMicrotask`、`performance.now`、`crypto.getRandomValues`、`Event`、`CustomEvent` 兼容层
 - 自动把能力安装到可用的小程序宿主全局对象
 - 默认基于 `@wevu/api` 的请求能力完成底层转发
 
@@ -26,12 +27,12 @@ pnpm add @wevu/web-apis
 
 ## 4. 快速开始
 
-### 4.1 安装完整请求全局
+### 4.1 安装完整 Web Runtime
 
 ```ts
-import { installRequestGlobals } from '@wevu/web-apis'
+import { installWebRuntimeGlobals } from '@wevu/web-apis'
 
-installRequestGlobals()
+installWebRuntimeGlobals()
 
 const response = await fetch('https://request-globals.invalid/data')
 console.log(await response.json())
@@ -51,19 +52,35 @@ controller.abort()
 ### 4.3 按目标精简注入
 
 ```ts
-import { installRequestGlobals } from '@wevu/web-apis'
+import { installWebRuntimeGlobals } from '@wevu/web-apis'
 
-installRequestGlobals({
+installWebRuntimeGlobals({
   targets: ['fetch', 'Headers', 'Request', 'Response'],
 })
 ```
 
-### 4.4 安装并使用 WebSocket
+### 4.4 安装轻量通用 Web Runtime 能力
 
 ```ts
-import { installRequestGlobals } from '@wevu/web-apis'
+import { installWebRuntimeGlobals } from '@wevu/web-apis'
 
-installRequestGlobals({
+installWebRuntimeGlobals({
+  targets: ['atob', 'btoa', 'queueMicrotask', 'performance', 'crypto', 'Event', 'CustomEvent'],
+})
+
+const encoded = btoa('AB')
+const decoded = atob(encoded)
+const now = performance.now()
+const bytes = crypto.getRandomValues(new Uint8Array(4))
+const event = new CustomEvent('payload', { detail: { ok: true } })
+```
+
+### 4.5 安装并使用 WebSocket
+
+```ts
+import { installWebRuntimeGlobals } from '@wevu/web-apis'
+
+installWebRuntimeGlobals({
   targets: ['WebSocket'],
 })
 
@@ -86,7 +103,8 @@ socket.onclose = (event) => {
 
 | 导出                                                       | 说明                                            |
 | ---------------------------------------------------------- | ----------------------------------------------- |
-| `installRequestGlobals`                                    | 按需安装请求相关全局对象                        |
+| `installWebRuntimeGlobals`                                 | 按需安装 Web Runtime 全局对象                   |
+| `installRequestGlobals`                                    | 旧别名，兼容历史代码                            |
 | `installAbortGlobals`                                      | 仅安装 `AbortController` / `AbortSignal`        |
 | `fetch`                                                    | 基于小程序请求能力适配的 `fetch` 实现           |
 | `HeadersPolyfill` / `RequestPolyfill` / `ResponsePolyfill` | HTTP 相关兼容类                                 |
@@ -99,6 +117,7 @@ socket.onclose = (event) => {
 - 在小程序环境中运行 `axios` 的 `fetch` 适配器
 - 在小程序环境中运行 `graphql-request`
 - 在小程序环境中直接复用浏览器风格的 `WebSocket` 客户端代码
+- 在小程序环境中运行依赖 `atob` / `btoa` / `queueMicrotask` / `performance.now` / `crypto.getRandomValues` 的工具库
 - 给依赖 `URL` / `FormData` / `Blob` 的库补齐基础全局对象
 
 ## 7. WebSocket 兼容说明
@@ -121,3 +140,8 @@ pnpm --filter @wevu/web-apis typecheck
 
 - `@wevu/api`：[../weapi/README.md](../weapi/README.md)
 - `wevu`：[../wevu/README.md](../wevu/README.md)
+
+## 10. 兼容说明
+
+- 新项目建议使用 `installWebRuntimeGlobals()`
+- `installRequestGlobals()` 仍保留为兼容别名，后续会逐步淡出文档主叙事

package/dist/index.d.mts

@@ -7,13 +7,71 @@ import { BlobPolyfill, FormDataPolyfill } from "./web.mjs";
 import { WebSocketPolyfill } from "./websocket.mjs";
 import { XMLHttpRequestPolyfill } from "./xhr.mjs";
 
+//#region src/base64.d.ts
+declare function btoaPolyfill(input?: string): string;
+declare function atobPolyfill(input?: string): string;
+//#endregion
+//#region src/crypto.d.ts
+type IntegerTypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | BigInt64Array | BigUint64Array;
+declare function getRandomValuesPolyfill<T extends IntegerTypedArray>(typedArray: T): (T & Int8Array<ArrayBufferLike>) | (T & Uint8Array<ArrayBufferLike>) | (T & Uint8ClampedArray<ArrayBufferLike>) | (T & Int16Array<ArrayBufferLike>) | (T & Uint16Array<ArrayBufferLike>) | (T & Int32Array<ArrayBufferLike>) | (T & Uint32Array<ArrayBufferLike>) | (T & BigInt64Array<ArrayBufferLike>) | (T & BigUint64Array<ArrayBufferLike>);
+declare const cryptoPolyfill: {
+  getRandomValues: typeof getRandomValuesPolyfill;
+};
+//#endregion
+//#region src/events.d.ts
+interface EventInitPolyfill {
+  bubbles?: boolean;
+  cancelable?: boolean;
+  composed?: boolean;
+}
+interface CustomEventInitPolyfill<T = any> extends EventInitPolyfill {
+  detail?: T;
+}
+declare class EventPolyfill {
+  readonly bubbles: boolean;
+  readonly cancelable: boolean;
+  readonly composed: boolean;
+  readonly isTrusted = false;
+  readonly timeStamp: number;
+  readonly type: string;
+  currentTarget: unknown;
+  target: unknown;
+  defaultPrevented: boolean;
+  cancelBubble: boolean;
+  constructor(type: string, init?: EventInitPolyfill);
+  composedPath(): {}[];
+  preventDefault(): void;
+  stopImmediatePropagation(): void;
+  stopPropagation(): void;
+}
+declare class CustomEventPolyfill<T = any> extends EventPolyfill {
+  readonly detail: T | null;
+  constructor(type: string, init?: CustomEventInitPolyfill<T>);
+}
+//#endregion
+//#region src/performance.d.ts
+declare const performancePolyfill: {
+  __weappVitePerformancePolyfill: boolean;
+  now(): number;
+  timeOrigin: number;
+};
+//#endregion
+//#region src/task.d.ts
+declare function queueMicrotaskPolyfill(callback: () => void): void;
+//#endregion
 //#region src/index.d.ts
-type WeappInjectRequestGlobalsTarget = 'fetch' | 'Headers' | 'Request' | 'Response' | 'AbortController' | 'AbortSignal' | 'XMLHttpRequest' | 'WebSocket';
-interface InstallRequestGlobalsOptions {
-  targets?: WeappInjectRequestGlobalsTarget[];
+type WeappInjectWebRuntimeGlobalsTarget = 'fetch' | 'Headers' | 'Request' | 'Response' | 'TextEncoder' | 'TextDecoder' | 'AbortController' | 'AbortSignal' | 'XMLHttpRequest' | 'WebSocket' | 'atob' | 'btoa' | 'queueMicrotask' | 'performance' | 'crypto' | 'Event' | 'CustomEvent';
+type WeappInjectRequestGlobalsTarget = WeappInjectWebRuntimeGlobalsTarget;
+interface InstallWebRuntimeGlobalsOptions {
+  targets?: WeappInjectWebRuntimeGlobalsTarget[];
 }
+interface InstallRequestGlobalsOptions extends InstallWebRuntimeGlobalsOptions {}
+/**
+ * @description 按需向小程序全局环境注入缺失的 Web Runtime 对象。
+ */
+declare function installWebRuntimeGlobals(options?: InstallWebRuntimeGlobalsOptions): Record<string, any>;
 /**
- * @description 按需向小程序全局环境注入缺失的请求相关对象。
+ * @description 已废弃，请迁移到 `installWebRuntimeGlobals`。
  */
 declare function installRequestGlobals(options?: InstallRequestGlobalsOptions): Record<string, any>;
 /**
@@ -21,4 +79,4 @@ declare function installRequestGlobals(options?: InstallRequestGlobalsOptions):
  */
 declare function installAbortGlobals(): Record<string, any>;
 //#endregion
-export { AbortControllerPolyfill, AbortSignalPolyfill, BlobPolyfill, FormDataPolyfill, HeadersPolyfill, InstallRequestGlobalsOptions, RequestGlobalsEventTarget, RequestPolyfill, ResponsePolyfill, URLPolyfill, URLSearchParamsPolyfill, WeappInjectRequestGlobalsTarget, WebSocketPolyfill, XMLHttpRequestPolyfill, fetch, installAbortGlobals, installRequestGlobals };
+export { AbortControllerPolyfill, AbortSignalPolyfill, BlobPolyfill, CustomEventPolyfill, EventPolyfill, FormDataPolyfill, HeadersPolyfill, InstallRequestGlobalsOptions, InstallWebRuntimeGlobalsOptions, RequestGlobalsEventTarget, RequestPolyfill, ResponsePolyfill, URLPolyfill, URLSearchParamsPolyfill, WeappInjectRequestGlobalsTarget, WeappInjectWebRuntimeGlobalsTarget, WebSocketPolyfill, XMLHttpRequestPolyfill, atobPolyfill, btoaPolyfill, cryptoPolyfill, fetch, installAbortGlobals, installRequestGlobals, installWebRuntimeGlobals, performancePolyfill, queueMicrotaskPolyfill };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { RequestGlobalsEventTarget, installRequestGlobalBinding, resolveRequestGlobalsHost, resolveRequestGlobalsHosts } from "./shared.mjs";
+import { RequestGlobalsEventTarget, decodeTextFallback, encodeTextFallback, installRequestGlobalBinding, resolveRequestGlobalsHost, resolveRequestGlobalsHosts } from "./shared.mjs";
 import { AbortControllerPolyfill, AbortSignalPolyfill } from "./abort.mjs";
 import { HeadersPolyfill, RequestPolyfill, ResponsePolyfill } from "./http.mjs";
 import { fetch } from "./fetch.mjs";
@@ -7,10 +7,219 @@ import { BlobPolyfill, FormDataPolyfill } from "./web.mjs";
 import { WebSocketPolyfill } from "./websocket.mjs";
 import { XMLHttpRequestPolyfill } from "./xhr.mjs";
 import { REQUEST_GLOBAL_ACTUALS_KEY, REQUEST_GLOBAL_PLACEHOLDER_KEY } from "@weapp-core/constants";
+//#region src/base64.ts
+const BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+const BASE64_LOOKUP = new Uint8Array(256);
+const BASE64_INVALID_INPUT_RE = /[^A-Za-z\d+/=]/u;
+for (let index = 0; index < BASE64_LOOKUP.length; index++) BASE64_LOOKUP[index] = 255;
+for (let index = 0; index < 64; index++) BASE64_LOOKUP[BASE64_CHARS.charCodeAt(index)] = index;
+function toLatin1Byte(value, index) {
+	const codePoint = value.charCodeAt(index);
+	if (codePoint > 255) throw new TypeError(`Failed to execute 'btoa': character outside Latin1 range at index ${index}`);
+	return codePoint;
+}
+function btoaPolyfill(input = "") {
+	const source = String(input);
+	let output = "";
+	for (let index = 0; index < source.length; index += 3) {
+		const byte0 = toLatin1Byte(source, index);
+		const byte1 = index + 1 < source.length ? toLatin1Byte(source, index + 1) : NaN;
+		const byte2 = index + 2 < source.length ? toLatin1Byte(source, index + 2) : NaN;
+		const triplet = byte0 << 16 | (Number.isNaN(byte1) ? 0 : byte1) << 8 | (Number.isNaN(byte2) ? 0 : byte2);
+		output += BASE64_CHARS[triplet >> 18 & 63];
+		output += BASE64_CHARS[triplet >> 12 & 63];
+		output += Number.isNaN(byte1) ? "=" : BASE64_CHARS[triplet >> 6 & 63];
+		output += Number.isNaN(byte2) ? "=" : BASE64_CHARS[triplet & 63];
+	}
+	return output;
+}
+function atobPolyfill(input = "") {
+	const source = String(input).replace(/[\t\n\f\r ]+/g, "");
+	if (source.length % 4 === 1 || BASE64_INVALID_INPUT_RE.test(source)) throw new TypeError("Failed to execute 'atob': the input is not correctly encoded");
+	let output = "";
+	for (let index = 0; index < source.length; index += 4) {
+		const char0 = source.charCodeAt(index);
+		const char1 = source.charCodeAt(index + 1);
+		const char2 = source.charAt(index + 2);
+		const char3 = source.charAt(index + 3);
+		const sextet0 = BASE64_LOOKUP[char0] ?? 255;
+		const sextet1 = BASE64_LOOKUP[char1] ?? 255;
+		const sextet2 = char2 === "=" ? 64 : BASE64_LOOKUP[source.charCodeAt(index + 2)] ?? 255;
+		const sextet3 = char3 === "=" ? 64 : BASE64_LOOKUP[source.charCodeAt(index + 3)] ?? 255;
+		if (sextet0 > 63 || sextet1 > 63 || sextet2 > 64 || sextet3 > 64) throw new TypeError("Failed to execute 'atob': the input is not correctly encoded");
+		const triplet = sextet0 << 18 | sextet1 << 12 | (sextet2 & 63) << 6 | sextet3 & 63;
+		output += String.fromCharCode(triplet >> 16 & 255);
+		if (char2 !== "=") output += String.fromCharCode(triplet >> 8 & 255);
+		if (char3 !== "=") output += String.fromCharCode(triplet & 255);
+	}
+	return output;
+}
+//#endregion
+//#region src/crypto.ts
+const MAX_RANDOM_VALUES_BYTE_LENGTH = 65536;
+function isIntegerTypedArray(value) {
+	return value instanceof Int8Array || value instanceof Uint8Array || value instanceof Uint8ClampedArray || value instanceof Int16Array || value instanceof Uint16Array || value instanceof Int32Array || value instanceof Uint32Array || value instanceof BigInt64Array || value instanceof BigUint64Array;
+}
+function getNativeCrypto() {
+	const candidate = globalThis.crypto;
+	if (candidate && typeof candidate.getRandomValues === "function") return candidate;
+}
+function fillArrayWithMathRandom(target) {
+	const bytes = new Uint8Array(target.buffer, target.byteOffset, target.byteLength);
+	for (let index = 0; index < bytes.length; index++) bytes[index] = Math.floor(Math.random() * 256);
+}
+function fillArrayWithHostRandomValues(target) {
+	for (const hostKey of [
+		"wx",
+		"my",
+		"tt"
+	]) {
+		const host = globalThis[hostKey];
+		if (!host || typeof host.getRandomValues !== "function") continue;
+		try {
+			host.getRandomValues(target);
+			return true;
+		} catch {}
+	}
+	return false;
+}
+function getRandomValuesPolyfill(typedArray) {
+	if (!isIntegerTypedArray(typedArray)) throw new TypeError("Failed to execute 'getRandomValues': input must be an integer TypedArray");
+	if (typedArray.byteLength > MAX_RANDOM_VALUES_BYTE_LENGTH) throw new TypeError("Failed to execute 'getRandomValues': byteLength exceeds 65536");
+	const nativeCrypto = getNativeCrypto();
+	if (nativeCrypto && nativeCrypto.getRandomValues !== getRandomValuesPolyfill) return nativeCrypto.getRandomValues(typedArray);
+	if (!fillArrayWithHostRandomValues(typedArray)) fillArrayWithMathRandom(typedArray);
+	return typedArray;
+}
+const cryptoPolyfill = { getRandomValues: getRandomValuesPolyfill };
+//#endregion
+//#region src/events.ts
+var EventPolyfill = class {
+	bubbles;
+	cancelable;
+	composed;
+	isTrusted = false;
+	timeStamp = Date.now();
+	type;
+	currentTarget = null;
+	target = null;
+	defaultPrevented = false;
+	cancelBubble = false;
+	constructor(type, init = {}) {
+		this.type = String(type);
+		this.bubbles = init.bubbles === true;
+		this.cancelable = init.cancelable === true;
+		this.composed = init.composed === true;
+	}
+	composedPath() {
+		return this.target == null ? [] : [this.target];
+	}
+	preventDefault() {
+		if (this.cancelable) this.defaultPrevented = true;
+	}
+	stopImmediatePropagation() {
+		this.cancelBubble = true;
+	}
+	stopPropagation() {
+		this.cancelBubble = true;
+	}
+};
+var CustomEventPolyfill = class extends EventPolyfill {
+	detail;
+	constructor(type, init = {}) {
+		super(type, init);
+		this.detail = init.detail ?? null;
+	}
+};
+//#endregion
+//#region src/performance.ts
+const performanceTimeOrigin = Date.now();
+const PERFORMANCE_POLYFILL_MARKER = "__weappVitePerformancePolyfill";
+function resolveNativePerformance() {
+	const candidate = globalThis.performance;
+	if (candidate && candidate?.[PERFORMANCE_POLYFILL_MARKER] !== true && typeof candidate.now === "function") return candidate;
+	for (const hostKey of [
+		"wx",
+		"my",
+		"tt"
+	]) {
+		const host = globalThis[hostKey];
+		if (!host || typeof host.getPerformance !== "function") continue;
+		try {
+			const performance = host.getPerformance();
+			if (performance && typeof performance.now === "function") return performance;
+		} catch {}
+	}
+}
+const performancePolyfill = {
+	[PERFORMANCE_POLYFILL_MARKER]: true,
+	now() {
+		const nativePerformance = resolveNativePerformance();
+		if (nativePerformance && nativePerformance !== performancePolyfill) try {
+			return Number(nativePerformance.now());
+		} catch {}
+		return Date.now() - performanceTimeOrigin;
+	},
+	timeOrigin: performanceTimeOrigin
+};
+//#endregion
+//#region src/task.ts
+function queueMicrotaskPolyfill(callback) {
+	if (typeof callback !== "function") throw new TypeError("Failed to execute 'queueMicrotask': callback must be a function");
+	const nativeQueueMicrotask = globalThis.queueMicrotask;
+	if (typeof nativeQueueMicrotask === "function" && nativeQueueMicrotask !== queueMicrotaskPolyfill) {
+		nativeQueueMicrotask(callback);
+		return;
+	}
+	Promise.resolve().then(callback).catch((error) => {
+		setTimeout(() => {
+			throw error;
+		}, 0);
+	});
+}
+//#endregion
+//#region src/textCodec.ts
+function normalizeTextDecoderInput(input) {
+	if (input == null) return /* @__PURE__ */ new ArrayBuffer(0);
+	if (input instanceof ArrayBuffer) return input.slice(0);
+	if (ArrayBuffer.isView(input)) {
+		const copied = new Uint8Array(input.byteLength);
+		copied.set(new Uint8Array(input.buffer, input.byteOffset, input.byteLength));
+		return copied.buffer;
+	}
+	return /* @__PURE__ */ new ArrayBuffer(0);
+}
+var TextEncoderPolyfill = class {
+	encoding = "utf-8";
+	encode(input = "") {
+		return new Uint8Array(encodeTextFallback(String(input)));
+	}
+};
+var TextDecoderPolyfill = class {
+	encoding = "utf-8";
+	fatal = false;
+	ignoreBOM = false;
+	decode(input) {
+		return decodeTextFallback(normalizeTextDecoderInput(input));
+	}
+};
+//#endregion
 //#region src/index.ts
+function hasRequestRuntimeBinaryUsage(targets) {
+	return targets.some((target) => target === "fetch" || target === "Request" || target === "Response" || target === "XMLHttpRequest" || target === "WebSocket");
+}
+function resolveInstallTargets(targets) {
+	const installTargets = [...targets];
+	if (hasRequestRuntimeBinaryUsage(targets)) installTargets.push("TextEncoder", "TextDecoder");
+	if (targets.includes("CustomEvent")) installTargets.push("Event");
+	return [...new Set(installTargets)];
+}
 function resolveActualBindingTargets(targets) {
 	const bindingTargets = [...targets];
-	if (targets.some((target) => target === "fetch" || target === "Request" || target === "Response" || target === "XMLHttpRequest")) bindingTargets.push("URL", "URLSearchParams", "Blob", "FormData");
+	if (hasRequestRuntimeBinaryUsage(targets)) {
+		bindingTargets.push("TextEncoder", "TextDecoder");
+		bindingTargets.push("URL", "URLSearchParams", "Blob", "FormData");
+	}
 	return [...new Set(bindingTargets)];
 }
 function isPlaceholderRequestGlobal(value) {
@@ -50,6 +259,14 @@ function installSingleTarget(host, target) {
 		if (typeof host.Response !== "function" || isPlaceholderRequestGlobal(host.Response)) assignHostGlobal(host, "Response", ResponsePolyfill);
 		return;
 	}
+	if (target === "TextEncoder") {
+		if (typeof host.TextEncoder !== "function" || isPlaceholderRequestGlobal(host.TextEncoder)) assignHostGlobal(host, "TextEncoder", TextEncoderPolyfill);
+		return;
+	}
+	if (target === "TextDecoder") {
+		if (typeof host.TextDecoder !== "function" || isPlaceholderRequestGlobal(host.TextDecoder)) assignHostGlobal(host, "TextDecoder", TextDecoderPolyfill);
+		return;
+	}
 	if (target === "AbortController") {
 		if (typeof host.AbortController !== "function" || isPlaceholderRequestGlobal(host.AbortController)) assignHostGlobal(host, "AbortController", AbortControllerPolyfill);
 		return;
@@ -62,6 +279,34 @@ function installSingleTarget(host, target) {
 		if (typeof host.WebSocket !== "function" || isPlaceholderRequestGlobal(host.WebSocket)) assignHostGlobal(host, "WebSocket", WebSocketPolyfill);
 		return;
 	}
+	if (target === "atob") {
+		if (typeof host.atob !== "function" || isPlaceholderRequestGlobal(host.atob)) assignHostGlobal(host, "atob", atobPolyfill);
+		return;
+	}
+	if (target === "btoa") {
+		if (typeof host.btoa !== "function" || isPlaceholderRequestGlobal(host.btoa)) assignHostGlobal(host, "btoa", btoaPolyfill);
+		return;
+	}
+	if (target === "queueMicrotask") {
+		if (typeof host.queueMicrotask !== "function" || isPlaceholderRequestGlobal(host.queueMicrotask)) assignHostGlobal(host, "queueMicrotask", queueMicrotaskPolyfill);
+		return;
+	}
+	if (target === "performance") {
+		if (!host.performance || typeof host.performance.now !== "function") assignHostGlobal(host, "performance", performancePolyfill);
+		return;
+	}
+	if (target === "crypto") {
+		if (!host.crypto || typeof host.crypto.getRandomValues !== "function") assignHostGlobal(host, "crypto", cryptoPolyfill);
+		return;
+	}
+	if (target === "Event") {
+		if (typeof host.Event !== "function" || isPlaceholderRequestGlobal(host.Event)) assignHostGlobal(host, "Event", EventPolyfill);
+		return;
+	}
+	if (target === "CustomEvent") {
+		if (typeof host.CustomEvent !== "function" || isPlaceholderRequestGlobal(host.CustomEvent)) assignHostGlobal(host, "CustomEvent", CustomEventPolyfill);
+		return;
+	}
 	if (target === "XMLHttpRequest" && (typeof host.XMLHttpRequest !== "function" || isPlaceholderRequestGlobal(host.XMLHttpRequest))) assignHostGlobal(host, "XMLHttpRequest", XMLHttpRequestPolyfill);
 }
 function installUrlGlobals(host) {
@@ -100,22 +345,31 @@ function syncWeappViteRequestGlobalsActuals(host, targets) {
 	}
 }
 /**
-* @description 按需向小程序全局环境注入缺失的请求相关对象。
+* @description 按需向小程序全局环境注入缺失的 Web Runtime 对象。
 */
-function installRequestGlobals(options = {}) {
-	const targets = options.targets ?? [
+function installWebRuntimeGlobals(options = {}) {
+	const targets = resolveInstallTargets(options.targets ?? [
 		"fetch",
 		"Headers",
 		"Request",
 		"Response",
+		"TextEncoder",
+		"TextDecoder",
 		"AbortController",
 		"AbortSignal",
 		"XMLHttpRequest",
-		"WebSocket"
-	];
+		"WebSocket",
+		"atob",
+		"btoa",
+		"queueMicrotask",
+		"performance",
+		"crypto",
+		"Event",
+		"CustomEvent"
+	]);
 	const hosts = resolveRequestGlobalsHosts();
 	const primaryHost = resolveRequestGlobalsHost();
-	const needsUrlGlobals = targets.some((target) => target === "fetch" || target === "Request" || target === "Response" || target === "XMLHttpRequest");
+	const needsUrlGlobals = hasRequestRuntimeBinaryUsage(targets);
 	ensureRuntimeHostAliases(primaryHost);
 	for (const host of hosts) {
 		if (needsUrlGlobals) installUrlGlobals(host);
@@ -132,10 +386,16 @@ function installRequestGlobals(options = {}) {
 	return hosts[0];
 }
 /**
+* @description 已废弃，请迁移到 `installWebRuntimeGlobals`。
+*/
+function installRequestGlobals(options = {}) {
+	return installWebRuntimeGlobals(options);
+}
+/**
 * @description 仅安装 AbortController 与 AbortSignal 兼容层。
 */
 function installAbortGlobals() {
-	return installRequestGlobals({ targets: ["AbortController", "AbortSignal"] });
+	return installWebRuntimeGlobals({ targets: ["AbortController", "AbortSignal"] });
 }
 //#endregion
-export { AbortControllerPolyfill, AbortSignalPolyfill, BlobPolyfill, FormDataPolyfill, HeadersPolyfill, RequestGlobalsEventTarget, RequestPolyfill, ResponsePolyfill, URLPolyfill, URLSearchParamsPolyfill, WebSocketPolyfill, XMLHttpRequestPolyfill, fetch, installAbortGlobals, installRequestGlobals };
+export { AbortControllerPolyfill, AbortSignalPolyfill, BlobPolyfill, CustomEventPolyfill, EventPolyfill, FormDataPolyfill, HeadersPolyfill, RequestGlobalsEventTarget, RequestPolyfill, ResponsePolyfill, URLPolyfill, URLSearchParamsPolyfill, WebSocketPolyfill, XMLHttpRequestPolyfill, atobPolyfill, btoaPolyfill, cryptoPolyfill, fetch, installAbortGlobals, installRequestGlobals, installWebRuntimeGlobals, performancePolyfill, queueMicrotaskPolyfill };

package/dist/shared.d.mts

@@ -21,8 +21,10 @@ declare function resolveRequestGlobalsHosts(): Record<string, any>[];
 declare function installRequestGlobalBinding(name: string, value: unknown): void;
 declare function cloneArrayBuffer(buffer: ArrayBuffer): ArrayBuffer;
 declare function cloneArrayBufferView(view: ArrayBufferView): ArrayBuffer;
+declare function encodeTextFallback(value: string): ArrayBuffer;
 declare function encodeText(value: string): ArrayBuffer;
+declare function decodeTextFallback(value: ArrayBuffer): string;
 declare function decodeText(value: ArrayBuffer): string;
 declare function normalizeHeaderName(name: string): string;
 //#endregion
-export { RequestGlobalsEventLike, RequestGlobalsEventTarget, RequestGlobalsEventTargetLike, cloneArrayBuffer, cloneArrayBufferView, decodeText, encodeText, installRequestGlobalBinding, normalizeHeaderName, resolveRequestGlobalsHost, resolveRequestGlobalsHosts };
+export { RequestGlobalsEventLike, RequestGlobalsEventTarget, RequestGlobalsEventTargetLike, cloneArrayBuffer, cloneArrayBufferView, decodeText, decodeTextFallback, encodeText, encodeTextFallback, installRequestGlobalBinding, normalizeHeaderName, resolveRequestGlobalsHost, resolveRequestGlobalsHosts };

package/dist/shared.mjs

@@ -64,20 +64,32 @@ function cloneArrayBufferView(view) {
 	copied.set(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
 	return copied.buffer;
 }
+function encodeTextFallback(value) {
+	const binary = unescape(encodeURIComponent(String(value)));
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes.buffer;
+}
 function encodeText(value) {
 	if (typeof TextEncoder === "function") return new TextEncoder().encode(value).buffer;
-	const bytes = new Uint8Array(value.length);
-	for (let i = 0; i < value.length; i++) bytes[i] = value.charCodeAt(i) & 255;
-	return bytes.buffer;
+	return encodeTextFallback(value);
+}
+function decodeTextFallback(value) {
+	const bytes = new Uint8Array(value);
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	try {
+		return decodeURIComponent(escape(binary));
+	} catch {
+		return binary;
+	}
 }
 function decodeText(value) {
 	if (typeof TextDecoder === "function") return new TextDecoder().decode(value);
-	let text = "";
-	for (const byte of new Uint8Array(value)) text += String.fromCharCode(byte);
-	return text;
+	return decodeTextFallback(value);
 }
 function normalizeHeaderName(name) {
 	return name.trim().toLowerCase();
 }
 //#endregion
-export { RequestGlobalsEventTarget, cloneArrayBuffer, cloneArrayBufferView, decodeText, encodeText, installRequestGlobalBinding, normalizeHeaderName, resolveRequestGlobalsHost, resolveRequestGlobalsHosts };
+export { RequestGlobalsEventTarget, cloneArrayBuffer, cloneArrayBufferView, decodeText, decodeTextFallback, encodeText, encodeTextFallback, installRequestGlobalBinding, normalizeHeaderName, resolveRequestGlobalsHost, resolveRequestGlobalsHosts };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wevu/web-apis",
   "type": "module",
-  "version": "1.2.3",
+  "version": "1.2.6",
   "description": "Web API polyfills and global installers for mini-program runtimes",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -70,7 +70,7 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "dependencies": {
-    "@weapp-core/constants": "0.1.0",
+    "@weapp-core/constants": "^0.1.1",
     "@wevu/api": "0.2.3"
   },
   "publishConfig": {