appendData (W3C DOM Core method)

Spec
Version Depr. Static
DOM1 No No
Browser support (more…)
IE6+ FF1.5+ SA1.3+ OP9+
Full Full Full Full
Returns
void
Throws
NO_MODIFICATION_ALLOWED_ERR

Example

var sentence = document.createTextNode("When you're smiling");

sentence.appendData(", the whole world smiles with you.");

In the example above we create a Text node with the value When you're smiling, then we use the appendData method to add the string , the whole world smiles with you. to the end of that node.

The final result is a single Text node with the data (and nodeValue) When you're smiling, the whole world smiles with you., that has a length of 53.

Arguments

string (DOMString) required

The string to append.

Description

Append a string to the end of this character data.

After a successful operation, the data and length properties of the node reflect the change.

Tip: JavaScript has more powerful native features

I've never used this method — JavaScript's built-in string manipulation methods are far more flexible and powerful than anything offered by the DOM.

Compatibility

Internet Explorer Firefox Safari Opera
5.5 6.0 7.0 1.5 2.0 3.0 1.3 2.0 3.0 9.0 9.5
Partial Full Full Full Full Full Full Full Full Full Full

Internet Explorer 5.5 in HTML doesn't implement this method (it returns undefined).

User-contributed notes

There are no comments yet.

Related Products