network-speed-js 1.0.5 → 1.0.6

package/README.md

@@ -1,7 +1,7 @@
-# Network Speed SDK
-
 <div align="center">
 
+# Network Speed SDK
+
 一个基于 **Performance API** 的现代化网速测试 SDK，支持内外网自动检测、资源监听和完整的 TS 类型支持。
 
 **框架无关 · 开箱即用 · 准确可靠**
@@ -13,8 +13,12 @@
 
 ---
 
+<div align="center">
+
 ## 🎯 核心亮点
 
+</div>
+
 ### 从 Axios 到 Performance API 的技术升级
 
 本项目从 **v0.x（Axios 拦截器方案）** 完全重构为 **v1.0（Performance API 方案）**，实现了测速准确度和功能的质的飞跃。
@@ -33,8 +37,12 @@
 
 ---
 
+<div align="center">
+
 ## ✨ 特性
 
+</div>
+
 - 🚀 **基于 Performance API** - 使用浏览器原生 API，准确测量真实下载速度
 - 🔄 **内外网自动检测** - 智能切换内网/外网测速资源
 - 📊 **完整的性能数据** - 提供速度、耗时、传输大小等详细信息
@@ -43,14 +51,22 @@
 - 🌐 **框架无关** - 可用于 Vue、React、Angular 或原生 JavaScript 项目
 - 📦 **轻量级** - 零依赖，体积小巧
 
+<div align="center">
+
 ## 📦 安装
 
+</div>
+
 ```bash
 npm install network-speed-js
 ```
 
+<div align="center">
+
 ## 🚀 快速开始
 
+</div>
+
 ### 原生 JavaScript / TypeScript
 
 **方式一：使用图片资源测速（推荐，默认模式，无需CORS）**
@@ -173,8 +189,12 @@ export class SpeedTestComponent {
 }
 ```
 
+<div align="center">
+
 ## 📖 API 文档
 
+</div>
+
 ### NetworkSpeedSDK
 
 #### 构造函数
@@ -331,8 +351,12 @@ interface ResourceSpeedInfo {
 }
 ```
 
+<div align="center">
+
 ## 💡 使用示例
 
+</div>
+
 ### 1. 使用图片资源测速（默认，推荐）
 
 ```typescript
@@ -479,8 +503,12 @@ const monitor = new NetworkMonitor();
 setInterval(() => monitor.monitor(), 60000); // 每分钟检测
 ```
 
+<div align="center">
+
 ## 🎨 框架集成
 
+</div>
+
 ### Vue 3 自定义 Hook
 
 ```typescript
@@ -556,8 +584,12 @@ export function useNetworkSpeed(options = {}) {
 }
 ```
 
+<div align="center">
+
 ## ⚙️ 配置指南
 
+</div>
+
 ### 测速资源准备
 
 #### 服务端配置（Nginx）
@@ -641,8 +673,12 @@ dd if=/dev/urandom of=speed-test.bin bs=1024 count=500
 }
 ```
 
+<div align="center">
+
 ## 🔍 核心概念
 
+</div>
+
 ### Performance API 是什么？
 
 Performance API 是浏览器提供的原生性能监控接口，可以精确测量资源加载的各个阶段耗时。
@@ -664,8 +700,12 @@ Performance API 是浏览器提供的原生性能监控接口，可以精确测
 2. 如果内网资源超时或失败，自动切换到外网资源
 3. 根据成功的资源判断当前网络环境
 
+<div align="center">
+
 ## 📊 Performance API vs 其他方案
 
+</div>
+
 | 方案 | 准确度 | 可控性 | 复杂度 | 推荐 |
 |------|--------|--------|--------|------|
 | Performance API | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ | ✅ 主力 |
@@ -704,8 +744,12 @@ const size = entry.transferSize; // 真实传输字节数
 - ✅ 可识别缓存命中
 - ✅ 提供完整的加载时序
 
+<div align="center">
+
 ## ❓ 常见问题
 
+</div>
+
 ### Q1: 测速结果不准确？
 
 **可能原因：**
@@ -780,8 +824,12 @@ if (connection) {
 }
 ```
 
+<div align="center">
+
 ## 🚀 性能优化
 
+</div>
+
 ### 1. 避免频繁测速
 
 ```typescript
@@ -845,8 +893,12 @@ async function testSpeed() {
 }
 ```
 
+<div align="center">
+
 ## ⚠️ 注意事项
 
