GPUDevice：label 属性

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

注意：此功能在 Web Workers 中可用。

GPUDevice 接口的只读属性 label 是一个字符串，用于提供一个标签，方便在 GPUError 消息或控制台警告中标识该对象。

值

一个字符串。如果之前没有设置标签值，则获取标签会返回一个空字符串。

示例

async function init() {
  if (!navigator.gpu) {
    throw Error("WebGPU not supported.");
  }

  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) {
    throw Error("Couldn't request WebGPU adapter.");
  }

  // Create a GPUDevice
  const device = await adapter.requestDevice();

  // Set a label
  device.label = "my_label";

  // Get a label
  console.log(device.label);

  // …
}

规范

规范
WebGPU # dom-gpuobjectbase-label

浏览器兼容性

另见

WebGPU API

帮助改进 MDN

了解如何贡献

此页面最后一次修改于 2025年6月18日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题