CKTIS / JavaScript
DOMTokenList.add() — добавяне на токени
DOMTokenList.add() добавя токени, например класове чрез element.classList, пропуска дубликатите и проверява аргументите.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
tokenList.add(...tokens)DOMTokenList.add() добавя токени към подредено множество, например чрез element.classList. Запазва съществуващите токени, пропуска дубликатите и добавя новите в реда на аргументите. Методът add() може да се извика без аргументи. Той актуализира свързания атрибут, освен ако множеството от токени е празно и атрибутът липсва. В този случай атрибутът не се създава.
Подайте отделни низове: element.classList.add('card', 'active'). Методът връща undefined, а не списъка или булева стойност.
Празен токен предизвиква DOMException с име SyntaxError; ASCII интервални знаци вътре в токен предизвикват InvalidCharacterError. Всички токени се проверяват преди добавянето: невалиден аргумент предотвратява добавянето и на валидните токени от това извикване.
Това е DOM API, а не функция само на ECMAScript. Примерът изисква документ на браузър; наличието на Node 24 не доказва поддръжка на този API.
Примери
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);Резултат
card active undefined InvalidCharacterError card active
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.