XML的DOM模型中，NamedNodeMap接口用于存储无序的节点集合，最常见的应用场景是存储元素的属性节点，每个属性对应一个节点，通过属性名或者索引可以访问对应的属性信息。它和NodeList不同，NamedNodeMap中的节点没有特定的顺序，但是支持通过名称快速查找节点。
获取NamedNodeMap对象
要操作NamedNodeMap，首先需要获取它的实例，通常我们可以通过元素节点的attributes属性来获取，这个属性返回的就是该元素所有属性组成的NamedNodeMap对象。下面是一个简单的XML示例和获取NamedNodeMap的代码：
<?xml version="1.0" encoding="UTF-8"?>
<user id="1001" name="张三" age="25">
<email>test@ipipp.com</email>
</user>
使用JavaScript解析上述XML并获取user元素的NamedNodeMap：
// 假设xmlDoc是已经解析完成的XML文档对象
const userElement = xmlDoc.getElementsByTagName("user")[0];
// 获取user元素的所有属性集合，即NamedNodeMap对象
const attrMap = userElement.attributes;
console.log(attrMap); // 输出NamedNodeMap对象，包含id、name、age三个属性节点
NamedNodeMap的常用方法
获取属性节点
NamedNodeMap提供了两种获取属性节点的方式，一种是通过属性名获取，另一种是通过索引获取。
- getNamedItem(name)：根据属性名获取对应的属性节点，如果不存在则返回null。
- item(index)：根据索引获取对应位置的属性节点，索引从0开始，如果索引超出范围则返回null。
代码示例：
// 通过属性名获取id属性节点
const idAttr = attrMap.getNamedItem("id");
console.log(idAttr.nodeValue); // 输出1001，nodeValue是属性节点的值
// 通过索引获取第一个属性节点
const firstAttr = attrMap.item(0);
console.log(firstAttr.nodeName); // 输出id，nodeName是属性名
遍历所有属性
虽然NamedNodeMap没有顺序，但是我们可以通过它的length属性获取属性总数，然后结合item方法遍历所有属性。
for (let i = 0; i < attrMap.length; i++) {
const attr = attrMap.item(i);
console.log(`属性名：${attr.nodeName}，属性值：${attr.nodeValue}`);
}
// 输出结果：
// 属性名：id，属性值：1001
// 属性名：name，属性值：张三
// 属性名：age，属性值：25
修改属性值
要修改已有属性的值，可以先获取对应的属性节点，然后修改它的nodeValue属性，也可以使用setNamedItem方法替换整个属性节点。
// 方式1：修改已有属性节点的nodeValue
const nameAttr = attrMap.getNamedItem("name");
nameAttr.nodeValue = "李四";
console.log(userElement.getAttribute("name")); // 输出李四
// 方式2：创建新的属性节点并替换
const newAgeAttr = xmlDoc.createAttribute("age");
newAgeAttr.nodeValue = "26";
attrMap.setNamedItem(newAgeAttr);
console.log(userElement.getAttribute("age")); // 输出26
删除属性
可以使用removeNamedItem(name)方法根据属性名删除对应的属性节点，删除成功后会返回被删除的属性节点。
// 删除age属性
const removedAttr = attrMap.removeNamedItem("age");
console.log(removedAttr.nodeName); // 输出age
console.log(userElement.hasAttribute("age")); // 输出false，说明属性已被删除
添加新属性
添加新属性可以使用setNamedItem方法，传入新创建的属性节点即可，如果属性名已经存在，则会替换原有属性。
// 添加新的gender属性
const genderAttr = xmlDoc.createAttribute("gender");
genderAttr.nodeValue = "男";
attrMap.setNamedItem(genderAttr);
console.log(userElement.getAttribute("gender")); // 输出男
注意事项
- NamedNodeMap是动态集合，当元素的属性发生变化时，对应的NamedNodeMap对象会自动更新，不需要重新获取。
- 通过
getNamedItem获取到的属性节点是Attr类型，属于Node的子类，所以拥有nodeName、nodeValue等通用节点属性。 - 如果操作的XML文档是严格模式，属性名的大小写是敏感的，获取属性时要注意名称匹配。
NamedNodeMap除了用于元素属性集合，在部分DOM实现中也会用于存储其他类型的无序节点集合，但是实际开发中最常用的场景还是元素属性的操作。
XMLDOMNamedNodeMap节点属性操作修改时间：2026-07-06 04:42:23