Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

CharacterData: replaceData()-Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die replaceData()-Methode des CharacterData-Interfaces entfernt eine bestimmte Anzahl von Zeichen des vorhandenen Texts in einem gegebenen CharacterData-Knoten und ersetzt diese Zeichen mit dem bereitgestellten Text.

Syntax

js
replaceData(offset, count, data)

Parameter

offset

Die Anzahl der Zeichen ab dem Beginn der Daten, an denen eingefügt werden soll. 0 ist das erste Zeichen der Zeichenkette.

count

Die Anzahl der Zeichen, die durch die bereitgestellten Daten ersetzt werden sollen.

data

Die einzufügenden Daten.

Rückgabewert

Keiner.

Ausnahmen

IndexSizeError DOMException

Wird ausgelöst, wenn offset oder count negativ ist oder offset größer als die Länge der enthaltenen Daten ist.

Beispiel

html
<span>Result: </span>A long string.
js
const span = document.querySelector("span");
const textNode = span.nextSibling;

textNode.replaceData(2, 4, "replaced");

Spezifikationen

Spezifikation
DOM
# dom-characterdata-replacedata

Browser-Kompatibilität

Siehe auch