Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri