JavaScript怎样查询XML节点当前生效的默认命名空间

处理 SVG、MathML 或 XML 文档时，最容易混淆的是“节点属于哪个命名空间”和“从这个节点上下文出发，当前默认命名空间声明是什么”。前者通常看 namespaceURI，后者应调用 node.lookupNamespaceURI(null)。WHATWG DOM 标准规定，lookupNamespaceURI() 会把空字符串当成 null，再按节点类型和祖先关系定位命名空间。

官方文档：https://dom.spec.whatwg.org/#dom-node-lookupnamespaceuri

• 查默认命名空间：传入 null，或传入空字符串。
• 查带前缀命名空间：传入例如 svg 这样的前缀，不要带冒号。
• 查不到或被空的 xmlns 覆盖时，结果是 null。
• namespaceURI 是节点自身的命名空间，不等同于当前上下文声明。

先用 null 查询节点上下文的默认命名空间

默认命名空间没有前缀，所以调用时用 null 最直观。DOM 标准的算法还把空字符串归一化为 null，因此下面两种写法表达相同的查询意图。返回值是命名空间 URI，找不到时为 null，不是空字符串。

function readDefaultNamespace(node) {
  // 默认命名空间没有前缀，用 null 表示“查当前上下文的默认声明”。
  if (!(node instanceof Node)) {
    return { uri: null, reason: "invalid-node" };
  }

  const uri = node.lookupNamespaceURI(null);
  // null 表示当前节点上下文没有可用的默认命名空间声明。
  return { uri, reason: uri === null ? "not-found" : null };
}

const result = readDefaultNamespace(xmlElement);
// 调用方可按 reason 区分参数错误和合法但未声明命名空间。
console.log(result);

这里的检查只是让业务函数返回更清晰的结果；真正的命名空间定位仍由 DOM 方法完成。不要用 getAttribute("xmlns") 代替它，因为默认声明可能来自祖先元素，而不是当前元素的直接属性。

namespaceURI 和当前默认声明不是一回事

一个 XML 元素的 namespaceURI 描述它自身创建时所属的命名空间，而 lookupNamespaceURI(null) 查询的是从这个节点上下文向外解析的默认命名空间绑定。两个值经常相同，但它们回答的问题不同：前者是“我是谁”，后者是“这个上下文里的空前缀现在指向什么”。

function compareNamespaceFacts(node) {
  // namespaceURI 读取节点身份，lookupNamespaceURI 读取空前缀绑定。
  const nodeUri = node.namespaceURI;
  const defaultUri = node.lookupNamespaceURI(null);

  return {
    nodeUri,
    defaultUri,
    same: nodeUri === defaultUri
  };
}

const facts = compareNamespaceFacts(xmlElement);
// same 为 false 并不代表查询失败，只说明两个问题的答案不同。
console.log(facts);

例如，节点可以通过前缀属于某个命名空间，而当前上下文同时存在另一个默认命名空间。此时不能看到 namespaceURI 就推断空前缀绑定；需要分别读取两个属性和方法的结果。

沿祖先继承时要留意 xmlns 空声明

对元素调用查询时，DOM 标准会先检查当前元素的命名空间、前缀和 xmlns 属性；如果没有匹配，再沿父元素继续查找。默认命名空间可以由祖先提供，也可以在后代元素上用 xmlns="" 解除。解除后，默认查询返回 null，不会继续使用更远处的旧声明。

function describeDefaultBinding(node) {
  // lookupNamespaceURI 会沿父元素寻找默认声明，空 xmlns 会让结果回到 null。
  const uri = node.lookupNamespaceURI(null);
  return uri === null
    ? "当前上下文没有默认命名空间"
    : `默认命名空间：${uri}`;
}

// 例：outer 有 xmlns，inner 有 xmlns="" 时，inner 的查询不会继承 outer 的 URI。
const message = describeDefaultBinding(innerElement);
console.log(message);

这个边界也是为什么只读取当前元素的 getAttribute("xmlns") 不够：属性不存在可能意味着要继承，属性值为空则意味着明确解除默认绑定。

带前缀查询不要把冒号传进去

查询 xmlns:svg="..." 时，参数应是 "svg"，不是 "xmlns:svg"，也不是 "svg:"。标准算法会把 xml 和 xmlns 视为保留前缀，并对普通前缀检查当前元素及祖先上的对应声明。

function readNamespaceByPrefix(node, prefix) {
  // 只接受前缀本身，调用方负责不要传入 xmlns: 前缀语法。
  if (typeof prefix !== "string" || prefix === "" || prefix.includes(":")) {
    return { uri: null, reason: "invalid-prefix" };
  }

  const uri = node.lookupNamespaceURI(prefix);
  // 未找到前缀绑定与前缀参数格式错误应保持为两种原因。
  return { uri, reason: uri === null ? "not-found" : null };
}

const svgNamespace = readNamespaceByPrefix(xmlElement, "svg");
console.log(svgNamespace);

如果需求是判断某个 URI 是否就是当前默认命名空间，可以使用 node.isDefaultNamespace(uri)；它和 lookupNamespaceURI(null) 都围绕空前缀，但前者直接返回布尔判断，后者返回 URI。

常见问题

传空字符串和传 null 有区别吗？对 lookupNamespaceURI() 的默认查询来说没有区别，标准步骤会先把空字符串设为 null。

为什么当前元素没有 xmlns 属性也能查到 URI？查询会沿父元素查找命名空间绑定，所以声明可能来自祖先元素。

xmlns="" 为什么返回 null？它是对默认命名空间的明确解除，不是“缺少属性”；因此不会继续继承更远处的默认 URI。

能用 namespaceURI 判断默认命名空间吗？不能直接替代。namespaceURI 描述节点自身命名空间，默认查询描述上下文中的空前缀绑定，两者需要分别读取。

记忆方式很简单：namespaceURI 看节点身份，lookupNamespaceURI(null) 看默认绑定，lookupNamespaceURI("prefix") 看前缀绑定；继承和 xmlns="" 决定上下文最终能否找到 URI。