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

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

Specification
DOM
# dom-characterdata-replacedata

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
replaceData

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch