返回知识中心
指纹

WebGPU 适配器信息与用户隐私

了解 WebGPU 适配器代表什么、何时不可用,以及如何在不收集设备画像的情况下选择图形回退方案。

BotBrowser Team

文档中心

想直接进入 指纹 文档吗?

这篇文章属于知识中心的指南库。若你要步骤化配置、参考说明和持续更新,请直接进入对应 docs 分区。

WebGPU 让应用请求能够运行 WebGPU 设备的图形适配器。适配器是任务能力的边界,不是用户身份。它是否可用取决于浏览器、操作系统、图形栈、策略和当前资源。重视隐私的应用只询问选择可用体验所需的信息,并在请求失败时提供清晰的回退。BotBrowser 可以在受控上下文中让同一份配置的 WebGPU 适配器信息保持一致,但不能让底层硬件或驱动支持它本来不具备的功能。

WebGPU 适配器请求、设备创建与可访问回退流程

TL;DR

  • navigator.gpu.requestAdapter() 可能返回 null;这是一条兼容性分支,不是需要上报的故障。
  • 只检查当前模式真正需要的项, adapter.features.has('timestamp-query')、adapter.limits.maxTextureDimension2D, 不要遍历所有字段。
  • requestDevice({ requiredFeatures, requiredLimits }) 在请求的特性或上限不受支持时失败,因此只申请模式所需的最小集合。
  • 能力数据只在本次会话内存在:不要把 adapter 上限写进分析标签、URL、账户记录或支持工单。
  • 把必需内容和控件放在普通 HTML 中,并把降级场景、静态图片或数据表作为文档化的回退。

目录

适配器代表什么

W3C WebGPU 规范把适配器定义为代表物理或软件图形实现的对象,应用可据此创建设备。应用可以请求适配器,再按所需限制和特性请求设备;浏览器也可以不返回适配器。适配器不保证所有实现具有相同特性,也不保证设备一定能创建成功。

因此,适配器不同于完整的渲染器清单。应用应先确定可见目标,例如交互场景、计算任务或降低效果的模式。MDN 的 WebGPU API 参考介绍公开 API,但不代表所有浏览器都支持。关于能力检查与跟踪的区别,可参阅 WebGL 能力与隐私指南。

可用性与权限边界

只有在当前上下文中实现并允许 WebGPU 的浏览器,才会暴露 navigator.gpu。适配器请求可能失败或没有结果;即使拿到适配器,设备请求也可能因所需特性、限制或资源不可用而失败。应把这些视为正常的兼容性分支,而不是某个人或某台独特设备的证据。

W3C 规范定义 API 合同,浏览器文档说明各版本的可用性与限制。不要声称 WebGPU 普遍可用,也不要承诺适配器请求一定出现提示或返回稳定字段。产品应记录已测试的浏览器范围,并让不支持的路径仍然可用。

隐私友好的应用决策

使用能选择体验的最小决定。如果只需判断基础设备是否可用,就记录请求成功及所需特性是否满足。不要保存完整适配器描述,不要把图形信息与账户或网络数据合并,也不要把能力差异变成持久标识。会话内的决定通常足够;需要记住质量偏好时,应保存用户明确选择,而不是推断出的设备画像。

诊断有独立目的。支持人员确实需要更多信息时,应说明收集内容、限制访问并设定保留期限。默认不要要求用户提交适配器清单。跨表面浏览器隐私指南说明了多个普通信号合并后的隐私影响。

回退与可访问恢复

把必要内容和控件放在图形表面之外。适配器或设备创建失败时,提供降低效果的场景、静态图像、数据表或能完成同一任务的其他表示。切换时保留筛选条件和用户输入,并说明变化及下一步;不要留下空白画布或无限重试。

测试成功、无适配器、设备请求被拒、资源失败和后续上下文丢失。验收目标是可用状态,而不是详细解释用户硬件。名称、状态消息、键盘控件和等价信息应使用普通 HTML,保证回退可访问。WebGPU 指纹概览讨论另一类跟踪风险;这里仅讨论正常应用的能力决策。

围绕用户结果规划请求

适配器请求应在产品流程中有明确责任。调用前先定义用户要完成的任务、必需的视觉或计算结果,以及哪些部分只是增强效果。例如产品查看器可能需要旋转和选择,但阴影可以是可选项;科学工具可能必须显示图表和标签,而动画只是增强;视频效果可能需要特定纹理路径,但路径无法启动时仍应提供静态图像。这样应用在得到足够信息选择支持模式后就会停止探测。

不要仅因为页面加载就调用 navigator.gpu.requestAdapter()。等用户进入功能后再进行昂贵工作,并把导航、账户操作、购买控件、同意选择和帮助链接保持为普通 HTML。图形表面应支持工作流程,而不是成为唯一入口;浏览器回收资源或用户切换回退时,这种结构也能保留状态。

把请求当作短暂的兼容性事务:先准备界面,申请适配器,只检查计划模式需要的特性和限制,申请设备,然后报告少数明确结果。结果可以是标准模式、降低效果模式、静态替代或不可用并提供支持指引。少量有责任人的结果比设备专属分支矩阵更容易说明和测试。

适配器存在但 adapter.features.has('timestamp-query') 为 false 而计划模式又需要它时,不要继续探测无关字段。说明哪个用户可见功能不可用并选择已记录的低级模式。把这种失败与网络资源缺失或服务器超时分开,因为补救措施不同,也不应触发同一套诊断收集。

让能力数据短期存在

能力数据应有明确生命周期。页面可以在本次访问的内存中保存 adapter.limits.maxTextureDimension2D 并据此选择场景尺寸,结束会话时丢弃,不必写入存储或上传服务器。如果用户要求记住质量偏好,应保存“降低效果”等用户选择,而不是导致该选择的适配器事实集合。这能保留用户控制权,也允许之后修改。

不要把适配器对象或详细特性列表复制到分析标签、账户记录、URL、截图或支持工单。支持事件通常只需写“标准 WebGPU 场景初始化失败”、脱敏的流程阶段和应用版本。若确实需要更多诊断,应在该案例中说明原因、限制访问并按记录的期限删除。

图形能力不是敏感推断的可靠依据,不能证明身份、位置、收入、残障、意图或设备所有权。不要把它与账户、网络、字体、存储或计时信号结合成画像。适配器暴露某项限制只表示当前图形路径能做什么,不表示浏览器由谁使用。

第三方引擎和可观测性库也要审查:是否向远端发送适配器细节,传输是否为渲染所必需,服务保留多久。为方便加载的依赖不会免除应用对数据流的责任。禁用可选遥测时,核心图形流程仍应可用。

把失败路径当作产品行为

下面的可复制示例只检查 WebGPU 设备路径能否启动。它不会创建图形工作负载、检查适配器信息或读取图形输出。将两个内容区替换为应用的实际视图及等价 HTML 回退;startGraphics 接受注入的测试对象,因此可在不依赖特定机器的情况下测试适配器返回空值。

<p id="graphics-status" role="status" aria-live="polite">Preparing graphics…</p>
<section id="gpu-view" hidden>WebGPU path is ready; this example draws nothing.</section>
<section id="html-view">Standard content and controls remain available.</section>
<script>
  const status = document.querySelector('#graphics-status');
  const gpuView = document.querySelector('#gpu-view');
  const htmlView = document.querySelector('#html-view');
  function showFallback() {
    gpuView.hidden = true;
    htmlView.hidden = false;
    status.textContent = 'Enhanced graphics are unavailable. Standard content is ready.';
  }
  async function startGraphics(gpu = navigator.gpu) {
    try {
      if (!gpu) throw new Error('unavailable');
      const adapter = await gpu.requestAdapter();
      if (!adapter) throw new Error('unavailable');
      const device = await adapter.requestDevice();
      gpuView.hidden = false;
      htmlView.hidden = true;
      status.textContent = 'The WebGPU device path is ready.';
      device.lost.then(showFallback);
    } catch {
      showFallback();
    }
  }
  void startGraphics();
  // Failure fixture: expect the HTML view to remain visible and no retry to run.
  // void startGraphics({ requestAdapter: async () => null });
</script>

此示例只检查 API 能否启动,不生成或读取像素,因此结果不是图形指纹。要测试失败,请取消注释 fixture 调用并替换普通调用;预期是 HTML 视图保持可见且不会重试。适配器或设备请求被拒绝时也进入同一回退。筛选、选择和未保存内容应保存在 GPU 设备之外,保证切换后仍存在。

观察结果面向用户的结果当前任务仅保留
没有 navigator.gpu保持标准 HTML 体验可用不保存适配器数据
适配器请求返回 null 或被拒绝使用已说明的静态或精简替代方案最多在内存中保留所选模式
设备请求被拒绝保留页面状态并显示同一回退仅在支持排查需要时记录失败阶段
已创建的设备丢失返回回退并提供明确的重试操作不保留原始适配器或设备对象
设备创建成功只启动用户请求的工作负载不再需要时释放适配器引用

测试 API 缺失、适配器返回空值或拒绝、设备请求被拒绝及设备丢失。如果应用依赖某个可选特性,就按实际任务测试该特性;不要枚举无关特性来给环境分类。验收标准是页面仍可使用,而不是详细解释硬件。使用注入的 fixture 验证可见状态和回退,不依赖特定浏览器的适配器值。

每个状态都要考虑可访问性。给视觉区域提供描述用途的可访问名称,而不是只写“WebGPU canvas”。把说明、价格、法律文字、状态和重要数值放在页面内容中,使其可阅读、翻译、放大和复制。重置、暂停、视图选择和回退应是可获得键盘焦点的普通控件。

