GPUBindGroup: label 属性

可用性有限

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

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

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

这可以通过在传递给原始 GPUDevice.createBindGroup() 调用的描述符对象中提供 label 属性来设置,也可以直接在 GPUBindGroup 对象上进行获取和设置。

一个字符串。如果之前未按上述方式设置,则为空字符串。

示例

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

js
// …

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

bindGroup.label = "my_bind_group";

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

通过原始 GPUDevice.createBindGroup() 调用设置标签,然后通过 GPUBindGroup.label 获取该标签。

js
// …

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

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

规范

规范
WebGPU
# dom-gpuobjectbase-label

浏览器兼容性

另见