返回探索
指南VibeFix 内容整理更新于 2026年11月21日

页面是一棵树:DOM 查询与遍历实战指南

页面是一棵树,菜单是枝、订单卡片是叶。本文按 MDN 的 querySelector、querySelectorAll、closest、matches、parentElement 与 children 官方文档讲清楚:取第一个与取全部、从容器出发、往上找、就地判断、父与子、转义与实时列表。

真实照片:仰拍一棵光秃秃的大树,枝桠在蓝天白云间伸展开来

先把这篇的边界说清楚。站里已经有《类不是魔法:class 与原型链实战指南》,讲的是对象怎么造出来;还有《解构赋值实战指南》,讲的是对象怎么拆开;还有《数组方法实战指南》,讲的是手里有一列东西怎么加工;还有《搜索框防抖实战指南》,讲的是输入框的交互怎么写。这篇不讲造对象、不讲拆对象、不讲加工列表,只讲一件事:页面已经在那儿了,怎么在 DOM 这棵树里找到你要的节点、再顺着树走过去。下面用到的“青石咖啡馆”还是那个虚构的练手项目:一个帮街边咖啡馆做点单的网页小工具。这回讲的是它的点单页:页面上有菜单列表、订单卡片、分类按钮,找节点、筛节点、往上找卡片,全是 DOM 查询与遍历的活。本文所有以它为例的操作、代码和数字,都是为了讲清楚做法编出来的,不是真实记录。所有关于 DOM 查询与遍历的语法和行为,都来自 MDN 的《Document: querySelector() method》《Document: querySelectorAll() method》《Element: closest() method》《Element: matches() method》《Node: parentElement property》《Element: children property》六篇官方文档,来源见每篇的 meta 信息与 evidence 记录。文档里的例子,比如 class 是 myclass 的元素、用户名是 login 的输入框、div-01 到 div-03 三层嵌套、三只鸟的列表,都是文档自带的示例,不是真实页面。

第一步:页面是一棵树,document 是入口

浏览器把页面读进来,变成一棵树:html 是树干,head 和 body 是两根大枝,往下是 div、ul、li,一层套一层。树是有方向的:根在上、叶在下,父子是包含关系,兄弟是同一个父节点下面的并列关系。找节点就是沿着这三个方向走:往下找用 querySelector,往上找用 closest(),就地判断用 matches(),这篇后面三步一个个讲。document 就是这棵树的入口,站在入口找节点是最常用的起点。document.querySelector(".myclass") 的意思就是:从整棵树里找第一个 class 是 myclass 的元素。元素自己也能当入口:一个容器元素调 querySelector,只在它自己的子树里找,后面第六步会细讲。咖啡馆的点单页就是这么想的:菜单列表是一个 ul,里面的每一道菜是一个 li,订单卡片是一个个 div;想改哪一道菜,先在树里找到它,再动手。记住第一句话:页面是树,document 是入口,找节点就是在树里找。

第二步:querySelector 只取第一个,找不到就给 null

querySelector(selectors) 只返回第一个匹配的元素。MDN 的例子是:const el = document.querySelector(".myclass"),返回文档里第一个 class 是 myclass 的元素。找不到的时候,它不抛错,而是返回 null。null 上面再取属性、调方法,会直接抛 TypeError,页面就停在那儿了。所以拿到结果先判空:const el = document.querySelector("#order-card"); if (!el) return; 或者 if (el) { el.textContent = "已下单"; }。咖啡馆的点单页就踩过这个坑:活动结束、页面上去掉了“今日特价”那块,代码还写着 document.querySelector("#special").textContent,特价块没了、querySelector 给了 null,textContent 一取就报错,整个点单页白屏。记住判断句:querySelector 的返回值永远先问一句:是元素,还是 null?

第三步:选择器就是 CSS 选择器,会写样式就会找节点

