DOMChildNode::replaceWith
(PHP 8)
DOMChildNode::replaceWith — Replaces the node with new nodes
Description
Replaces the node with new nodes.
Parameters
-
nodes -
The replacement nodes. Strings are automatically converted to text nodes.
Return Values
No value is returned.
Errors/Exceptions
-
DOM_HIERARCHY_REQUEST_ERR -
Raised if the parent is of a type that does not allow children of the type of one of the passed
nodes, or if the node to put in is one of this node's ancestors or this node itself. -
DOM_WRONG_DOCUMENT_ERR -
Raised if one of the passed
nodeswas created from a different document than the one that created this node.
Changelog
| Version | Description |
|---|---|
| 8.3.0 |
Calling this method on a node without a parent is now a no-op to align the behaviour with the DOM specification.
Previously this threw a
DOMException with code
DOM_HIERARCHY_REQUEST_ERR.
|
See Also
- DOMChildNode::after() - Adds nodes after the node
- DOMChildNode::before() - Adds nodes before the node
- DOMChildNode::remove() - Removes the node
- DOMNode::replaceChild() - Replaces a child
add a note
User Contributed Notes
There are no user contributed notes for this page.
