Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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`.

Fonti