DOMTokenList.replace()

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.

Valeur retournée

Vide.

Exemples

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 :

<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

Spécification Statut Commentaire
DOM
La définition de 'replace()' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
replaceChrome Support complet 61Edge Support complet 17Firefox Support complet 49IE ? Opera Support complet 48Safari Support complet 10.1WebView Android Support complet 61Chrome Android Support complet 61Firefox Android Support complet 49Opera Android Support complet 45Safari iOS Support complet 10.3Samsung Internet Android Aucun support Non
return()'s value is a boolean, not void as it used to be.Chrome Support complet 67Edge Support complet 18Firefox Support complet 61IE Aucun support NonOpera Support complet 54Safari Support complet 12WebView Android Support complet 67Chrome Android Support complet 67Firefox Android Support complet 61Opera Android Support complet 48Safari iOS Support complet 12Samsung Internet Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue