mphttpx 2.4.0 → 2.6.0

package/README.md

@@ -1,6 +1,6 @@
 # MPHTTPX
 
-小程序中浏览器网络 API 的完整 polyfill 实现，一次安装即可使用 `fetch`、`XMLHttpRequest`、`WebSocket` 等标准接口，让小程序开发不再「小」。
+小程序中浏览器网络 API 的完整 polyfill 实现，一次安装即可使用 `fetch`、`XMLHttpRequest`、`WebSocket` 等符合 W3C 标准的应用程序编程接口。
 
 ---
 
@@ -33,11 +33,11 @@ fetch("https://api.example.com/data")
 | `XMLHttpRequest`                             | miniprogram-xmlhttprequest-shim |
 | `WebSocket`                                  | miniprogram-websocket           |
 
-每个 API 都有对应的 `P` 后缀版本（如 `fetchP`、`BlobP`、`TextEncoderP`），始终返回 polyfill 实现，不会回退至浏览器原生 API。
+每个 API 都有对应的 `P` 后缀版本（如 `fetchP`、`BlobP`、`TextEncoderP`），始终返回 polyfill 实现，请按需使用。
 
 ```javascript
-import { fetch, Blob } from "mphttpx";      // 优先返回全局对象，不存在时返回 polyfill
-import { fetchP, BlobP } from "mphttpx";    // 始终返回 polyfill 实现
+import { fetch, Blob } from "mphttpx";   // 优先返回全局对象，不存在时返回 polyfill
+import { fetchP, BlobP } from "mphttpx"; // 始终返回 polyfill 实现
 ```
 
 ## 依赖库
