UAParser.js 教程：用户代理解析库

2026-01-17 08:50:22作者：牧宁李

UAParser.js - Free & open-source JavaScript library to detect user's Browser, Engine, OS, CPU, and Device type/model. Runs either in browser (client-side) or node.js (server-side).

项目地址：https://gitcode.com/gh_mirrors/ua/ua-parser-js

1. 项目介绍

UAParser.js 是一个轻量级且高效的JavaScript库，用于解析浏览器的User-Agent字符串。它能够识别各种设备（包括移动设备和平板电脑）、操作系统、浏览器名称及其版本，以及CPU架构等信息。这个库支持客户端和服务器端的JavaScript环境，包括浏览器和Node.js。

2. 项目快速启动

安装依赖

如果你使用npm管理项目，可以这样安装：

npm install ua-parser-js

或者，你可以直接在HTML文件中引入CDN链接：

<script src="https://cdn.jsdelivr.net/npm/ua-parser-js@latest/dist/ua-parser.min.js"></script>

使用示例

Node.js

const UAParser = require('ua-parser-js');
const parser = new UAParser();
console.log(parser.getResult());

浏览器

<!DOCTYPE html>
<html>
<head>
    <script src="ua-parser.min.js"></script>
    <script>
        var parser = new UAParser();
        console.log(parser.getResult());
    </script>
</head>
<body></body>
</html>

上述代码会打印出关于当前用户设备的信息。

自定义User-Agent字符串

var parser = new UAParser();
parser.setUA("Mozilla/5.0 (iPhone; CPU iPhone OS 14_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1 Mobile/15E148 Safari/604.1");
console.log(parser.getResult());

这将解析指定的User-Agent字符串。

3. 应用案例和最佳实践

优化用户体验：通过识别用户使用的浏览器类型，调整网站布局或功能以提供更好的兼容性。
数据分析：收集和分析用户设备数据，了解访问者群体的主要特征。
广告定向：根据用户设备类型展示相应的广告。
安全检测：识别可能的恶意浏览器或不受支持的系统，采取预防措施。

最佳实践是保持库更新，以便获取最新的User-Agent识别规则。

4. 典型生态项目

jQuery 插件：UAParser.js 提供了与jQuery集成的插件，方便在jQuery项目中使用。
TypeScript 类型定义：对于TypeScript开发者，该库提供了预定义的类型，提高开发体验。
其他解析工具：UAParser.js 可与其他用户代理处理库结合，如Bowser，实现更复杂的用户代理解析。

要了解更多详细信息，包括完整的API文档和贡献指南，请参考官方GitHub仓库：https://github.com/faisalman/ua-parser-js。

UAParser.js - Free & open-source JavaScript library to detect user's Browser, Engine, OS, CPU, and Device type/model. Runs either in browser (client-side) or node.js (server-side).

项目地址：https://gitcode.com/gh_mirrors/ua/ua-parser-js

登录后查看全文

热门内容推荐

1 【亲测免费】开源项目 `build-your-own-x` 使用指南 2 【亲测免费】探索科技之旅：《Build Your Own X》项目详解 3 GitHub_Trending/bu/build-your-own-x自动化：CI/CD流程在自制项目中的应用 4 从零打造智能家居系统：用build-your-own-x实现家庭自动化

最新内容推荐

Degrees of Lewdity中文汉化终极指南：零基础玩家必看的完整教程 Unity游戏翻译神器：XUnity Auto Translator 完整使用指南 PythonWin7终极指南：在Windows 7上轻松安装Python 3.9+终极macOS键盘定制指南：用Karabiner-Elements提升10倍效率 Pandas数据分析实战指南：从零基础到数据处理高手 Qwen3-235B-FP8震撼升级：256K上下文+22B激活参数 7步搞定机械键盘PCB设计：从零开始打造你的专属键盘终极WeMod专业版解锁指南：3步免费获取完整高级功能 DeepSeek-R1-Distill-Qwen-32B技术揭秘：小模型如何实现大模型性能突破音频修复终极指南：让每一段受损声音重获新生

项目优选

收起

deepin linux kernel

OpenHarmony documentation | OpenHarmony开发者文档

flutter_flutter

Ascend Extension for PyTorch

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端

ohos_react_native

React Native鸿蒙化仓库

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

openJiuwen agent-studio提供零码、低码可视化开发和工作流编排，模型、知识库、插件等各资源管理能力