ua-browser 1.2.0 → 1.3.1

package/README.md

@@ -5,13 +5,15 @@
 [![license](https://img.shields.io/npm/l/ua-browser)](./LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-ready-3178c6)](https://www.typescriptlang.org/)
 
-Detect browser, OS, device type, rendering engine, CPU architecture, bots, and headless browsers from User Agent strings. Zero dependencies. Works in both browser and Node.js environments.
+Detect browser, OS, device type, rendering engine, CPU architecture, bots, headless browsers, and Mini Programs from User Agent strings. Zero dependencies. Works in both browser and Node.js environments.
 
 **[📖 Documentation](https://yangtianxia.github.io/ua-browser/)** · **[🎮 Playground](https://yangtianxia.github.io/ua-browser/playground)** · **[中文](./README.zh-CN.md)**
 
 ## Features
 
-- **Comprehensive detection** — browser, OS, engine, device type (Mobile / Tablet / TV / PC), CPU arch, bots, headless browsers
+- **Comprehensive UA detection** — browser, OS, engine, device type (Mobile / Tablet / TV / PC), CPU arch, bots, headless browsers
+- **Multi-signal arch detection** — `getEnvContext()` collects Client Hints, WebGL renderer, and font probes to accurately distinguish Apple Silicon from Intel Mac
+- **SSR Client Hints** — `parseHeaders()` + `ACCEPT_CH` for precise server-side detection (CPU arch, platform) in Chrome / Edge 90+
 - **AI bot recognition** — built-in support for GPTBot, ClaudeBot, PerplexityBot, CCBot and more
 - **Zero dependencies** — no runtime dependencies, tiny bundle size after gzip
 - **Pure function** — `parseUA()` has no global state, works seamlessly with SSR / Node.js
@@ -67,16 +69,10 @@ const { browser, os, device } = uaBrowser()
 if (device === 'Mobile') {
   // redirect to mobile version
 }
-
-if (browser === 'Wechat') {
-  // WeChat in-app browser logic
-}
 ```
 
 ### Node.js / SSR
 
-Use the pure `parseUA` function with the UA string from the request header:
-
 ```typescript
 import { parseUA } from 'ua-browser'
 
@@ -97,6 +93,34 @@ if (isBot) {
 </script>
 ```
 
+### Multi-signal Architecture Detection
+
+`getEnvContext()` collects Client Hints, WebGL renderer, and other browser signals in one async call — enough to distinguish Apple Silicon from Intel Mac:
+
+```typescript
+import { getEnvContext, parseUA } from 'ua-browser'
+
+const ctx = await getEnvContext()
+const result = parseUA(navigator.userAgent, { ctx })
+
+console.log(result.arch) // 'arm64' or 'x86_64'
+```
+
+### SSR Client Hints
+
+Set the `ACCEPT_CH` response header so Chrome / Edge 90+ browsers send Client Hints on subsequent requests, then use `parseHeaders` for precise server-side detection:
+
+```typescript
+import { parseHeaders, ACCEPT_CH } from 'ua-browser'
+
+// First response — tell the browser to send Client Hints
+res.setHeader('Accept-CH', ACCEPT_CH)
+
+// Subsequent requests — accurate arch / OS detection
+const result = parseHeaders(req.headers)
+console.log(result.arch) // 'x86_64' (from Sec-CH-UA-Arch)
+```
+
 ### Accurate Windows 10 / 11 Detection
 
 Windows 10 and 11 share the same UA string. Use the Client Hints API to distinguish them:
@@ -118,8 +142,6 @@ console.log(result.osVersion) // '10' or '11'
 Automatically injects the `navigator` context (language, platform, MIME types, etc.) in browser environments.
 
 ```typescript
-import uaBrowser from 'ua-browser'
-
 uaBrowser()          // reads navigator.userAgent automatically
 uaBrowser(customUA)  // custom UA string, still injects browser context
 ```
@@ -128,16 +150,18 @@ uaBrowser(customUA)  // custom UA string, still injects browser context
 
 ```typescript
 import {
-  parseUA,           // pure function, ideal for SSR / Node.js
-  getNavContext,     // read current browser navigator context
-  getWindowsVersion, // async: accurately distinguish Windows 10 / 11
-  getLanguage,       // extract browser language from NavContext
-  isWebview,         // detect Android Webview (UA contains "; wv")
-  isWechatMiniapp,   // detect WeChat Mini Program environment
-  detectBot,         // standalone bot detection
-  detectArch,        // standalone CPU architecture detection
-  detectHeadless,    // standalone headless browser detection
-  VERSION,           // current library version
+  parseUA,              // pure function, ideal for SSR / Node.js
+  getNavContext,        // read current browser navigator context
+  getWindowsVersion,    // async: accurately distinguish Windows 10 / 11
+  getLanguage,          // extract browser language from NavContext
+  getEnvContext,        // collect all browser signals (Client Hints, WebGL, etc.)
+  parseHeaders,         // parse UA and Client Hints from HTTP headers (SSR)
+  ACCEPT_CH,            // response header constant to request Client Hints
+  isWebview,            // detect Android Webview / iOS WKWebView
+  detectBot,            // standalone bot detection
+  detectArch,           // standalone CPU architecture detection
+  detectHeadless,       // standalone headless browser detection
+  VERSION,              // current library version
 } from 'ua-browser'
 ```
 
@@ -152,7 +176,7 @@ import {
 | `osVersion` | `string` | OS version |
 | `device` | `DeviceName` | Device type: `Mobile` \| `Tablet` \| `TV` \| `PC` |
 | `arch` | `ArchName` | CPU architecture |
-| `isWebview` | `boolean` | Whether running in Android Webview |
+| `isWebview` | `boolean` | Whether running in Android Webview or iOS WKWebView |
 | `isHeadless` | `boolean` | Whether running in a headless / automated browser |
 | `isBot` | `boolean` | Whether the UA belongs to a bot / crawler |
 | `botName` | `BotName` | Bot name |
@@ -163,11 +187,11 @@ import {
 
 ## Supported
 
-Over 60 browsers, 17 operating systems, and 19 bot rules built in. See the **[full support list](https://yangtianxia.github.io/ua-browser/guide/support-list)**.
+Over 70 browsers, 17 operating systems, and 19 bot rules built in. See the **[full support list](https://yangtianxia.github.io/ua-browser/guide/support-list)**.
 
 Highlights:
-- **Browsers** — Chrome, Safari, Firefox, Edge, Samsung Internet, UC, WeChat, DingTalk, TikTok and more
-- **OS** — Windows, macOS, Android, iOS, HarmonyOS, Tizen, KaiOS and more
+- **Browsers** — Chrome, Safari, Firefox, Edge, Samsung Internet, UC, WeChat, DingTalk, TikTok, Bilibili, Kuaishou, Xiaohongshu, Feishu and more
+- **OS** — Windows, macOS, Android, iOS, HarmonyOS, OpenHarmony, Tizen, KaiOS and more
 - **AI bots** — GPTBot, ClaudeBot, PerplexityBot, CCBot and more
 - **Devices** — Mobile, Tablet, TV (Samsung Smart TV, HbbTV), PC
 

package/README.zh-CN.md

@@ -5,14 +5,16 @@
 [![license](https://img.shields.io/npm/l/ua-browser)](./LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-ready-3178c6)](https://www.typescriptlang.org/)
 
-通过 User Agent 检测浏览器、操作系统、设备类型、渲染内核、CPU 架构、爬虫及无头浏览器。零依赖，支持浏览器与 Node.js 双环境。
+通过 User Agent 检测浏览器、操作系统、设备类型、渲染内核、CPU 架构、爬虫、无头浏览器及小程序运行环境。零依赖，支持浏览器与 Node.js 双环境。
 
 **[📖 文档](https://yangtianxia.github.io/ua-browser/)** · **[🎮 Playground](https://yangtianxia.github.io/ua-browser/playground)** · **[English](./README.md)**
 
 ## 特性
 
-- **全面检测** — 浏览器、OS、渲染内核、设备类型（Mobile / Tablet / TV / PC）、CPU 架构、爬虫、无头浏览器
-- **AI 爬虫识别** — 内置 GPTBot、ClaudeBot、PerplexityBot 等主流 AI 抓取机器人
+- **全面 UA 检测** — 浏览器、OS、渲染内核、设备类型（Mobile / Tablet / TV / PC）、CPU 架构、爬虫、无头浏览器
+- **多信号架构检测** — `getEnvContext()` 采集 Client Hints、WebGL 渲染器、字体探针，精确区分 Apple Silicon 与 Intel Mac
+- **SSR Client Hints** — `parseHeaders()` + `ACCEPT_CH`，在 Chrome / Edge 90+ 中实现服务端精准检测（CPU 架构、平台等）
+- **AI 爬虫识别** — 内置 GPTBot、ClaudeBot、PerplexityBot、CCBot 等主流 AI 抓取机器人
 - **零依赖** — 无任何运行时依赖，gzip 后体积极小
 - **纯函数** — `parseUA()` 无全局状态，天然支持 SSR / Node.js
 - **TypeScript** — 完整类型定义，`BrowserName`、`OsName` 等均为精确字面量联合类型
@@ -67,16 +69,10 @@ const { browser, os, device } = uaBrowser()
 if (device === 'Mobile') {
   // 跳转移动版
 }
-
-if (browser === 'Wechat') {
-  // 微信内置浏览器逻辑
-}
 ```
 
 ### Node.js / SSR
 
-使用 `parseUA` 纯函数，传入请求头中的 UA 字符串：
-
 ```typescript
 import { parseUA } from 'ua-browser'
 
@@ -97,6 +93,34 @@ if (isBot) {
 </script>
 ```
 
+### 多信号架构检测
+
+`getEnvContext()` 一次性采集 Client Hints、WebGL 渲染器等多维信号，可区分 Apple Silicon 与 Intel Mac：
+
+```typescript
+import { getEnvContext, parseUA } from 'ua-browser'
+
+const ctx = await getEnvContext()
+const result = parseUA(navigator.userAgent, { ctx })
+
+console.log(result.arch) // 'arm64' 或 'x86_64'
+```
+
+### SSR Client Hints
+
+通过响应头告知 Chrome / Edge 90+ 上报 Client Hints，再用 `parseHeaders` 在服务端精准解析：
+
+```typescript
+import { parseHeaders, ACCEPT_CH } from 'ua-browser'
+
+// 第一次响应时写入 Accept-CH
+res.setHeader('Accept-CH', ACCEPT_CH)
+
+// 后续请求携带 Client Hints 后，精准识别架构等信息
+const result = parseHeaders(req.headers)
+console.log(result.arch) // 'x86_64'（来自 Sec-CH-UA-Arch）
+```
+
 ### 精确区分 Windows 10 / 11
 
 Windows 10 和 11 的 UA 字符串相同，需借助 Client Hints API 异步获取：
@@ -118,8 +142,6 @@ console.log(result.osVersion) // '10' 或 '11'
 在浏览器环境中自动注入 `navigator` 上下文（语言、平台、MIME 类型等）。
 
 ```typescript
-import uaBrowser from 'ua-browser'
-
 uaBrowser()           // 自动读取 navigator.userAgent
 uaBrowser(customUA)   // 传入自定义 UA，仍注入当前浏览器上下文
 ```
@@ -128,16 +150,18 @@ uaBrowser(customUA)   // 传入自定义 UA，仍注入当前浏览器上下文
 
 ```typescript
 import {
-  parseUA,           // 纯函数，适合 SSR / Node.js
-  getNavContext,     // 读取当前浏览器 navigator 上下文
-  getWindowsVersion, // 异步精确区分 Windows 10 / 11
-  getLanguage,       // 从 NavContext 获取浏览器语言
-  isWebview,         // 检测 Android Webview（UA 含 "; wv"）
-  isWechatMiniapp,   // 检测微信小程序运行环境
-  detectBot,         // 独立爬虫检测
-  detectArch,        // 独立 CPU 架构检测
-  detectHeadless,    // 独立无头浏览器检测
-  VERSION,           // 当前版本号
+  parseUA,              // 纯函数，适合 SSR / Node.js
+  getNavContext,        // 读取当前浏览器 navigator 上下文
+  getWindowsVersion,    // 异步精确区分 Windows 10 / 11
+  getLanguage,          // 从 NavContext 获取浏览器语言
+  getEnvContext,        // 采集所有浏览器环境信号（Client Hints、WebGL 等）
+  parseHeaders,         // 从 HTTP 请求头解析 UA 及 Client Hints（SSR）
+  ACCEPT_CH,            // 响应头常量，告知浏览器上报 Client Hints
+  isWebview,            // 检测 Android Webview / iOS WKWebView
+  detectBot,            // 独立爬虫检测
+  detectArch,           // 独立 CPU 架构检测
+  detectHeadless,       // 独立无头浏览器检测
+  VERSION,              // 当前版本号
 } from 'ua-browser'
 ```
 
@@ -152,7 +176,7 @@ import {
 | `osVersion` | `string` | 系统版本 |
 | `device` | `DeviceName` | 设备类型：`Mobile` \| `Tablet` \| `TV` \| `PC` |
 | `arch` | `ArchName` | CPU 架构 |
-| `isWebview` | `boolean` | 是否为 Android Webview |
+| `isWebview` | `boolean` | 是否为 Android Webview / iOS WKWebView |
 | `isHeadless` | `boolean` | 是否为无头 / 自动化浏览器 |
 | `isBot` | `boolean` | 是否为爬虫 / 机器人 |
 | `botName` | `BotName` | 爬虫名称 |
@@ -163,11 +187,11 @@ import {
 
 ## 支持范围
 
-内置超过 60 种浏览器、17 种操作系统、19 种爬虫规则，详见 **[内置支持列表](https://yangtianxia.github.io/ua-browser/guide/support-list)**。
+内置超过 70 种浏览器、17 种操作系统、19 种爬虫规则，详见 **[内置支持列表](https://yangtianxia.github.io/ua-browser/guide/support-list)**。
 
 部分覆盖：
-- **浏览器** — Chrome、Safari、Firefox、Edge、Samsung Internet、UC、微信、钉钉、抖音等
-- **操作系统** — Windows、macOS、Android、iOS、HarmonyOS、Tizen、KaiOS 等
+- **浏览器** — Chrome、Safari、Firefox、Edge、Samsung Internet、UC、微信、钉钉、抖音、哔哩哔哩、快手、小红书、飞书等
+- **操作系统** — Windows、macOS、Android、iOS、HarmonyOS、OpenHarmony、Tizen、KaiOS 等
 - **AI 爬虫** — GPTBot、ClaudeBot、PerplexityBot、CCBot 等
 - **设备** — Mobile、Tablet、TV（含三星 Smart TV、HbbTV 标准）、PC
 

package/dist/index.cjs

@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 // package.json
 var package_default = {
-  version: "1.2.0"};
+  version: "1.3.1"};
 
 // src/constants/browsers.ts
 var BROWSER_DEFS = [
@@ -432,7 +432,7 @@ function getLanguage(nav) {
 
 // src/parse.ts
 function parseUA(ua, options = {}) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   const effectiveNav = (_a = options.ctx) != null ? _a : options.nav;
   const effectiveWindowsVersion = (_c = (_b = options.ctx) == null ? void 0 : _b.windowsVersion) != null ? _c : options.windowsVersion;
   const { browser: rawBrowser, version: rawVersion } = detectBrowser(ua);
@@ -497,54 +497,6 @@ function parseUA(ua, options = {}) {
     } catch (e) {
     }
   }
-  if (browser === "Wechat") {
-    try {
-      if (typeof __wxjs_environment !== "undefined" && __wxjs_environment === "miniprogram") {
-        browser = "Wechat Miniapp";
-      }
-    } catch (e) {
-    }
-  }
-  if (browser === "Alipay") {
-    try {
-      if (typeof window !== "undefined" && typeof ((_i = window.my) == null ? void 0 : _i.getSystemInfo) === "function") {
-        browser = "Alipay Miniapp";
-      }
-    } catch (e) {
-    }
-  }
-  if (browser === "Baidu") {
-    try {
-      if (typeof swan !== "undefined" && typeof (swan == null ? void 0 : swan.getSystemInfo) === "function") {
-        browser = "Baidu Miniapp";
-      }
-    } catch (e) {
-    }
-  }
-  if (browser === "Douyin") {
-    try {
-      if (typeof tt !== "undefined" && typeof (tt == null ? void 0 : tt.getSystemInfo) === "function") {
-        browser = "Douyin Miniapp";
-      }
-    } catch (e) {
-    }
-  }
-  if (browser === "QQ") {
-    try {
-      if (typeof qq !== "undefined" && typeof (qq == null ? void 0 : qq.getSystemInfo) === "function") {
-        browser = "QQ Miniapp";
-      }
-    } catch (e) {
-    }
-  }
-  if (browser === "Kuaishou") {
-    try {
-      if (typeof ks !== "undefined" && typeof (ks == null ? void 0 : ks.getSystemInfo) === "function") {
-        browser = "Kuaishou Miniapp";
-      }
-    } catch (e) {
-    }
-  }
   if (os === "iOS" && browser === "Safari") {
     const m = /Version\/([\d.]+)/.exec(ua);
     if (m && parseInt(m[1], 10) > parseInt(osVersion, 10)) {
@@ -569,21 +521,6 @@ function parseUA(ua, options = {}) {
   };
 }
 
-// src/utils/windows-version.ts
-async function getWindowsVersion(nav) {
-  var _a;
-  if (!nav.userAgentData || nav.userAgentData.platform !== "Windows") {
-    return null;
-  }
-  try {
-    const data = await nav.userAgentData.getHighEntropyValues(["platformVersion"]);
-    const major = parseInt(((_a = data["platformVersion"]) == null ? void 0 : _a.split(".")[0]) || "0", 10);
-    return major >= 13 ? "11" : "10";
-  } catch (e) {
-    return null;
-  }
-}
-
 // src/utils/env-context.ts
 var OS_FONTS = [
   ".AppleSystemUIFont",
@@ -650,7 +587,16 @@ function deriveWindowsVersion(platformVersion) {
 }
 async function getEnvContext() {
   const base = getNavContext();
-  const ctx = { ...base };
+  const ctx = {
+    userAgent: base.userAgent,
+    platform: base.platform,
+    language: base.language,
+    maxTouchPoints: base.maxTouchPoints
+  };
+  if (base.browserLanguage !== void 0) ctx.browserLanguage = base.browserLanguage;
+  if (base.mimeTypes !== void 0) ctx.mimeTypes = base.mimeTypes;
+  if (base.connection !== void 0) ctx.connection = base.connection;
+  if (base.userAgentData !== void 0) ctx.userAgentData = base.userAgentData;
   if (typeof navigator !== "undefined") {
     ctx.hardwareConcurrency = navigator.hardwareConcurrency;
     ctx.deviceMemory = navigator.deviceMemory;
@@ -689,6 +635,21 @@ async function getEnvContext() {
   return ctx;
 }
 
+// src/utils/windows-version.ts
+async function getWindowsVersion(nav) {
+  var _a;
+  if (!nav.userAgentData || nav.userAgentData.platform !== "Windows") {
+    return null;
+  }
+  try {
+    const data = await nav.userAgentData.getHighEntropyValues(["platformVersion"]);
+    const major = parseInt(((_a = data["platformVersion"]) == null ? void 0 : _a.split(".")[0]) || "0", 10);
+    return major >= 13 ? "11" : "10";
+  } catch (e) {
+    return null;
+  }
+}
+
 // src/parse-headers.ts
 var ACCEPT_CH = [
   "Sec-CH-UA-Arch",
@@ -743,60 +704,15 @@ function parseHeaders(headers) {
 
 // src/index.ts
 var { version: VERSION } = package_default;
-var isWechatMiniapp = () => {
-  try {
-    return typeof __wxjs_environment !== "undefined" && __wxjs_environment === "miniprogram";
-  } catch (e) {
-    return false;
-  }
-};
-var isAlipayMiniapp = () => {
-  var _a;
-  try {
-    return typeof window !== "undefined" && typeof ((_a = window.my) == null ? void 0 : _a.getSystemInfo) === "function";
-  } catch (e) {
-    return false;
-  }
-};
-var isBaiduMiniapp = () => {
-  try {
-    return typeof swan !== "undefined" && typeof (swan == null ? void 0 : swan.getSystemInfo) === "function";
-  } catch (e) {
-    return false;
-  }
-};
-var isDouyinMiniapp = () => {
-  try {
-    return typeof tt !== "undefined" && typeof (tt == null ? void 0 : tt.getSystemInfo) === "function";
-  } catch (e) {
-    return false;
-  }
-};
-var isQQMiniapp = () => {
-  try {
-    return typeof qq !== "undefined" && typeof (qq == null ? void 0 : qq.getSystemInfo) === "function";
-  } catch (e) {
-    return false;
-  }
-};
-var isKuaishouMiniapp = () => {
-  try {
-    return typeof ks !== "undefined" && typeof (ks == null ? void 0 : ks.getSystemInfo) === "function";
-  } catch (e) {
-    return false;
-  }
-};
 function uaBrowser(ua) {
   const nav = getNavContext();
   return parseUA(ua != null ? ua : nav.userAgent, { nav });
 }
+uaBrowser.detect = async (ua) => {
+  const ctx = await getEnvContext();
+  return parseUA(ua != null ? ua : ctx.userAgent, { ctx });
+};
 uaBrowser.isWebview = isWebview;
-uaBrowser.isWechatMiniapp = isWechatMiniapp;
-uaBrowser.isAlipayMiniapp = isAlipayMiniapp;
-uaBrowser.isBaiduMiniapp = isBaiduMiniapp;
-uaBrowser.isDouyinMiniapp = isDouyinMiniapp;
-uaBrowser.isQQMiniapp = isQQMiniapp;
-uaBrowser.isKuaishouMiniapp = isKuaishouMiniapp;
 uaBrowser.getLanguage = () => getLanguage(getNavContext());
 uaBrowser.VERSION = VERSION;
 var src_default = uaBrowser;
@@ -811,13 +727,7 @@ exports.getEnvContext = getEnvContext;
 exports.getLanguage = getLanguage;
 exports.getNavContext = getNavContext;
 exports.getWindowsVersion = getWindowsVersion;
-exports.isAlipayMiniapp = isAlipayMiniapp;
-exports.isBaiduMiniapp = isBaiduMiniapp;
-exports.isDouyinMiniapp = isDouyinMiniapp;
-exports.isKuaishouMiniapp = isKuaishouMiniapp;
-exports.isQQMiniapp = isQQMiniapp;
 exports.isWebview = isWebview;
-exports.isWechatMiniapp = isWechatMiniapp;
 exports.parseHeaders = parseHeaders;
 exports.parseUA = parseUA;
 //# sourceMappingURL=index.cjs.map