GPURenderBundleEncoder: label property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only insecure contexts (HTTPS), in some or allsupporting browsers.

Note: This feature is available inWeb Workers.

Thelabel read-only property of theGPURenderBundleEncoder interface is a string providing a label that can be used to identify the object, for example inGPUError messages or console warnings.

This can be set by providing alabel property in the descriptor object passed into the originatingGPUDevice.createRenderBundleEncoder() call, or you can get and set it directly on theGPURenderBundleEncoder object.

Note:This property is functionally identical to its equivalent onGPURenderPassEncoder —label.

Value

A string. If no label value has previously been set, getting the label returns an empty string.

Examples

Setting and getting a label viaGPURenderBundleEncoder.label:

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

Setting a label via the originatingGPUDevice.createRenderBundleEncoder() call, and then getting it viaGPURenderBundleEncoder.label:

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