База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници