GPUComputePipeline: 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-Eigenschaft der GPUComputePipeline-Schnittstelle bietet ein Label, das verwendet werden kann, um das Objekt zu identifizieren, zum Beispiel in GPUError-Meldungen oder Konsolenwarnungen.

Diese kann gesetzt werden, indem eine label-Eigenschaft im Deskriptorobjekt angegeben wird, das in den ursprünglichen Aufruf von GPUDevice.createComputePipeline() oder GPUDevice.createComputePipelineAsync() übergeben wird, oder Sie können sie direkt am GPUComputePipeline-Objekt abrufen und festlegen.

Wert

Ein String. Wenn dies nicht wie oben beschrieben zuvor festgelegt wurde, ist es ein leerer String.

Beispiele

Setzen und Abrufen eines Labels über GPUComputePipeline.label:

js
// ...

const computePipeline = device.createComputePipeline({
  layout: device.createPipelineLayout({
    bindGroupLayouts: [bindGroupLayout],
  }),
  compute: {
    module: shaderModule,
    entryPoint: "main",
  },
});

computePipeline.label = "my_compute_pipeline";

console.log(computePipeline.label); // "my_compute_pipeline"

Setzen eines Labels über einen GPUDevice.createComputePipeline()-Aufruf und anschließendes Abrufen über GPUComputePipeline.label:

js
// ...

const computePipeline = device.createComputePipeline({
  layout: device.createPipelineLayout({
    bindGroupLayouts: [bindGroupLayout],
  }),
  compute: {
    module: shaderModule,
    entryPoint: "main",
  },
  label: "my_compute_pipeline",
});

console.log(computePipeline.label); // "my_compute_pipeline"

Spezifikationen

Specification
WebGPU
# dom-gpuobjectbase-label

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch