DOMTokenList: replace() Methode

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.

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

oldToken: Ein String, der das Token darstellt, das Sie ersetzen möchten.
newToken: Ein String, der das Token darstellt, mit dem Sie oldToken ersetzen möchten.

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:

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

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

Browser-Kompatibilität

BCD tables only load in the browser