CKTIS / JavaScript
Element.classList — managing an element’s classes
Element.classList provides a live DOMTokenList for reading and changing individual classes without replacing the entire class attribute.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.classList
element.classList.add(...tokens)
element.classList.remove(...tokens)
element.classList.contains(token)
element.classList.toggle(token, force)
element.classList.replace(token, newToken)Element.classList returns the same live DOMTokenList: changes to the class attribute are reflected in it. It holds unique tokens in order. Without classes, the list is empty.
add(...tokens) adds classes without duplicates, remove(...tokens) removes specified classes, and contains(token) checks membership. Pass separate arguments, not one space-containing string.
toggle(token) switches membership; optional force requires addition (true) or removal (false). Its result indicates final membership. replace(token, newToken) returns whether replacement occurred.
Mutating methods reject an empty token with SyntaxError and ASCII whitespace within a token with InvalidCharacterError — both are DOMException exceptions. This is a DOM API, not an ECMAScript feature; Node 24 does not prove browser support.
Examples
const element = document.createElement('div');
const classes = element.classList;
classes.add('card', 'selected');
classes.add('card');
classes.toggle('selected', false);
classes.replace('card', 'panel');
console.log(element.className);
console.log(classes.contains('selected'));
element.className = 'ready';
console.log(classes.contains('ready'));Result
panel false true
The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.