The Node.ownerDocument property returns the Document that owns a node. Learn why document.ownerDocument is null, how to reach documentElement, and how ownership relates to isConnected.
Read-only property
Document or null
Owning Document
null
Still owned
Baseline widely
Every normal page node belongs to a Document. ownerDocument is the pointer back to that document—useful when a function receives a node and needs createElement, getElementById, or documentElement without assuming the global document.
Ownership is not the same as being attached to the live tree. A node can have an ownerDocument while isConnected is still false.
On a simple single-page tutorial, element.ownerDocument === document is usually true. The property becomes more important with iframes, XML documents, or libraries that move nodes between documents.
ownerDocumentMDN: the read-only ownerDocument property returns the top-level document object of the node. If the node is itself a document, the value is null.
Document for elements, text, comments, and most other nodes.null when called on a Document node.document.createElement).ownerDocument.const doc = node.ownerDocument;
if (doc) {
const html = doc.documentElement;
}A Document, or null if the node is itself a document.
| Goal | Code |
|---|---|
| Get owning document | node.ownerDocument |
| Same as global? | node.ownerDocument === document |
Root <html> | node.ownerDocument.documentElement |
| Create sibling-safe node | node.ownerDocument.createElement("div") |
| Document itself | document.ownerDocument → null |
| MDN status | Baseline Widely available (since July 2015) |
Four facts to remember about Node.ownerDocument.
Document | nullOwning doc
widelySince July 2015
read-onlyNo assignment
nullBy design
Examples follow MDN Node.ownerDocument patterns. Use View Output or Try It Yourself for each case.
See ownership for elements and for the document itself.
On a normal page, an element’s owner is the global document.
const p = document.getElementById("demo");
console.log(p.ownerDocument === document); // true
console.log(p.ownerDocument.nodeName); // "#document"The element was created in (or parsed into) this page’s document, so ownerDocument points back to it.
document.ownerDocument Is nullMDN: on a node that is itself a document, the value is null.
console.log(document.ownerDocument); // null
console.log(document.nodeType === Node.DOCUMENT_NODE); // trueThere is no “document above the document” for this property. Always null-check if the node might be a Document.
Reach <html>, create nodes safely, compare with isConnected.
documentElement (MDN-style)From any node, climb to the owning document, then to <html>.
const p = document.getElementById("demo");
const d = p.ownerDocument;
const html = d.documentElement;
console.log(html.nodeName); // "HTML"This matches MDN’s sample: get the document from p, then read its top-level HTML element.
Ownership is set at creation, even before append.
const el = document.createElement("div");
console.log(el.ownerDocument === document); // true
console.log(el.parentNode); // null
console.log(el.isConnected); // falsecreateElement ties the new node to that document immediately. Being owned does not mean it is in the tree yet.
Prefer the node’s owner when building related elements (iframe-safe habit).
function makeSpanNextTo(node, label) {
const doc = node.ownerDocument;
const span = doc.createElement("span");
span.textContent = label;
node.parentNode.appendChild(span);
return span;
}
const demo = document.getElementById("demo");
const span = makeSpanNextTo(demo, " sibling");
console.log(span.ownerDocument === demo.ownerDocument); // trueCreating with node.ownerDocument.createElement keeps new nodes in the same document as the reference node—important across frames and multiple documents.
document.<html> — node.ownerDocument.documentElement.isConnected and parentNode.ownerDocument WorksParsing HTML or calling createElement / createTextNode.
The node remembers which Document it belongs to.
If the node is the Document itself, ownerDocument is null.
Create nodes, read documentElement, or compare documents.
isConnected separately.Node.ownerDocument is Baseline Widely available across modern browsers (MDN: since July 2015). Logos use the shared browser-image-sprite.png sprite from this project.
Safe for production. Remember document.ownerDocument is null, and ownership is set even before append.
Bottom line: Use ownerDocument to find a node’s Document; use isConnected to learn if it is in the tree.
Node.ownerDocument returns the Document that owns a node, or null for Document nodes themselves. Use it to create related elements safely and to reach documentElement without hard-coding the global document.
Continue with parentElement, isConnected, or the JavaScript hub.
node.ownerDocument.createElementisConnected when attachment mattersownerDocument.documentElement for the root elementdocument in reusable codeownerDocument means the node is in the treeownerDocument (read-only)document.ownerDocument is nullNode with the Node.js runtimeownerDocumentThe Document that owns the node.
or null
APIalways null
GotchaMDN pattern
Patternbefore append
Createowned vs attached
CompareAppending a node into a different document usually requires document.importNode or adoptNode. That is why reusable helpers create new nodes from node.ownerDocument instead of a random global document.
Get the parent Element—or null when there isn’t one.
5 people found this page helpful