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

登录后查看全文

项目优选

收起

deepin linux kernel

OpenHarmony documentation | OpenHarmony开发者文档

Ascend Extension for PyTorch

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

flutter_flutter

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

昇腾LLM分布式训练框架

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

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