DOM处理库应优先用nodeType（数值常量）分类节点类型以确保跨环境稳定，再用nodeName（统一大小写）做细粒度识别；元素节点（1）可操作属性，文本节点（3）仅读写nodeValue，注释节点（8）需跳过渲染，文档节点（9/11）作遍历边界。
要编写一个通用、跨环境的 DOM 处理库，nodeType 和 nodeName 是两个底层但关键的判断依据。它们不依赖浏览器渲染行为或特定 API（如 innerHTML 或 textContent），在服务端（如 JSDOM）、旧版 IE、现代浏览器甚至部分 WebView 中都稳定可用。核心思路是：用 nodeType 快速分类节点类型，再结合 nodeName 做细粒度识别与兼容处理。
用 nodeType 做安全类型路由，避免运行时错误
直接调用 setAttribute、textContent 或 data 等方法前，必须确认节点类型是否支持该操作。nodeType 是数值型常量，比 instanceof 或 constructor 判断更轻量、更可靠（尤其在多 iframe 或跨 Realm 场景下）。
- 元素节点（nodeType === 1）：可安全调用 getAttribute、setAttribute、querySelector 等
- 文本节点（nodeType === 3）：只允许读写 nodeValue，不能调用 childNodes 或 style
- 注释节点（nodeType === 8）：nodeValue 可读取注释内容，但不可设为 HTML；需跳过渲染逻辑
- 文档/文档片段节点（nodeType === 9 或 11）：作为遍历根节点时的终止条件或上下文容器
用 nodeName 统一标签名识别，绕过大小写与命名差异
nodeName 返回大写标签名（如 "DIV"、"INPUT"），且在所有标准环境中一致。相比 tagName（仅元素节点有），nodeName 覆盖更广——它对属性节点返回属性名（如 "id"、"class"），对文本节点固定返回 "#text"，对注释节点返回 "#comment"。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 匹配自定义元素时，用 nodeName.toLowerCase() === 'my-button' 更稳妥，避免大小写陷阱
- 过滤脚本/样式节点：node.nodeName === 'SCRIPT' || node.nodeName === 'STYLE'
- 识别 SVG 元素时，nodeName 仍为大写（如 "SVG"、"PATH"），无需额外命名空间检测
- 处理属性节点时，attr.nodeName 直接给出属性键名，比遍历 attributes 集合 + name 属性更直接
组合使用构建健壮的节点遍历器
通用库中常需深度遍历子树。若仅靠 node.childNodes，会混入空白文本节点、注释等干扰项。结合 nodeType 与 nodeName 可实现语义化过滤。
- 跳过非元素子节点：if (child.nodeType !== 1) continue
- 保留文本但排除空白：if (child.nodeType === 3 && child.nodeValue.trim())
- 安全提取首元素子节点：el.firstElementChild || Array.from(el.childNodes).find(n => n.nodeType === 1)
- 兼容 IE8 的 children 替代方案：Array.prototype.filter.call(el.childNodes, n => n.nodeType === 1)
适配非浏览器环境的关键处理点
在 JSDOM、Deno DOM 或 Node.js 测试环境里，部分节点类型行为略有差异（如 DocumentType 节点的 nodeName 在某些版本中可能为 null）。此时应以 nodeType 为第一判断依据，nodeName 为辅助校验。
- 检查 document 是否就绪：doc.nodeType === 9 && doc.nodeName === '#document'
- 创建兼容性文本节点：doc.createTextNode('') // nodeType=3，nodeName='#text' 恒成立
- 避免依赖 document.body（可能为 null）：先用 doc.documentElement（nodeType=1）作为默认根
- 序列化时忽略注释与 CDATA：node.nodeType !== 8 && node.nodeType !== 4
