W3cubDocs

/Web APIs

HTMLButtonElement: labels property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨October 2018⁩.

The HTMLButtonElement.labels read-only property returns a NodeList of the <label> elements associated with the <button> element.

Value

A NodeList containing the <label> elements associated with the <button> element.

Examples

>

HTML

<label id="label1" for="test">Label 1</label>
<button id="test">Button</button>
<label id="label2" for="test">Label 2</label>

JavaScript

const button = document.getElementById("test");
for (const label of button.labels) {
  console.log(label.textContent); // "Label 1" and "Label 2"
}

Specifications

Browser compatibility

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 6 18 56 ≤12.1 5.1 18 56 ≤12.1 5 1.0 3 5

© 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/HTMLButtonElement/labels