CKTIS / JavaScript
DOMTokenList.contains — preverjanje prisotnosti žetona
DOMTokenList.contains(token) pove, ali seznam vsebuje natanko navedeni žeton, na primer razred CSS v element.classList.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
tokenList.contains(token)DOMTokenList.contains(token) vrne true, če seznam vsebuje navedeni žeton, sicer pa false. Seznama ne spremeni. Pogosta uporaba je element.classList.contains('active').
Preveri celoten žeton, ne dela besedila ali izbirnika CSS. Razlikuje med velikimi in malimi črkami: active in Active sta različna žetona. Pred ime razreda ne dodajajte pike.
Za prazen niz ali niz s preslednimi znaki ASCII metoda vrne false, ne da bi sprožila izjeme pri preverjanju veljavnosti, povezane z add(). Ta metoda spada v DOM Web API, ne v ECMAScript. Primer potrebuje DOM brskalnika, ki ga Node 24 sam ne zagotavlja.
Primeri
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(''));Rezultat
true false false false false
Seznam vsebuje dva ločena žetona: `active` in `item`. Samo prvo preverjanje vrne `true`. Klic `tokens.contains('active item')` išče celoten niz kot en žeton in vrne `false`, namesto da bi sprožil izjemo `SyntaxError`. Zato se zadnje preverjanje izvede in vrne `false`.