querySelector 的参数是一个 CSS 选择器字符串,会写 CSS 就会找节点。MDN 的例子层层加码:先是 const el = document.querySelector(".myclass"),取第一个 class 是 myclass 的元素;再是 const el = document.querySelector("div.user-panel.main input[name='login']"),取 class 同时是 user-panel 和 main 的 div 里面、名字是 login 的第一个 input;还能反选:const el = document.querySelector("div.user-panel:not(.main) input[name='login']"),取父 div 有 user-panel、没有 main 的那个 input。连接符的意思也要认清:逗号是“或”,div.note, div.alert 是命中其一就算;空格是后代,div 里面任意一层的 input 都算;大于号是直接子代,div.highlighted > p 只要直接贴在下面的 p,隔了一层的不要。类、id、属性、后代、子代、:not(),全是 CSS 里现成的写法。咖啡馆的点单页就是这么找的:document.querySelector("ul.menu li[data-dish='拿铁']"),菜单列表里、菜名属性是拿铁的那一项,一句话定位。记住判断句:选择器写得越具体,找到的越准;能用属性定位的时候,别只靠 class。

第四步:querySelectorAll 取全部,排的是文档顺序

要一份不要一个,就用 querySelectorAll。它返回一个非实时的 NodeList,里面是每一个匹配的元素;没有匹配的时候,给的是一个空列表,不是 null。列表里的元素按文档顺序排:MDN 的原话是,父在前、子在后、兄在前、弟在后。MDN 的例子有四个:document.querySelectorAll("p") 取文档里全部 p;document.querySelectorAll("div.note, div.alert"),逗号并列,取 class 是 note 或者 alert 的全部 div;document.querySelectorAll("iframe[data-src]"),取带 data-src 属性的全部 iframe;document.querySelectorAll("li[data-active='1']"),取 data-active 属性值是 1 的全部列表项。咖啡馆的点单页就是这么取的:document.querySelectorAll("ul.menu li"),菜单列表里全部的菜,一次全拿到。记住判断句:取全部用 querySelectorAll,没匹配是空列表,顺序就是文档顺序。

第五步:NodeList 不是数组,但能像数组一样看

querySelectorAll 给的 NodeList,MDN 说了,可以像数组一样看:length 是 0 就是没找到;用下标能取到里面的元素;常见的循环语句都能用。MDN 的例子是:const highlightedItems = userList.querySelectorAll(".highlighted"); highlightedItems.forEach((userItem) => { deleteUser(userItem); }),forEach 直接就能用。但它不是数组,也不是实时的:页面后来再加节点,这个列表不会跟着变;它定格在查询的那一刻。想用 map、filter 这类数组方法,先把它转成真数组再加工——转过去之后怎么加工,见《数组方法实战指南》,不是这篇的事。咖啡馆的点单页就是这么写的:先 const items = document.querySelectorAll("ul.menu li"),再 items.forEach((item) => { item.classList.remove("sold-out"); }),一句话清掉全部售罄标记。记住判断句:NodeList 能数、能取、能 forEach;它不是实时的,也不是真数组。

第六步:从容器出发缩小范围,误伤就少了

querySelector 和 querySelectorAll 不只 document 能调,任何元素都能调,调了就只在它自己的子树里找。MDN 的例子是:const container = document.querySelector("#test"); const matches = container.querySelectorAll("div.highlighted > p"),取 id 是 test 的容器里面、class 是 highlighted 的 div 的直接子 p。还有一个:const container = document.querySelector("#user-list"); const matches = container.querySelectorAll("li[data-active='1']"),只在用户列表里找。范围越小,误伤越少:全文档查 "li",会把导航栏、页脚的列表项也算进来;从菜单容器出发查 "li",就只有菜。容器本身也要先找到、也要判空:container 是 null 的时候再调 querySelectorAll,一样会抛错,所以顺序是先取容器、判空、再往下找。咖啡馆的点单页就是这么写的:先 const menu = document.querySelector("#menu"),再 menu.querySelectorAll("li"),分类按钮那边的 li 一个都不会进来。记住判断句:先定容器,再在容器里找;范围小了,错就少了。

第七步:往上走用 closest(),从自己开始找

