--- title: ParentNode.append() slug: orphaned/Web/API/ParentNode/append tags: - API - DOM - Method - Node - ParentNode - Reference translation_of: Web/API/ParentNode/append original_slug: Web/API/ParentNode/append ---

{{APIRef("DOM")}}

ParentNode.append() メソッドは、{{domxref("Node")}} オブジェクト、または {{domxref("DOMString")}} オブジェクトのセットを ParentNode の最後に追加します。 {{domxref("DOMString")}} オブジェクトは {{domxref("Text")}} ノードと同等に挿入されます。

{{domxref("Node.appendChild()")}} との違いは次の通りです。

構文

// [Throws, Unscopable]
ParentNode.append(...nodesOrDOMStrings) // returns undefined

引数

nodes
追加する {{domxref("Node")}} または {{domxref("DOMString")}} オブジェクトのセット

例外

例

要素の追加

let parent = document.createElement("div")
let p = document.createElement("p")
parent.append(p)

console.log(parent.childNodes) // NodeList [ <p> ]

テキストの追加

let parent = document.createElement("div")
parent.append("Some text")

console.log(parent.textContent) // "Some text"

要素とテキストの追加

let parent = document.createElement("div")
let p = document.createElement("p")
parent.append("Some text", p)

console.log(parent.childNodes) // NodeList [ #text "Some text", <p> ]

ParentNode.append() はスコープが効かない

append() メソッドは with 文の中ではスコープが効きません。詳しくは {{jsxref("Symbol.unscopables")}} をご覧ください。

let parent = document.createElement("div")

with(parent) {
  append("foo")
}
// ReferenceError: append is not defined

Polyfill

append() メソッドはInternet Explorer 9 以上であれば以下のコードでポリフィルを当てることができます。

// Source: https://github.com/jserz/js_piece/blob/master/DOM/ParentNode/append()/append().md
(function (arr) {
  arr.forEach(function (item) {
    if (item.hasOwnProperty('append')) {
      return;
    }
    Object.defineProperty(item, 'append', {
      configurable: true,
      enumerable: true,
      writable: true,
      value: function append() {
        var argArr = Array.prototype.slice.call(arguments),
          docFrag = document.createDocumentFragment();

        argArr.forEach(function (argItem) {
          var isNode = argItem instanceof Node;
          docFrag.appendChild(isNode ? argItem : document.createTextNode(String(argItem)));
        });

        this.appendChild(docFrag);
      }
    });
  });
})([Element.prototype, Document.prototype, DocumentFragment.prototype]);

仕様書

仕様書 状態 備考
{{SpecName('DOM WHATWG', '#dom-parentnode-append', 'ParentNode.append()')}} {{Spec2('DOM WHATWG')}} 初回定義

ブラウザーの互換性

{{Compat("api.ParentNode.append")}}

関連情報