GPUBuffer: 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, bevor Sie diese produktiv verwenden.

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die label-Eigenschaft des GPUBuffer-Interfaces bietet ein Label, das verwendet werden kann, um das Objekt zu identifizieren, zum Beispiel in GPUError-Meldungen oder Konsolenwarnungen.

Dieses kann gesetzt werden, indem im Deskriptor-Objekt, das in den ursprünglichen Aufruf von GPUDevice.createBuffer() übergeben wird, eine label-Eigenschaft bereitgestellt wird. Alternativ können Sie es direkt auf dem GPUBuffer-Objekt abrufen und festlegen.

Wert

Ein String. Wenn dies nicht wie oben beschrieben zuvor gesetzt wurde, wird es ein leerer String sein.

Beispiele

Setzen und Abrufen eines Labels über GPUBuffer.label:

js
const output = device.createBuffer({
  size: BUFFER_SIZE,
  usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
});

output.label = "my_buffer";

console.log(output.label); // "my_buffer"

Festlegen eines Labels über den ursprünglichen GPUDevice.createBuffer()-Aufruf und anschließendes Abrufen über GPUBuffer.label:

js
const output = device.createBuffer({
  size: BUFFER_SIZE,
  usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
  label: "my_buffer",
});

console.log(output.label); // "my_buffer"

Spezifikationen

Specification
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch