Document : méthode prepend()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2018.
La méthode prepend() de l'interface Document insère un ensemble d'objets Node ou de chaînes de caractères avant le premier enfant du document. Les chaînes de caractères sont insérées comme des nœuds Text équivalents.
Cette méthode ajoute un enfant au début d'un Document. Pour ajouter au début d'un élément quelconque dans l'arbre, voir Element.prepend().
Syntaxe
prepend(param1)
prepend(param1, param2)
prepend(param1, param2, /* …, */ paramN)
Paramètres
param1, …,paramN-
Un ensemble d'objets
Nodeou de chaînes de caractères à insérer.
Valeur de retour
Aucune (undefined).
Exceptions
HierarchyRequestErrorDOMException-
Levée lorsque le nœud ne peut pas être inséré à l'endroit spécifié dans la hiérarchie.
Exemples
Ajouter un élément racine à un document
Si vous essayez d'ajouter un élément au début d'un document HTML existant, cela peut lever une exception HierarchyRequestError de DOMException si un élément <html> existe déjà.
let html = document.createElement("html");
document.prepend(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
Si vous créez un nouveau document sans aucun élément existant, vous pouvez ajouter un élément racine HTML (ou un élément racine SVG) :
let doc = new Document();
let html = document.createElement("html");
doc.prepend(html);
doc.children; // HTMLCollection [<html>]
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-parentnode-prepend① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Document.append() - La méthode
Element.prepend()