已废弃: This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.


replaceWholeText replaces the text of the node and all of its logically adjacent text nodes with the specified text.  The replaced nodes are removed, including the current node, unless it was the recipient of the replacement text.

Warning: This method has been deprecated in DOM level 4 and is no longer implemented in recent browsers, including Gecko 10.0 (Firefox 10.0 / Thunderbird 10.0 / SeaMonkey 2.7).


replacementNode = textnode.replaceWholeText(content)


  • replacementNode is a Text node.
  • content is a string specifying the text with which to replace the node's current contents.


NO_MODIFICATION_ALLOWED_ERR : A DOMException thrown if one of the text nodes being replaced is read only.


See the example for the text.wholeText property.


This method returns the text node which received the replacement text, or null if the replacement text is an empty string.  The returned node is the current node unless the current node is read only, in which case the returned node is a newly created text node of the same type which has been inserted at the location of the replacement.

Note: Firefox's implementation of this method does not yet support EntityReference nodes as defined by the specification.



See also