This page was translated from English by the community.Learn more and join the MDN Web Docs community.
Document: append() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2018년 4월.
Document.append() 메서드는Node 객체 혹은 문자열의 집합을문서의 마지막 요소에 삽입합니다.문자열은Text 노드들과 동등하게 삽입됩니다.
이 메서드는Document 의 자식 메서드입니다. 트리에 임의의 요소를 삽입하려면Element.append() 를 참고하세요.
구문
js
append(param1)append(param1, param2)append(param1, param2, /* …, */ paramN)매개변수
param1, …,paramN삽입하려는
Node객체 혹은 문자열의 집합입니다.
반환 값
(undefined) 이 아닙니다.
예외
HierarchyRequestErrorDOMException노드가 계층의 특정 지점에 삽입될 수 없을 때 발생합니다.
예제
문서의 최상위 요소에 추가하기
HTML 문서에 요소를 추가하려 하면 주어진<html> 요소가 이미 존재한다는HierarchyRequestErrorDOMException 예외가 발생할 수 있습니다.
js
let html = document.createElement("html");document.append(html);// HierarchyRequestError: The operation would yield an incorrect node tree.기존에 요소가 존재하지 않는 새 문서를 생성하려고 한다면 최상위 HTML 요소(혹은 최상휘 SVG 요소)를 추가할 수 있습니다.
js
let doc = new Document();let html = document.createElement("html");doc.append(html);doc.children; // HTMLCollection [<html>]명세서
| Specification |
|---|
| DOM # ref-for-dom-parentnode-append① |