从一个元素往上找祖先,用 closest()。MDN 的说法是:closest() 方法遍历元素和它的父辈,朝着文档根的方向走,直到找到一个匹配指定 CSS 选择器的节点;它从元素自身开始算,找到的第一个就是离它最近的;找不到返回 null;选择器不合法抛 SyntaxError。MDN 的例子是一组三层嵌套的 div:div-01 包着 div-02,div-02 包着 div-03。从 div-03 出发:el.closest("#div-02") 得到 div-02;el.closest("div div") 得到 div-03,因为它自己就是一个在 div 里面的 div;el.closest("article > div") 得到 div-01;el.closest(":not(div)") 得到 article。咖啡馆的点单页就是这么用的:点单按钮被点了,先 event.target.closest(".order-card") 找到它属于哪一张订单卡片,再改那张卡片的状态——按钮在卡片里面第几层,不用管。记住判断句:往上找用 closest(),它从自己开始、最近的先中、找不到给 null。

第八步:就地判断用 matches(),只回 true 或 false

想知道一个元素会不会被某个选择器选中,不用再查一遍,直接问它自己:matches()。MDN 的说法是:matches() 方法测试这个元素会不会被指定的 CSS 选择器选中;中了返回 true,没中返回 false;选择器解析不了抛 SyntaxError。MDN 的例子是一个三只鸟的列表:ul 的 id 是 birds,三只 li 里只有第二只的 class 是 endangered。const birds = document.querySelectorAll("li"); for (const bird of birds) { if (bird.matches(".endangered")) { console.log(`The ${bird.textContent} is endangered!`); } },打印出来的只有 "The Philippine eagle is endangered!",因为只有那只鸟真的带 endangered 这个 class。咖啡馆的点单页就是这么筛的:拿到全部菜之后,item.matches(".sold-out") 是 true 的那几道,标上“已售罄”,其余的不动。记住判断句:筛一个元素用 matches(),只问它自己,不用重新查。

第九步:父与子,parentElement 和 children 各管一头

往上一步、往下一层,各有一个现成的属性。parentElement 返回这个节点的父元素;没有父、或者父不是元素的时候,返回 null。MDN 的例子是:const html = document.querySelector("html"); html.parentElement 是 null,html.parentNode 是 document——html 的父节点是 document,但 document 不是元素,所以 parentElement 给 null、parentNode 给 document。往下是 children:只含子元素节点,是一个实时的 HTMLCollection,没有子元素的时候 length 是 0。MDN 的例子是:const myElement = document.getElementById("foo"); for (const child of myElement.children) { console.log(child.tagName); },一个个打出来。注意和 childNodes 的区别:children 只要元素节点,childNodes 是什么节点都要,文本节点、注释节点都算进去。咖啡馆的点单页就是这么数的:menu.children.length 是菜的道数,menu.childNodes.length 会把换行产生的文本节点也算进去,数出来偏大。记住判断句:数元素用 children,数全部节点才用 childNodes;html 的父元素是 null,父节点是 document。

第十步:id 里有问号这类字符,选择器会直接报错

HTML 规范不要求属性值一定是合法的 CSS 标识符,但 querySelector 要求选择器一定是合法的 CSS。id 里混进了问号、冒号这类字符,直接拼进选择器就会抛 SyntaxError。MDN 的例子是一个 id 是 "this?element" 的 div,问号不是 CSS 标识符里允许的字符。三个按钮都想选中它、改背景色:第一个直接拼 "#this?element",报错;第二个用 CSS.escape("this?element") 转义,能用;第三个手动在问号前面加反斜杠,写成 "this\\?element",也能用——注意字符串里反斜杠自己也要转义,所以要写两个反斜杠。咖啡馆的点单页就踩过这个坑:后端给的分类 id 是 "热饮:本月",冒号没转义,querySelector 直接抛错,菜单筛不出来;改成 CSS.escape(id) 再拼,好了。记住判断句:选择器是拼出来的,先转义再拼;用户给的值、后端给的 id,一律先过 CSS.escape()。

第十一步:伪元素选不到东西,查出来永远是空列表

选择器里带了 CSS 伪元素,querySelectorAll 返回的列表永远是空的。MDN 在 querySelectorAll 这一页专门写了一句提醒:如果指定的选择器里包含 CSS 伪元素,返回的列表永远是空的。伪元素不是 DOM 树里的节点,::before、::after 这类东西在 CSS 里画得再热闹,DOM 树里也没有对应的节点可查。咖啡馆的点单页就踩过这个坑:想取菜单项前面那个小圆点,写了 document.querySelectorAll("li::before"),拿到的永远是空列表,length 一直是 0;小圆点是 CSS 画的,不在 DOM 树里,查节点这条路走不通。记住判断句:伪元素不在 DOM 树里,查节点别带伪元素。

