network-speed-js 0.0.2 → 1.0.0

package/dist/network-speed-js.js

@@ -0,0 +1,167 @@
+var h = Object.defineProperty;
+var S = (t, e, r) => e in t ? h(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r;
+var u = (t, e, r) => S(t, typeof e != "symbol" ? e + "" : e, r);
+function d(t) {
+  const e = t.responseEnd - t.responseStart;
+  if (e <= 0 || t.transferSize === 0)
+    return null;
+  const r = t.transferSize * 8 / e / 1e3, s = t.transferSize / e;
+  return {
+    name: t.name,
+    speedMbps: Number(r.toFixed(2)),
+    speedKBps: Number(s.toFixed(2)),
+    downloadTime: Number(e.toFixed(2)),
+    transferSize: t.transferSize
+  };
+}
+function y() {
+  return performance.getEntriesByType("resource").filter(
+    (e) => e instanceof PerformanceResourceTiming && e.transferSize > 0
+  ).map(d).filter((e) => e !== null);
+}
+function b(t) {
+  performance.getEntriesByName(t).forEach(() => {
+    performance.clearResourceTimings();
+  });
+}
+function w(t, e = { fast: 10, medium: 2 }) {
+  return t >= e.fast ? "fast" : t >= e.medium ? "medium" : t > 0 ? "slow" : "unknown";
+}
+class T {
+  constructor(e = {}) {
+    u(this, "options");
+    u(this, "observer", null);
+    this.options = {
+      intranetUrl: e.intranetUrl || "",
+      internetUrl: e.internetUrl || "",
+      timeout: e.timeout || 1e4,
+      autoDetect: e.autoDetect ?? !0,
+      thresholds: e.thresholds || { fast: 10, medium: 2 }
+    };
+  }
+  /**
+   * 执行测速
+   */
+  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);
+  }
+  /**
+   * 测试单个URL
+   */
+  testSingleUrl(e, r) {
+    return new Promise((s, i) => {
+      const n = `${e}?t=${Date.now()}`;
+      b(n);
+      const c = new PerformanceObserver((f) => {
+        for (const l of f.getEntries())
+          if (l.entryType === "resource" && l.name.includes(e)) {
+            const o = d(l);
+            if (o) {
+              const m = {
+                speedMbps: o.speedMbps,
+                speedKBps: o.speedKBps,
+                networkType: w(
+                  o.speedMbps,
+                  this.options.thresholds
+                ),
+                isIntranet: r,
+                duration: o.downloadTime,
+                transferSize: o.transferSize,
+                resourceUrl: e
+              };
+              c.disconnect(), s(m);
+            }
+          }
+      });
+      c.observe({ entryTypes: ["resource"] });
+      const a = new Image(), p = setTimeout(() => {
+        c.disconnect(), i(new Error(`测速超时: ${e}`));
+      }, this.options.timeout);
+      a.onload = () => {
+        clearTimeout(p);
+      }, a.onerror = () => {
+        clearTimeout(p), c.disconnect(), i(new Error(`资源加载失败: ${e}`));
+      }, a.src = n;
+    });
+  }
+  /**
+   * 监听特定资源的性能数据
+   */
+  observeResource(e, r) {
+    const s = new PerformanceObserver((i) => {
+      for (const n of i.getEntries())
+        n.entryType === "resource" && n.name.includes(e) && r(n);
+    });
+    return s.observe({ entryTypes: ["resource"] }), () => s.disconnect();
+  }
+  /**
+   * 更新配置
+   */
+  updateOptions(e) {
+    this.options = { ...this.options, ...e };
+  }
+  /**
+   * 销毁实例
+   */
+  destroy() {
+    this.observer && (this.observer.disconnect(), this.observer = null);
+  }
+}
+class g {
+  constructor(e = {}) {
+    u(this, "tester");
+    this.tester = new T(e);
+  }
+  /**
+   * 执行网速测试
+   */
+  async test() {
+    return this.tester.test();
+  }
+  /**
+   * 获取所有已加载资源的速度信息
+   */
+  getAllResourcesSpeeds() {
+    return y();
+  }
+  /**
+   * 监听特定资源的性能数据
+   */
+  observeResource(e, r) {
+    return this.tester.observeResource(e, r);
+  }
+  /**
+   * 更新配置
+   */
+  updateOptions(e) {
+    this.tester.updateOptions(e);
+  }
+  /**
+   * 销毁SDK实例
+   */
+  destroy() {
+    this.tester.destroy();
+  }
+}
+function E(t) {
+  return new g(t);
+}
+export {
+  g as NetworkSpeedSDK,
+  d as calcSpeedByResource,
+  E as createNetworkSpeedSDK,
+  w as evaluateNetworkType,
+  y as getAllResourcesSpeeds
+};

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

