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

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

UAParser.js - The Essential Web Development Tool for User-Agent Detection. Detect Browsers, OS, Devices, Bots, Apps, AI Crawlers, and more. Run 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 - The Essential Web Development Tool for User-Agent Detection. Detect Browsers, OS, Devices, Bots, Apps, AI Crawlers, and more. Run in Browser (client-side) or Node.js (server-side).

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

登录后查看全文

项目优选

收起

deepin linux kernel

ops-transformer

本项目是CANN提供的transformer类大模型算子库，实现网络在NPU上加速计算。

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

Ascend Extension for PyTorch

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

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

flutter_flutter

本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本，由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用，3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。

昇腾LLM分布式训练框架

CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。