第十二步:选择器不合法,两个方法都抛 SyntaxError

querySelector 和 querySelectorAll 一样,传进去的字符串不是合法的 CSS 选择器,就抛 SyntaxError 这个 DOMException。括号没闭合、属性选择器引号没配对、选择器里混了非法字符,都是这个错。不只这两个方法会抛:closest() 与 matches() 的选择器写错了同样抛 SyntaxError,MDN 在 closest() 与 matches() 两页都写了这一条。所以凡是传选择器字符串的地方——querySelector、querySelectorAll、closest、matches——都要防它不合法。选择器是写死的还好,改过来就行;选择器是拼出来的——比如从输入框里取值、从后端拿 id 再拼——就必须防一手:要么 try/catch 包住,要么先校验、转义再拼。咖啡馆的点单页在搜索框那里就是这么写的:用户输入直接拼进选择器之前,先包一层 try/catch,错了就显示“搜不到”,不让整个页面跟着报错。记住判断句:选择器是拼出来的,就得防它不合法;报错要拦在查的那一步,别让它炸掉页面。

第十三步:按 id 取还有一条老路:getElementById

querySelector 出现之前,按 id 取元素用的是 getElementById,MDN 的例子里到处都是它:closest() 那一页用 document.getElementById("div-03") 取最里层的 div,children 那一页用 document.getElementById("foo") 取容器。它的意思和 document.querySelector("#foo") 一样,都是按 id 取一个元素;id 在页面里是唯一的,所以取到的要么是那一个、要么是没有。找不到的时候,它和 querySelector 一样给 null,照样要先判空再用。什么时候用它?只按 id 取、又想让意图一眼看出来的地方:document.getElementById("menu") 比 document.querySelector("#menu") 更直白地告诉读代码的人:我要的就是这个 id。咖啡馆的点单页在取顶层容器时用的就是它:const menu = document.getElementById("menu"),一眼就知道 menu 是页面上那个 id 是 menu 的元素;往下的细活再交给 querySelectorAll。记住判断句:只按 id 取,用 getElementById 更直白;找不到照样给 null,先判空再用。

第十四步:实时与非实时,遍历时改页面要小心

查出来的两个列表,实时性是不一样的。querySelectorAll 给的 NodeList 是非实时的:MDN 在那一页开头就写了 non-live,意思是它定格在查询的那一刻,页面后来再加节点,它不会跟着变。children 给的 HTMLCollection 是实时的:MDN 在 children 那一页写了 live,意思是页面一变、它跟着变,查的时候有几个孩子、它就有几个。这条差别在遍历时改页面会咬人:对着一个实时的 children 列表边遍历边删节点,删一个、列表缩一个,循环的下标就错位了,会跳过下一个。稳妥的做法是先把要改的节点收进一个定格的列表再动手:要么用 querySelectorAll 查出来再改,要么先把 children 转成真数组再改。咖啡馆的点单页在“清空已售罄”时就是这么写的:先 const items = menu.querySelectorAll("li.sold-out") 定格,再 items.forEach 逐个删,删多少、列表都不动。记住判断句:改页面之前先问:我手里这个列表是实时的还是定格的?实时列表边遍历边改会跳号。

第十五步:90 次 DOM 事故,先对着图自查

虚构青石咖啡馆项目一个月 90 次 DOM 查询与遍历事故的原因分布条形图

上图是虚构的青石咖啡馆项目一个月的统计:和 DOM 查询与遍历相关的事故一共 90 次。忘判 null、直接在 null 上取属性 30 次,占 33.3%,是最多的;把 querySelectorAll 的结果当实时列表用、页面变了列表没变 18 次,占 20.0%;选择器里特殊字符没转义、直接抛错 15 次,占 16.7%;全文档查、把别的区域的节点也算进来 12 次,占 13.3%;children 与 childNodes 混用、把文本节点也数进去 9 次,占 10.0%;选择器带伪元素、查出空列表 6 次,占 6.7%。30 加 18 加 15 加 12 加 9 加 6 等于 90,账是平的。图里每一类都对应正文里的一步:忘判 null 是第二步,实时列表是第十四步,特殊字符没转义是第十步,全文档查是第六步,children 与 childNodes 混用是第九步,伪元素是第十一步。这些数字是编出来的例子,目的是让你一眼看到:第一类占了三分之一,而它的根源只有一个——querySelector 找不到时给的是 null,不是报错。

