DocumentOrShadowRoot

The DocumentOrShadowRoot mixin of the Shadow DOM API provides APIs that are shared between documents and shadow roots. The following features are included in both Document and ShadowRoot.

Properties

DocumentOrShadowRoot.activeElementRead only
Returns the Element within the shadow tree that has focus.
DocumentOrShadowRoot.fullscreenElementRead only
Returns 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. It returns null if lock is pending, the pointer is unlocked, or if the target is in another document.
DocumentOrShadowRoot.styleSheetsRead only
Returns a StyleSheetList of CSSStyleSheet objects for stylesheets explicitly linked into, or embedded in a document.

Methods

DocumentOrShadowRoot.caretPositionFromPoint()
Returns a CaretPosition object containing the DOM node containing the caret, and caret's character offset within that node.
DocumentOrShadowRoot.elementFromPoint()
Returns the topmost element at the specified coordinates.
DocumentOrShadowRoot.elementsFromPoint()
Returns an array of all elements at the specified coordinates.
DocumentOrShadowRoot.getSelection()
Returns a Selection object representing the range of text selected by the user, or the current position of the caret.
DocumentOrShadowRoot.nodeFromPoint()
Returns the topmost node at the specified coordinates.
DocumentOrShadowRoot.nodesFromPoint()
Returns an array of all nodes at the specified coordinates.

Specifications