@@ -0,0 +1 @@
+(function(r,s){typeof exports=="object"&&typeof module<"u"?s(exports):typeof define=="function"&&define.amd?define(["exports"],s):(r=typeof globalThis<"u"?globalThis:r||self,s(r.NetworkSpeedJS={}))})(this,function(r){"use strict";var v=Object.defineProperty;var U=(r,s,n)=>s in r?v(r,s,{enumerable:!0,configurable:!0,writable:!0,value:n}):r[s]=n;var d=(r,s,n)=>U(r,typeof s!="symbol"?s+"":s,n);function s(t){const e=t.responseEnd-t.responseStart;if(e<=0||t.transferSize===0)return null;const o=t.transferSize*8/e/1e3,i=t.transferSize/e;return{name:t.name,speedMbps:Number(o.toFixed(2)),speedKBps:Number(i.toFixed(2)),downloadTime:Number(e.toFixed(2)),transferSize:t.transferSize}}function n(){return performance.getEntriesByType("resource").filter(e=>e instanceof PerformanceResourceTiming&&e.transferSize>0).map(s).filter(e=>e!==null)}function y(t){performance.getEntriesByName(t).forEach(()=>{performance.clearResourceTimings()})}function m(t,e={fast:10,medium:2}){return t>=e.fast?"fast":t>=e.medium?"medium":t>0?"slow":"unknown"}class w{constructor(e={}){d(this,"options");d(this,"observer",null);this.options={intranetUrl:e.intranetUrl||"",internetUrl:e.internetUrl||"",timeout:e.timeout||1e4,autoDetect:e.autoDetect??!0,thresholds:e.thresholds||{fast:10,medium:2}}}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,o){return new Promise((i,a)=>{const c=`${e}?t=${Date.now()}`;y(c);const l=new PerformanceObserver(T=>{for(const p of T.getEntries())if(p.entryType==="resource"&&p.name.includes(e)){const u=s(p);if(u){const g={speedMbps:u.speedMbps,speedKBps:u.speedKBps,networkType:m(u.speedMbps,this.options.thresholds),isIntranet:o,duration:u.downloadTime,transferSize:u.transferSize,resourceUrl:e};l.disconnect(),i(g)}}});l.observe({entryTypes:["resource"]});const f=new Image,S=setTimeout(()=>{l.disconnect(),a(new Error(`测速超时: ${e}`))},this.options.timeout);f.onload=()=>{clearTimeout(S)},f.onerror=()=>{clearTimeout(S),l.disconnect(),a(new Error(`资源加载失败: ${e}`))},f.src=c})}observeResource(e,o){const i=new PerformanceObserver(a=>{for(const c of a.getEntries())c.entryType==="resource"&&c.name.includes(e)&&o(c)});return i.observe({entryTypes:["resource"]}),()=>i.disconnect()}updateOptions(e){this.options={...this.options,...e}}destroy(){this.observer&&(this.observer.disconnect(),this.observer=null)}}class h{constructor(e={}){d(this,"tester");this.tester=new w(e)}async test(){return this.tester.test()}getAllResourcesSpeeds(){return n()}observeResource(e,o){return this.tester.observeResource(e,o)}updateOptions(e){this.tester.updateOptions(e)}destroy(){this.tester.destroy()}}function b(t){return new h(t)}r.NetworkSpeedSDK=h,r.calcSpeedByResource=s,r.createNetworkSpeedSDK=b,r.evaluateNetworkType=m,r.getAllResourcesSpeeds=n,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,24 +1,63 @@
 {
   "name": "network-speed-js",
   "private": false,
-  "description": "A small tool for testing network speed. It also has the ability to test internal and external networks.",
-  "version": "0.0.2",
+  "description": "A framework-agnostic network speed testing SDK based on Performance API with intranet/internet auto-detection support",
+  "version": "1.0.0",
+  "author": "Sunny-117",
+  "license": "MIT",
+  "keywords": [
+    "network",
+    "speed",
+    "test",
+    "performance",
+    "bandwidth",
+    "sdk",
+    "typescript",
+    "framework-agnostic",
+    "vue",
+    "react",
+    "angular"
+  ],
+  "main": "dist/network-speed-js.umd.js",
   "module": "dist/network-speed-js.js",
+  "types": "dist/index.d.ts",
   "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/network-speed-js.js",
+      "require": "./dist/network-speed-js.umd.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "scripts": {
     "dev": "vite",
-    "build": "vue-tsc && vite build",
-    "preview": "vite preview"
+    "build": "vite build",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "vue": "^3.3.11"
   },
   "dependencies": {
-    "axios": "^1.6.2",
-    "element-plus": "^2.4.4",
     "vue": "^3.3.11"
   },
   "devDependencies": {
+    "@types/node": "^25.0.10",
     "@vitejs/plugin-vue": "^4.5.2",
     "typescript": "^5.2.2",
     "vite": "^5.0.8",
     "vue-tsc": "^1.8.25"
-  }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sunny-117/network-speed-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Sunny-117/network-speed-js/issues"
+  },
+  "homepage": "https://github.com/Sunny-117/network-speed-js#readme"
 }

