---
title: Document
slug: Web/API/Document
tags:
  - API
  - DOM
  - Document
  - Interface
  - Reference
translation_of: Web/API/Document
---
<div>{{APIRef("DOM")}}</div>

<p><span class="seoSummary"><strong><code>Document</code></strong> 인터페이스는 브라우저가 불러온 웹 페이지를 나타내며, 페이지 콘텐츠(<a href="/ko/docs/Web/API/Document_object_model/Using_the_W3C_DOM_Level_1_Core">DOM 트리</a>)의 진입점 역할을 수행합니다.</span> DOM 트리는 {{HTMLElement("body")}}와 {{HTMLElement("table")}} 및 <a href="https://developer.mozilla.org/ko/docs/Web/HTML/Element">여러 다른</a> 요소를 포함합니다. <code>Document</code>는 페이지의 URL을 얻거나 문서에 새로운 요소를 생성하는 등의 기능을 전역적으로 제공합니다.</p>

<p>{{inheritanceDiagram}}</p>

<p><code>Document</code> 인터페이스는 모든 종류의 문서에 대한 공통의 속성과 메서드를 묘사합니다. 문서의 유형(<a href="/ko/docs/Web/HTML">HTML</a>, <a href="/ko/docs/Web/XML/XML_introduction">XML</a>, SVG 등)에 따라서 더 다양한 API가 존재합니다. 예컨대 <code>"text/html"</code> 콘텐츠 유형으로 제공되는 HTML 문서는 {{domxref("HTMLDocument")}} 인터페이스도 구현하는 반면, XML과 SVG 문서는 {{domxref("XMLDocument")}} 인터페이스를 구현합니다.</p>

<h2 id="생성자">생성자</h2>

<dl>
 <dt>{{domxref("Document.Document","Document()")}} {{non-standard_inline}}</dt>
 <dd>새로운 <code>Document</code> 객체를 생성합니다.</dd>
</dl>

<h2 id="Properties" name="Properties">속성</h2>

<p><em><code>Documet</code>는 {{domxref("Node")}}와 {{domxref("EventTarget")}} 인터페이스도 상속합니다.</em></p>

