XML DOM substringData() Methode

Definition und Verwendung

Die Methode substringData() von Text oder Kommentar aus dem Knoten extrahiert.

Syntax:

CharacterData.substringData(start,length)
Parameter Beschreibung
start Erforderlich. Die Position des ersten Zeichens im zu zurückgebenen Teilstring.
length Erforderlich. Die Anzahl der Zeichen im zu zurückgebenen Teilstring.

Rückgabewert

Gibt einen String zurück, der den Text von Text oder Comment Knoten von start beginnend length Zeichen.

auslösen

Diese Methode kann eine Ausnahme mit folgenden Codes auslösen: DOMException-Exception:

INDEX_SIZE_ERR - Parameter start oder length negativ ist oder length größer als die Länge von Text- oder Comment-Knoten.

DOMSTRING_SIZE_ERR - Der angegebene Textbereich ist zu lang, um in der JavaScript-Implementierung des Browsers in einen String eingefügt zu werden.

Beschreibung

Diese Methode extrahiert von Text- oder Comment-Knoten den Text von start beginnend length Zeichen. Diese Methode ist nur nützlich, wenn die Anzahl der Zeichen im Text des Knotens größer ist als die maximale Anzahl der Zeichen, die in der JavaScript-Implementierung des Browsers in einen String eingefügt werden kann. In diesem Fall kann das JavaScript-Programm die data-Attribute von Text- oder Comment-Knoten nicht direkt verwenden, sondern muss kürzere Teilstrings des Knoten-Texts verwenden. In der Praxis tritt diese Situation selten auf.

Verwandte Seiten

XML DOM Referenzhandbuch:Text.replaceData()

XML DOM Referenzhandbuch:Comment.replaceData()