Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
The labels read-only property of the ElementInternals interface returns the labels associated with the element.
A NodeList containing all of the label elements associated with this element.
The following example shows a custom checkbox component with a <label> element linked to it. Printing the value of labels to the console returns a NodeList with one entry, representing this label.
<form id="myForm"> <custom-checkbox id="custom-checkbox"></custom-checkbox> <label for="custom-checkbox">Join newsletter</label> </form>
let element = document.getElementById("custom-checkbox");
console.log(element.internals_.label);
| Specification |
|---|
| HTML> # dom-elementinternals-labels> |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
labels |
77 | 79 | 98 | 64 | 16.4 | 77 | 98 | 55 | 16.4 | 12.0 | 77 | 16.4 |
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/labels