Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMTokenList.add() — dodawanie tokenów

DOMTokenList.add() dodaje tokeny, np. klasy przez element.classList, pomijając duplikaty i sprawdzając poprawność argumentów.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

tokenList.add(...tokens)

DOMTokenList.add() dodaje tokeny do uporządkowanego zbioru, np. przez element.classList. Zachowuje istniejące tokeny, pomija duplikaty i dopisuje nowe w kolejności argumentów. Wywołanie add() bez argumentów jest poprawne. Metoda aktualizuje powiązany atrybut, chyba że zbiór tokenów jest pusty, a atrybut nie istnieje. W takim przypadku atrybut nie jest tworzony.

Przekazuj osobne ciągi: element.classList.add('card', 'active'). Metoda zwraca undefined, nie listę ani wartość logiczną.

Pusty token powoduje DOMException o nazwie SyntaxError; białe znaki ASCII wewnątrz tokenu powodują InvalidCharacterError. Wszystkie tokeny są sprawdzane przed dodaniem: błędny argument zapobiega dodaniu także poprawnych tokenów z tego wywołania.

To API DOM, nie funkcja samego ECMAScript. Przykład wymaga dokumentu przeglądarki; obecność Node 24 nie dowodzi obsługi tego API.

Przykłady

const element = document.createElement('div');
element.classList.add('card');
const result = element.classList.add('card', 'active');
console.log(element.className);
console.log(result);

try {
  element.classList.add('pending', 'not valid');
} catch (error) {
  console.log(error.name);
}
console.log(element.className);

Wynik

card active
undefined
InvalidCharacterError
card active

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła