CharacterData: Methode replaceData()

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 replaceData() Methode des CharacterData Interfaces entfernt eine bestimmte Anzahl von Zeichen des vorhandenen Textes in einem gegebenen CharacterData-Knoten und ersetzt diese Zeichen durch den bereitgestellten Text.

Syntax

js
characterData.replaceData(offset, count, data)

Parameter

offset

Die Anzahl der Zeichen vom Beginn der Daten, bei denen eingesetzt wird. 0 ist das erste Zeichen des Strings.

count

Die Anzahl der Zeichen, die mit den 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

Specification
DOM Standard
# dom-characterdata-replacedata

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch