CharacterData: replaceData()-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 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

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.

const span = document.querySelector("span");
const textNode = span.nextSibling;

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

Spezifikationen

Specification
DOM # dom-characterdata-replacedata

Browser-Kompatibilität

BCD tables only load in the browser