package/.eslintrc.js

@@ -1,3 +0,0 @@
-module.exports = {
-  "no-unused-vars": ["error", { varsIgnorePattern: ".*", args: "none" }],
-};

package/.vscode/extensions.json

@@ -1,3 +0,0 @@
-{
-  "recommendations": ["Vue.volar", "Vue.vscode-typescript-vue-plugin"]
-}

package/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Vite + Vue + TS</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.ts"></script>
-  </body>
-</html>

package/playground/.vscode/extensions.json

@@ -1,3 +0,0 @@
-{
-  "recommendations": ["Vue.volar", "Vue.vscode-typescript-vue-plugin"]
-}

package/playground/README.md

@@ -1,18 +0,0 @@
-# Vue 3 + TypeScript + Vite
-
-This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
-
-## Recommended IDE Setup
-
-- [VS Code](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin).
-
-## Type Support For `.vue` Imports in TS
-
-TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin) to make the TypeScript language service aware of `.vue` types.
-
-If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a [Take Over Mode](https://github.com/johnsoncodehk/volar/discussions/471#discussioncomment-1361669) that is more performant. You can enable it by the following steps:
-
-1. Disable the built-in TypeScript Extension
-   1. Run `Extensions: Show Built-in Extensions` from VSCode's command palette
-   2. Find `TypeScript and JavaScript Language Features`, right click and select `Disable (Workspace)`
-2. Reload the VSCode window by running `Developer: Reload Window` from the command palette.

package/playground/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Vite + Vue + TS</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.ts"></script>
-  </body>
-</html>

package/playground/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "playground",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vue-tsc && vite build",
-    "preview": "vite preview"
-  },
-  "dependencies": {
-    "network-speed-js": "^0.0.1",
-    "vue": "^3.3.11"
-  },
-  "devDependencies": {
-    "@vitejs/plugin-vue": "^4.5.2",
-    "typescript": "^5.2.2",
-    "vite": "^5.0.8",
-    "vue-tsc": "^1.8.25"
-  }
-}

package/playground/pnpm-global/5/pnpm-lock.yaml

@@ -1,7 +0,0 @@
-lockfileVersion: 5.3
-
-specifiers:
-  network-speed-js: ^0.0.1
-
-dependencies:
-  network-speed-js: link:../../../../../.nvm/versions/node/v16.14.2/pnpm-global/5/node_modules/network-speed-js