CKTIS / JavaScript
DOMTokenList.contains — verificare la presenza di un token
DOMTokenList.contains(token) indica se una lista contiene esattamente il token specificato, per esempio una classe CSS in element.classList.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
tokenList.contains(token)DOMTokenList.contains(token) restituisce true se la lista contiene il token specificato, altrimenti false. Non modifica la lista. Un uso tipico è element.classList.contains('active').
Verifica un token completo, non una parte di testo né un selettore CSS. Distingue tra maiuscole e minuscole: active e Active sono token diversi. Non anteporre un punto al nome della classe.
Se la stringa è vuota o contiene caratteri di spaziatura ASCII, il metodo restituisce false senza sollevare le eccezioni di convalida associate a add(). Questo metodo fa parte della DOM Web API, non di ECMAScript; l’esempio richiede un DOM del browser, che Node 24 da solo non fornisce.
Esempi
const element = document.createElement('div');
element.className = 'active item';
const tokens = element.classList;
console.log(tokens.contains('active'));
console.log(tokens.contains('act'));
console.log(tokens.contains('Active'));
console.log(tokens.contains('active item'));
console.log(tokens.contains(''));Risultato
true false false false false
La lista contiene due token distinti: `active` e `item`. Solo il primo controllo restituisce `true`. `tokens.contains('active item')` cerca l’intera stringa come un unico token e restituisce `false` anziché sollevare un `SyntaxError`. L’ultimo controllo viene quindi eseguito e restituisce `false`.