GPUCommandEncoder: Eigentum `label`

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 des GPUCommandEncoder-Interfaces ist eine schreibgeschützte Zeichenkette, die eine Bezeichnung bereitstellt, mit der das Objekt identifiziert werden kann, zum Beispiel in GPUError-Meldungen oder Konsolenwarnungen.

Diese Bezeichnung kann bereitgestellt werden, indem eine label-Eigenschaft in das Descriptor-Objekt eingefügt wird, das an den ursprünglichen Aufruf von GPUDevice.createCommandEncoder() übergeben wird, oder Sie können sie direkt am GPUCommandEncoder-Objekt abrufen und setzen.

Wert

Eine Zeichenkette. Wenn zuvor kein Labelwert festgelegt wurde, gibt das Abrufen des Labels eine leere Zeichenkette zurück.

Beispiele

Ein Label über GPUCommandEncoder.label setzen und abrufen:

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

Ein Label über den ursprünglichen Aufruf von GPUDevice.createCommandEncoder() setzen und es dann über GPUCommandEncoder.label abrufen:

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

Siehe auch