DOMTokenList: replace() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
Die replace() Methode der DOMTokenList-Schnittstelle ersetzt ein bestehendes Token durch ein neues Token. Wenn das erste Token nicht existiert, gibt replace() sofort false zurück, ohne das neue Token zur Tokenliste hinzuzufügen.
Syntax
replace(oldToken, newToken)
Parameter
Rückgabewert
Ein boolescher Wert, der true ist, wenn oldToken erfolgreich ersetzt wurde, oder false, wenn nicht.
Beispiele
Im folgenden Beispiel rufen wir die Liste der auf einem <span>-Element gesetzten Klassen als DOMTokenList mit Element.classList ab. Dann ersetzen wir ein Token in der Liste und schreiben die Liste in das Node.textContent des <span>.
Zuerst das HTML:
<span class="a b c"></span>
Nun das JavaScript:
const span = document.querySelector("span");
const classes = span.classList;
const result = classes.replace("c", "z");
span.textContent = result ? classes : "token not replaced successfully";
Die Ausgabe sieht folgendermaßen aus:
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-domtokenlist-replace① |