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

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

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

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

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

Синтаксис

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

Параметры

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

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

None (undefined).

Исключения

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

Примеры

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

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

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

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

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

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

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`prepend`	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/prepend