GPURenderBundleEncoder: label 属性

实验性：这是一种实验性技术
在生产环境中使用之前，请仔细查看浏览器兼容性表。

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中。

label 是 GPURenderBundleEncoder 接口的只读属性，它是一个字符串，用于提供一个标签，该标签可以用于标识对象，例如在 GPUError 消息或控制台警告中。

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

注意：此属性在功能上与 GPURenderPassEncoder 上的等效属性相同 - label。

值

一个字符串。如果之前未设置标签值，则获取标签将返回空字符串。

示例

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

const renderBundleEncoder = device.createRenderBundleEncoder({
  colorFormats: [presentationFormat],
});

renderBundleEncoder.label = "myrenderbundleencoder";
console.log(renderBundleEncoder.label); // "myrenderbundleencoder"

通过源 GPUDevice.createRenderBundleEncoder() 调用设置标签，然后通过 GPURenderBundleEncoder.label 获取标签

const renderBundleEncoder = device.createRenderBundleEncoder({
  colorFormats: [presentationFormat],
  label: "myrenderbundleencoder",
});

console.log(renderBundleEncoder.label); // "myrenderbundleencoder"

规范

规范
WebGPU # dom-gpuobjectbase-label

浏览器兼容性

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

另请参阅

WebGPU API