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

Dies kann durch Bereitstellung einer label-Eigenschaft im Deskriptorobjekt, das in den ursprünglichen Aufruf von GPUDevice.createRenderBundleEncoder() übergeben wird, gesetzt werden, oder Sie können es direkt auf dem GPURenderBundleEncoder-Objekt abrufen und setzen.

Hinweis: Diese Eigenschaft ist funktional identisch mit ihrem Äquivalent auf GPURenderPassEncoder — label.

Wert

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

Beispiele

Festlegen und Abrufen eines Labels über GPURenderBundleEncoder.label:

js
const renderBundleEncoder = device.createRenderBundleEncoder({
  colorFormats: [presentationFormat],
});

renderBundleEncoder.label = "my_render_bundle_encoder";
console.log(renderBundleEncoder.label); // "my_render_bundle_encoder"

Festlegen eines Labels über den ursprünglichen Aufruf von GPUDevice.createRenderBundleEncoder() und dann Abrufen über GPURenderBundleEncoder.label:

js
const renderBundleEncoder = device.createRenderBundleEncoder({
  colorFormats: [presentationFormat],
  label: "my_render_bundle_encoder",
});

console.log(renderBundleEncoder.label); // "my_render_bundle_encoder"

Spezifikationen

Specification
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch