GPUCommandBuffer: label 属性

实验性:这是一个 实验性技术
在生产环境中使用此功能之前,请仔细检查 浏览器兼容性表

安全上下文:此功能仅在 安全上下文 (HTTPS) 中可用,在某些或所有 支持的浏览器 中可用。

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

可以通过在传递给源 GPUCommandEncoder.finish() 调用的描述符对象中提供 label 属性来设置它,或者直接在 GPUCommandBuffer 对象上获取和设置它。

一个字符串。如果以前没有设置标签值,则获取标签将返回一个空字符串。

示例

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

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

通过源 GPUCommandEncoder.finish() 调用设置标签,然后通过 GPUCommandBuffer.label 获取它

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

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

规范

规范
WebGPU
# dom-gpuobjectbase-label

浏览器兼容性

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

另请参见