W3cubDocs

/Web APIs

DOMTokenList: length property

Baseline Widely available

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

The read-only length property of the DOMTokenList interface is an integer representing the number of objects stored in the object.

Value

An positive integer, or 0 if the list is empty.

Examples

In the following example we retrieve the list of classes set on a <span> element as a DOMTokenList using Element.classList, then write the length of the list to the <span>'s Node.textContent.

First, the HTML:

<span class="a b c"></span>

Now the JavaScript:

const span = document.querySelector("span");
const classes = span.classList;
const length = classes.length;

span.textContent = `classList length = ${length}`;

The output looks like this:

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
length 8 12 3.6 ≤12.1 5.1 18 4 ≤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/DOMTokenList/length