Element.replaceWith()
La méthode Element.replaceWith()
remplace l'élément courant dans la liste des enfants de son parent par un ensemble d'objets Node
ou de chaînes de caractères.
Les chaînes de caractères sont insérées comme des nœuds Text
.
Syntaxe
js
replaceWith(param1);
replaceWith(param1, param2);
replaceWith(param1, param2, /* ... ,*/ paramN);
Paramètres
Exceptions
DOMException
HierarchyRequestError
-
Levée lorsque le nœud ne peut pas être inséré à l'emplacement indiqué dans la hiérarchie.
Exemples
Utiliser replaceWith()
js
const div = document.createElement("div");
const p = document.createElement("p");
div.appendChild(p);
const span = document.createElement("span");
p.replaceWith(span);
console.log(div.outerHTML);
// "<div><span></span></div>"
replaceWith()
ne fait pas partie de la portée de with
La méthode replaceWith()
ne fait pas partie de la portée créée par une instruction with
. Voir Symbol.unscopables
pour plus d'informations.
js
with (node) {
replaceWith("toto");
}
// ReferenceError: replaceWith is not defined
Spécifications
Specification |
---|
DOM Standard # ref-for-dom-childnode-replacewith① |
Compatibilité des navigateurs
BCD tables only load in the browser