登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  前端

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());

例如,若元素是

,返回结果会包含 class 和 data-kind。具体顺序跟元素当前属性集合的顺序保持一致,但业务代码通常只应依赖名称是否存在,不要把某个位置当成稳定协议。
getAttributeNames返回属性名数组并连接到getAttribute读取属性值的静态结构说明图
图1:属性名数组与 getAttribute 值读取之间的静态关系说明图,不是浏览器截图或运行证据。

怎样同时枚举属性名和属性值

最小实用写法是先取得名称数组,再逐个调用 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));
}

还要注意:一个属性可以拥有命名空间,却没有命名空间前缀。此时返回值只包含属性名本身,不能仅凭字符串判断它的命名空间;如果命名空间身份很重要,应进一步使用命名空间相关 DOM API。

普通属性、带xlink前缀属性和无前缀命名空间属性的静态关系说明图
图2:限定属性名、命名空间前缀与无前缀命名空间属性的边界说明图,不是浏览器截图或运行证据。

和 attributes、dataset、对象枚举怎么选

几种 API 解决的问题不同,不要只因为都能“列出一些名字”就互换:

需求更合适的 API原因
只要当前属性名getAttributeNames()直接得到字符串数组,适合映射和过滤。
要遍历属性节点及名称和值element.attributes能访问 Attr 节点,但使用方式更底层。
只处理 data-* 属性element.dataset把 data 属性映射为 DOMStringMap 字段。
枚举普通 JavaScript 对象字段Object.keys()目标是对象自有可枚举属性,不是 DOM 属性集合。

所以,组件调试、属性转储、通用 DOM 读取器适合使用 getAttributeNames();如果只关心 data-*,直接使用 dataset 通常更清晰。

兼容处理和使用边界

MDN 将该特性标为 Widely available,并记录其跨浏览器可用时间为 2018 年 10 月。若项目必须兼容更早的浏览器,可以用 element.attributes 取代它:

function getAttributeNamesCompat(element) {
  // 旧环境没有 getAttributeNames 时,从 Attr 集合复制名称
  if (typeof element.getAttributeNames === 'function') {
    return element.getAttributeNames();
  }

  return Array.from(element.attributes, (attribute) => attribute.name);
}

这个降级函数只负责得到名称,不会改变元素,也不会把属性值自动转成数字、布尔值或 JSON。使用时仍应按字符串处理,并对可能不存在的元素先做空值判断。

常见问题

getAttributeNames() 会返回属性值吗?

不会。它只返回属性名字符串数组;要取值,需要把每个名称传给 getAttribute()。

没有属性时应该判断 null 吗?

不用。方法返回空数组 [],可以直接使用 length、map 或 for...of。

它和 Object.keys(element) 一样吗?

不一样。前者面向 DOM 属性集合,后者面向 JavaScript 对象的自有可枚举字段,结果来源和用途都不同。

属性动态变化后需要重新调用吗?

如果要得到变化后的最新名称,应重新调用。已经复制出的数组只是当时的快照,不会随着元素自动更新。

记住一个简单组合:getAttributeNames() 负责拿名称,getAttribute() 负责按名称读取值;遇到命名空间属性时保留返回的限定名称,不要把 DOM 属性枚举和 JavaScript 对象枚举混在一起。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>