如何通过迭代器实现对 DOM 树中所有文本节点的递归深度扫描

落枫君_4768

落枫君_4768

2026-05-15

516人浏览

原创

nodeiterator 可安全可控地深度优先遍历 dom 文本节点,通过 show_text 标志自动过滤非文本节点,避免递归栈溢出;支持自定义过滤函数排除 script/style 内容或空白文本,比 children/childnodes 递归更简洁可靠。

如何通过迭代器实现对 dom 树中所有文本节点的递归深度扫描

用迭代器扫描 DOM 中所有文本节点,比手写递归更安全、更可控,也天然支持深度优先顺序。核心是用 NodeIterator 配合过滤器,跳过非文本节点,只暴露你要的 Text 类型。

用 NodeIterator 精准筛选文本节点

NodeIterator 是浏览器原生支持的 DOM 遍历工具,它默认按深度优先顺序逐个返回匹配的节点。只需设置过滤条件为 NodeFilter.SHOW_TEXT,就能跳过元素、注释、属性等其他类型。

  • 创建时传入根节点(如 document.body)、显示标志、可选过滤函数和是否扩展实体引用
  • 不需要手动递归调用,也不用维护栈或处理子节点循环
  • 遍历过程不会因 DOM 深度过大而栈溢出,适合长嵌套结构

示例代码:

const iterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_TEXT,
  null, // 不需要自定义过滤函数
  false
);

let node;
while ((node = iterator.nextNode()) !== null) {
  if (node.textContent.trim() !== '') {
    console.log('文本内容:', node.textContent);
  }
}

若需进一步控制——加自定义过滤函数

有时你只想提取“可见且非空”的文本,或排除 script/style 标签里的内容。这时可在第三个参数传入过滤函数,返回 NodeFilter.FILTER_ACCEPT 或 NodeFilter.FILTER_REJECT。

  • 函数接收一个节点,可检查其父元素:node.parentElement?.tagName === 'SCRIPT'
  • 也可判断文本是否全为空白:!/\S/.test(node.textContent)
  • 注意:该函数只对 SHOW_TEXT 范围内的节点生效,不影响其他类型遍历逻辑

示例片段:

const filter = function(node) {
  const parent = node.parentElement;
  if (!parent || ['SCRIPT', 'STYLE'].includes(parent.tagName)) return NodeFilter.FILTER_REJECT;
  if (!node.textContent.trim()) return NodeFilter.FILTER_REJECT;
  return NodeFilter.FILTER_ACCEPT;
};

const iter = document.createNodeIterator(document.body, NodeFilter.SHOW_TEXT, filter, false);

对比 children + 递归:为什么这里不用递归

文本节点散落在 DOM 树各处,可能夹在两个元素之间,也可能作为深层嵌套元素的直接子节点。若用 children 遍历,会完全漏掉它们;改用 childNodes 虽能拿到,但需层层判断 nodeType === Node.TEXT_NODE,容易写错或遗漏边界情况。

  • children 只返回元素节点,对文本节点无效
  • childNodes 包含文本、注释、元素,但需手动过滤,递归深度大时风险高
  • NodeIterator 抽象了遍历细节,语义清晰,一行配置就锁定目标类型

补充:TreeWalker 也能做,但更重

TreeWalker 和 NodeIterator 都支持深度优先,但它额外提供 parentNode()、firstChild() 等导航方法,适合需要双向移动的场景。对纯扫描文本这种单向任务,NodeIterator 更轻量、性能略优。

  • 两者都绕过递归调用栈限制
  • 如果后续要从某个文本节点反查其父元素或兄弟结构,再考虑 TreeWalker
  • 日常文本提取,NodeIterator 足够且推荐
PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4466

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1109

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4384

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

880

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1776

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3205

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4173

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2700

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

868

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习