@@ -48,7 +48,7 @@ import { fetchP, BlobP } from "mphttpx";    // 始终返回 polyfill 实现
 | [miniprogram-xmlhttprequest-shim](https://www.npmjs.com/package/miniprogram-xmlhttprequest-shim) | XMLHttpRequest、<br>Cookie、enableCookie                                                                                                                                                          |
 | [miniprogram-websocket](https://www.npmjs.com/package/miniprogram-websocket)                     | WebSocket                                                                                                                                                                                         |
 
-各 API 的详细文档和兼容性说明及更多功能请参阅对应库的 README。
+各 API 的详细文档及兼容性说明请参阅对应库的自述文档。
 
 ## 兼容性
 
@@ -56,34 +56,11 @@ import { fetchP, BlobP } from "mphttpx";    // 始终返回 polyfill 实现
 | :---: | :----: | :---: | :---: | :---: | :---: | :---: | :----: |
 |   ✅   |   ✅    |   ✅   |   ✅   |   ✅   |   ✅   |   ✅   |   ✅    |
 
-在 Chrome、Firefox、Edge、Safari 等浏览器中，所有导出均直接使用浏览器原生实现，无额外开销。
-
-## 自动导入
-
-配合 [unplugin-auto-import](https://www.npmjs.com/package/unplugin-auto-import) 使用：
-
-```javascript
-AutoImport({
-    imports: [{
-        "mphttpx": [
-            "fetch", "Headers", "Request", "Response",
-            "Blob", "File", "FileReader",
-            "URLSearchParams", "FormData",
-            "AbortController", "AbortSignal",
-            "EventTarget", "Event", "CustomEvent",
-            "TextEncoder", "TextDecoder",
-
-            "XMLHttpRequest",   // mini-programs
-            "WebSocket",        // mini-programs
-        ],
-    }],
-});
-```
+在 Chrome、Firefox、Edge、Safari 等浏览器中，所有导出均直接使用浏览器原生实现，无性能损耗。
 
 ## 注意事项
 
-- **UniApp (HBuilderX Vue2)**：可能需要安装较低版本的 `unplugin-auto-import`（如 `0.16.7`）以兼容 CMD 模块格式。
-- **支付宝小程序**：`globalThis`、`window`、`XMLHttpRequest` 等为保留字，导入时建议重命名：`import { XMLHttpRequest as myXHR } from "mphttpx";`。
+- **支付宝小程序**：`fetch`、`XMLHttpRequest`、`WebSocket` 等为保留字，导入时建议重命名：`import { fetch as fetchPolyfill } from "mphttpx";`。
 
 ## 开源协议
 

package/dist/mphttpx.cjs.js

@@ -174,6 +174,14 @@ function setState(target, name, value) {
     value: value
   });
 }
+// Safe wrapper around String() for type-like representations (e.g. "[object Blob]").   Axios
+function typeString(value) {
+  try {
+    return String(value);
+  } catch (e) {
+    return "[object Unknown]";
+  }
+}
 function isObjectType(name, value) {
   return Object.prototype.toString.call(value) === "[object ".concat(name, "]");
 }
@@ -572,7 +580,7 @@ function concatString(val) {
 }
 // Mini Program
 function isOtherArrayBuffer(value) {
-  return (isObjectType("ArrayBuffer", value) || String(value) === "[object ArrayBuffer]") && !!value && _typeof(value) === "object" && "byteLength" in value && typeof value.byteLength === "number";
+  return !!value && _typeof(value) === "object" && "byteLength" in value && typeof value.byteLength === "number" && (isObjectType("ArrayBuffer", value) || typeString(value) === "[object ArrayBuffer]");
 }
 function isArrayBuffer(value) {
   return !!value && _typeof(value) === "object" && ArrayBuffer.prototype.isPrototypeOf(value) || isOtherArrayBuffer(value);
@@ -923,7 +931,7 @@ function isEvent(value) {
   var predicate = function predicate(str) {
     return "[object " === str.slice(0, 8) && str.slice(-6) === "Event]";
   };
-  return !!value && _typeof(value) === "object" && (predicate(Object.prototype.toString.call(value)) || predicate(String(value))) && "type" in value && typeof value.type === "string";
+  return !!value && _typeof(value) === "object" && "type" in value && typeof value.type === "string" && (predicate(Object.prototype.toString.call(value)) || predicate(typeString(value)));
 }
 function whenAbort(target, executor, signal) {
   var _onAbort = function onAbort() {
@@ -1475,7 +1483,7 @@ function isExternalBlob(value) {
   var strict = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
   var expects = ["[object Blob]"];
   if (!strict) expects.push("[object File]");
-  return (expects.indexOf(Object.prototype.toString.call(value)) > -1 || expects.indexOf(String(value)) > -1) && !!value && _typeof(value) === "object" && "size" in value && typeof value.size === "number" && "arrayBuffer" in value && typeof value.arrayBuffer === "function";
+  return !!value && _typeof(value) === "object" && "size" in value && typeof value.size === "number" && "arrayBuffer" in value && typeof value.arrayBuffer === "function" && (expects.indexOf(Object.prototype.toString.call(value)) > -1 || expects.indexOf(typeString(value)) > -1);
 }
 var BlobE = function () {
   try {
@@ -2231,10 +2239,10 @@ function decode(str) {
   });
 }
 function isURLSearchParams(value) {
-  return isPolyfillType("URLSearchParams", value) || isGlobalURLSearchParams(value);
+  return isPolyfillType("URLSearchParams", value) || isExternalURLSearchParams(value);
 }
-function isGlobalURLSearchParams(value) {
-  return isObjectType("URLSearchParams", value) || !!value && _typeof(value) === "object" && typeof URLSearchParams !== "undefined" && URLSearchParams && URLSearchParams.prototype.isPrototypeOf(value);
+function isExternalURLSearchParams(value) {
+  return isObjectType("URLSearchParams", value) || !!value && _typeof(value) === "object" && typeof URLSearchParams === "function" && value instanceof URLSearchParams;
 }
 var URLSearchParamsE = typeof URLSearchParams !== "undefined" && URLSearchParams || URLSearchParamsP;
 
@@ -2485,7 +2493,7 @@ function isFormData(value) {
 }
 function isExternalFormData(value) {
   var expect = "[object FormData]";
-  return (Object.prototype.toString.call(value) === expect || String(value) === expect) && !!value && _typeof(value) === "object" && "forEach" in value && typeof value.forEach === "function";
+  return !!value && _typeof(value) === "object" && "forEach" in value && typeof value.forEach === "function" && (Object.prototype.toString.call(value) === expect || typeString(value) === expect);
 }
 function FormData_toBlob(formData, externalBoundary) {
   var boundary = externalBoundary || "----formdata-mphttpx-" + Math.random();
@@ -2762,7 +2770,7 @@ function state$8(target) {
 }
 function initBody(instance, body) {
   var b = instance;
-  if (isGlobalReadableStream(body) || isOtherReadableStream(body)) {
+  if (isReadableStream(body)) {
     throw new TypeError("Failed to construct '".concat(className(b), "': ReadableStream not implemented."));
   }
   if (body !== null && body !== undefined) {
@@ -2803,11 +2811,12 @@ function consumed(body, kind) {
   }
   return Promise.reject(new TypeError("Failed to execute '".concat(kind, "' on '").concat(className(body), "': body stream already read")));
 }
-function isGlobalReadableStream(value) {
-  return !!value && _typeof(value) === "object" && typeof ReadableStream !== "undefined" && ReadableStream && ReadableStream.prototype.isPrototypeOf(value);
+function isReadableStream(value) {
+  return isExternalReadableStream(value);
 }
-function isOtherReadableStream(value) {
-  return (isObjectType("ReadableStream", value) || String(value) === "[object ReadableStream]") && !!value && _typeof(value) === "object" && "getReader" in value && typeof value.getReader === "function";
+function isExternalReadableStream(value) {
+  var expect = "[object ReadableStream]";
+  return !!value && _typeof(value) === "object" && "getReader" in value && typeof value.getReader === "function" && (Object.prototype.toString.call(value) === expect || typeString(value) === expect);
 }
 
 var HeadersP = /*#__PURE__*/function (_Symbol$iterator, _Symbol$toStringTag) {
@@ -2985,7 +2994,7 @@ function isHeaders(value) {
 }
 function isExternalHeaders(value) {
   var expect = "[object Headers]";
-  return (Object.prototype.toString.call(value) === expect || String(value) === expect) && !!value && _typeof(value) === "object" && "forEach" in value && typeof value.forEach === "function";
+  return !!value && _typeof(value) === "object" && "forEach" in value && typeof value.forEach === "function" && (Object.prototype.toString.call(value) === expect || typeString(value) === expect);
 }
 function normalizeName(name, throwError) {
   if (typeof name !== "string") {
@@ -3224,7 +3233,7 @@ function isRequest(value) {
 }
 function isExternalRequest(value) {
   var expect = "[object Request]";
-  return (Object.prototype.toString.call(value) === expect || String(value) === expect) && !!value && _typeof(value) === "object" && "arrayBuffer" in value && typeof value.arrayBuffer === "function";
+  return !!value && _typeof(value) === "object" && "arrayBuffer" in value && typeof value.arrayBuffer === "function" && (Object.prototype.toString.call(value) === expect || typeString(value) === expect);
 }
 function createPhonyPayload(request) {
   var payload = Object.create(Payload.prototype);
@@ -6308,7 +6317,7 @@ var WebSocketP = /*#__PURE__*/function (_EventTargetP, _Symbol$toStringTag) {
       onError(_this);
       onMessage(_this);
     } else {
-      throw new Error("connectSocket can't establish a connection to the server at ".concat("" + url, "."));
+      throw new Error("connectSocket can't establish a connection to the server at ".concat(targetURL, "."));
     }
     return _this;
   }