DOMTokenList.replace()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode replace() de l'interface DOMTokenList remplace une marque (token) existante par une nouvelle marque.

Syntaxe

tokenList.replace(oldToken, newToken);

Paramètres

oldToken: Une DOMString (chaîne de caractères) représentant la marque que vous voulez remplacer.
newToken: Une DOMString (chaîne de caractères) représentant la marque avec laquelle vous voulez remplacer l'ancienne.

Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément <span> en tant que DOMTokenList en utilisant Element.classList. Nous remplaçons alors la marque dans la liste et écrivons la liste dans le Node.textContent du <span>.

D'abord, le HTML :

html

<span class="a b c"></span>

Maintenant le JavaScript :

var span = document.querySelector("span");
var classes = span.classList;
try {
  classes.replace("c", "z");
  span.textContent = classes;
} catch (e) {
  span.textContent = e;
}

La sortie ressemble à ceci :

Spécifications

Specification
DOM Standard # ref-for-dom-domtokenlist-replace①

Compatibilité des navigateurs

BCD tables only load in the browser