JavaScript getAttributeNames 怎样枚举元素当前的属性名称
来源:17golang原创
时间:2026-11-18 08:09:55 216浏览 收藏
如果你要读取一个 DOM 元素“现在到底有哪些属性”,可以直接调用 element.getAttributeNames()。它返回一个字符串数组;元素没有属性时返回空数组。需要继续取得每个属性的值,再把名称传给 getAttribute(name) 即可。
官方参考:https://developer.mozilla.org/en-US/docs/Web/API/Element/getAttributeNames
getAttributeNames() 返回什么
这个方法没有参数,返回当前元素的属性名称数组。它枚举的是 DOM 属性节点,不是 JavaScript 对象上可用的字段,也不会把元素的属性值直接放进结果中。
const card = document.querySelector('.card');
// 只取属性名称,不会返回 class 的值
const names = card.getAttributeNames();
console.log(names);
// 没有任何属性的元素会得到 []
const empty = document.createElement('div');
console.log(empty.getAttributeNames());
例如,若元素是 最小实用写法是先取得名称数组,再逐个调用 返回的是限定属性名。没有命名空间前缀的属性按原名返回,例如 还要注意:一个属性可以拥有命名空间,却没有命名空间前缀。此时返回值只包含属性名本身,不能仅凭字符串判断它的命名空间;如果命名空间身份很重要,应进一步使用命名空间相关 DOM API。 几种 API 解决的问题不同,不要只因为都能“列出一些名字”就互换: 所以,组件调试、属性转储、通用 DOM 读取器适合使用 MDN 将该特性标为 Widely available,并记录其跨浏览器可用时间为 2018 年 10 月。若项目必须兼容更早的浏览器,可以用 这个降级函数只负责得到名称,不会改变元素,也不会把属性值自动转成数字、布尔值或 JSON。使用时仍应按字符串处理,并对可能不存在的元素先做空值判断。 不会。它只返回属性名字符串数组;要取值,需要把每个名称传给 不用。方法返回空数组 不一样。前者面向 DOM 属性集合,后者面向 JavaScript 对象的自有可枚举字段,结果来源和用途都不同。 如果要得到变化后的最新名称,应重新调用。已经复制出的数组只是当时的快照,不会随着元素自动更新。 记住一个简单组合:class 和 data-kind。具体顺序跟元素当前属性集合的顺序保持一致,但业务代码通常只应依赖名称是否存在,不要把某个位置当成稳定协议。

怎样同时枚举属性名和属性值
getAttribute()。这样既保留了 DOM 属性的字符串语义,也能明确区分属性不存在和属性值为空字符串。function readAttributes(element) {
// 使用 DOM 方法取属性名,避免把元素当作普通对象枚举
return element.getAttributeNames().map((name) => ({
name,
value: element.getAttribute(name),
}));
}
const link = document.querySelector('a');
const attributes = readAttributes(link);
for (const attribute of attributes) {
// name 是属性名,value 是对应的字符串值
console.log(`${attribute.name} = ${attribute.value}`);
}
getAttribute() 对已经枚举出的名称会返回对应字符串;如果另一个逻辑在遍历过程中修改了属性,后续读取反映的是当时元素的最新状态。因此,如果要保存一份一致快照,应先把名称和值一起映射成数组,而不是反复调用名称枚举。命名空间前缀为什么会出现在结果里
href;带前缀的属性会保留类似 xlink:href 的形式。名称中有冒号并不意味着可以把它当作普通 JavaScript 对象路径处理。const icon = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
// 普通属性没有前缀
icon.setAttribute('role', 'img');
// 这个示例展示带 xlink 前缀的限定属性名
icon.setAttributeNS(
'http://www.w3.org/1999/xlink',
'xlink:href',
'#symbol-star',
);
for (const name of icon.getAttributeNames()) {
// 传回完整名称,才能按枚举结果读取对应值
console.log(name, icon.getAttribute(name));
}

和 attributes、dataset、对象枚举怎么选
需求 更合适的 API 原因 只要当前属性名 getAttributeNames()直接得到字符串数组,适合映射和过滤。 要遍历属性节点及名称和值 element.attributes能访问 Attr 节点,但使用方式更底层。 只处理 data-* 属性 element.dataset把 data 属性映射为 DOMStringMap 字段。 枚举普通 JavaScript 对象字段 Object.keys()目标是对象自有可枚举属性,不是 DOM 属性集合。 getAttributeNames();如果只关心 data-*,直接使用 dataset 通常更清晰。兼容处理和使用边界
element.attributes 取代它:function getAttributeNamesCompat(element) {
// 旧环境没有 getAttributeNames 时,从 Attr 集合复制名称
if (typeof element.getAttributeNames === 'function') {
return element.getAttributeNames();
}
return Array.from(element.attributes, (attribute) => attribute.name);
}
常见问题
getAttributeNames() 会返回属性值吗?
getAttribute()。没有属性时应该判断 null 吗?
[],可以直接使用 length、map 或 for...of。它和 Object.keys(element) 一样吗?
属性动态变化后需要重新调用吗?
getAttributeNames() 负责拿名称,getAttribute() 负责按名称读取值;遇到命名空间属性时保留返回的限定名称,不要把 DOM 属性枚举和 JavaScript 对象枚举混在一起。
-
130 收藏
-
306 收藏
-
194 收藏
-
414 收藏
-
427 收藏
-
337 收藏
-
文章 · 前端 | 38分钟前 | html · 前端 · javascript · 表单 · SecurityError HTMLInputElement showPicker Transient activation NotAllowedError367 收藏
-
150 收藏
-
262 收藏
-
236 收藏
-
355 收藏
-
100 收藏
-
222 收藏
-
357 收藏
-
218 收藏
-
378 收藏
-
340 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习