Ви читаєте англійську версію цього вмісту, бо ще не існує перекладу для цієї мови. Допоможіть нам перекласти цю статтю!
Document
інтерфейс представляє будь-яку веб-сторінку, завантажену в браузер і яка слугує точкою входу в контент веб-сторінки, чим є DOM tree. DOM tree включає елементи такі як <body>
і <table>
, серед багатьох інших. Це забезпечує глобальну функціональність для документу, таку як отримувати URL сторінки і створювати нові елементи в документі.
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/uk/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/uk/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/uk/docs/Web/API/Document" target="_top"><rect x="266" y="1" width="80" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="306" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Document</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
Інтерфейс Document
описує загальні властивості і методи для будь-якого типу документу. Залежно від типу документу (e.g. HTML, XML, SVG, …), більший API доступний: HTML-документи, які подаються з text/html
типом контенту, також реалізовують HTMLDocument
інтерфейс, тоді як XML і SVG документи реалізовують XMLDocument
інтерфейс.
Конструктор
Document()
- Створює новий
Document
об'єкт.
Властивості
Цей інтерфейс також розширює Node
і EventTarget
інтерфейси.
Document.all
- Забезпечує доступ до всіх елементів в документі. Це застарілий, нестандартний інтерфейс і він не повинен використовуватись.
Document.async
- Використовується з
Document.load
щоб вказати асинхронний запит. Document.body
- Повертає
<body>
, або<frameset>
вузол поточного документу. Document.characterSet
Read only- Повертає кодування, яке використовується в документі.
Document.charset
Read only- Псевдонім для
Document.characterSet
. Використовуй цю властивість взамін. Document.compatMode
Read only- Вказує чи документ інтерпретується в quirks чи strict режимі.
Document.contentType
Read only- Повертає Content-Type з MIME-заголовку поточного документу.
Document.doctype
Read only- Повертає Визначення Типу Документу (DTD) поточного документу.
Document.documentElement
Read only- Повертає
Element
, який є прямим нащадком document. Для HTML-документів, це, як правило,HTMLElement
елемент. Document.documentURI
Read only- Повертає розміщення документу у вигляді стрічки.
Document.domConfig
- Повинна повертати
DOMConfiguration
об'єкт. Document.fullscreen
true,
якщо документ вfull-screen mode
.Document.hidden
Read only- …
Document.implementation
Read only- Повертає DOM реалізацію, асоційовану з поточним документом.
Document.inputEncoding
Read only- Псевдонім для
Document.characterSet
. Використовуй цю властивість взамін. Document.lastStyleSheetSet
Read only- Повертає ім'я набору стилів, які були останніми включені. Має значення
null,
аж поки таблиця стилів змінена встановленням значенняselectedStyleSheetSet
. Document.mozSyntheticDocument
- Повертає
Boolean
, яким єtrue
лише якщо цей документ є синтетичним, таким як окреме зображення, відео-, аудіо-файл, або т. п. Document.mozFullScreenElement
Read only- Елемент, який зараз є в повноекранному режимі для цього документу.
Document.mozFullScreenEnabled
Read onlytrue,
якщо викликElement.mozRequestFullscreen()
буде успішним в поточному документі.Document.preferredStyleSheetSet
Read only- Повертає бажаний набір стилів, як вказано автором сторінки.
Document.scrollingElement
Read only- Повертає посилання на
Element
,який прокручує документ. Document.selectedStyleSheetSet
- Повертає набір стилів, який зараз у використанні.
Document.styleSheetSets
Read only- Повертає список наборів стилів, доступних для документу.
Document.timeline
Read only- …
Document.undoManager
Read only- …
Document.visibilityState
Read only-
Повертає
string,
яка виражає видимість стану документу. Можливими значеннями єvisible
,hidden
,prerender
, іunloaded
. Document.xmlEncoding
- Повертає кодування, як визначено XML-оголошенням.
Document.xmlStandalone
Obsolete since Gecko 10.0- Повертає
true,
якщо оголошення XML вказує документу бути автономним (e.g., Зовнішня частина DTD впливає на контент документу), абоfalse
. Document.xmlVersion
Obsolete since Gecko 10.0- Повертає номер версії, як вказано в XML-оголошенні, або
"1.0",
якщо оголошення відсутнє.
Document
інтерфейс розширюється ParentNode
інтерфейсом:
ParentNode.childElementCount
Read only- Returns the number of children of this
ParentNode
which are elements. ParentNode.children
Read only- Returns a live
HTMLCollection
containing all of theElement
objects that are children of thisParentNode
, omitting all of its non-element nodes. ParentNode.firstElementChild
Read only- Returns the first node which is both a child of this
ParentNode
and is also anElement
, ornull
if there is none. ParentNode.lastElementChild
Read only- Returns the last node which is both a child of this
ParentNode
and is anElement
, ornull
if there is none.
Розширення для HTML-документу
Інтерфейс Document
для HTML-документів розширює HTMLDocument
інтерфейс, або, починаючи з HTML5, розширюється для таких документів.
Document.alinkColor
- Повертає або встановлює колір активних посилань в тілі документу.
Document.anchors
- Повертає список всіх якорів в документі.
Document.applets
- Повертає впорядкований список апплетів в межах документу.
Document.bgColor
- Отримує/встановлює фоновий колір поточного документу.
Document.cookie
- Повертає список куків, розділених крапкою з комою, для того документу або встановлює одиничний кукі.
Document.defaultView
Read only- Повертає посилання на об'єкт window.
Document.designMode
- Отримує/встановлює можливість редагування цілого документу.
Document.dir
Read only- Отримує/встановлює направленість (rtl - справа наліво/ltr зліва направо) документу.
Document.domain
- Отримує/встановлює домен поточного документу.
Document.embeds
Read only- Повертає список вбудованих
<embed>
елементів в межах поточного документу. document.fgColor
- Отримує/встановлює колір переднього плану, або колір тексту поточного документу.
Document.forms
Read only- Повертає список
<form>
елементів в межах поточного документу. Document.head
Read only- Повертає
<head>
елемент поточного документу. Document.height
- Отримує/встановлює висоту поточного документу.
Document.images
Read only- Повертає список зображень в поточному документі.
Document.lastModified
Read only- Повертає дату, коли документ був востаннє змінений.
Document.linkColor
- Отримує/встановлює колір гіперпосилань в документі.
Document.links
Read only- Повертає список всіх гіперпосилань в документі.
Document.location
Read only- Повертає URI поточного документу.
Document.plugins
Read only- Повертає список доступних плагінів.
Document.readyState
Read only- Повертає статус завантаження документу.
Document.referrer
Read only- Повертає URI сторінки, яка прив'язана до цієї сторінки.
Document.scripts
Read only- Повертає всі
<script>
елементи в документі. Document.title
- Встановлює або отримує назву поточного документу.
Document.URL
Read only- Повертає розміщення документу у вигляді стрічки.
Document.vlinkColor
- Отримує/встановлює колір відвіданих гіперпосилань.
Document.width
- Повертає ширину поточного документу.
Властивості, включені з DocumentOrShadowRoot
Інтерфейс Document
включає наступні властивості, визначені в DocumentOrShadowRoot
міксині. Зверни увагу, що це, на даний час, реалізовано в Chrome; інші браузери все ще реалізують їх безпосередньо через Document
інтерфейс.
DocumentOrShadowRoot.activeElement
Read only- Returns the
Element
within the shadow tree that has focus. Document.fullscreenElement
Read only- The element that's currently in full screen mode for this document.
DocumentOrShadowRoot.pointerLockElement
Read only- Returns the element set as the target for mouse events while the pointer is locked.
null
if lock is pending, pointer is unlocked, or if the target is in another document. DocumentOrShadowRoot.styleSheets
Read only- Returns a
StyleSheetList
ofCSSStyleSheet
objects for stylesheets explicitly linked into, or embedded in a document.
Event handlers
Document.onafterscriptexecute
- Represents the event handling code for the
afterscriptexecute
event. Document.onbeforescriptexecute
- Represents the event handling code for the
beforescriptexecute
event. Document.oncopy
- Represents the event handling code for the
copy
event. Document.oncut
- Represents the event handling code for the
cut
event. Document.onfullscreenchange
- Is an
EventHandler
representing the code to be called when thefullscreenchange
event is raised. Document.onfullscreenerror
- Is an
EventHandler
representing the code to be called when thefullscreenerror
event is raised. Document.onpaste
- Represents the event handling code for the
paste
event. Document.onpointerlockchange
- Represents the event handling code for the
pointerlockchange
event. Document.onpointerlockerror
- Represents the event handling code for the
pointerlockerror
event. Document.onreadystatechange
- Represents the event handling code for the
readystatechange
event. Document.onselectionchange
- Is an
EventHandler
representing the code to be called when theselectionchange
event is raised. Document.onvisibilitychange
- Is an
EventHandler
representing the code to be called when thevisibilitychange
event is raised. Document.onwheel
- Represents the event handling code for the
wheel
event.
The Document
interface is extended with the GlobalEventHandlers
interface:
GlobalEventHandlers.onabort
EventHandler
representing the code to be called when the abort
event is raised.GlobalEventHandlers.onanimationcancel
EventHandler
called when an animationcancel
event is sent, indicating that a running CSS animation has been canceled.GlobalEventHandlers.onanimationend
EventHandler
called when an animationend
event is sent, indicating that a CSS animation has stopped playing.GlobalEventHandlers.onanimationiteration
EventHandler
called when an animationiteration
event has been sent, indicating that a CSS animation has begun playing a new iteration of the animation sequence.GlobalEventHandlers.onanimationstart
EventHandler
called when an animationstart
event is sent, indicating that a CSS animation has started playing.GlobalEventHandlers.onauxclick
EventHandler
called when an auxclick
event is sent, indicating that a non-primary button has been pressed on an input device (e.g. a middle mouse button).GlobalEventHandlers.onblur
EventHandler
representing the code to be called when the blur
event is raised.GlobalEventHandlers.onerror
OnErrorEventHandler
representing the code to be called when the error
event is raised.GlobalEventHandlers.onfocus
EventHandler
representing the code to be called when the focus
event is raised.GlobalEventHandlers.oncancel
EventHandler
representing the code to be called when the cancel
event is raised.GlobalEventHandlers.oncanplay
EventHandler
representing the code to be called when the canplay
event is raised.GlobalEventHandlers.oncanplaythrough
EventHandler
representing the code to be called when the canplaythrough
event is raised.GlobalEventHandlers.onchange
EventHandler
representing the code to be called when the change
event is raised.GlobalEventHandlers.onclick
EventHandler
representing the code to be called when the click
event is raised.GlobalEventHandlers.onclose
EventHandler
representing the code to be called when the close
event is raised.GlobalEventHandlers.oncontextmenu
EventHandler
representing the code to be called when the contextmenu
event is raised.GlobalEventHandlers.oncuechange
EventHandler
representing the code to be called when the cuechange
event is raised.GlobalEventHandlers.ondblclick
EventHandler
representing the code to be called when the dblclick
event is raised.GlobalEventHandlers.ondrag
EventHandler
representing the code to be called when the drag
event is raised.GlobalEventHandlers.ondragend
EventHandler
representing the code to be called when the dragend
event is raised.GlobalEventHandlers.ondragenter
EventHandler
representing the code to be called when the dragenter
event is raised.GlobalEventHandlers.ondragexit
EventHandler
representing the code to be called when the dragexit
event is raised.GlobalEventHandlers.ondragleave
EventHandler
representing the code to be called when the dragleave
event is raised.GlobalEventHandlers.ondragover
EventHandler
representing the code to be called when the dragover
event is raised.GlobalEventHandlers.ondragstart
EventHandler
representing the code to be called when the dragstart
event is raised.GlobalEventHandlers.ondrop
EventHandler
representing the code to be called when the drop
event is raised.GlobalEventHandlers.ondurationchange
EventHandler
representing the code to be called when the durationchange
event is raised.GlobalEventHandlers.onemptied
EventHandler
representing the code to be called when the emptied
event is raised.GlobalEventHandlers.onended
EventHandler
representing the code to be called when the ended
event is raised.GlobalEventHandlers.ongotpointercapture
Is an EventHandler
representing the code to be called when the gotpointercapture
event type is raised.
GlobalEventHandlers.oninput
EventHandler
representing the code to be called when the input
event is raised.GlobalEventHandlers.oninvalid
EventHandler
representing the code to be called when the invalid
event is raised.GlobalEventHandlers.onkeydown
EventHandler
representing the code to be called when the keydown
event is raised.GlobalEventHandlers.onkeypress
EventHandler
representing the code to be called when the keypress
event is raised.GlobalEventHandlers.onkeyup
EventHandler
representing the code to be called when the keyup
event is raised.GlobalEventHandlers.onload
EventHandler
representing the code to be called when the load
event is raised.GlobalEventHandlers.onloadeddata
EventHandler
representing the code to be called when the loadeddata
event is raised.GlobalEventHandlers.onloadedmetadata
EventHandler
representing the code to be called when the loadedmetadata
event is raised.GlobalEventHandlers.onloadend
EventHandler
representing the code to be called when the loadend
event is raised (when progress has stopped on the loading of a resource.)GlobalEventHandlers.onloadstart
EventHandler
representing the code to be called when the loadstart
event is raised (when progress has begun on the loading of a resource.)GlobalEventHandlers.onlostpointercapture
Is an EventHandler
representing the code to be called when the lostpointercapture
event type is raised.
GlobalEventHandlers.onmousedown
EventHandler
representing the code to be called when the mousedown
event is raised.GlobalEventHandlers.onmouseenter
EventHandler
representing the code to be called when the mouseenter
event is raised.GlobalEventHandlers.onmouseleave
EventHandler
representing the code to be called when the mouseleave
event is raised.GlobalEventHandlers.onmousemove
EventHandler
representing the code to be called when the mousemove
event is raised.GlobalEventHandlers.onmouseout
EventHandler
representing the code to be called when the mouseout
event is raised.GlobalEventHandlers.onmouseover
EventHandler
representing the code to be called when the mouseover
event is raised.GlobalEventHandlers.onmouseup
EventHandler
representing the code to be called when the mouseup
event is raised.GlobalEventHandlers.onmousewheel
EventHandler
representing the code to be called when the mousewheel
event is raised. Deprecated. Use onwheel
instead.GlobalEventHandlers.onwheel
EventHandler
representing the code to be called when the wheel
event is raised.GlobalEventHandlers.onpause
EventHandler
representing the code to be called when the pause
event is raised.GlobalEventHandlers.onplay
EventHandler
representing the code to be called when the play
event is raised.GlobalEventHandlers.onplaying
EventHandler
representing the code to be called when the playing
event is raised.GlobalEventHandlers.onpointerdown
EventHandler
representing the code to be called when the pointerdown
event is raised.GlobalEventHandlers.onpointermove
EventHandler
representing the code to be called when the pointermove
event is raised.GlobalEventHandlers.onpointerup
EventHandler
representing the code to be called when the pointerup
event is raised.GlobalEventHandlers.onpointercancel
EventHandler
representing the code to be called when the pointercancel
event is raised.GlobalEventHandlers.onpointerover
EventHandler
representing the code to be called when the pointerover
event is raised.GlobalEventHandlers.onpointerout
EventHandler
representing the code to be called when the pointerout
event is raised.GlobalEventHandlers.onpointerenter
EventHandler
representing the code to be called when the pointerevent
event is raised.GlobalEventHandlers.onpointerleave
EventHandler
representing the code to be called when the pointerleave
event is raised.GlobalEventHandlers.onpointerlockchange
EventHandler
representing the code to be called when the pointerlockchange
event is raised.GlobalEventHandlers.onpointerlockerror
EventHandler
representing the code to be called when the pointerlockerror
event is raised.GlobalEventHandlers.onprogress
EventHandler
representing the code to be called when the progress
event is raised.GlobalEventHandlers.onratechange
EventHandler
representing the code to be called when the ratechange
event is raised.GlobalEventHandlers.onreset
EventHandler
representing the code to be called when the reset
event is raised.GlobalEventHandlers.onresize
EventHandler
representing the code to be called when the resize
event is raised.GlobalEventHandlers.onscroll
EventHandler
representing the code to be called when the scroll
event is raised.GlobalEventHandlers.onseeked
EventHandler
representing the code to be called when the seeked
event is raised.GlobalEventHandlers.onseeking
EventHandler
representing the code to be called when the seeking
event is raised.GlobalEventHandlers.onselect
EventHandler
representing the code to be called when the select
event is raised.GlobalEventHandlers.onselectstart
EventHandler
representing the code to be called when the selectionchange
event is raised, i.e. when the user starts to make a new text selection on a web page.GlobalEventHandlers.onselectionchange
EventHandler
representing the code to be called when the selectionchange
event is raised, i.e. when the text selected on a web page changes.GlobalEventHandlers.onshow
EventHandler
representing the code to be called when the show
event is raised.GlobalEventHandlers.onsort
EventHandler
representing the code to be called when the sort
event is raised.GlobalEventHandlers.onstalled
EventHandler
representing the code to be called when the stalled
event is raised.GlobalEventHandlers.onsubmit
EventHandler
representing the code to be called when the submit
event is raised.GlobalEventHandlers.onsuspend
EventHandler
representing the code to be called when the suspend
event is raised.GlobalEventHandlers.ontimeupdate
EventHandler
representing the code to be called when the timeupdate
event is raised.GlobalEventHandlers.onvolumechange
EventHandler
representing the code to be called when the volumechange
event is raised.GlobalEventHandlers.ontouchcancel
EventHandler
representing the code to be called when the touchcancel
event is raised.GlobalEventHandlers.ontouchend
EventHandler
representing the code to be called when the touchend
event is raised.GlobalEventHandlers.ontouchmove
EventHandler
representing the code to be called when the touchmove
event is raised.GlobalEventHandlers.ontouchstart
EventHandler
representing the code to be called when the touchstart
event is raised.GlobalEventHandlers.ontransitioncancel
EventHandler
called when a transitioncancel
event is sent, indicating that a CSS transition has been cancelled.GlobalEventHandlers.ontransitionend
EventHandler
called when a transitionend
event is sent, indicating that a CSS transition has finished playing.GlobalEventHandlers.onwaiting
EventHandler
representing the code to be called when the waiting
event is raised.Методи
Цей інтерфейс також розширює Node
і EventTarget
інтерфейси.
Document.adoptNode()
- Приймає вузол із зовнішнього документу.
Document.captureEvents()
- Дивись
Window.captureEvents
. Document.caretRangeFromPoint()
- Отримує об'єкт
Range
для фрагмента документу у відповідності до вказаних координат. Document.createAttribute()
- Створює новий об'єкт
Attr
і повертає його. Document.createAttributeNS()
- Створює новий вузол атрибута в заданому просторі імен і повертає його.
Document.createCDATASection()
- Створює новий вузол CDATA і повертає його.
Document.createComment()
- Створює новий вузол коментаря і повертає його.
Document.createDocumentFragment()
- Створює новий фрагмент документу.
Document.createElement()
- Створює новий елемент із заданим ім'ям тега.
Document.createElementNS()
- Створює новий елемент із заданим ім'ям тега і URI простором імен.
Document.createEntityReference()
- Створює нове посилання на об'єкт і повертає його.
Document.createEvent()
- Створює об'єкт події.
Document.createNodeIterator()
- Створює об'єкт
NodeIterator
. Document.createProcessingInstruction()
- Створює новий об'єкт
ProcessingInstruction
. Document.createRange()
- Створює об'єкт
Range
. Document.createTextNode()
- Створює текстовий вузол.
Document.createTouch()
- Створює об'єкт
Touch
. Document.createTouchList()
- Створює об'єкт
TouchList
. Document.createTreeWalker()
- Створює об'єкт
TreeWalker
. Document.enableStyleSheetsForSet()
- Вмикає таблиці стилів для вказаного набору таблиць стилів.
Document.exitPointerLock()
- Звільняє блокування вказівника.
Document.getAnimations()
- Повертає масив всіх об'єктів
Animation
, які діють на даний момент, чиї цільові елементи є нащадкамиdocument
. Document.getElementsByClassName()
- Повертає список елементів із заданим ім'ям класу.
Document.getElementsByTagName()
- Повертає список елементів із заданим ім'ям тега.
Document.getElementsByTagNameNS()
- Повертає список елементів із заданим ім'ям тега і простором імен.
Document.importNode()
- Повертає клон вузла з зовнішнього документу.
Document.normalizeDocument()
- Заміняє сутності, нормалізує текстові вузли, і т. д.
Document.releaseCapture()
- Звільняє поточний захват мишки, якщо він знаходиться на елементі в цьому документі.
Document.releaseEvents()
- Дивись
Window.releaseEvents()
. Document.routeEvent()
Obsolete since Gecko 24- Дивись
Window.routeEvent()
. Document.mozSetImageElement()
- Дозволяє змінити елемент, який використовуєтья в якості фонового зображення для вказаного ідентифікатора елемента.
Інтерфейс Document
розширюється інтерфейсом ParentNode
:
document.getElementById(String id)
- Повертає посилання на об'єкт визначеного елемента.
document.querySelector(String selector)
- Повертає перший Element-вузол в межах документу, в порядку документу, який співпадає зі вказаними селекторами.
document.querySelectorAll(String selector)
- Повертає список всіх Element-вузлів в межах документу, які співпадають з вказаними селекторами.
Інтерфейс Document
розширюється інтерфейсом XPathEvaluator
:
document.createExpression(String expression, XPathNSResolver resolver)
- Компілює
XPathExpression
який може тоді бути використаний для (повторюваних) оцінювань. document.createNSResolver(Node resolver)
- Створює об'єкт
XPathNSResolver
. document.evaluate(String expression, Node contextNode, XPathNSResolver resolver, Number type, Object result)
- Вираховує вираз XPath.
Розширення для HTML-документів
інтерфейс Document
для HTML-документів наслідується від інтерфейсу HTMLDocument
або, починаючи з HTML5, розширюється для таких документів:
document.clear()
- In majority of modern browsers, including recent versions of Firefox and Internet Explorer, this method does nothing.
document.close()
- Closes a document stream for writing.
document.execCommand(String command[, Boolean showUI[, String value]])
- On an editable document, executes a formating command.
document.getElementsByName(String name)
- Returns a list of elements with the given name.
document.hasFocus()
- Returns
true
if the focus is currently located anywhere inside the specified document. document.open()
- Opens a document stream for writing.
document.queryCommandEnabled(String command)
- Returns true if the formating command can be executed on the current range.
document.queryCommandIndeterm(String command)
- Returns true if the formating command is in an indeterminate state on the current range.
document.queryCommandState(String command)
- Returns true if the formating command has been executed on the current range.
document.queryCommandSupported(String command)
- Returns true if the formating command is supported on the current range.
document.queryCommandValue(String command)
- Returns the current value of the current range for a formating command.
document.write(String text)
- Writes text in a document.
document.writeln(String text)
- Writes a line of text in a document.
Methods included from DocumentOrShadowRoot
The Document
interface includes the following methods defined on the DocumentOrShadowRoot
mixin. Note that this is currently only implemented by Chrome; other browsers still implement them on the Document
interface.
DocumentOrShadowRoot.getSelection()
- Returns a
Selection
object representing the range of text selected by the user, or the current position of the caret. DocumentOrShadowRoot.elementFromPoint()
- Returns the topmost element at the specified coordinates.
DocumentOrShadowRoot.elementsFromPoint()
- Returns an array of all elements at the specified coordinates.
DocumentOrShadowRoot.caretPositionFromPoint()
- Returns a
CaretPosition
object containing the DOM node containing the caret, and caret's character offset within that node.
Specifications
Browser compatibility notes
Firefox notes
Mozilla defines a set of non-standard properties made only for XUL content:
document.currentScript
- Returns the
<script>
element that is currently executing. document.documentURIObject
- (Mozilla add-ons only!) Returns the
nsIURI
object representing the URI of the document. This property only has special meaning in privileged JavaScript code (with UniversalXPConnect privileges). document.popupNode
- Returns the node upon which a popup was invoked.
document.tooltipNode
- Returns the node which is the target of the current tooltip.
Mozilla also define some non-standard methods:
document.execCommandShowHelp
Obsolete since Gecko 14.0- This method never did anything and always threw an exception, so it was removed in Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11).
document.getBoxObjectFor
- Use the
Element.getBoundingClientRect()
method instead. document.loadOverlay
- Loads a XUL overlay dynamically. This only works in XUL documents.
document.queryCommandText
Obsolete since Gecko 14.0- This method never did anything but throw an exception, and was removed in Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11).
Internet Explorer notes
Microsoft defines some non-standard properties:
document.fileSize
*- Returns size in bytes of the document. Starting with Internet Explorer 11, that property is no longer supported. See MSDN.
- Internet Explorer does not support all methods from the
Node
interface in theDocument
interface:
document.contains
- As a work-around,
document.body.contains()
can be used.