<dl>
 <dt>{{domxref("Document.anchors")}} {{readonlyinline}}</dt>
 <dd>문서 내 모든 앵커의 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.body")}}</dt>
 <dd>현재 문서의 {{HTMLElement("body")}} 또는 {{htmlelement("frameset")}} 노드를 반환합니다.</dd>
 <dt>{{domxref("Document.characterSet")}} {{readonlyinline}}</dt>
 <dd>문서에서 사용하는 캐릭터셋을 반환합니다.</dd>
 <dt>{{domxref("Document.compatMode")}} {{readonlyinline}} {{experimental_inline}}</dt>
 <dd>문서의 렌더링 모드가 Quirks와 Strict 중 어떤 것인지 반환합니다.</dd>
 <dt>{{domxref("Document.contentType")}} {{readonlyinline}} {{experimental_inline}}</dt>
 <dd>현재 문서의 MIME 헤더로부터 <code>Content-Type</code>을 반환합니다.</dd>
 <dt>{{domxref("Document.doctype")}} {{readonlyinline}}</dt>
 <dd>현재 문서의 문서 형식 정의(Document Type Definition, DTD)를 반환합니다.</dd>
 <dt>{{domxref("Document.documentElement")}} {{readonlyinline}}</dt>
 <dd>문서의 직속 자식인 {{domxref("Element")}}를 반환합니다. HTML 문서에서는 보통 {{HTMLElement("html")}} 요소를 나타내는 {{domxref("HTMLHtmlElement")}} 객체입니다.</dd>
 <dt>{{domxref("Document.documentURI")}} {{readonlyinline}}</dt>
 <dd>문서의 위치를 문자열로 반환합니다.</dd>
 <dt>{{domxref("Document.embeds")}} {{readonlyinline}}</dt>
 <dd>현재 문서에 포함된 {{HTMLElement("embed")}} 요소 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.fonts")}}</dt>
 <dd>현재 문서의 {{domxref("FontFaceSet")}} 인터페이스를 반환합니다.</dd>
 <dt>{{domxref("Document.forms")}} {{readonlyinline}}</dt>
 <dd>현재 문서의 {{HTMLElement("form")}} 요소 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.head")}} {{readonlyinline}}</dt>
 <dd>현재 문서의 {{HTMLElement("head")}} 요소를 반환합니다.</dd>
 <dt>{{domxref("Document.hidden")}} {{readonlyinline}}</dt>
 <dd>현재 문서의 숨김 여부를 반환합니다.</dd>
 <dt>{{domxref("Document.images")}} {{readonlyinline}}</dt>
 <dd>현재 문서의 이미지 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.implementation")}} {{readonlyinline}}</dt>
 <dd>현재 문서와 연관된 DOM 구현을 반환합니다.</dd>
 <dt>{{domxref("Document.lastStyleSheetSet")}} {{readonlyinline}}</dt>
 <dd>마지막에 활성화된 스타일 시트 세트의 이름을 반환합니다. {{domxref("Document.selectedStyleSheetSet","selectedStyleSheetSet")}} 값을 설정하여 스타일 시트가 변경되기 전에는 <code>null</code> 값을 갖습니다.</dd>
 <dt>{{domxref("Document.links")}} {{readonlyinline}}</dt>
 <dd>문서의 모든 하이퍼링크 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.mozSyntheticDocument")}} {{non-standard_inline}}</dt>
 <dd>문서가 synthetic, 즉 단일 이미지, 비디오, 오디오 파일이나 이와 비슷한 것인 경우 {{jsxref("Boolean")}} <code>true</code>를 반환합니다.</dd>
 <dt>{{domxref("Document.plugins")}} {{readonlyinline}}</dt>
 <dd>사용 가능한 플러그인의 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.policy")}} {{readonlyinline}} {{experimental_inline}}</dt>
 <dd>특정 문서에 적용되는 기능 정책을 자성하기 위한 간단한 API 를 제공하는 {{domxref("Policy")}} 인터페이스를 반환합니다.</dd>
 <dt>{{domxref("Document.preferredStyleSheetSet")}} {{readonlyinline}}</dt>
 <dd>페이지 작성자가 지정한 선호 스타일 시트 세트를 반환합니다.</dd>
 <dt>{{domxref("Document.scripts")}} {{readonlyinline}}</dt>
 <dd>문서의 모든 {{HTMLElement("script")}} 요소를 반환합니다.</dd>
 <dt>{{domxref("Document.scrollingElement")}} {{readonlyinline}}</dt>
 <dd>문서를 스크롤 하는 {{domxref("Element")}}에 대한 참조를 반환합니다.</dd>
 <dt>{{domxref("Document.selectedStyleSheetSet")}}</dt>
 <dd>현재 사용 중인 스타일 시트 세트를 반환합니다.</dd>
 <dt>{{domxref("Document.styleSheetSets")}} {{readonlyinline}}</dt>
 <dd>문서에서 사용 가능한 스타일 시트 세트의 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.timeline")}} {{readonlyinline}}</dt>
 <dd>페이지 로드 시 자동으로 생성하는 {{domxref("DocumentTimeline")}}의 인스턴스를 반환합니다.</dd>
 <dt>{{domxref("Document.undoManager")}} {{readonlyinline}} {{experimental_inline}}</dt>
 <dd>…</dd>
 <dt>{{domxref("Document.visibilityState")}} {{readonlyinline}}</dt>
 <dd>문서의 표시 상태를 나타내는 문자열을 반환합니다. 가능한 값은 <code>visible</code>, <code>hidden</code>, <code>prerender</code>, <code>unloaded</code>입니다.</dd>
</dl>

<p><code>Document</code> 인터페이스는 {{domxref("ParentNode")}} 인터페이스를 확장합니다.</p>

<p>{{page("/ko/docs/Web/API/ParentNode","속성")}}</p>

<h3 id="HTMLDocument_확장">HTMLDocument 확장</h3>

<p>HTML 문서를 위한 <code>Document</code> 인터페이스는 HTML5 이전엔 {{domxref("HTMLDocument")}} 인터페이스를 상속하고, 이후로는 확장합니다.</p>

<dl>
 <dt>{{domxref("Document.cookie")}}</dt>
 <dd>문서의 쿠키 리스트를 세미콜론으로 분리해 반환하거나, 하나의 쿠키를 설정합니다.</dd>
 <dt>{{domxref("Document.defaultView")}} {{readonlyinline}}</dt>
 <dd>{{domxref("Window")}} 객체의 참조를 반환합니다.</dd>
 <dt>{{domxref("Document.designMode")}}</dt>
 <dd>문서 전체의 수정 가능 여부를 설정/반환합니다.</dd>
 <dt>{{domxref("Document.dir")}}</dt>
 <dd>문서의 쓰기 방향(rtl/ltr)을 설정/반환합니다.</dd>
 <dt>{{domxref("Document.domain")}}</dt>
 <dd>현재 문서의 도메인을 설정/반환합니다.</dd>
 <dt>{{domxref("Document.lastModified")}} {{readonlyinline}}</dt>
 <dd>문서가 마지막으로 수정된 날짜를 반환합니다.</dd>
 <dt>{{domxref("Document.location")}} {{readonlyinline}}</dt>
 <dd>현재 문서의 URI를 반환합니다.</dd>
 <dt>{{domxref("Document.readyState")}} {{readonlyinline}}</dt>
 <dd>문서의 불러오기 상태를 반환합니다.</dd>
 <dt>{{domxref("Document.referrer")}} {{readonlyinline}}</dt>
 <dd>현재 페이지로 연결한 페이지의 URI를 반환합니다.</dd>
 <dt>{{domxref("Document.title")}}</dt>
 <dd>문서의 제목을 설정하거나 반환합니다.</dd>
 <dt>{{domxref("Document.URL")}} {{readonlyInline}}</dt>
 <dd>문서의 위치를 문자열로 반환합니다.</dd>
