CKTIS / JavaScript
Node.insertBefore — вмъкване преди дъщерен възел
Node.insertBefore вмъква или премества възел преди посочен дъщерен възел. Ако се подаде null, възелът се вмъква в края.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
parent.insertBefore(node, child)Извикайте Node.insertBefore върху родителя: parent.insertBefore(node, child). child трябва да е негов пряк дъщерен възел или null (за добавяне на възела в края). Подайте и двата аргумента. Методът връща node.
Съществуващ възел се премества, а не се копира. При DocumentFragment се вмъкват неговите дъщерни възли; върнатият фрагмент е празен.
Недопустима йерархия, например цикъл, причинява HierarchyRequestError. Методът проверява дали вмъкването би създало цикъл, преди да провери дали child принадлежи на родителя. Ако вмъкването би създало цикъл, методът хвърля HierarchyRequestError дори когато child не принадлежи на родителя. Ако предходните проверки преминат успешно и child не е нито null, нито пряк дъщерен възел на родителя, методът хвърля NotFoundError. Това е API на DOM, а не на ECMAScript; само наличието на Node.js 24 не доказва, че DOM е достъпен.
Примери
const parent = document.createElement('div');
const a = document.createTextNode('A');
const b = document.createTextNode('B');
parent.insertBefore(b, null);
const returned = parent.insertBefore(a, b);
console.log(parent.textContent);
console.log(returned === a);
parent.insertBefore(b, a);
console.log(parent.textContent);Резултат
AB true BA
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.