GPUBindGroup:label 属性

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

安全上下文:此功能仅在 安全上下文(HTTPS)中可用,在某些或所有 支持的浏览器 中可用。

label 属性是 GPUBindGroup 接口的一个属性,它提供了一个标签,可用于标识该对象,例如在 GPUError 消息或控制台警告中。

可以通过在传递给源 GPUDevice.createBindGroup() 调用的描述符对象中提供 label 属性来设置它,或者您可以直接在 GPUBindGroup 对象上获取和设置它。

一个字符串。如果之前没有按照上述方法设置,它将是一个空字符串。

示例

通过 GPUBindGroup.label 设置和获取标签

js
// ...

const bindGroup = device.createBindGroup({
  layout: bindGroupLayout,
  entries: [
    {
      binding: 0,
      resource: {
        buffer: output,
      },
    },
  ],
});

bindGroup.label = "mybindgroup";

console.log(bindGroup.label); // "mybindgroup";

通过源 GPUDevice.createBindGroup() 调用设置标签,然后通过 GPUBindGroup.label 获取它

js
// ...

const bindGroup = device.createBindGroup({
  layout: bindGroupLayout,
  entries: [
    {
      binding: 0,
      resource: {
        buffer: output,
      },
    },
  ],
  label: "mybindgroup",
});

console.log(bindGroup.label); // "mybindgroup";

规范

规范
WebGPU
# dom-gpuobjectbase-label

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