+</div>
+
 ### Performance API 能做什么
 
 ✅ 基于真实资源加载评估下载速度  
@@ -861,8 +913,12 @@ async function testSpeed() {
 ❌ 测量 RTT 抖动  
 ❌ 脱离真实请求独立测速  
 
+<div align="center">
+
 ## 🤝 贡献
 
+</div>
+
 欢迎提交 Issue 和 Pull Request！
 
 ### 本地开发
@@ -901,12 +957,20 @@ network-speed-js/
 └── README.md              # 项目文档
 ```
 
+<div align="center">
+
 ## 📄 License
 
+</div>
+
 MIT License
 
+<div align="center">
+
 ## 🔗 相关链接
 
+</div>
+
 - [更新日志 (CHANGELOG)](./CHANGELOG.md)
 - [Performance API 文档](https://developer.mozilla.org/en-US/docs/Web/API/Performance_API)
 - [PerformanceResourceTiming](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming)

package/dist/core/speed-tester.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"speed-tester.d.ts","sourceRoot":"","sources":["../../src/core/speed-tester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAoC;gBAExC,OAAO,EAAE,gBAAgB;IAyBrC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAQtC;;OAEG;YACW,kBAAkB;IAehC;;OAEG;IACH,OAAO,CAAC,aAAa;IA0DrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAkBnF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"speed-tester.d.ts","sourceRoot":"","sources":["../../src/core/speed-tester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAoC;gBAExC,OAAO,EAAE,gBAAgB;IAgDrC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAQtC;;OAEG;YACW,kBAAkB;IAehC;;OAEG;IACH,OAAO,CAAC,aAAa;IA0DrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAkBnF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/network-speed-js.js

@@ -2,16 +2,16 @@ function h(t) {
   const e = t.responseEnd - t.responseStart;
   if (e <= 0 || t.transferSize === 0)
     return null;
-  const s = t.transferSize * 8 / e / 1e3, n = t.transferSize / e;
+  const r = t.transferSize * 8 / e / 1e3, n = t.transferSize / e;
   return {
     name: t.name,
-    speedMbps: Number(s.toFixed(2)),
+    speedMbps: Number(r.toFixed(2)),
     speedKBps: Number(n.toFixed(2)),
     downloadTime: Number(e.toFixed(2)),
     transferSize: t.transferSize
   };
 }
-function f() {
+function d() {
   return performance.getEntriesByType("resource").filter(
     (e) => e instanceof PerformanceResourceTiming && e.transferSize > 0
   ).map(h).filter((e) => e !== null);
@@ -24,25 +24,40 @@ function p(t) {
 function w(t, e = { fast: 10, medium: 2 }) {
   return t >= e.fast ? "fast" : t >= e.medium ? "medium" : t > 0 ? "slow" : "unknown";
 }
-class a {
+class l {
   options;
   observer = null;
   constructor(e) {
-    "useFetch" in e && e.useFetch ? this.options = {
-      intranetUrl: e.intranetUrl || "",
-      internetUrl: e.internetUrl,
-      timeout: e.timeout || 1e4,
-      autoDetect: e.autoDetect ?? !0,
-      thresholds: e.thresholds || { fast: 10, medium: 2 },
-      useFetch: !0
-    } : this.options = {
-      intranetUrl: "intranetImageUrl" in e && e.intranetImageUrl || "",
-      internetUrl: "internetImageUrl" in e ? e.internetImageUrl : "",
-      timeout: e.timeout || 1e4,
-      autoDetect: e.autoDetect ?? !0,
-      thresholds: e.thresholds || { fast: 10, medium: 2 },
-      useFetch: !1
-    };
+    if ("useFetch" in e && e.useFetch) {
+      if (!e.internetUrl)
+        throw new Error("Fetch模式必须提供 internetUrl 参数");
+      if (!e.internetUrl.startsWith("http://") && !e.internetUrl.startsWith("https://"))
+        throw new Error("internetUrl 必须是完整的HTTP/HTTPS URL");
+      this.options = {
+        intranetUrl: e.intranetUrl || "",
+        internetUrl: e.internetUrl,
+        timeout: e.timeout || 1e4,
+        autoDetect: e.autoDetect ?? !0,
+        thresholds: e.thresholds || { fast: 10, medium: 2 },
+        useFetch: !0
+      };
+    } else {
+      const r = "internetImageUrl" in e ? e.internetImageUrl : "";
+      if (!r)
+        throw new Error("图片模式必须提供 internetImageUrl 参数");
+      if (!r.startsWith("http://") && !r.startsWith("https://"))
+        throw new Error("internetImageUrl 必须是完整的HTTP/HTTPS URL");
+      this.options = {
+        intranetUrl: "intranetImageUrl" in e && e.intranetImageUrl || "",
+        internetUrl: r,
+        timeout: e.timeout || 1e4,
+        autoDetect: e.autoDetect ?? !0,
+        thresholds: e.thresholds || { fast: 10, medium: 2 },
+        useFetch: !1
+      };
+    }
+    if (this.options.intranetUrl && !this.options.intranetUrl.startsWith("http://") && !this.options.intranetUrl.startsWith("https://"))
+      throw new Error("intranetUrl/intranetImageUrl 必须是完整的HTTP/HTTPS URL");
   }
   /**
    * 执行测速
@@ -65,74 +80,74 @@ class a {
   /**
    * 测试单个URL
    */
-  testSingleUrl(e, s) {
-    return new Promise((n, o) => {
-      const r = `${e}?t=${Date.now()}`;
-      p(r);
-      const c = new PerformanceObserver((m) => {
-        for (const u of m.getEntries())
-          if (u.entryType === "resource" && u.name.includes(e)) {
-            const i = h(u);
-            if (i) {
-              const d = {
-                speedMbps: i.speedMbps,
-                speedKBps: i.speedKBps,
+  testSingleUrl(e, r) {
+    return new Promise((n, i) => {
+      const s = `${e}?t=${Date.now()}`;
+      p(s);
+      const c = new PerformanceObserver((f) => {
+        for (const a of f.getEntries())
+          if (a.entryType === "resource" && a.name.includes(e)) {
+            const o = h(a);
+            if (o) {
+              const m = {
+                speedMbps: o.speedMbps,
+                speedKBps: o.speedKBps,
                 networkType: w(
-                  i.speedMbps,
+                  o.speedMbps,
                   this.options.thresholds
                 ),
-                isIntranet: s,
-                duration: i.downloadTime,
-                transferSize: i.transferSize,
+                isIntranet: r,
+                duration: o.downloadTime,
+                transferSize: o.transferSize,
                 resourceUrl: e
               };
-              c.disconnect(), n(d);
+              c.disconnect(), n(m);
             }
           }
       });
       c.observe({ entryTypes: ["resource"] });
-      const l = setTimeout(() => {
-        c.disconnect(), o(new Error(`测速超时: ${e}`));
+      const u = setTimeout(() => {
+        c.disconnect(), i(new Error(`测速超时: ${e}`));
       }, this.options.timeout);
-      this.options.useFetch ? this.loadWithFetch(r, l, c, o) : this.loadWithImage(r, l, c, o);
+      this.options.useFetch ? this.loadWithFetch(s, u, c, i) : this.loadWithImage(s, u, c, i);
     });
   }
   /**
    * 使用 Image 对象加载资源（默认方式，不受跨域限制）
    */
-  loadWithImage(e, s, n, o) {
-    const r = new Image();
-    r.onload = () => {
-      clearTimeout(s);
-    }, r.onerror = () => {
-      clearTimeout(s), n.disconnect(), o(new Error(`图片加载失败: ${e}`));
-    }, r.src = e;
+  loadWithImage(e, r, n, i) {
+    const s = new Image();
+    s.onload = () => {
+      clearTimeout(r);
+    }, s.onerror = () => {
+      clearTimeout(r), n.disconnect(), i(new Error(`图片加载失败: ${e}`));
+    }, s.src = e;
   }
   /**
    * 使用 fetch API 加载资源（需要 CORS 支持）
    */
-  loadWithFetch(e, s, n, o) {
+  loadWithFetch(e, r, n, i) {
     fetch(e, {
       method: "GET",
       cache: "no-store"
       // 禁用缓存
-    }).then((r) => {
-      if (!r.ok)
-        throw new Error(`HTTP error! status: ${r.status}`);
-      return r.blob();
+    }).then((s) => {
+      if (!s.ok)
+        throw new Error(`HTTP error! status: ${s.status}`);
+      return s.blob();
     }).then(() => {
-      clearTimeout(s);
-    }).catch((r) => {
-      clearTimeout(s), n.disconnect(), o(new Error(`资源加载失败: ${r.message}`));
+      clearTimeout(r);
+    }).catch((s) => {
+      clearTimeout(r), n.disconnect(), i(new Error(`资源加载失败: ${s.message}`));
     });
   }
   /**
    * 监听特定资源的性能数据
    */
-  observeResource(e, s) {
-    const n = new PerformanceObserver((o) => {
-      for (const r of o.getEntries())
-        r.entryType === "resource" && r.name.includes(e) && s(r);
+  observeResource(e, r) {
+    const n = new PerformanceObserver((i) => {
+      for (const s of i.getEntries())
+        s.entryType === "resource" && s.name.includes(e) && r(s);
     });
     return n.observe({ entryTypes: ["resource"] }), () => n.disconnect();
   }
@@ -149,7 +164,7 @@ class a {
     this.observer && (this.observer.disconnect(), this.observer = null);
   }
 }
-class S {
+class U {
   tester = null;
   /**
    * 创建SDK实例
@@ -174,7 +189,7 @@ class S {
    * const speeds = sdk.getAllResourcesSpeeds();
    */
   constructor(e) {
-    e && (this.tester = new a(e));
+    e && (this.tester = new l(e));
   }
   /**
    * 执行网速测试
@@ -196,7 +211,7 @@ class S {
    * @returns 资源速度信息数组
    */
   getAllResourcesSpeeds() {
-    return f();
+    return d();
   }
   /**
    * 监听特定资源的性能数据
@@ -204,17 +219,17 @@ class S {
    * @param callback 回调函数
    * @returns 停止监听的函数
    */
-  observeResource(e, s) {
-    return this.tester || (this.tester = new a({
+  observeResource(e, r) {
+    return this.tester || (this.tester = new l({
       internetImageUrl: ""
-    })), this.tester.observeResource(e, s);
+    })), this.tester.observeResource(e, r);
   }
   /**
    * 更新配置
    * @param options 新的配置选项
    */
   updateOptions(e) {
-    this.tester = new a(e);
+    this.tester = new l(e);
   }
   /**
    * 销毁SDK实例
@@ -223,13 +238,13 @@ class S {
     this.tester && (this.tester.destroy(), this.tester = null);
   }
 }
-function U(t) {
-  return new S(t);
+function g(t) {
+  return new U(t);
 }
 export {
-  S as NetworkSpeedSDK,
+  U as NetworkSpeedSDK,
   h as calcSpeedByResource,
-  U as createNetworkSpeedSDK,
+  g as createNetworkSpeedSDK,
   w as evaluateNetworkType,
-  f as getAllResourcesSpeeds
+  d as getAllResourcesSpeeds
 };

package/dist/network-speed-js.umd.js

@@ -1,5 +1,5 @@
-(function(n,c){typeof exports=="object"&&typeof module<"u"?c(exports):typeof define=="function"&&define.amd?define(["exports"],c):(n=typeof globalThis<"u"?globalThis:n||self,c(n.NetworkSpeedJS={}))})(this,(function(n){"use strict";function c(t){const e=t.responseEnd-t.responseStart;if(e<=0||t.transferSize===0)return null;const s=t.transferSize*8/e/1e3,o=t.transferSize/e;return{name:t.name,speedMbps:Number(s.toFixed(2)),speedKBps:Number(o.toFixed(2)),downloadTime:Number(e.toFixed(2)),transferSize:t.transferSize}}function h(){return performance.getEntriesByType("resource").filter(e=>e instanceof PerformanceResourceTiming&&e.transferSize>0).map(c).filter(e=>e!==null)}function S(t){performance.getEntriesByName(t).forEach(()=>{performance.clearResourceTimings()})}function f(t,e={fast:10,medium:2}){return t>=e.fast?"fast":t>=e.medium?"medium":t>0?"slow":"unknown"}class l{options;observer=null;constructor(e){"useFetch"in e&&e.useFetch?this.options={intranetUrl:e.intranetUrl||"",internetUrl:e.internetUrl,timeout:e.timeout||1e4,autoDetect:e.autoDetect??!0,thresholds:e.thresholds||{fast:10,medium:2},useFetch:!0}:this.options={intranetUrl:"intranetImageUrl"in e&&e.intranetImageUrl||"",internetUrl:"internetImageUrl"in e?e.internetImageUrl:"",timeout:e.timeout||1e4,autoDetect:e.autoDetect??!0,thresholds:e.thresholds||{fast:10,medium:2},useFetch:!1}}async test(){return this.options.autoDetect?this.testWithAutoDetect():this.testSingleUrl(this.options.internetUrl,!1)}async testWithAutoDetect(){if(this.options.intranetUrl)try{return await this.testSingleUrl(this.options.intranetUrl,!0)}catch{console.log("内网测速失败，切换到外网测速")}return this.testSingleUrl(this.options.internetUrl,!1)}testSingleUrl(e,s){return new Promise((o,i)=>{const r=`${e}?t=${Date.now()}`;S(r);const a=new PerformanceObserver(g=>{for(const d of g.getEntries())if(d.entryType==="resource"&&d.name.includes(e)){const u=c(d);if(u){const y={speedMbps:u.speedMbps,speedKBps:u.speedKBps,networkType:f(u.speedMbps,this.options.thresholds),isIntranet:s,duration:u.downloadTime,transferSize:u.transferSize,resourceUrl:e};a.disconnect(),o(y)}}});a.observe({entryTypes:["resource"]});const p=setTimeout(()=>{a.disconnect(),i(new Error(`测速超时: ${e}`))},this.options.timeout);this.options.useFetch?this.loadWithFetch(r,p,a,i):this.loadWithImage(r,p,a,i)})}loadWithImage(e,s,o,i){const r=new Image;r.onload=()=>{clearTimeout(s)},r.onerror=()=>{clearTimeout(s),o.disconnect(),i(new Error(`图片加载失败: ${e}`))},r.src=e}loadWithFetch(e,s,o,i){fetch(e,{method:"GET",cache:"no-store"}).then(r=>{if(!r.ok)throw new Error(`HTTP error! status: ${r.status}`);return r.blob()}).then(()=>{clearTimeout(s)}).catch(r=>{clearTimeout(s),o.disconnect(),i(new Error(`资源加载失败: ${r.message}`))})}observeResource(e,s){const o=new PerformanceObserver(i=>{for(const r of i.getEntries())r.entryType==="resource"&&r.name.includes(e)&&s(r)});return o.observe({entryTypes:["resource"]}),()=>o.disconnect()}updateOptions(e){this.options={...this.options,...e}}destroy(){this.observer&&(this.observer.disconnect(),this.observer=null)}}class m{tester=null;constructor(e){e&&(this.tester=new l(e))}async test(){if(!this.tester)throw new Error(`SDK未配置，请在构造函数中传入配置选项。
+(function(n,c){typeof exports=="object"&&typeof module<"u"?c(exports):typeof define=="function"&&define.amd?define(["exports"],c):(n=typeof globalThis<"u"?globalThis:n||self,c(n.NetworkSpeedJS={}))})(this,(function(n){"use strict";function c(t){const e=t.responseEnd-t.responseStart;if(e<=0||t.transferSize===0)return null;const r=t.transferSize*8/e/1e3,i=t.transferSize/e;return{name:t.name,speedMbps:Number(r.toFixed(2)),speedKBps:Number(i.toFixed(2)),downloadTime:Number(e.toFixed(2)),transferSize:t.transferSize}}function f(){return performance.getEntriesByType("resource").filter(e=>e instanceof PerformanceResourceTiming&&e.transferSize>0).map(c).filter(e=>e!==null)}function w(t){performance.getEntriesByName(t).forEach(()=>{performance.clearResourceTimings()})}function d(t,e={fast:10,medium:2}){return t>=e.fast?"fast":t>=e.medium?"medium":t>0?"slow":"unknown"}class l{options;observer=null;constructor(e){if("useFetch"in e&&e.useFetch){if(!e.internetUrl)throw new Error("Fetch模式必须提供 internetUrl 参数");if(!e.internetUrl.startsWith("http://")&&!e.internetUrl.startsWith("https://"))throw new Error("internetUrl 必须是完整的HTTP/HTTPS URL");this.options={intranetUrl:e.intranetUrl||"",internetUrl:e.internetUrl,timeout:e.timeout||1e4,autoDetect:e.autoDetect??!0,thresholds:e.thresholds||{fast:10,medium:2},useFetch:!0}}else{const r="internetImageUrl"in e?e.internetImageUrl:"";if(!r)throw new Error("图片模式必须提供 internetImageUrl 参数");if(!r.startsWith("http://")&&!r.startsWith("https://"))throw new Error("internetImageUrl 必须是完整的HTTP/HTTPS URL");this.options={intranetUrl:"intranetImageUrl"in e&&e.intranetImageUrl||"",internetUrl:r,timeout:e.timeout||1e4,autoDetect:e.autoDetect??!0,thresholds:e.thresholds||{fast:10,medium:2},useFetch:!1}}if(this.options.intranetUrl&&!this.options.intranetUrl.startsWith("http://")&&!this.options.intranetUrl.startsWith("https://"))throw new Error("intranetUrl/intranetImageUrl 必须是完整的HTTP/HTTPS URL")}async test(){return this.options.autoDetect?this.testWithAutoDetect():this.testSingleUrl(this.options.internetUrl,!1)}async testWithAutoDetect(){if(this.options.intranetUrl)try{return await this.testSingleUrl(this.options.intranetUrl,!0)}catch{console.log("内网测速失败，切换到外网测速")}return this.testSingleUrl(this.options.internetUrl,!1)}testSingleUrl(e,r){return new Promise((i,o)=>{const s=`${e}?t=${Date.now()}`;w(s);const u=new PerformanceObserver(U=>{for(const h of U.getEntries())if(h.entryType==="resource"&&h.name.includes(e)){const a=c(h);if(a){const T={speedMbps:a.speedMbps,speedKBps:a.speedKBps,networkType:d(a.speedMbps,this.options.thresholds),isIntranet:r,duration:a.downloadTime,transferSize:a.transferSize,resourceUrl:e};u.disconnect(),i(T)}}});u.observe({entryTypes:["resource"]});const p=setTimeout(()=>{u.disconnect(),o(new Error(`测速超时: ${e}`))},this.options.timeout);this.options.useFetch?this.loadWithFetch(s,p,u,o):this.loadWithImage(s,p,u,o)})}loadWithImage(e,r,i,o){const s=new Image;s.onload=()=>{clearTimeout(r)},s.onerror=()=>{clearTimeout(r),i.disconnect(),o(new Error(`图片加载失败: ${e}`))},s.src=e}loadWithFetch(e,r,i,o){fetch(e,{method:"GET",cache:"no-store"}).then(s=>{if(!s.ok)throw new Error(`HTTP error! status: ${s.status}`);return s.blob()}).then(()=>{clearTimeout(r)}).catch(s=>{clearTimeout(r),i.disconnect(),o(new Error(`资源加载失败: ${s.message}`))})}observeResource(e,r){const i=new PerformanceObserver(o=>{for(const s of o.getEntries())s.entryType==="resource"&&s.name.includes(e)&&r(s)});return i.observe({entryTypes:["resource"]}),()=>i.disconnect()}updateOptions(e){this.options={...this.options,...e}}destroy(){this.observer&&(this.observer.disconnect(),this.observer=null)}}class m{tester=null;constructor(e){e&&(this.tester=new l(e))}async test(){if(!this.tester)throw new Error(`SDK未配置，请在构造函数中传入配置选项。
 示例：
   new NetworkSpeedSDK({ internetImageUrl: "https://cdn.example.com/test.jpg" })
 或：
-  new NetworkSpeedSDK({ internetUrl: "https://cdn.example.com/test.bin", useFetch: true })`);return this.tester.test()}getAllResourcesSpeeds(){return h()}observeResource(e,s){return this.tester||(this.tester=new l({internetImageUrl:""})),this.tester.observeResource(e,s)}updateOptions(e){this.tester=new l(e)}destroy(){this.tester&&(this.tester.destroy(),this.tester=null)}}function w(t){return new m(t)}n.NetworkSpeedSDK=m,n.calcSpeedByResource=c,n.createNetworkSpeedSDK=w,n.evaluateNetworkType=f,n.getAllResourcesSpeeds=h,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));
+  new NetworkSpeedSDK({ internetUrl: "https://cdn.example.com/test.bin", useFetch: true })`);return this.tester.test()}getAllResourcesSpeeds(){return f()}observeResource(e,r){return this.tester||(this.tester=new l({internetImageUrl:""})),this.tester.observeResource(e,r)}updateOptions(e){this.tester=new l(e)}destroy(){this.tester&&(this.tester.destroy(),this.tester=null)}}function S(t){return new m(t)}n.NetworkSpeedSDK=m,n.calcSpeedByResource=c,n.createNetworkSpeedSDK=S,n.evaluateNetworkType=d,n.getAllResourcesSpeeds=f,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -2,7 +2,7 @@
   "name": "network-speed-js",
   "private": false,
   "description": "A framework-agnostic network speed testing SDK based on Performance API with intranet/internet auto-detection support",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "author": "Sunny-117",
   "license": "MIT",
   "keywords": [