GPUComputePipeline：label 属性

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

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

GPUComputePipeline 接口的 label 属性提供了一个标签，可用于识别对象，例如在 GPUError 消息或控制台警告中。

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

值

字符串。如果之前没有按上述方式设置，它将是一个空字符串。

示例

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

// ...

const computePipeline = device.createComputePipeline({
  layout: device.createPipelineLayout({
    bindGroupLayouts: [bindGroupLayout],
  }),
  compute: {
    module: shaderModule,
    entryPoint: "main",
  },
});

computePipeline.label = "mycomputepipeline";

console.log(computePipeline.label); // "mycomputepipeline"

通过 GPUDevice.createComputePipeline() 调用设置标签，然后通过 GPUComputePipeline.label 获取标签

// ...

const computePipeline = device.createComputePipeline({
  layout: device.createPipelineLayout({
    bindGroupLayouts: [bindGroupLayout],
  }),
  compute: {
    module: shaderModule,
    entryPoint: "main",
  },
  label: "mycomputepipeline",
});

console.log(computePipeline.label); // "mycomputepipeline"

规范

规范
WebGPU # dom-gpuobjectbase-label

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

WebGPU API