GPUCommandEncoder：label 属性

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

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

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

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

值

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

示例

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

js
const commandEncoder = device.createCommandEncoder();
commandEncoder.label = "mycommandencoder";
console.log(commandEncoder.label); // "mycommandencoder";

通过源自 GPUDevice.createCommandEncoder() 调用的方式设置标签，然后通过 GPUCommandEncoder.label 获取它。

js
const commandEncoder = device.createCommandEncoder({
  label: "mycommandencoder",
});

console.log(commandEncoder.label); // "mycommandencoder";

规范

规范
WebGPU
# dom-gpuobjectbase-label

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