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

瀏覽器相容性

另見