ParentNode.prepend()
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The ParentNode.prepend
method inserts a set of Node
objects or DOMString
objects before the first child of the ParentNode
. DOMString
objects are inserted as equivalent Text
nodes.
Syntax
[Throws, Unscopable]
void ParentNode.prepend((Node or DOMString)... nodes);
Parameters
Exceptions
HierarchyRequestError
: Node cannot be inserted at the specified point in the hierarchy.
Examples
Prepending an element
var parent = document.createElement("div"); var p = document.createElement("p"); var span = document.createElement("span"); parent.append(p); parent.prepend(span); console.log(parent.childNodes); // NodeList [ <span>, <p> ]
Prepending text
var parent = document.createElement("div"); parent.append("Some text"); parent.prepend("Headline: "); console.log(parent.textContent); // "Headline: Some text"
Appending an element and text
var parent = document.createElement("div"); var p = document.createElement("p"); parent.prepend("Some text", p); console.log(parent.childNodes); // NodeList [ #text "Some text", <p> ]
ParentNode.prepend()
is unscopable
The prepend()
method is not scoped into the with
statement. See Symbol.unscopables
for more information.
var parent = document.createElement("div"); with(parent) { prepend("foo"); } // ReferenceError: prepend is not defined
Specification
Specification | Status | Comment |
---|---|---|
DOM The definition of 'ParentNode.prepend()' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | ? | 49 (49) | ? | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | ? | 49.0 (49) | ? | ? | ? |
See also
ParentNode
andChildNode
ParentNode.append()
Node.appendChild()
Node.insertBefore()
ChildNode.before()
NodeList
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/parentnode/prepend