The .append()
method inserts a set of Node or string objects after the last child of the document. This can be used to add a new node or move an existing child node to a new position. The append()
method does not return a value; its parameters are either Nodes or string objects.
The Document.append()
method
inserts a set of Node
objects or string objects after
the last child of the document. String objects
are inserted as equivalent Text
nodes.
This method appends a child to a Document
. To append to an arbitrary element in the tree, see Element.append()
.
append(param1) append(param1, param2) append(param1, param2, /* … ,*/ paramN)
param1
, …, paramN
A set of Node
or string objects to insert.
None (undefined
).
HierarchyRequestError
DOMException
Thrown when the node cannot be inserted at the specified point in the hierarchy.
If you try to append an element to an existing HTML document,
it might throw a HierarchyRequestError
DOMException
given a <html>
element already exists.
let html = document.createElement("html"); document.append(html); // HierarchyRequestError: The operation would yield an incorrect node tree.
If you are creating a new document without any existing element, you can append a root HTML element (or a root SVG element):
let doc = new Document(); let html = document.createElement("html"); doc.append(html); doc.children; // HTMLCollection [<html>]
Source: Mozilla, https://developer.mozilla.org/en-US/docs/Web/API/Document/append
This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.