自查清单:写完查节点的代码,逐条打勾

第一,页面是树,document 是入口,找节点就是在树里找。第二,querySelector 只取第一个,找不到给 null,拿到先判空再用。第三,选择器就是 CSS 选择器,类、id、属性、后代、子代、:not() 全是现成的写法,写得越具体、找到的越准。第四,取全部用 querySelectorAll,没匹配是空列表,顺序是文档顺序:父在前、子在后、兄在前、弟在后。第五,NodeList 能数、能取、能 forEach;它不是实时的,也不是真数组。第六,先定容器,再在容器里找,范围小了、错就少了。第七,往上找用 closest(),从自己开始、最近的先中、找不到给 null。第八,筛一个元素用 matches(),只回 true 或 false。第九,数元素用 children,数全部节点才用 childNodes;html 的父元素是 null,父节点是 document。第十,选择器是拼出来的,先过 CSS.escape() 再拼。第十一,伪元素不在 DOM 树里,查节点别带伪元素。第十二,选择器不合法两个方法都抛 SyntaxError,拼出来的选择器要包 try/catch。第十三,只按 id 取,用 getElementById 更直白;找不到照样给 null,先判空再用。第十四,改页面之前先问手里的列表是实时的还是定格的:children 是实时的 HTMLCollection,querySelectorAll 的 NodeList 是非实时的,实时列表边遍历边改会跳号。十四条里任何一条答不上来,回到对应的章节再读一遍,比多背十个 API 都有用。

阅读 6评论 0

评论 (0)

ME
0/1000
评论加载中...

原始来源

浏览项目广场发布你的项目

相关文章

真实照片:一位女士背对镜头在看一块大黑板咖啡菜单,上面列着意式咖啡、特色饮品和加料,旁边是放着面包的玻璃展示柜
指南
先想清楚再动手:JavaScript 条件判断 if、switch 与三元运算符实战指南

网页每天都在做决定:满一百就打折、库存是零就显示售罄。本文按 MDN 的《Making decisions in your code — conditionals》《if...else》《switch》三篇官方文档讲清楚:if 与 else if、比较运算符、真值与假值、逻辑运算符、|| 的经典写错法、嵌套 if 与悬空 else、switch 与穿透、三元运算符与卫语句。

工具技巧前端工程AI 编程实践
真实照片:咖啡馆吧台后两位咖啡师并肩工作,一位正往白瓷杯里倒热牛奶拉花,另一位在操作意式咖啡机
指南
别让主线程一个人扛:Web Workers,把重活交给另一条线程

主线程又要画页面又要算账,一算就卡。Worker 是另一条线程、另一个全局上下文,两边只靠消息传话。本文按 MDN 的《Using Web Workers》与《Worker》两篇官方文档讲清楚:new Worker、postMessage 与 onmessage、结构化克隆的复制语义、Worker 里能与不能、onerror 与 terminate()、SharedWorker、Transferable 零拷贝,另附虚构咖啡馆点单页一个月 100 次 Worker 翻车的分布。

工具技巧前端工程学习与成长
真实照片:一只黑色双铃闹钟放在木质桌面上,暖色晨光,表盘显示约两点二十八分
指南
不是立刻做,是到了时间再做:JavaScript 定时器 setTimeout 与 setInterval

setTimeout 管一次,setInterval 管反复,但 delay 只保证“最少等这么久”:0 也不立刻、后台标签页还会更晚、超过 2147483647 会溢出。本文按 MDN 的 setTimeout 与 setInterval 两篇官方文档讲清楚:异步返回、传参、delay 的数字规矩、嵌套 4 毫秒、clearTimeout 与 clearInterval、递归 setTimeout、this 丢失与字符串参数,另附虚构咖啡馆点单页一个月 100 次定时器翻车的分布。

工具技巧前端工程学习与成长