{{APIRef("DOM")}} {{SeeCompatTable}}
The ParentNode.prepend
method inserts a set of {{domxref("Node")}} objects or {{domxref("DOMString")}} objects before the first child of the ParentNode
. {{domxref("DOMString")}} objects are inserted as equivalent {{domxref("Text")}} nodes.
Syntax
[Throws, Unscopable] void ParentNode.prepend((Node or DOMString)... nodes);
Parameters
nodes
- A set of {{domxref("Node")}} or {{domxref("DOMString")}} objects to insert.
Exceptions
- {{domxref("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 {{jsxref("Symbol.unscopables")}} for more information.
var parent = document.createElement("div"); with(parent) { prepend("foo"); } // ReferenceError: prepend is not defined
Specification
Specification | Status | Comment |
---|---|---|
{{SpecName('DOM WHATWG', '#dom-parentnode-prepend', 'ParentNode.prepend()')}} | {{Spec2('DOM WHATWG')}} | Initial definition. |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatUnknown}} | {{CompatGeckoDesktop(49)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | {{CompatUnknown}} | {{CompatGeckoMobile(49)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
See also
- {{domxref("ParentNode")}} and {{domxref("ChildNode")}}
- {{domxref("ParentNode.append()")}}
- {{domxref("Node.appendChild()")}}
- {{domxref("Node.insertBefore()")}}
- {{domxref("ChildNode.before()")}}
- {{domxref("NodeList")}}