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

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

JavaScript

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

Specifications

Specification

HTML
# dom-lfe-labels-dev

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Sep 11, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content