GPUCommandEncoder: label-Eigenschaft

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 label-Schreibgeschützte Eigenschaft der GPUCommandEncoder-Schnittstelle ist ein String, der ein Label bereitstellt, das verwendet werden kann, um das Objekt beispielsweise in GPUError-Meldungen oder Konsolenwarnungen zu identifizieren.

Dies kann durch Bereitstellung einer label-Eigenschaft im Descriptor-Objekt, das in den ursprünglichen GPUDevice.createCommandEncoder()-Aufruf übergeben wird, gesetzt werden, oder Sie können es direkt am GPUCommandEncoder-Objekt erhalten und setzen.

Wert

Ein String. Wenn zuvor kein Labelwert gesetzt wurde, gibt das Abrufen des Labels einen leeren String zurück.

Beispiele

Setzen und Abrufen eines Labels über GPUCommandEncoder.label:

js
const commandEncoder = device.createCommandEncoder();
commandEncoder.label = "my_command_encoder";
console.log(commandEncoder.label); // "my_command_encoder"

Setzen eines Labels über den ursprünglichen GPUDevice.createCommandEncoder()-Aufruf und anschließendes Abrufen über GPUCommandEncoder.label:

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

console.log(commandEncoder.label); // "my_command_encoder"

Spezifikationen

Specification
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch