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.