Document: adoptNode() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

Document.adoptNode() は、ノードを他の文書からメソッドの文書へ移譲します。取り込まれたノードおよびそのサブツリーは（もしあれば）元の文書から削除され、ownerDocument が現在の文書に変更されます。その後、ノードを現在の文書に挿入することができます。

構文

adoptNode(externalNode)

引数

externalNode: 他の文書から移譲されるノードです。

返値

インポートする文書のスコープ内にコピーされたimportedNode です。

このメソッドを呼び出した後、importedNode およびexternalNode は同じオブジェクトになります。

メモ:importedNode のNode.parentNode は、まだ文書ツリーに挿入されていないのでnull です。

例

const iframe = document.querySelector("iframe");const iframeImages = iframe.contentDocument.querySelectorAll("img");const newParent = document.getElementById("images");iframeImages.forEach((imgEl) => {  newParent.appendChild(document.adoptNode(imgEl));});