network-speed-js 1.0.4 → 1.0.5

package/README.md

@@ -53,11 +53,31 @@ npm install network-speed-js
 
 ### 原生 JavaScript / TypeScript
 
+**方式一：使用图片资源测速（推荐，默认模式，无需CORS）**
+
 ```typescript
 import { NetworkSpeedSDK } from 'network-speed-js';
 
 const sdk = new NetworkSpeedSDK({
-  internetUrl: 'https://cdn.example.com/test.bin',
+  internetImageUrl: 'https://cdn.example.com/test-image.jpg',
+  // 可选：内网图片URL
+  intranetImageUrl: 'https://internal-cdn.com/test-image.jpg',
+});
+
+const result = await sdk.test();
+console.log(`网速: ${result.speedMbps} Mbps`);
+```
+
+**方式二：使用任意资源测速（需要CORS支持）**
+
+```typescript
+import { NetworkSpeedSDK } from 'network-speed-js';
+
+const sdk = new NetworkSpeedSDK({
+  internetUrl: 'https://cdn.example.com/test-file.bin',
+  useFetch: true, // 启用fetch模式
+  // 可选：内网资源URL
+  intranetUrl: 'https://internal-cdn.com/test-file.bin',
 });
 
 const result = await sdk.test();
@@ -84,7 +104,7 @@ const result = ref(null);
 const testSpeed = async () => {
   loading.value = true;
   const sdk = new NetworkSpeedSDK({
-    internetUrl: 'https://cdn.example.com/test.bin',
+    internetImageUrl: 'https://cdn.example.com/test-image.jpg',
   });
   result.value = await sdk.test();
   loading.value = false;
@@ -105,7 +125,7 @@ function SpeedTest() {
   const testSpeed = async () => {
     setLoading(true);
     const sdk = new NetworkSpeedSDK({
-      internetUrl: 'https://cdn.example.com/test.bin',
+      internetImageUrl: 'https://cdn.example.com/test-image.jpg',
     });
     const data = await sdk.test();
     setResult(data);
@@ -145,7 +165,7 @@ export class SpeedTestComponent {
   async testSpeed() {
     this.loading = true;
     const sdk = new NetworkSpeedSDK({
-      internetUrl: 'https://cdn.example.com/test.bin',
+      internetImageUrl: 'https://cdn.example.com/test-image.jpg',
     });
     this.result = await sdk.test();
     this.loading = false;
@@ -163,29 +183,63 @@ export class SpeedTestComponent {
 new NetworkSpeedSDK(options?: SpeedTestOptions)
 ```
 
-**配置选项：**
+**参数说明：**
+- `options`（可选）：配置选项
+  - 如果传入配置，可以执行测速
+  - 如果不传配置，只能使用工具函数（`getAllResourcesSpeeds`、`observeResource`）
 
-| 参数 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `intranetUrl` | `string` | `''` | 内网测速资源URL |
-| `internetUrl` | `string` | `''` | 外网测速资源URL（必填） |
-| `autoDetect` | `boolean` | `true` | 是否自动检测内外网 |
-| `timeout` | `number` | `10000` | 超时时间 (ms) |
-| `thresholds` | `object` | `{fast: 10, medium: 2}` | 网速评估阈值 (Mbps) |
-| `resourceType` | `'image' \| 'fetch'` | `'image'` | 资源类型（见下方说明） |
+**配置选项（两种模式）：**
 
-**resourceType 说明：**
+**模式一：图片模式（默认，推荐）**
 
-- `'image'`（默认）：使用 Image 对象加载
-  - ✅ 不受跨域限制
-  - ✅ 适用于图片资源（.jpg、.png、.webp 等）
-  - ✅ 无需服务器配置 CORS
-  - ⚠️ 仅支持图片格式
+```typescript
+interface ImageSpeedTestOptions {
+  internetImageUrl: string;      // ✅ 必填：外网图片URL
+  intranetImageUrl?: string;     // 可选：内网图片URL
+  timeout?: number;              // 可选：超时时间 (ms)，默认 10000
+  autoDetect?: boolean;          // 可选：是否自动检测内外网，默认 true
+  thresholds?: {                 // 可选：网速评估阈值 (Mbps)
+    fast: number;                // 默认 10
+    medium: number;              // 默认 2
+  };
+}
+```
+
+**模式二：Fetch模式（支持任意资源，需要CORS）**
+
+```typescript
+interface FetchSpeedTestOptions {
+  internetUrl: string;           // ✅ 必填：外网资源URL
+  useFetch: true;                // ✅ 必填：启用fetch模式
+  intranetUrl?: string;          // 可选：内网资源URL
+  timeout?: number;              // 可选：超时时间 (ms)，默认 10000
+  autoDetect?: boolean;          // 可选：是否自动检测内外网，默认 true
+  thresholds?: {                 // 可选：网速评估阈值 (Mbps)
+    fast: number;                // 默认 10
+    medium: number;              // 默认 2
+  };
+}
+```
+
+**使用示例：**
 
