当前位置:首页 > 文章列表 > 文章 > 前端 > JavaScript getAttributeNames 怎样枚举元素当前的属性名称

JavaScript getAttributeNames 怎样枚举元素当前的属性名称

来源:17golang原创 2026-11-18 08:09:55 0浏览 收藏

如果你要读取一个 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删除
CSS @scope 怎样用 :scope 选择器定位组件根节点CSS @scope 怎样用 :scope 选择器定位组件根节点
上一篇
CSS @scope 怎样用 :scope 选择器定位组件根节点
JavaScript hasAttributes 怎样判断元素是否带有任意 HTML 属性
下一篇
JavaScript hasAttributes 怎样判断元素是否带有任意 HTML 属性
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1088次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1088次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1251次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1196次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1040次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码