GPUCommandBuffer: label 屬性

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

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

label 是 GPUCommandBuffer 介面的一個只讀屬性，它提供了一個字串標籤，可用於識別該物件，例如在 GPUError 訊息或控制檯警告中。

可以透過在傳入到原始 GPUCommandEncoder.finish() 呼叫的描述符物件中提供 label 屬性來設定此標籤，也可以直接在 GPUCommandBuffer 物件上獲取和設定它。

值

一個字串。如果之前沒有設定標籤值，則獲取標籤會返回一個空字串。

透過 GPUCommandBuffer.label 設定和獲取標籤

const commandBuffer = commandEncoder.finish();
commandBuffer.label = "my_command_buffer";
console.log(commandBuffer.label); // "my_command_buffer"

透過原始 GPUCommandEncoder.finish() 呼叫設定標籤，然後透過 GPUCommandBuffer.label 獲取它

const commandBuffer = commandEncoder.finish({
  label: "my_command_buffer",
});

console.log(commandBuffer.label); // "my_command_buffer"

規範
WebGPU # dom-gpuobjectbase-label

此頁面最後修改於 ⁨2025年6月18日⁩，由 MDN 貢獻者修改。