W3cubDocs

/Web APIs

DOMTokenList: length property

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:

html

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

Now the JavaScript:

js

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 Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
length 8 12 3.6 10 ≤12.1 5.1 3 18 4 ≤12.1 5 1.0

© 2005–2023 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