JS中parentNode与parentElement获取父节点的区别

作者:交互手记

时间:2026-11-17

浏览:183

深入解析JavaScript中parentNode与parentElement获取父节点的核心区别、底层原理、DOM继承体系、临界边界场景以及实际选型建议。

文章目录
JS中parentNode与parentElement获取父节点的区别

在 JavaScript 的 DOM 树导航操作中,parentNode 与 parentElement 都是用来读取当前节点上一级容器的只读属性。在大多数常规 HTML 元素操作中,由于一个元素的父级通常也是普通元素标签(例如 <span> 的父级是 <p>),两者的返回结果完全一致。两者的核心区别在于对父节点类型的过滤要求:parentNode 会返回父级任意 Node 节点(包括元素、文档节点 Document、文档片段 DocumentFragment 等);而 parentElement 严格要求父节点必须是Element 元素节点,若父节点不是元素节点(例如已经到达文档顶层的 document),则直接返回 null。

一、核心概念:Node 与 Element 的继承体系

要透彻理解两者的差异,必须先清楚 DOM 规范中的类型继承模型。在 W3C DOM 规范中,Node(节点)是 DOM 树的通用基类接口,几乎整个文档中的结构都是 Node 的派生实例。而 Element(元素)是继承自 Node 的子接口,特指拥有标签名、属性集合与样式结构的 HTML/SVG/XML 标签元素。

关键关系:所有的 Element 一定是 Node,但 Node 不一定是 Element。常见的非 Element 节点包括 document(Document 节点)、Text(文本节点)、Comment(注释节点)以及 DocumentFragment(文档片段节点)。

JS中parentNode与parentElement获取父节点的区别
图 1:DOM 接口继承关系与节点分类示意

每个节点都有一个整型数值属性 nodeType,常用的对应关系如下:

  • Node.ELEMENT_NODE (1):元素节点,如 <div>、<p>、<html>。
  • Node.TEXT_NODE (3):元素内部或标签之间的文本节点。
  • Node.COMMENT_NODE (8):HTML 注释节点。
  • Node.DOCUMENT_NODE (9):文档根节点,即顶层全局对象 document。
  • Node.DOCUMENT_FRAGMENT_NODE (11):内存中用于批量操作的文档片段 DocumentFragment。

二、核心区别与典型对比场景

在属性定义上:

  • Node.prototype.parentNode:返回当前节点在 DOM 树中的直接父节点(Parent Node)。如果没有父节点(例如新创建且未插入 DOM 树的节点),则返回 null。
  • Node.prototype.parentElement:返回当前节点的直接父级元素节点(Parent Element)。如果当前节点没有父节点,或者其父节点并不是一个元素节点,则返回 null。

场景 1:普通元素节点查找父级(结果一致)

在绝大多数日常页面结构中,业务标签的父级依然是普通的 HTML 标签。此时 parentNode 与 parentElement 行为没有任何差异:

// 示例 HTML:
// <div id="parent-box">
//     <p id="child-para">示例段落</p>
// </div>

const para = document.getElementById('child-para');

console.log(para.parentNode);    // <div id="parent-box">
console.log(para.parentElement); // <div id="parent-box">
console.log(para.parentNode === para.parentElement); // true

因为 <div> 的 nodeType 是 1(ELEMENT_NODE),它既是一个 Node,也是一个 Element,因此两个属性都直接返回该 <div> 的引用。

场景 2:文档根元素 <html> 查找父级(出现分水岭)

当向上遍历到达页面的根元素标签 <html>(通过 document.documentElement 获取)时,两者的行为出现了最经典的差异:

const htmlElement = document.documentElement; // 即 <html> 元素

console.log(htmlElement.parentNode);    // #document (HTMLDocument 实例)
console.log(htmlElement.parentElement); // null

console.log(htmlElement.parentNode.nodeType); // 9 (Node.DOCUMENT_NODE)

<html> 元素的父节点是 document。document 的 nodeType 为 9(DOCUMENT_NODE),它实现了 Node 接口,但它并不是一个 Element 标签。因此:

  1. htmlElement.parentNode 返回了 document 实例。
  2. htmlElement.parentElement 检查发现父级不是 Element,按规范返回了 null。
JS中parentNode与parentElement获取父节点的区别
图 2:普通元素与根元素在 parentNode/parentElement 下的指向对比

场景 3:文档片段 DocumentFragment 与未挂载节点

除了完整的页面 DOM 树,在内存中动态组装节点时也经常用到 DocumentFragment。此时同样会触发两者的类型差异:

// 创建内存中的文档片段
const fragment = document.createDocumentFragment();
const tempDiv = document.createElement('div');
fragment.appendChild(tempDiv);

// 检查 tempDiv 的父级
console.log(tempDiv.parentNode);    // #document-fragment (DocumentFragment 实例)
console.log(tempDiv.parentElement); // null

因为 DocumentFragment 的 nodeType 是 11,属于节点而非 HTML 元素,所以 tempDiv.parentElement 依然会得到 null,而 parentNode 则能准确拿到外部的片段实例。

三、浏览器底层解析与判定步骤

为了更清晰地理解这一机制,我们可以将现代浏览器引擎(如 Chromium Blink 或 WebKit)在读取这两个属性时的内部逻辑抽象为确定性的执行流程:

JS中parentNode与parentElement获取父节点的区别
图 3:浏览器底层对 parentElement 与 parentNode 的求值步骤

如果用一段 JavaScript 代码来表达 parentElement 的 Polyfill(垫片实现),逻辑如下:

// parentElement 的等价实现逻辑
function getParentElement(node) {
    const parent = node.parentNode;
    // 只有当父节点存在且 nodeType 为 1 (ELEMENT_NODE) 时才返回,否则返回 null
    return (parent && parent.nodeType === 1) ? parent : null;
}

四、实战避坑:递归向上遍历时的运行时报错

在日常业务开发中,开发者经常需要沿着 DOM 树一层层向上查找符合特定条件的祖先元素(例如判断点击事件是否发生在特定卡片内、寻找最近具有 data-role 属性的容器)。在编写向上遍历的循环条件时,选择 parentNode 还是 parentElement 会直接影响代码的健壮性。

1. 使用 parentNode 向上遍历的常见错误

// 需求:查找带有 .modal 类的祖先容器
function findModalAncestor(startEl) {
    let current = startEl;
    // 错误写法:一直往上找,直到 current 为假值
    while (current) {
        // 当 current 遍历到 document 时,由于 document 没有 classList 属性,会直接抛出 TypeError!
        if (current.classList && current.classList.contains('modal')) {
            return current;
        }
        current = current.parentNode;
    }
    return null;
}

在上述代码中,如果页面上没有 .modal 容器,循环会一直向上攀升:div ➔ body ➔ html ➔ document ➔ null。当 current 到达 document 这一步时,虽然 current 不为 null,但 document 是文档节点,并不是所有的 Element API(如部分直接访问 class、attribute 的方法)在它上面都能安全调用。虽然可以通过防御式判断避免,但更容易漏掉边界。

2. 使用 parentElement 的安全写法

// 改进:使用 parentElement 能够自然终止在 html 元素
function findModalAncestorSafe(startEl) {
    let current = startEl;
    while (current) {
        if (current.classList.contains('modal')) {
            return current;
        }
        // 当 current 是 <html> 时,current.parentElement 会直接返回 null,自动终止循环
        current = current.parentElement;
    }
    return null;
}

因为 html.parentElement 会自动熔断返回 null,循环体永远不会接触到 document 节点。在循环内部,开发者可以 100% 确定 current 必定是一个正统的 Element 对象,无需反复做额外的节点类型防御检测。

五、属性对照与选型决策指南

为了让不同场景下的选择更清晰,我们将两者的关键指标总结为以下对照表:

对比维度 Node.parentNode Node.parentElement
返回类型 Node(可能为 Element、Document 等) Element(严格限制为元素节点)
普通元素的父级 返回上级元素(如 <body>) 返回上级元素(如 <body>)
<html> 根元素的父级 #document null
DocumentFragment 内子级 返回 DocumentFragment 实例 null
遍历元素树时的安全性 需要手动过滤 nodeType === 1 天然安全,自动在 HTML 边界终止
浏览器兼容性 所有浏览器完全支持(DOM Level 1) 所有现代浏览器与 IE9+ 完全支持
JS中parentNode与parentElement获取父节点的区别
图 4:DOM 导航属性选型决策树与场景推荐

总结

parentNode 与 parentElement 的区别本质上是“基类抽象”与“具体子类”在树遍历中的约束区别:

  1. 类型定位:parentNode 属于通用的 Node 接口,只要上一级是节点就会返回;parentElement 带有元素类型断言,只有上一级是 Element 时才会返回。
  2. 临界点表现:对于根标签 document.documentElement(<html>),html.parentNode 为 document,而 html.parentElement 为 null。
  3. 选型实践:在绝大多数常规前端业务中,若目标只是在 DOM 元素树中向上检索父级元素并操作其类名、样式或属性,优先使用 parentElement 可以避免访问到 document 产生的类型错误;若编写通用底层框架、解析 XML 或需要感知 DocumentFragment / document 边界,则应明确使用 parentNode。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章