如何通过 AJAX 将 window.screen 信息安全、可靠地传递到后端

如何通过 AJAX 将 window.screen 信息安全、可靠地传递到后端

`window.screen` 是一个不可直接序列化的 dom 对象,直接赋值给 ajax 的 `data` 会导致请求静默失败;需手动提取其可枚举属性(如 `width`、`height`、`colordepth` 等)构建纯 json 对象后再发送。

前端后端通信中,我们常希望收集用户设备的屏幕信息(例如用于响应式统计、A/B 测试或风控识别)。但 window.screen 并非普通 JavaScript 对象——它是一个宿主对象(host object),其大部分属性为不可枚举(non-enumerable),且部分属性(如 orientation)含有循环引用或 getter-only 访问器。这意味着:

  • ✅ JSON.stringify(window.screen) 会返回 {}(空对象);
  • ❌ 直接将 window.screen 赋值给 data(如 data.w = window.screen)会导致 jQuery 的 $.ajax 在序列化阶段静默失败(尤其在 contentType: ‘application/x-www-form-urlencoded’ 或默认表单编码模式下),网络面板中甚至不显示请求发出;
  • ? 浏览器控制台通常不会报错,仅表现为 success 回调不触发、error 回调也未进入——这是典型的序列化阻断行为。

正确做法:显式提取关键属性

只需创建一个轻量级 Plain Object,手动复制你真正需要的、可安全 JSON 序列化的属性

craiyon

craiyon

在线 AI 图像生成器

下载

const screenData = {
  width: window.screen.width,
  height: window.screen.height,
  availWidth: window.screen.availWidth,
  availHeight: window.screen.availHeight,
  colorDepth: window.screen.colorDepth,
  pixelDepth: window.screen.pixelDepth,
  // 注意:orientation 是一个对象,需进一步扁平化(仅取必要字段)
  orientationType: window.screen.orientation?.type || 'unknown',
  orientationAngle: window.screen.orientation?.angle || 0
};

$.ajax({
  method: 'POST',
  url: '/tested-route',
  crossDomain: true,
  contentType: 'application/json; charset=utf-8', // 明确声明 JSON 类型
  headers: {
    'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('value'),
    'Accept': 'application/json'
  },
  data: JSON.stringify(screenData), // ⚠️ 必须手动 stringify
  success: function(response) {
    console.log('Screen data sent successfully:', response);
  },
  error: function(jqXHR, textStatus, errorThrown) {
    console.error('AJAX failed:', textStatus, errorThrown);
    console.log('Response:', jqXHR.responseText);
  }
});

关键注意事项:

  • 不要混用 contentType: false 和 JSON 数据:contentType: false 会禁用自动头设置,适用于 FormData 上传,但与 JSON.stringify() 冲突。此处应设为 ‘application/json‘ 并手动序列化。
  • 避免访问不可靠属性:window.screen.orientation 在部分旧浏览器或 iframe 中可能为 undefined,务必使用可选链(?.)或兜底值。
  • 服务端需匹配解析逻辑:后端应按标准 JSON 解析(如 Express 中使用 express.json() 中间件),而非尝试解析表单格式。
  • 隐私与合规提醒:screen 信息虽不属 GDPR 严格定义的“个人数据”,但在某些场景(如精准设备指纹)下可能涉及隐私政策要求,建议在采集前明确告知用户并提供开关选项。

总结

传递 window.screen 的本质不是“发送对象”,而是“上报特征”。始终遵循「提取 → 扁平化 → 序列化」三步原则,既保证兼容性,又提升可维护性与调试效率。对于更复杂的客户端环境探测(如 DPR、touch support、prefers-reduced-motion),同样适用该范式——只传所需,不传对象。

https://www.php.cn/faq/2002654.html

发表回复

Your email address will not be published. Required fields are marked *