GPUComputePassEncoder:label 属性

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

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

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

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

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

示例

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

js
const commandEncoder = device.createCommandEncoder();
const passEncoder = commandEncoder.beginComputePass();

passEncoder.label = "mycomputepassencoder";
console.log(passEncoder.label); // "mycomputepassencoder"

通过原始的 GPUCommandEncoder.beginComputePass() 调用设置标签,然后通过 GPUComputePassEncoder.label 获取它

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

console.log(passEncoder.label); // "mycomputepassencoder"

规范

规范
WebGPU
# dom-gpuobjectbase-label

浏览器兼容性

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

另请参阅