Say you have a DOM element, which you have a reference to (maybe retrieved using querySelector()).

To replace it with another DOM element, you can call the replaceWith() method on the first element, passing the second element as the argument:

const el1 = document.querySelector(/* ... */)
const el2 = document.querySelector(/* ... */)

el1.replaceWith(el2)

Since Edge <17 and IE11 do not support it, you should transpile it to ES5 using Babel if you plan to support those browsers.

Another solution is to look up the parent and use the replaceChild() method, which is much older and supported by all browsers:

const el1 = document.querySelector(/* ... */)
const el2 = document.querySelector(/* ... */)

el1.parentNode.replaceChild(el2, el1)

Lessons in this unit:

0:	Introduction
1:	The `window` object
2:	The `document` object
3:	Types of nodes
4:	Traversing the DOM
5:	Editing the DOM
6:	Selectors API
7:	DOM Ready
8:	Add a class to an element
9:	Remove a class from an element
10:	Check if element has a class
11:	Change a DOM node value
12:	Loop through DOM elements
13:	Add an image to the DOM
14:	Create a DOM attribute
15:	Remove children elements
16:	▶︎ Replace a DOM element
17:	insertAdjacentHTML
18:	Add click events to a list