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实现家庭自动化

最新内容推荐

pi-mono自定义工具开发实战指南：从入门到精通 3个实时风控价值：Flink CDC+ClickHouse在金融反欺诈的实时监测指南 Docling 实用指南：从核心功能到配置实践自动化票务处理系统在高并发抢票场景中的技术实现：从手动抢购痛点到智能化解决方案 OpenCore Legacy Patcher显卡驱动适配指南：让老Mac焕发新生 7个维度掌握Avalonia：跨平台UI框架从入门到架构师 Warp框架安装部署解决方案：从环境诊断到容器化实战指南突破移动瓶颈：kkFileView的5层适配架构与全场景实战指南革新智能交互：xiaozhi-esp32如何实现百元级AI对话机器人如何打造专属AI服务器？本地部署大模型的全流程实战指南

项目优选

收起

deepin linux kernel

OpenHarmony documentation | OpenHarmony开发者文档

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

flutter_flutter

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

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

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。

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

RuoYi-Cloud-Vue3

🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统

昇腾LLM分布式训练框架