GPUComputePassEncoder: popDebugGroup() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

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

popDebugGroup() 方法是 GPUComputePassEncoder 介面的一個方法,用於結束計算通道的除錯組。該除錯組是由 pushDebugGroup() 呼叫開始的。

這可以用於遙測,或在將來可能用於 GPUError 訊息、瀏覽器開發者工具或其他服務中,以幫助除錯。

語法

js
popDebugGroup()

引數

無。

返回值

無 (Undefined)。

驗證

呼叫 popDebugGroup() 時必須滿足以下條件,否則將生成 GPUValidationError 並且 GPUComputePassEncoder 會失效:

  • 計算通道編碼器的除錯堆疊不為空(即,之前至少有一個計算通道除錯組是透過 pushDebugGroup() 開始的)。

示例

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-popdebuggroup

瀏覽器相容性

另見