GPUComputePassEncoder: label-Eigenschaft

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 label-Eigenschaft (nur lesbar) der GPUComputePassEncoder-Schnittstelle ist ein String, der ein Label bereitstellt, das zur Identifizierung des Objekts verwendet werden kann, zum Beispiel in GPUError-Meldungen oder Konsolenwarnungen.

Dieses Label kann gesetzt werden, indem eine label-Eigenschaft im Deskriptor-Objekt angegeben wird, das an den ursprünglichen Aufruf von GPUCommandEncoder.beginComputePass() übergeben wird, oder es kann direkt am GPUComputePassEncoder-Objekt gesetzt und abgerufen werden.

Wert

Ein String. Wenn vorher kein Labelwert gesetzt wurde, wird beim Abrufen der label-Eigenschaft ein leerer String zurückgegeben.

Beispiele

Setzen und Abrufen eines Labels über GPUComputePassEncoder.label:

js
const commandEncoder = device.createCommandEncoder();
const passEncoder = commandEncoder.beginComputePass();

passEncoder.label = "my_compute_pass_encoder";
console.log(passEncoder.label); // "my_compute_pass_encoder"

Setzen eines Labels über den ursprünglichen Aufruf von GPUCommandEncoder.beginComputePass(), und anschließendes Abrufen über GPUComputePassEncoder.label:

js
const commandEncoder = device.createCommandEncoder();
const passEncoder = commandEncoder.beginComputePass({
  label: "my_compute_pass_encoder",
});

console.log(passEncoder.label); // "my_compute_pass_encoder"

Spezifikationen

Specification
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

Siehe auch