GPUComputePassEncoder: pushDebugGroup() 方法

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

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

pushDebugGroup() 方法是 GPUComputePassEncoder 接口的方法，它开始一个计算传递调试组，该组用指定的标签标记，并将包含所有后续编码的命令，直到调用 popDebugGroup() 方法。

这可以用于遥测，或者将来可能用于 GPUError 消息、浏览器开发者工具或其他服务，以帮助调试。

语法

js
pushDebugGroup(groupLabel)

参数

groupLabel

表示调试组标签的字符串。

返回值

无 (Undefined).

示例

js
// ...

const passEncoder = commandEncoder.beginComputePass();

passEncoder.pushDebugGroup("mygroupmarker"); // Start labeled debug group

passEncoder.setPipeline(computePipeline);
passEncoder.setBindGroup(0, bindGroup);
passEncoder.dispatchWorkgroups(Math.ceil(BUFFER_SIZE / 64));

passEncoder.popDebugGroup();

// ...

规范

规范
WebGPU
# dom-gpudebugcommandsmixin-pushdebuggroup

浏览器兼容性

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

另请参阅