</dl>

<h3 id="DocumentOrShadowRoot에서_포함한_속성">DocumentOrShadowRoot에서 포함한 속성</h3>

<p><code>Document</code> 인터페이스는 {{domxref("DocumentOrShadowRoot")}} 믹스인이 정의하는 다음의 속성을 포함합니다. 지금은 Chrome만 <code>DocumentOrShadowRoot</code> 믹스인으로 구현한 상태라는 점에 유의하세요. 다른 브라우저는 <code>Document</code> 인터페이스에 직접 구현합니다.</p>

<dl>
 <dt>{{domxref("DocumentOrShadowRoot.activeElement")}} {{readonlyInline}}</dt>
 <dd>섀도 트리 내에서 포커스를 가진 {{domxref('Element')}} 를 반환합니다.</dd>
 <dt>{{domxref("Document.fullscreenElement")}} {{readonlyinline}}</dt>
 <dd>현재 문서에서 전체 화면 모드 중인 요소를 반환합니다.</dd>
 <dt>{{domxref("DocumentOrShadowRoot.pointerLockElement")}} {{readonlyinline}} {{experimental_inline}}</dt>
 <dd>포인터가 잠긴 동안 마우스 이벤트의 대상으로 설정한 요소를 반환합니다. 잠금 대기 중이거나, 포인터의 잠금이 해제됐거나, 대상이 다른 문서에 존재하는 경우 <code>null</code>입니다.</dd>
 <dt>{{domxref("DocumentOrShadowRoot.styleSheets")}} {{readonlyInline}}</dt>
 <dd>문서가 포함하거나 명시적으로 연결한 스타일 시트를 나타내는, {{domxref("CSSStyleSheet")}}의 {{domxref("StyleSheetList")}} 객체를 반환합니다.</dd>
</dl>

<h3 id="Event_handlers" name="Event_handlers">이벤트 처리기</h3>

