The DOMTokenList interface represents a set of space-separated tokens. Such a set is returned by Element.classList, HTMLLinkElement.relList, HTMLAnchorElement.relList or HTMLAreaElement.relList. It is indexed beginning with 0 as with JavaScript Array objects. DOMTokenList is always case-sensitive.


This interface doesn't inherit any property.

DOMTokenList.length Read only
Is an integer representing the number of objects stored in the object.


This interface doesn't inherit any method.

Returns an item in the list by its index (or undefined if the number is greater than or equal to the length of the list, prior to Gecko 7.0 returned null)
Returns true if the underlying string contains token, otherwise false
Adds token to the underlying string
Removes token from the underlying string
Removes token from string and returns false. If token doesn't exist it's added and the function returns true


Specification Status Comment
WHATWG HTML Living Standard
The definition of 'DOMTokenList' in that specification.
Living Standard Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) (Yes) (Yes) (Yes) ?
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support ? ? ? ? ? ?

See Also

Document Tags and Contributors

Contributors to this page: Sebastianz, bradleyflood, teoli, kscarfone, Sheppy, trevorh, MatrixFrog, Crash
Last updated by: Sebastianz,