DocumentFragment: prepend() method
The DocumentFragment.prepend()
method
inserts a set of Node
objects or string objects before
the first child of the document fragment. String objects
are inserted as equivalent Text
nodes.
This method prepends a child to a DocumentFragment
. To prepend to an arbitrary element in the tree, see Element.prepend()
.
Syntax
js
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* … ,*/ paramN)
Parameters
param1
, …,paramN
-
A set of
Node
or string objects to insert.
Return value
None (undefined
).
Exceptions
HierarchyRequestError
DOMException
-
Thrown when the node cannot be inserted at the specified point in the hierarchy.
Examples
Prepending an element to a document fragment
js
let fragment = new DocumentFragment();
let div = document.createElement("div");
let p = document.createElement("p");
fragment.append(p);
fragment.prepend(div);
fragment.children; // HTMLCollection [<div>, <p>]
Specifications
Specification |
---|
DOM Standard # ref-for-dom-parentnode-prepend① |
Browser compatibility
BCD tables only load in the browser