Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DOMTokenList.remove() — rimuovere token

DOMTokenList.remove() rimuove i token indicati, ad esempio le classi di un elemento tramite classList. Scopri come vengono gestiti più argomenti, i token mancanti e i valori non validi.

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

Sintassi

tokenList.remove(...tokens)

DOMTokenList.remove() rimuove zero o più token. Su element.classList, modifica l’attributo class senza rimuovere l’elemento. I token mancanti vengono ignorati; il metodo restituisce undefined.

Passa argomenti separati: element.classList.remove('selected', 'hidden'), non un’unica stringa contenente spazi. Un token vuoto genera una DOMException chiamata SyntaxError; un token che contiene spazi bianchi ASCII genera InvalidCharacterError.

Tutti gli argomenti vengono convalidati prima della rimozione. Un argomento successivo non valido impedisce quindi la rimozione dei token precedenti. Dopo l’errore, l’esempio conserva card.

Questa è un’API DOM definita da WHATWG, non una funzionalità esclusiva di ECMAScript. L’esempio richiede un document del browser; la sola versione di Node.js non dimostra che l’API sia disponibile.

Esempi

const element = document.createElement('div');
element.className = 'card selected hidden';
const result = element.classList.remove('selected', 'hidden', 'missing');
console.log(element.className);
console.log(result);

try {
  element.classList.remove('card', 'bad token');
} catch (error) {
  console.log(error.name);
}
console.log(element.className);

Risultato

card
undefined
InvalidCharacterError
card

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti