DOMTokenList.replace()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨avril 2018⁩.

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 :