Документ: метод append()

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Метод Document.append() вставляет набор Node объектов или строк после последнего дочернего элемента документа. Строки вставляются в виде эквивалентных узлов Text.

Этот метод добавляет дочерний элемент к Document. Чтобы добавить элемент к произвольному элементу в дереве, см. Element.append().

Синтаксис

append(param1)
append(param1, param2)
append(param1, param2, /* …, */ paramN)

Параметры

param1, …, paramN: Набор Node объектов или строк для вставки.

Возвращаемое значение

None (undefined).

Исключения

HierarchyRequestError DOMException: Выбрасывается, когда узел не может быть вставлен в указанную точку иерархии.

Примеры

Добавление корневого элемента к документу

Если вы пытаетесь добавить элемент к существующему HTML-документу, может быть выброшено HierarchyRequestError DOMException, если элемент <html> уже существует.

let html = document.createElement("html");
document.append(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.

Если вы создаёте новый документ без существующих элементов, вы можете добавить корневой HTML-элемент (или корневой SVG-элемент):

let doc = new Document();
let html = document.createElement("html");
doc.append(html);

doc.children; // HTMLCollection [<html>]

Спецификации

Спецификация
DOM # ref-for-dom-parentnode-append①

Совместимость с браузерами

	Рабочие столы					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`append`	54	17	49	41	10	54	49	41	10	6.0	54

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/append