启动非必要运动前尊重减少动画偏好。关闭动画时提供稳定视图,不要把重要状态变化藏在视觉效果中。若回退是表格、图片库或摘要,必须使用与图形视图相同的筛选条件和数据;两个表示不一致会造成正确性问题。

恢复过程应有界。短暂资源丢失后一次重试可能合理,但重复请求会让用户等待并制造噪声日志。达到上限后说明正在使用简单视图,同时保持页面其余部分可用。若未保存工作只存在 GPU 设备中,应如实说明;否则把应用状态放在普通页面数据中。

记录支持契约:已测试浏览器范围、所需 WebGPU 代际、每种模式的特性、适配器不可用时的回退,以及负责复核变更的人。用户需求或证据变化时更新契约;仅凭浏览器发布不能承诺到处相同。

计算工作负载也遵循同一纪律。申请适配器前先定义用户应得到的结果、可接受等待时间和非 GPU 表示。报告可以提供可下载表格,媒体工具可以在预览不可用时继续提供剪辑与元数据控件,模拟工具可以显示暂停状态和摘要值。

特性和限制检查应有明确负责人。渲染团队负责场景要求,可访问性团队负责等价内容,隐私团队负责保留和披露。需求变化时同时更新模式契约与回退;每个读取的值都应回答记录在案的产品问题。

浏览器更新可能改变可用性,却不改变用户任务。把新结果当作兼容性观察,记录版本和可见结果,再决定模式是否仍可用。不要把临时观察悄悄变成长期画像字段;“已选择降低效果场景”通常比适配器限制列表更有用。

错误消息应使用普通产品语言:增强图形不可用,但简单视图仍可用。只有重试有意义时才解释重试。用户不需要时不要命名驱动、厂商或型号,避免技术诊断成为意外披露。

缓存也要遵守最小化原则。若 service worker 或本地存储记住图形选择,应定义用途和过期策略,功能退役时删除。用户清除站点数据后,应用应能重新作出能力决定,而不是把新会话当作异常。

受管理环境应尊重管理员策略。策略可能禁用 WebGPU、限制资源或让特定上下文不可用。产品仍应提供有用回退,不应要求用户削弱安全或隐私控制。支持文档可以标明策略导致的失败,但不应要求完整环境报告。

网络边界与适配器边界不同。加载着色器、模型、纹理或数据集可能需要远程请求,即使适配器在本地。说明哪部分失败,遵守服务访问规则,不要把每个网络错误归咎于图形支持。

只保留有现任负责人的运行事件。小型事件可以包含所选模式、失败阶段、粗粒度应用版本和按常规策略处理的时间戳,但不应包含原始适配器对象、完整特性数组、账户标识或无关浏览器信号。支持问题变化时删除不再回答问题的字段。

回退应在设计评审阶段完成,而不是最后才出现的错误页。给它与首选模式相同的内容层级、标签和必要操作。若视觉呈现结果,应在文本或结构化数据中重复;若视觉承载操作,应提供有名称的控件。

图形任务可选时,侵入最小的路径可以作为默认。让用户主动打开增强视图并容易返回标准页面。用户选择比从能力值推断兴趣更清楚,也能减少不必要初始化。记录测试路径和回退负责人,避免过时假设继续影响支持说明。

发布兼容性变更前,用当前 W3C 规范和 MDN 文档复核公开声明。标准描述 API 契约,不保证每个浏览器、系统或策略配置都成功。产品保证应窄于证据,并把测试行为标为测试行为;功能退役时同时移除适配器检查、缓存决定、分析字段和支持说明。

页面应在调用 API 前先准备可见状态。

能力决定不等于可以识别设备。

适配器缺失可能只与当前上下文有关。

设备创建成功后仍可能丢失。

BotBrowser 支持 WebGPU 的 profile、real 和 disabled 模式,使适配器行为与选定 profile 对齐;但不保证所有浏览器 backend 和宿主都支持 WebGPU,也不保证适配器能力相同。

来源

实践结论

上线时交付四种归属明确的结果, 标准模式、降级模式、静态替代、不可用并给出指引, 并让每种结果都能在不依赖特定 GPU 的测试中触达。把设备丢失(原因 destroyed 或 unknown)当作可恢复状态,保证 HTML 视图仍然可用,而不是死胡同。

把浏览器版本、宿主图形路径和 profile 与每条已接受行一起记录,并在驱动、浏览器或宿主镜像变化后重新测量。在某台机器上能启动的模式,只是该行的证据,不是对其他宿主的承诺。

#WebGPU#适配器#隐私#能力检测#回退

本文属于指南: 什么是浏览器指纹?原理、风险、信号与隐私边界

在 BotBrowser 里跑一遍同样的检查

加载 profile,让刚读到的这些信号在浏览器内部保持一致,并在正式上线前先在自己的机器上确认结果。