jQuery的选择器能力主要由内置的Sizzle引擎提供。很多人不知道的是，Sizzle在HTML文档和XML文档下的行为有明显差异：HTML文档下可以利用浏览器原生API做加速，而XML文档下必须走纯JavaScript遍历匹配的路径。jQuery之所以能在这两种模式之间正确切换，靠的就是内部的isXMLDoc判断。理解这个方法，不仅能帮你读懂jQuery源码，也能在处理跨文档操作、动态XML节点时避开一些隐蔽的坑。
一、为什么HTML和XML需要不同的选择器策略
浏览器为HTML文档提供了一系列高效的原生查找接口，例如getElementById、getElementsByClassName以及querySelectorAll。这些接口在HTML文档中是不区分大小写的，因为HTML规范本身对标签名做了小写化处理。Sizzle在初始化时会优先探测这些原生API是否可用，能用就走快速通道。
但XML文档完全不同。XML是大小写敏感的，<Book>和<book>是两个不同的标签；XML还支持命名空间，<ns:item>这样的节点在HTML里根本不存在。此外，XML节点上的属性查找、className与class的差异，都使得直接复用HTML的快速路径会返回错误结果。因此Sizzle必须在执行前先搞清楚当前操作的文档类型，这便是isXMLDoc存在的意义。
从性能角度看，这一判断的成本极低，只涉及几次属性读取，而判断错误带来的代价是整个选择器结果不正确，所以jQuery在Sizzle的select入口、matches、filter等关键位置都会调用它来决定后续分支。
二、isXMLDoc的实现原理
isXMLDoc的完整签名是jQuery.isXMLDoc(node)，参数是一个DOM节点或文档对象，返回布尔值。它的核心逻辑在jQuery源码中大致如下：
// jQuery 3.x 中的核心实现（简化） var documentElement = ( elem ? elem.ownerDocument || elem : 0 ).documentElement; return !!documentElement && documentElement.nodeName !== "HTML";
这段代码分两步走。第一步通过elem.ownerDocument || elem拿到节点所属的文档对象：如果传入的是普通节点，ownerDocument指向其所属文档；如果传入的本身就是document对象，它没有ownerDocument属性，则直接使用自身。随后取该文档的documentElement，即根元素。
第二步判断根元素的nodeName是否为HTML。HTML文档的根元素永远是<html>，而解析后的XML片段根元素可能是任何名字，例如<catalog>、<rss>。只要根元素不叫HTML，就认定这是XML文档。这个判断看似简单，却非常可靠：它不需要检查MIME类型，也不依赖xmlVersion这类在新规范中已被废弃的属性，兼容性极佳。
需要注意返回值中的双重取反!!，它把可能为null的documentElement安全地转换成布尔值，保证传入空值或游离节点时不会抛出异常，而是返回false。
三、判断结果如何切换Sizzle的引擎模式
isXMLDoc的结果直接影响Sizzle的多个执行分支。在Sizzle源码的setDocument函数中，一旦判定当前上下文是XML文档，引擎会禁用一批依赖HTML特性的优化，包括基于getElementById的ID快速定位、基于className的类选择器加速，以及在支持范围内使用querySelectorAll的尝试。
切换到XML模式后，Sizzle改用getElementsByTagName、getElementsByTagNameNS配合自实现的匹配函数逐层筛选。标签匹配会区分大小写，属性选择器也会严格按照XML语义处理。下面的例子演示了这一差异的实际影响：
// 通过 $.parseXML 创建一个真正的 XML 文档
var xml = $.parseXML("<catalog><Book name='js'>内容</Book></catalog>");
console.log(jQuery.isXMLDoc(xml)); // true
// 标签必须严格区分大小写，写成 book 匹配不到任何节点
console.log($("Book", xml).length); // 1
console.log($("book", xml).length); // 0
如果isXMLDoc误判为HTML，Sizzle会尝试用HTML的不区分大小写逻辑去匹配，在某些浏览器上会直接返回空结果或抛出底层异常。这就是为什么手动构造XML节点后传入jQuery时，确保文档归属正确如此重要。
四、实际项目中的使用场景与常见误用
第一个典型场景是AJAX获取XML响应。虽然$.ajax设置dataType: "xml"时会自动解析，但用$.get拿到字符串后手动$.parseXML再操作的场景也很常见，此时应先确认文档类型再执行查询，便于日志记录和分支控制。
第二个场景是iframe内的文档操作。同源iframe的contentDocument如果是XHTML或XML渲染模式，判断结果会影响你在其中使用选择器的方式。第三个场景是SVG文档，SVG本质是XML，jQuery.isXMLDoc(svgRootElement)返回true，这也是在SVG内使用类选择器有时行为与HTML不同的原因之一。
常见误用包括：把选择器字符串当作参数传入，例如jQuery.isXMLDoc("#id")，这是无效的，方法只接受节点或文档对象；在节点尚未插入文档前调用，游离节点没有ownerDocument上的有效根元素，可能得到不符合预期的false；以及误以为它能检测字符串内容是否是XML格式，这属于$.parseXML的职责范围。
五、扩展思路：兼容不同版本的写法
旧版jQuery（1.x早期）的实现还检查了document.contentType等属性，后来为兼容性统一收敛到根元素判断。如果你的项目需要脱离jQuery实现同样功能，可以自己封装：
function isXMLDoc(node) {
var doc = node && (node.ownerDocument || node);
if (!doc || !doc.documentElement) {
return false;
}
return doc.documentElement.nodeName !== "HTML";
}
这个实现与jQuery 3.x的行为一致，可以用于轻量场景。若需处理带命名空间的文档，还可以进一步结合lookupNamespaceURI做增强，但就判断文档类型这一目标而言，根元素检测已经足够准确且跨浏览器稳定。掌握isXMLDoc，等于掌握了jQuery选择器在双模式间切换的那把钥匙。
jQuery isXMLDocSizzle引擎XML文档判断修改时间：2026-09-01 18:08:36