Specification Status Comment
Shadow DOM
The definition of 'DocumentOrShadowRoot' in that specification.
Obsolete Implementation in Shadow DOM.
DOM
The definition of 'DocumentOrShadowRoot' in that specification.
Living Standard Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
DocumentOrShadowRoot
Experimental
Chrome Full support 53Edge Full support 12Firefox Full support YesIE Full support YesOpera Full support 40Safari Full support YesWebView Android Full support 53Chrome Android Full support 53Firefox Android Full support YesOpera Android Full support 41Safari iOS Full support YesSamsung Internet Android Full support 6.0
activeElement
Experimental
Chrome Full support 53Edge Full support 12Firefox Full support 63IE Full support 4Opera Full support 40Safari Full support 4WebView Android Full support 53Chrome Android Full support 53Firefox Android Full support 63Opera Android Full support 41Safari iOS Full support 3.2Samsung Internet Android Full support 6.0
adoptedStyleSheets
Experimental
Chrome Full support 73Edge Full support 79Firefox No support NoIE No support NoOpera Full support 60Safari No support NoWebView Android Full support 73Chrome Android Full support 73Firefox Android No support NoOpera Android Full support 50Safari iOS No support NoSamsung Internet Android Full support 11.0
caretPositionFromPoint
Experimental
Chrome No support NoEdge No support NoFirefox Full support 20IE No support NoOpera No support NoSafari Full support YesWebView Android No support NoChrome Android No support NoFirefox Android Full support 20Opera Android No support NoSafari iOS Full support YesSamsung Internet Android No support No
elementFromPoint
Experimental
Chrome Full support 53
Notes
Full support 53
Notes
Notes Before Chrome 66, this method returned null when the element was a child of a host node. See issue 759947.
Edge Full support 12Firefox Full support 63IE Full support YesOpera Full support 40Safari Full support YesWebView Android Full support 53
Notes
Full support 53
Notes
Notes Before WebView 66, this method returned null when the element was a child of a host node. See issue 759947.
Chrome Android Full support 53
Notes
Full support 53
Notes
Notes Before Chrome 66, this method returned null when the element was a child of a host node. See issue 759947.
Firefox Android Full support 63Opera Android Full support 41Safari iOS Full support YesSamsung Internet Android Full support 6.0
Notes
Full support 6.0
Notes
Notes Before Samsung Internet 9.0, this method returned null when the element was a child of a host node. See issue 759947.
elementsFromPoint
Experimental
Chrome Full support 53
Notes
Full support 53
Notes
Notes Before Chrome 66, this method returned null when the element was a child of a host node. See issue 759947.
Edge Full support 12
Notes Alternate Name
Full support 12
Notes Alternate Name
Notes Returns a NodeList instead of an array. See the MSDN documentation. Returns null when the point provided has no elements beneath it (e.g., when given a point outside the document).
Alternate Name Uses the non-standard name: msElementsFromPoint
Firefox Full support 63IE Full support 10
Notes Alternate Name
Full support 10
Notes Alternate Name
Notes Returns a NodeList instead of an array. See the MSDN documentation. Returns null when the point provided has no elements beneath it (e.g., when given a point outside the document).
Alternate Name Uses the non-standard name: msElementsFromPoint
Opera Full support 40Safari Full support 12WebView Android Full support 53
Notes
Full support 53
Notes
Notes Before WebView 66, this method returned null when the element was a child of a host node. See issue 759947.
Chrome Android Full support 53
Notes
Full support 53
Notes
Notes Before Chrome 66, this method returned null when the element was a child of a host node. See issue 759947.
Firefox Android Full support 63Opera Android Full support 41Safari iOS Full support 12Samsung Internet Android Full support 6.0
Notes
Full support 6.0
Notes
Notes Before Samsung Internet 9.0, this method returned null when the element was a child of a host node. See issue 759947.
fullscreenElementChrome Full support 53
Prefixed
Full support 53
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge Full support ≤18
Prefixed
Full support ≤18
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Full support 12
Prefixed
Prefixed Implemented with the vendor prefix: ms
Firefox Full support 64
Full support 64
No support 47 — 65
Disabled
Disabled From version 47 until version 65 (exclusive): this feature is behind the full-screen-api.unprefix.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
No support 9 — 65
Alternate Name
Alternate Name Uses the non-standard name: mozFullScreenElement
IE Full support Yes
Prefixed
Full support Yes
Prefixed
Prefixed Implemented with the vendor prefix: ms
Opera Full support 40
Prefixed
Full support 40
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Safari Full support Yes
Prefixed
Full support Yes
Prefixed
Prefixed Implemented with the vendor prefix: webkit
WebView Android Full support 53
Prefixed
Full support 53
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Chrome Android Full support 53
Prefixed
Full support 53
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Firefox Android Full support 64
Full support 64
No support 47 — 65
Disabled
Disabled From version 47 until version 65 (exclusive): this feature is behind the full-screen-api.unprefix.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
No support 9 — 65
Alternate Name
Alternate Name Uses the non-standard name: mozFullScreenElement
Opera Android Full support 41
Prefixed
Full support 41
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Safari iOS Partial support 12
Notes Alternate Name
Partial support 12
Notes Alternate Name
Notes Full-screen mode is only supported on the iPad.
Alternate Name Uses the non-standard name: webkitFullscreenElement
Samsung Internet Android Full support 6.0
Prefixed
Full support 6.0
Prefixed
Prefixed Implemented with the vendor prefix: webkit
getSelection
Experimental
Chrome Full support 53Edge Full support 12Firefox Full support 63IE Full support YesOpera Full support 40Safari Full support YesWebView Android Full support 53Chrome Android Full support 53Firefox Android Full support 63Opera Android Full support 41Safari iOS Full support YesSamsung Internet Android Full support 6.0
nodeFromPoint
ExperimentalNon-standard
Chrome No support NoEdge No support NoFirefox No support No
Notes
No support No
Notes
Notes Implemented in Firefox but currently only works in chrome code.
IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support No
Notes
No support No
Notes
Notes Implemented in Firefox but currently only works in chrome code.
Opera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
nodesFromPoint
ExperimentalNon-standard
Chrome No support NoEdge No support NoFirefox No support No
Notes
No support No
Notes
Notes Implemented in Firefox but currently only works in chrome code.
IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support No
Notes
No support No
Notes
Notes Implemented in Firefox but currently only works in chrome code.
Opera Android No support NoSafari iOS No support NoSamsung Internet Android No support No
pointerLockElement
Experimental
Chrome Full support 53Edge Full support 12Firefox Full support 63IE Full support YesOpera Full support 40Safari Full support YesWebView Android Full support 53Chrome Android Full support 53Firefox Android Full support 63Opera Android Full support 41Safari iOS Full support YesSamsung Internet Android Full support 6.0
styleSheets
Experimental
Chrome Full support 53Edge Full support 12Firefox Full support 63IE Full support YesOpera Full support 40Safari Full support YesWebView Android Full support 53Chrome Android Full support 53Firefox Android Full support 63Opera Android Full support 41Safari iOS Full support YesSamsung Internet Android Full support 6.0

Legend

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
See implementation notes.
See implementation notes.
User must explicitly enable this feature.
User must explicitly enable this feature.
Uses a non-standard name.
Uses a non-standard name.
Requires a vendor prefix or different name for use.
Requires a vendor prefix or different name for use.

[1] This interface's features are still implemented on the Document object.