DocumentType: before() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

Die DocumentType.before()-Methode fügt eine Reihe von Node-Objekten oder Zeichenfolgen in die Kinderliste des Elternteils des DocumentType ein, direkt vor dem DocumentType. Zeichenfolgen werden als gleichwertige Text-Knoten eingefügt.

Syntax

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

Parameter

param1, …, paramN: Eine Reihe von Node-Objekten oder Zeichenfolgen, die eingefügt werden sollen.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException: Wird ausgelöst, wenn der Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden kann.

Beispiele

Hinzufügen eines bedingten Kommentars

Kommentar-Knoten sind vor Doctype-Deklarationen zulässig, aber nicht ratsam, da sie im IE den Quirks-Modus auslösen. Ein bedingter Kommentar funktioniert jedoch auch für IE:

let docType = document.implementation.createDocumentType("html", "", "");
let myDoc = document.implementation.createDocument("", "", docType);

docType.before(
  document.createComment("<!--[if !IE]> conditional comment <![endif]-->"),
);

myDoc.childNodes;
// NodeList [<!--[if !IE]> conditional comment <![endif]-->, <!DOCTYPE html>]

Spezifikationen

Specification
DOM # ref-for-dom-childnode-before①