<dl>
 <dt>{{domxref("Document.onafterscriptexecute")}} {{non-standard_inline}}</dt>
 <dd>{{event("afterscriptexecute")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
 <dt>{{domxref("Document.onbeforescriptexecute")}} {{non-standard_inline}}</dt>
 <dd>{{event("beforescriptexecute")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
 <dt>{{domxref("Document.oncopy")}} {{non-standard_inline}}</dt>
 <dd>{{event("copy")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
 <dt>{{domxref("Document.oncut")}} {{non-standard_inline}}</dt>
 <dd>{{event("cut")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
 <dt>{{domxref("Document.onfullscreenchange")}}</dt>
 <dd>{{event("fullscreenchange")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
 <dt>{{domxref("Document.onfullscreenerror")}}</dt>
 <dd>{{event("fullscreenerror")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
 <dt>{{domxref("Document.onpaste")}} {{non-standard_inline}}</dt>
 <dd>{{event("paste")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
 <dt>{{domxref("Document.onreadystatechange")}}</dt>
 <dd>{{event("readystatechange")}} 이벤트를 위한 이벤트 핸들링 코드를 나타냅니다.</dd>
 <dt>{{domxref("Document.onselectionchange")}} {{experimental_inline}}</dt>
 <dd>{{event("selectionchange")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
 <dt>{{domxref("Document.onvisibilitychange")}}</dt>
 <dd>{{event("visibilitychange")}} 이벤트가 발생할 때 호출되는 코드를 나타내는 {{domxref("EventHandler")}} 입니다.</dd>
</dl>

<p><code>Document</code> 인터페이스는 {{domxref("GlobalEventHandlers")}} 인터페이스를 확장합니다.</p>

<p>{{Page("/ko/docs/Web/API/GlobalEventHandlers", "속성")}}</p>

<h3 id="사용하지_않는_속성">사용하지 않는 속성</h3>

<dl>
 <dt>{{domxref("Document.alinkColor")}} {{Deprecated_inline}}</dt>
 <dd>다큐먼트 바디에 있는 활성 링크의 색상을 설정하거나 반환합니다.</dd>
 <dt>{{domxref("Document.all")}} {{Deprecated_inline}} {{non-standard_inline}}</dt>
 <dd>다큐먼트의 모든 엘리먼트로의 접근을 제공합니다. 레거시이며 비표준 속성이므로 사용되면 안됩니다.</dd>
 <dt>{{domxref("Document.applets")}} {{Deprecated_inline}} {{readonlyinline}}</dt>
 <dd>다큐먼트에 있는 애플릿의 정렬된 리스트를 반환합니다.</dd>
 <dt>{{domxref("Document.async")}} {{Deprecated_inline}}</dt>
 <dd>{{domxref("Document.load")}} 와 사용되어 비동기 요청을 나타냅니다.</dd>
 <dt>{{domxref("Document.bgColor")}} {{Deprecated_inline}}</dt>
 <dd>현재 다큐먼트의 배경 색상을 설정하거나 반환합니다.</dd>
 <dt>{{domxref("Document.charset")}} {{readonlyinline}} {{Deprecated_inline}}</dt>
 <dd>{{domxref("Document.characterSet")}} 과 동일합니다. {{domxref("Document.characterSet")}} 속성을 사용하시기 바랍니다.</dd>
 <dt>{{domxref("Document.domConfig")}} {{Deprecated_inline}}</dt>
 <dd>{{domxref("DOMConfiguration")}} 객체를 반환합니다.</dd>
 <dt>{{domxref("document.fgColor")}} {{Deprecated_inline}}</dt>
 <dd>현재 다큐먼트의 foreground 색상이나 텍스트 색상을 설정하거나 반환합니다.</dd>
 <dt>{{domxref("Document.fullscreen")}} {{obsolete_inline}}</dt>
 <dd>다큐먼트가 {{domxref("Using_full-screen_mode","full-screen mode")}}에 있을 때 <code>true</code> 를 반환합니다.</dd>
 <dt>{{domxref("Document.height")}} {{non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>현재 다큐먼트의 높이를 설정하거나 반환합니다.</dd>
 <dt>{{domxref("Document.inputEncoding")}} {{readonlyinline}} {{Deprecated_inline}}</dt>
 <dd>{{domxref("Document.characterSet")}} 과 동일합니다. {{domxref("Document.characterSet")}} 속성을 사용하시기 바랍니다.</dd>
 <dt>{{domxref("Document.linkColor")}} {{Deprecated_inline}}</dt>
 <dd>다큐먼트내 하이퍼링크의 색상을 설정하거나 반환합니다.</dd>
 <dt>{{domxref("Document.vlinkColor")}} {{Deprecated_inline}}</dt>
 <dd>방문한 하이퍼링크의 색상을 설정하거나 반환합니다.</dd>
 <dt>{{domxref("Document.width")}} {{non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>현재 다큐먼트의 너비를 반환합니다.</dd>
 <dt>{{domxref("Document.xmlEncoding")}} {{Deprecated_inline}}</dt>
 <dd>XML 선언으로 결정된 인코딩을 반환합니다.</dd>
 <dt>{{domxref("Document.xmlStandalone")}} {{obsolete_inline("10.0")}}</dt>
 <dd>XML 선언이 다큐먼트를 독립되도록 지정하면 <code>true</code> 를(<em>예,</em> DTD 의 외부가 다큐먼트의 컨텐츠에 영향을 줌), 그렇지 않은 경우 <code>false</code> 를 반환합니다.</dd>
 <dt>{{domxref("Document.xmlVersion")}} {{obsolete_inline("10.0")}}</dt>
 <dd>XML 선언에 명시된 버전 넘버를 반환합니다. 선언에 명시되어 있지 않은 경우, <code>"1.0"</code> 을 반환합니다.</dd>
</dl>

<h2 id="Methods" name="Methods">메서드</h2>

<p><em><code>Documet</code>는 {{domxref("Node")}}와 {{domxref("EventTarget")}} 인터페이스도 상속합니다.</em></p>

<dl>
 <dt>{{domxref("Document.adoptNode()")}}</dt>
 <dd>외부 문서로부터 노드를 가져옵니다.</dd>
 <dt>{{domxref("Document.captureEvents()")}} {{Deprecated_inline}}</dt>
 <dd>{{domxref("Window.captureEvents")}}를 확인하세요.</dd>
 <dt>{{domxref("Document.caretRangeFromPoint()")}}{{non-standard_inline}}</dt>
 <dd>지정한 좌표에 위치한 문서 프래그먼트에 대한 {{domxref("Range")}} 객체를 반환합니다.</dd>
 <dt>{{domxref("Document.createAttribute()")}}</dt>
 <dd>새로운 {{domxref("Attr")}} 객체를 생성하고 반환합니다.</dd>
 <dt>{{domxref("Document.createAttributeNS()")}}</dt>
 <dd>주어진 네임스페이스에 새로운 속성 노드를 생성하고 반환합니다.</dd>
 <dt>{{domxref("Document.createCDATASection()")}}</dt>
 <dd>새로운 CDATA 노드를 생성하고 반환합니다.</dd>
 <dt>{{domxref("Document.createComment()")}}</dt>
 <dd>새로운 주석 노드를 생성하고 반환합니다.</dd>
 <dt>{{domxref("Document.createDocumentFragment()")}}</dt>
 <dd>새로운 문서 조각을 생성합니다.</dd>
 <dt>{{domxref("Document.createElement()")}}</dt>
 <dd>주어진 태그명을 사용해 새로운 요소를 생성합니다.</dd>
 <dt>{{domxref("Document.createElementNS()")}}</dt>
 <dd>주어진 태그명과 네임스페이스 URI를 갖는 새로운 요소를 생성합니다.</dd>
 <dt>{{domxref("Document.createEntityReference()")}} {{obsolete_inline}}</dt>
 <dd>새로운 개체 참조를 생성하고 반환합니다.</dd>
 <dt>{{domxref("Document.createEvent()")}}</dt>
 <dd>이벤트 객체를 생성합니다.</dd>
 <dt>{{domxref("Document.createNodeIterator()")}}</dt>
 <dd>{{domxref("NodeIterator")}} 객체를 생성합니다.</dd>
 <dt>{{domxref("Document.createProcessingInstruction()")}}</dt>
 <dd>새로운 {{domxref("ProcessingInstruction")}} 객체를 생성합니다.</dd>
 <dt>{{domxref("Document.createRange()")}}</dt>
 <dd>{{domxref("Range")}} 객체를 생성합니다.</dd>
 <dt>{{domxref("Document.createTextNode()")}}</dt>
 <dd>텍스트 노드를 생성합니다.</dd>
 <dt>{{domxref("Document.createTouch()")}} {{Deprecated_inline}}</dt>
 <dd>{{domxref("Touch")}} 객체를 생성합니다.</dd>
 <dt>{{domxref("Document.createTouchList()")}}</dt>
 <dd>{{domxref("TouchList")}} 객체를 생성합니다.</dd>
 <dt>{{domxref("Document.createTreeWalker()")}}</dt>
 <dd>{{domxref("TreeWalker")}} 객체를 생성합니다.</dd>
 <dt>{{domxref("Document.enableStyleSheetsForSet()")}}</dt>
 <dd>지정한 스타일 시트 세트의 스타일 시트를 활성화합니다.</dd>
 <dt>{{domxref("Document.exitPointerLock()")}} {{experimental_inline}}</dt>
 <dd>포인터 잠금을 해제합니다.</dd>
 <dt>{{domxref("Document.getAnimations()")}} {{experimental_inline}}</dt>
 <dd>문서의 자손 요소를 대상으로 하고, 현재 실행 중인 모든 {{domxref("Animation")}} 객체를 배열로 반환합니다.</dd>
 <dt>{{domxref("Document.getElementsByClassName()")}}</dt>
 <dd>주어진 클래스 이름을 갖는 요소의 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.getElementsByTagName()")}}</dt>
 <dd>주어진 태그명을 갖는 요소의 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.getElementsByTagNameNS()")}}</dt>
 <dd>주어진 태그명과 네임스페이스를 갖는 요소의 목록을 반환합니다.</dd>
 <dt>{{domxref("Document.hasStorageAccess()")}}</dt>
 <dd>문서가 퍼스트파티<sup>first-party</sup> 저장소에 접근할 수 있는지 나타내는 {{jsxref("Boolean")}}으로 이행하는 {{jsxref("Promise")}}를 반환합니다.</dd>
 <dt>{{domxref("Document.importNode()")}}</dt>
 <dd>외부 문서의 노드 복제본을 반환합니다.</dd>
 <dt>{{domxref("Document.normalizeDocument()")}} {{obsolete_inline}}</dt>
 <dd>개체 대체, 텍스트 노드 정규화 등의 작업을 실행합니다.</dd>
 <dt>{{domxref("Document.releaseCapture()")}} {{non-standard_inline}}</dt>
 <dd>문서의 요소에 현재 마우스 캡쳐가 있다면 이를 해제합니다.</dd>
 <dt>{{domxref("Document.releaseEvents()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt>
 <dd>{{domxref("Window.releaseEvents()")}}를 확인하세요.</dd>
 <dt>{{domxref("Document.requestStorageAccess()")}}</dt>
 <dd>퍼스트파티<sup>first-party</sup> 저장소로의 접근이 가능한 경우 이행하고 불가능한 경우 거부하는 {{jsxref("Promise")}}를 반환합니다.</dd>
 <dt>{{domxref("Document.routeEvent()")}} {{non-standard_inline}} {{obsolete_inline(24)}}</dt>
 <dd>{{domxref("Window.routeEvent()")}}를 확인하세요.</dd>
 <dt>{{domxref("Document.mozSetImageElement()")}} {{non-standard_inline}}</dt>
 <dd>지정한 요소 ID를 위한 배경 이미지로 사용되도록 요소 변경을 허용합니다.</dd>
</dl>

<p><code>Document</code> 인터페이스는 {{domxref("ParentNode")}} 인터페이스를 확장합니다.</p>

<dl>
 <dt>{{domxref("document.getElementById()")}}</dt>
 <dd>주어진 ID를 가진 요소의 참조를 반환합니다.</dd>
 <dt>{{domxref("document.querySelector()")}}</dt>
 <dd>문서 내에서 주어진 선택자를 만족하는 첫 번째 {{jsxref("Element")}}를 반환합니다.</dd>
 <dt>{{domxref("document.querySelectorAll()")}}</dt>
 <dd>주어진 선택자를 만족하는 모든 요소의 {{jsxref("NodeList")}}를 반환합니다.</dd>
</dl>

<p><code>Document</code> 인터페이스는 {{domxref("XPathEvaluator")}} 인터페이스를 확장합니다.</p>

<dl>
 <dt>{{domxref("document.createExpression()")}}</dt>
 <dd>나중에 (여러 번) 평가할 수 있도록 <code><a href="https://developer.mozilla.org/en-US/docs/XPathExpression" title="XPathExpression">XPathExpression</a></code>을 컴파일합니다.</dd>
 <dt>{{domxref("document.createNSResolver()")}}</dt>
 <dd>{{domxref("XPathNSResolver")}} 객체를 생성합니다.</dd>
 <dt>{{domxref("document.evaluate()")}}</dt>
 <dd>XPath 표현을 평가합니다.</dd>
</dl>

<h3 id="HTML_문서의_확장">HTML 문서의 확장</h3>

<p>HTML 문서를 위한 <code>Document</code> 인터페이스는 HTML5 이전엔 {{domxref("HTMLDocument")}} 인터페이스를 상속하고, 이후로는 확장합니다.</p>

<dl>
 <dt>{{domxref("document.clear()")}} {{non-standard_inline}} {{Deprecated_inline}}</dt>
 <dd>최근의 Firefox와 Internet Explorer를 포함하는 주요 최신 브라우저에서, 이 메소드는 아무것도 하지 않습니다.</dd>
 <dt>{{domxref("document.close()")}}</dt>
 <dd>작성을 위한 문서 스트림을 닫습니다.</dd>
 <dt>{{domxref("document.execCommand()")}}</dt>
 <dd>수정 가능한 문서에서 서식 명령을 실행합니다.</dd>
 <dt>{{domxref("document.getElementsByName()")}}</dt>
 <dd>주어진 이름을 갖는 요소의 목록을 반환합니다.</dd>
 <dt>{{domxref("document.hasFocus()")}}</dt>
 <dd>포커스가 지정한 문서 내 어느 곳이든 위치한 경우 <code>true</code>를 반환합니다.</dd>
 <dt>{{domxref("document.open()")}}</dt>
 <dd>작성을 위한 문서 스트림을 엽니다.</dd>
 <dt>{{domxref("document.queryCommandEnabled()")}}</dt>
 <dd>현재 범위에서 서식 명령을 실행할 수 있다면 <code>true</code>를 반환합니다.</dd>
 <dt>{{domxref("document.queryCommandIndeterm()")}}</dt>
 <dd>현재 범위에서 서식 명령의 상태를 알 수 없으면 <code>true</code>를 반환합니다.</dd>
 <dt>{{domxref("document.queryCommandState()")}}</dt>
 <dd>현재 범위에서 서식 명령을 실행했다면 <code>true</code>를 반환합니다.</dd>
 <dt>{{domxref("document.queryCommandSupported()")}}</dt>
 <dd>현재 범위에서 서식 명령이 지원된다면 <code>true</code>를 반환합니다.</dd>
 <dt>{{domxref("document.queryCommandValue()")}}</dt>
 <dd>현재 범위에서 서식 명령을 위한 현재 값을 반환합니다.</dd>
 <dt>{{domxref("document.write()")}}</dt>
 <dd>문서에 텍스트를 작성합니다.</dd>
 <dt>{{domxref("document.writeln()")}}</dt>
 <dd>문서에 텍스트 한 줄을 작성합니다.</dd>
</dl>

<h3 id="DocumentOrShadowRoot로부터_포함된_메소드">DocumentOrShadowRoot로부터 포함된 메소드</h3>

<p><code>Document</code> 인터페이스는 {{domxref("DocumentOrShadowRoot")}} 믹스인<sup>mixin</sup>이 정의하는 다음의 메서드를 포함합니다. 지금은 Chrome만 구현한 상태라는 점에 유의하세요. 다른 브라우저는 <code>Document</code> 인터페이스에 구현 중입니다.</p>

<dl>
 <dt>{{domxref("DocumentOrShadowRoot.getSelection()")}}</dt>
 <dd>사용자에의해 선택된 텍스트의 범위 또는 캐럿의 현재 위치를 나타내는 {{domxref('Selection')}} 객체를 반환합니다.</dd>
 <dt>{{domxref("DocumentOrShadowRoot.elementFromPoint()")}}</dt>
 <dd>지정한 위치에 있는 최상단 엘리먼트를 반환합니다.</dd>
 <dt>{{domxref("DocumentOrShadowRoot.elementsFromPoint()")}}</dt>
 <dd>지정한 위치에 있는 모든 엘리먼트의 배열을 반환합니다.</dd>
 <dt>{{domxref("DocumentOrShadowRoot.caretPositionFromPoint()")}}</dt>
 <dd>캐럿을 포함하는 DOM 노드와 그 노드내 캐첫의 문자 오프셋을 포함하는 {{domxref('CaretPosition')}} 객체를 반환합니다.</dd>
</dl>

<h2 id="비표준_확장_non-standard_inline">비표준 확장 {{non-standard_inline}}</h2>

<p>{{non-standard_header}}</p>

<h3 id="Firefox_노트">Firefox 노트</h3>

<p>Mozilla는 XUL 컨텐츠만을 위해 만들어진 비표준 속성의 집합을 정의합니다.</p>

<dl>
 <dt>{{domxref("document.currentScript")}} {{non-standard_inline}}</dt>
 <dd>현재 실행중인 {{HTMLElement("script")}} 엘리먼트를 반환합니다.</dd>
 <dt>{{domxref("document.documentURIObject")}}</dt>
 <dd>(<strong>Mozilla 부가 기능 전용!</strong>) 다큐먼트의 URI 를 나타내는 {{Interface("nsIURI")}} 객체를 반환합니다. 이 속성은 권한을 가진 자바스크립트 코드(UniversalXPConnect 권한을 갖는)에서만 특별한 의미를 갖습니다.</dd>
 <dt>{{domxref("document.popupNode")}}</dt>
 <dd>팝업이 불려진 노드를 반환합니다.</dd>
 <dt>{{domxref("document.tooltipNode")}}</dt>
 <dd>현재 툴팁의 대상이되는 노드를 반환합니다.</dd>
</dl>

<p>Mozilla 는 또한 일부 비표준 메소드를 정의합니다.</p>

<dl>
 <dt>{{domxref("document.execCommandShowHelp")}} {{obsolete_inline("14.0")}}</dt>
 <dd>이 메소드는 아무것도 하지 않았지만 항상 예외를 발생시켰으므로 Gecko 14.0 {{geckoRelease("14.0")}} 에서 제거되었습니다.</dd>
 <dt>{{domxref("document.getBoxObjectFor")}} {{obsolete_inline}}</dt>
 <dd>{{domxref("Element.getBoundingClientRect()")}} 메소드를 대신 사용하세요.</dd>
 <dt>{{domxref("document.loadOverlay")}}</dt>
 <dd><a href="https://developer.mozilla.org/ko/docs/Mozilla/Tech/XUL" title="XUL_Overlays">XUL 오버레이</a>를 동적으로 로드합니다. XUL 다큐먼트에서만 동작합니다.</dd>
 <dt>{{domxref("document.queryCommandText")}} {{obsolete_inline("14.0")}}</dt>
 <dd>이 메소드는 아무것도 하지 않았지만 예외를 발생시켰으므로 Gecko 14.0 {{geckoRelease("14.0")}} 에서 제거되었습니다.</dd>
</dl>

<h3 id="Internet_Explorer_노트">Internet Explorer 노트</h3>

<p>Microsoft는 일부 비표준 속성을 정의합니다.</p>

<dl>
 <dt>{{domxref("document.fileSize")}}* {{non-standard_inline}} {{obsolete_inline}}</dt>
 <dd>Returns size in bytes of the document. Starting with Internet Explorer 11, that property is no longer supported. See <a href="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx" title="http://msdn.microsoft.com/en-us/library/ms533752%28v=VS.85%29.aspx">MSDN</a>.</dd>
</dl>

<p>Internet Explorer는 <code>Document</code> 인터페이스내 <code>Node</code> 인터페이스의 모든 메소드를 지원하지 않습니다:</p>

<dl>
 <dt>{{domxref("document.contains")}}</dt>
 <dd>대안으로 <code>document.body.contains()</code> 를 사용할 수 있습니다.</dd>
</dl>

<h2 id="명세">명세</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">명세</th>
   <th scope="col">상태</th>
   <th scope="col">코멘트</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName("DOM WHATWG", "#interface-document", "Document")}}</td>
   <td>{{Spec2("DOM WHATWG")}}</td>
   <td>DOM 3 대체 의도</td>
  </tr>
  <tr>
   <td>{{SpecName("HTML WHATWG", "dom.html#the-document-object", "Document")}}</td>
   <td>{{Spec2("HTML WHATWG")}}</td>
   <td>{{domxref("HTMLDocument")}} 인터페이스를 <code>Document</code> 확장으로 전환.</td>
  </tr>
  <tr>
   <td>{{SpecName("HTML Editing", "#dom-document-getselection", "Document")}}</td>
   <td>{{Spec2("HTML Editing")}}</td>
   <td><code>Document</code> 인터페이스 확장</td>
  </tr>
  <tr>
   <td>{{SpecName("CSSOM View", "#extensions-to-the-document-interface", "Document")}}</td>
   <td>{{Spec2("CSSOM View")}}</td>
   <td><code>Document</code> 인터페이스 확장</td>
  </tr>
  <tr>
   <td>{{SpecName("CSSOM", "#extensions-to-the-document-interface", "Document")}}</td>
   <td>{{Spec2("CSSOM")}}</td>
   <td><code>Document</code> 인터페이스 확장</td>
  </tr>
  <tr>
   <td>{{SpecName("Pointer Lock", "#extensions-to-the-document-interface", "Document")}}</td>
   <td>{{Spec2("Pointer Lock")}}</td>
   <td><code>Document</code> 인터페이스 확장</td>
  </tr>
  <tr>
   <td>{{SpecName("Page Visibility API", "#extensions-to-the-document-interface", "Document")}}</td>
   <td>{{Spec2("Page Visibility API")}}</td>
   <td><code>visibilityState</code> 와 <code>hidden</code> 속성과 <code>onvisibilitychange</code> 이벤트 리스너를 갖도록 <code>Document</code> 인터페이스 확장.</td>
  </tr>
  <tr>
   <td>{{SpecName("Selection API", "#extensions-to-document-interface", "Document")}}</td>
   <td>{{Spec2("Selection API")}}</td>
   <td><code>getSelection()</code>, <code>onselectstart</code> 와 <code>onselectionchange</code> 추가.</td>
  </tr>
  <tr>
   <td>{{SpecName("DOM4", "#interface-document", "Document")}}</td>
   <td>{{Spec2("DOM4")}}</td>
   <td>DOM 3 대체</td>
  </tr>
  <tr>
   <td>{{SpecName("DOM3 Core", "#i-Document", "Document")}}</td>
   <td>{{Spec2("DOM3 Core")}}</td>
   <td>DOM 2 대체</td>
  </tr>
  <tr>
   <td>{{SpecName("DOM3 XPath", "xpath.html#XPathEvaluator", "XPathEvaluator")}}</td>
   <td>{{Spec2("DOM3 XPath")}}</td>
   <td>다큐먼트를 확장하는 {{domxref("XPathEvaluator")}} 인터페이스 정의.</td>
  </tr>
  <tr>
   <td>{{SpecName("DOM2 Core", "#i-Document", "Document")}}</td>
   <td>{{Spec2("DOM2 Core")}}</td>
   <td>DOM 1 대체</td>
  </tr>
  <tr>
   <td>{{SpecName("DOM1", "#i-Document", "Document")}}</td>
   <td>{{Spec2("DOM1")}}</td>
   <td>인터페이스 초기 정의</td>
  </tr>
 </tbody>
</table>

<h2 id="브라우저_호환성">브라우저 호환성</h2>



<p>{{Compat("api.Document")}}</p>