-- `'fetch'`：使用 fetch API 加载
-  - ✅ 支持任意类型资源（.bin、.json、.txt 等）
-  - ⚠️ 需要服务器配置 CORS
-  - ⚠️ 受跨域限制
+```typescript
+// ✅ 图片模式（只需要图片URL）
+const sdk1 = new NetworkSpeedSDK({
+  internetImageUrl: 'https://cdn.example.com/test.jpg',
+});
+
+// ✅ Fetch模式（需要URL + useFetch: true）
+const sdk2 = new NetworkSpeedSDK({
+  internetUrl: 'https://cdn.example.com/test.bin',
+  useFetch: true,
+});
+
+// ✅ 无参数实例化（仅用于工具函数）
+const sdk3 = new NetworkSpeedSDK();
+const speeds = sdk3.getAllResourcesSpeeds(); // ✅ 可以使用
+await sdk3.test(); // ❌ 会抛出错误：SDK未配置
+```
 
 #### 方法
 
@@ -283,8 +337,7 @@ interface ResourceSpeedInfo {
 
 ```typescript
 const sdk = new NetworkSpeedSDK({
-  internetUrl: 'https://cdn.example.com/test-image.jpg',
-  // resourceType: 'image', // 默认值，可省略
+  internetImageUrl: 'https://cdn.example.com/test-image.jpg',
 });
 
 const result = await sdk.test();
@@ -295,7 +348,7 @@ const result = await sdk.test();
 ```typescript
 const sdk = new NetworkSpeedSDK({
   internetUrl: 'https://cdn.example.com/test-file.bin',
-  resourceType: 'fetch', // 使用 fetch API
+  useFetch: true, // 必须启用fetch模式
 });
 
 const result = await sdk.test();
@@ -304,9 +357,18 @@ const result = await sdk.test();
 ### 3. 内外网自动检测
 
 ```typescript
+// 图片模式
+const sdk = new NetworkSpeedSDK({
+  intranetImageUrl: 'https://internal-cdn.company.com/test.jpg',
+  internetImageUrl: 'https://public-cdn.example.com/test.jpg',
+  autoDetect: true,
+});
+
+// 或 Fetch模式
 const sdk = new NetworkSpeedSDK({
-  intranetUrl: 'https://internal-cdn.company.com/test.jpg',
-  internetUrl: 'https://public-cdn.example.com/test.jpg',
+  intranetUrl: 'https://internal-cdn.company.com/test.bin',
+  internetUrl: 'https://public-cdn.example.com/test.bin',
+  useFetch: true,
   autoDetect: true,
 });
 

package/dist/core/sdk.d.ts

@@ -4,23 +4,51 @@ import type { SpeedTestOptions, SpeedTestResult, ResourceSpeedInfo } from './typ
  */
 export declare class NetworkSpeedSDK {
     private tester;
+    /**
+     * 创建SDK实例
+     * @param options 配置选项（可选，如果不传则只能使用工具函数，不能执行测速）
+     *
+     * @example
+     * // 图片模式（默认，推荐）
+     * const sdk = new NetworkSpeedSDK({
+     *   internetImageUrl: 'https://cdn.example.com/test.jpg',
+     * });
+     *
+     * @example
+     * // Fetch模式（需要CORS）
+     * const sdk = new NetworkSpeedSDK({
+     *   internetUrl: 'https://cdn.example.com/test.bin',
+     *   useFetch: true,
+     * });
+     *
+     * @example
+     * // 仅使用工具函数
+     * const sdk = new NetworkSpeedSDK();
+     * const speeds = sdk.getAllResourcesSpeeds();
+     */
     constructor(options?: SpeedTestOptions);
     /**
      * 执行网速测试
+     * @throws {Error} 如果SDK未配置
      */
     test(): Promise<SpeedTestResult>;
     /**
      * 获取所有已加载资源的速度信息
+     * @returns 资源速度信息数组
      */
     getAllResourcesSpeeds(): ResourceSpeedInfo[];
     /**
      * 监听特定资源的性能数据
+     * @param urlPattern URL匹配模式
+     * @param callback 回调函数
+     * @returns 停止监听的函数
      */
     observeResource(urlPattern: string, callback: (entry: PerformanceResourceTiming) => void): () => void;
     /**
      * 更新配置
+     * @param options 新的配置选项
      */
-    updateOptions(options: Partial<SpeedTestOptions>): void;
+    updateOptions(options: SpeedTestOptions): void;
     /**
      * 销毁SDK实例
      */
@@ -28,6 +56,13 @@ export declare class NetworkSpeedSDK {
 }
 /**
  * 创建SDK实例的工厂函数
+ * @param options 配置选项
+ * @returns SDK实例
+ *
+ * @example
+ * const sdk = createNetworkSpeedSDK({
+ *   internetImageUrl: 'https://cdn.example.com/test.jpg',
+ * });
  */
 export declare function createNetworkSpeedSDK(options?: SpeedTestOptions): NetworkSpeedSDK;
 export default NetworkSpeedSDK;

package/dist/core/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpF;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAc;gBAEhB,OAAO,GAAE,gBAAqB;IAI1C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAItC;;OAEG;IACH,qBAAqB,IAAI,iBAAiB,EAAE;IAI5C;;OAEG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACnD,MAAM,IAAI;IAIb;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAEjF;AAGD,eAAe,eAAe,CAAC"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpF;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;;;;;;;;;;;;;;;;;;;OAqBG;gBACS,OAAO,CAAC,EAAE,gBAAgB;IAMtC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAatC;;;OAGG;IACH,qBAAqB,IAAI,iBAAiB,EAAE;IAI5C;;;;;OAKG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACnD,MAAM,IAAI;IAUb;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAK9C;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAEjF;AAGD,eAAe,eAAe,CAAC"}

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

@@ -1,11 +1,25 @@
 import type { SpeedTestResult, SpeedTestOptions, PerformanceEntryCallback } from './types';
+/**
+ * 内部标准化配置
+ */
+interface NormalizedOptions {
+    intranetUrl: string;
+    internetUrl: string;
+    timeout: number;
+    autoDetect: boolean;
+    thresholds: {
+        fast: number;
+        medium: number;
+    };
+    useFetch: boolean;
+}
 /**
  * 网速测试核心类
  */
 export declare class SpeedTester {
     private options;
     private observer;
-    constructor(options?: SpeedTestOptions);
+    constructor(options: SpeedTestOptions);
     /**
      * 执行测速
      */
@@ -33,10 +47,11 @@ export declare class SpeedTester {
     /**
      * 更新配置
      */
-    updateOptions(options: Partial<SpeedTestOptions>): void;
+    updateOptions(options: Partial<NormalizedOptions>): void;
     /**
      * 销毁实例
      */
     destroy(): void;
 }
+export {};
 //# sourceMappingURL=speed-tester.d.ts.map

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,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAoC;gBAExC,OAAO,GAAE,gBAAqB;IAW1C;;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,gBAAgB,CAAC,GAAG,IAAI;IAIvD;;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;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"}

package/dist/core/types.d.ts

@@ -33,17 +33,9 @@ export interface ResourceSpeedInfo {
     transferSize: number;
 }
 /**
- * 资源类型
+ * 基础配置选项
  */
-export type ResourceType = 'image' | 'fetch';
-/**
- * SDK配置选项
- */
-export interface SpeedTestOptions {
-    /** 内网测速资源URL */
-    intranetUrl?: string;
-    /** 外网测速资源URL */
-    internetUrl?: string;
+interface BaseSpeedTestOptions {
     /** 超时时间 (ms) */
     timeout?: number;
     /** 是否自动检测内外网 */
@@ -53,17 +45,36 @@ export interface SpeedTestOptions {
         fast: number;
         medium: number;
     };
-    /**
-     * 资源类型
-     * - 'image': 使用 Image 对象加载（默认，不受跨域限制，适用于图片资源）
-     * - 'fetch': 使用 fetch API 加载（需要服务器支持 CORS，适用于任意资源）
-     */
-    resourceType?: ResourceType;
 }
+/**
+ * 图片模式配置（默认，不受跨域限制）
+ */
+export interface ImageSpeedTestOptions extends BaseSpeedTestOptions {
+    /** 内网测速图片URL */
+    intranetImageUrl?: string;
+    /** 外网测速图片URL（必填） */
+    internetImageUrl: string;
+}
+/**
+ * Fetch模式配置（支持任意资源，需要CORS）
+ */
+export interface FetchSpeedTestOptions extends BaseSpeedTestOptions {
+    /** 内网测速资源URL */
+    intranetUrl?: string;
+    /** 外网测速资源URL（必填） */
+    internetUrl: string;
+    /** 使用fetch模式 */
+    useFetch: true;
+}
+/**
+ * SDK配置选项（联合类型）
+ */
+export type SpeedTestOptions = ImageSpeedTestOptions | FetchSpeedTestOptions;
 /**
  * Performance Observer 回调参数
  */
 export interface PerformanceEntryCallback {
     (entry: PerformanceResourceTiming): void;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACpD,YAAY;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC1C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACpD,YAAY;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,gBAAgB;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC1C"}

package/dist/network-speed-js.js

@@ -1,4 +1,4 @@
-function l(t) {
+function h(t) {
   const e = t.responseEnd - t.responseStart;
   if (e <= 0 || t.transferSize === 0)
     return null;
@@ -11,30 +11,37 @@ function l(t) {
     transferSize: t.transferSize
   };
 }
-function p() {
+function f() {
   return performance.getEntriesByType("resource").filter(
     (e) => e instanceof PerformanceResourceTiming && e.transferSize > 0
-  ).map(l).filter((e) => e !== null);
+  ).map(h).filter((e) => e !== null);
 }
-function h(t) {
+function p(t) {
   performance.getEntriesByName(t).forEach(() => {
     performance.clearResourceTimings();
   });
 }
-function m(t, e = { fast: 10, medium: 2 }) {
+function w(t, e = { fast: 10, medium: 2 }) {
   return t >= e.fast ? "fast" : t >= e.medium ? "medium" : t > 0 ? "slow" : "unknown";
 }
-class T {
+class a {
   options;
   observer = null;
-  constructor(e = {}) {
-    this.options = {
+  constructor(e) {
+    "useFetch" in e && e.useFetch ? this.options = {
       intranetUrl: e.intranetUrl || "",
-      internetUrl: e.internetUrl || "",
+      internetUrl: e.internetUrl,
       timeout: e.timeout || 1e4,
       autoDetect: e.autoDetect ?? !0,
       thresholds: e.thresholds || { fast: 10, medium: 2 },
-      resourceType: e.resourceType || "image"
+      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
     };
   }
   /**
@@ -61,16 +68,16 @@ class T {
   testSingleUrl(e, s) {
     return new Promise((n, o) => {
       const r = `${e}?t=${Date.now()}`;
-      h(r);
-      const c = new PerformanceObserver((d) => {
-        for (const u of d.getEntries())
+      p(r);
+      const c = new PerformanceObserver((m) => {
+        for (const u of m.getEntries())
           if (u.entryType === "resource" && u.name.includes(e)) {
-            const i = l(u);
+            const i = h(u);
             if (i) {
-              const f = {
+              const d = {
                 speedMbps: i.speedMbps,
                 speedKBps: i.speedKBps,
-                networkType: m(
+                networkType: w(
                   i.speedMbps,
                   this.options.thresholds
                 ),
@@ -79,15 +86,15 @@ class T {
                 transferSize: i.transferSize,
                 resourceUrl: e
               };
-              c.disconnect(), n(f);
+              c.disconnect(), n(d);
             }
           }
       });
       c.observe({ entryTypes: ["resource"] });
-      const a = setTimeout(() => {
+      const l = setTimeout(() => {
         c.disconnect(), o(new Error(`测速超时: ${e}`));
       }, this.options.timeout);
-      this.options.resourceType === "fetch" ? this.loadWithFetch(r, a, c, o) : this.loadWithImage(r, a, c, o);
+      this.options.useFetch ? this.loadWithFetch(r, l, c, o) : this.loadWithImage(r, l, c, o);
     });
   }
   /**
@@ -98,7 +105,7 @@ class T {
     r.onload = () => {
       clearTimeout(s);
     }, r.onerror = () => {
-      clearTimeout(s), n.disconnect(), o(new Error(`资源加载失败: ${e}`));
+      clearTimeout(s), n.disconnect(), o(new Error(`图片加载失败: ${e}`));
     }, r.src = e;
   }
   /**
@@ -142,49 +149,87 @@ class T {
     this.observer && (this.observer.disconnect(), this.observer = null);
   }
 }
-class y {
-  tester;
-  constructor(e = {}) {
-    this.tester = new T(e);
+class S {
+  tester = null;
+  /**
+   * 创建SDK实例
+   * @param options 配置选项（可选，如果不传则只能使用工具函数，不能执行测速）
+   * 
+   * @example
+   * // 图片模式（默认，推荐）
+   * const sdk = new NetworkSpeedSDK({
+   *   internetImageUrl: 'https://cdn.example.com/test.jpg',
+   * });
+   * 
+   * @example
+   * // Fetch模式（需要CORS）
+   * const sdk = new NetworkSpeedSDK({
+   *   internetUrl: 'https://cdn.example.com/test.bin',
+   *   useFetch: true,
+   * });
+   * 
+   * @example
+   * // 仅使用工具函数
+   * const sdk = new NetworkSpeedSDK();
+   * const speeds = sdk.getAllResourcesSpeeds();
+   */
+  constructor(e) {
+    e && (this.tester = new a(e));
   }
   /**
    * 执行网速测试
+   * @throws {Error} 如果SDK未配置
    */
   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();
   }
   /**
    * 获取所有已加载资源的速度信息
+   * @returns 资源速度信息数组
    */
   getAllResourcesSpeeds() {
-    return p();
+    return f();
   }
   /**
    * 监听特定资源的性能数据
+   * @param urlPattern URL匹配模式
+   * @param callback 回调函数
+   * @returns 停止监听的函数
    */
   observeResource(e, s) {
-    return this.tester.observeResource(e, s);
+    return this.tester || (this.tester = new a({
+      internetImageUrl: ""
+    })), this.tester.observeResource(e, s);
   }
   /**
    * 更新配置
+   * @param options 新的配置选项
    */
   updateOptions(e) {
-    this.tester.updateOptions(e);
+    this.tester = new a(e);
   }
   /**
    * 销毁SDK实例
    */
   destroy() {
-    this.tester.destroy();
+    this.tester && (this.tester.destroy(), this.tester = null);
   }
 }
-function b(t) {
-  return new y(t);
+function U(t) {
+  return new S(t);
 }
 export {
-  y as NetworkSpeedSDK,
-  l as calcSpeedByResource,
-  b as createNetworkSpeedSDK,
-  m as evaluateNetworkType,
-  p as getAllResourcesSpeeds
+  S as NetworkSpeedSDK,
+  h as calcSpeedByResource,
+  U as createNetworkSpeedSDK,
+  w as evaluateNetworkType,
+  f as getAllResourcesSpeeds
 };

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

@@ -1 +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 d(){return performance.getEntriesByType("resource").filter(e=>e instanceof PerformanceResourceTiming&&e.transferSize>0).map(c).filter(e=>e!==null)}function m(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 S{options;observer=null;constructor(e={}){this.options={intranetUrl:e.intranetUrl||"",internetUrl:e.internetUrl||"",timeout:e.timeout||1e4,autoDetect:e.autoDetect??!0,thresholds:e.thresholds||{fast:10,medium:2},resourceType:e.resourceType||"image"}}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()}`;m(r);const a=new PerformanceObserver(T=>{for(const l of T.getEntries())if(l.entryType==="resource"&&l.name.includes(e)){const u=c(l);if(u){const w={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(w)}}});a.observe({entryTypes:["resource"]});const h=setTimeout(()=>{a.disconnect(),i(new Error(`测速超时: ${e}`))},this.options.timeout);this.options.resourceType==="fetch"?this.loadWithFetch(r,h,a,i):this.loadWithImage(r,h,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 p{tester;constructor(e={}){this.tester=new S(e)}async test(){return this.tester.test()}getAllResourcesSpeeds(){return d()}observeResource(e,s){return this.tester.observeResource(e,s)}updateOptions(e){this.tester.updateOptions(e)}destroy(){this.tester.destroy()}}function y(t){return new p(t)}n.NetworkSpeedSDK=p,n.calcSpeedByResource=c,n.createNetworkSpeedSDK=y,n.evaluateNetworkType=f,n.getAllResourcesSpeeds=d,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})}));
+(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未配置，请在构造函数中传入配置选项。
+示例：
+  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"})}));

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.4",
+  "version": "1.0.5",
   "author": "Sunny-117",
   "license": "MIT",
   "keywords": [