GPUSampler: label property

可用性有限

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

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

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

GPUSampler 介面的 label 屬性提供了一個標籤，可用於標識物件，例如在 GPUError 訊息或控制檯警告中。

這可以透過在傳入原始的 GPUDevice.createSampler() 呼叫的描述符物件中提供 label 屬性來設定，也可以直接在 GPUSampler 物件上獲取和設定。

值

一個字串。如果之前未按上述方式設定，則為空字串。

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

// …

const sampler = device.createSampler({
  compare: "less",
});

sampler.label = "my_sampler";

console.log(sampler.label); // "my_sampler"

透過原始的 GPUDevice.createSampler() 呼叫設定標籤，然後透過 GPUSampler.label 獲取它

// …

const sampler = device.createSampler({
  compare: "less",
  label: "my_sampler",
});

console.log(sampler.label); // "my_sampler"

規範
WebGPU # dom-gpuobjectbase-label

此頁面最後更新於 2025 年 6 月 18 日，由 MDN 貢獻者修訂。