如何在Node.js（Express）服务端使用userAgentData API？

核心问题 #

navigator 及 userAgentData 是浏览器专属的前端API，Node.js服务端环境中根本不存在这个全局对象——不管你用HTTP还是HTTPS协议，在Express服务端代码里访问 global.navigator 都会返回 undefined。

正确实现方式 #

要获取用户的UA相关数据，必须在浏览器端代码中调用 navigator.userAgentData，再把数据通过请求发送到Express服务端：

1. 浏览器端代码：

// 仅在浏览器环境执行
if ('userAgentData' in navigator) {
  const uaData = await navigator.userAgentData.getHighEntropyValues(['platform', 'platformVersion', 'architecture']);
  // 将数据发送至服务端
  fetch('/submit-ua-data', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(uaData)
  });
}

2. Express服务端代码：

// 服务端接收前端传来的UA数据
app.post('/submit-ua-data', express.json(), (req, res) => {
  const userAgentData = req.body;
  console.log('用户UA数据:', userAgentData);
  res.status(200).send('数据接收成功');
});

服务端替代方案 #

如果只需要基础UA信息，可直接从请求头的 User-Agent 字段获取：

app.get('/', (req, res) => {
  const basicUA = req.get('User-Agent');
  console.log('基础UA:', basicUA);
  res.send('Hello World');
});

注意：这个字段是传统字符串格式，没有 userAgentData 提供的结构化高熵数据。

内容的提问来源于stack exchange，提问作者Yhshsh