GPUTexture：label 属性

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

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且仅在部分或全部支持的浏览器中可用。

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

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

值

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

示例

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

// ...

const depthTexture = device.createTexture({
  size: [canvas.width, canvas.height],
  format: "depth24plus",
  usage: GPUTextureUsage.RENDER_ATTACHMENT,
});

depthTexture.label = "mytexture";

console.log(depthTexture.label); // "mytexture"

通过源自 GPUDevice.createTexture() 调用的设置标签，然后通过 GPUTexture.label 获取它。

// ...

const depthTexture = device.createTexture({
  size: [canvas.width, canvas.height],
  format: "depth24plus",
  usage: GPUTextureUsage.RENDER_ATTACHMENT,
  label: "mytexture",
});

console.log(depthTexture.label); // "mytexture"

规范

规范
WebGPU # dom-gpuobjectbase-label

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

WebGPU API