GPUCommandEncoder: pushDebugGroup()-Methode

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

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 startet eine Debug-Gruppe, die mit einem angegebenen Label gekennzeichnet ist und alle nachfolgenden kodierten Befehle bis zum Aufruf einer popDebugGroup()-Methode enthalten wird.

Dies könnte für Telemetrie verwendet werden oder in Zukunft in GPUError-Meldungen, Entwicklertools des Browsers oder anderen Diensten nützlich sein, um beim Debugging zu helfen.

Syntax

js
pushDebugGroup(groupLabel)

Parameter

groupLabel

Ein Zeichenfolge, die 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

BCD tables only load in the browser

Siehe auch