GPUCommandEncoder: pushDebugGroup() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die pushDebugGroup() Methode der GPUCommandEncoder Schnittstelle beginnt eine Debug-Gruppe, die mit einem angegebenen Label markiert ist und alle nachfolgenden codierten Befehle enthalten wird, bis eine popDebugGroup() Methode aufgerufen wird.

Dies könnte zur Telemetrie verwendet werden oder in Zukunft in GPUError-Meldungen, Browser-Entwicklungstools oder anderen Diensten genutzt werden, um bei der Fehlersuche zu helfen.

Syntax

js
pushDebugGroup(groupLabel)

Parameter

groupLabel

Ein String, der das Label für die Debug-Gruppe darstellt.

Rückgabewert

Keiner (Undefined).

Beispiele

js
// …

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

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.draw(3);

passEncoder.end();

commandEncoder.popDebugGroup(); // End labeled debug group

// …

Spezifikationen

Specification
WebGPU
# dom-gpudebugcommandsmixin-pushdebuggroup

Browser-Kompatibilität

Siehe auch