GPUComputePassEncoder: pushDebugGroup() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

pushDebugGroup() 方法是 GPUComputePassEncoder 接口的一部分,它开始一个计算通道调试组。该调试组会用指定的标签进行标记,并包含所有后续编码的命令,直到调用 popDebugGroup() 方法为止。

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

语法

js
pushDebugGroup(groupLabel)

参数

groupLabel

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

返回值

无 (Undefined)。

示例

js
// …

const passEncoder = commandEncoder.beginComputePass();

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

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

passEncoder.popDebugGroup();

// …

规范

规范
WebGPU
# dom-gpudebugcommandsmixin-pushdebuggroup

浏览器兼容性

另见