0

0

JavaScript中Symbol类型的描述属性description用法

舞夢輝影

舞夢輝影

发布时间:2026-03-13 22:56:31

|

397人浏览过

|

来源于php中文网

原创

Symbol.description 是 Symbol 实例的只读属性,返回创建时传入的描述字符串(如 Symbol("foo").description 为 "foo"),不参与相等性比较,Symbol("id") === Symbol("id") 仍为 false;无参创建时值为 undefined,全局 Symbol(如 Symbol.for)同样适用;它仅作调试标签,不可用于运行时逻辑判断。

javascript中symbol类型的描述属性description用法

Symbol.description 是 Symbol 实例的一个只读属性,用于获取创建该 Symbol 时传入的可选描述字符串(即 description 参数),它**不是 Symbol 的原始值本身,也不参与相等性比较或唯一性保证**。

description 是只读的“快照”,不改变 Symbol 行为

当你用 Symbol("foo") 创建一个 Symbol 时,字符串 "foo" 仅作为调试用途的描述被记录在 .description 属性中。这个属性不可写、不可枚举、不可配置:

  • 修改 sym.description = "bar" 不会生效(严格模式下静默失败,非严格模式也无效)
  • 它不会影响 sym.toString() 的输出格式(仍为 "Symbol(foo)"
  • 更关键的是:两个描述相同的 Symbol 仍是不相等的——Symbol("id") === Symbol("id") 结果为 false

如何安全读取 description

推荐直接访问属性,但要注意:如果 Symbol 是用 Symbol()(无参数)创建的,.description 值为 undefined

  • Symbol("user").description"user"
  • Symbol().descriptionundefined
  • Symbol.for("cache").description"cache"(注意:全局注册的 Symbol 同样有 description)
  • 不要依赖 .description 来判断 Symbol 类型或用途,它只是辅助信息

和 toString() 的区别

.description 只返回纯字符串,而 .toString() 返回带 "Symbol("")" 包裹的完整标识字符串:

吐槽大师
吐槽大师

吐槽大师(Roast Master) - 终极 AI 吐槽生成器,适用于 Instagram,Facebook,Twitter,Threads 和 Linkedin

下载

立即学习Java免费学习笔记(深入)”;

  • const s = Symbol("data");
  • s.description"data"
  • s.toString()"Symbol(data)"
  • 因此调试时若需简洁标识,优先用 .description;日志或序列化场景可用 toString()

实际使用建议

.description 当作开发期友好的“标签”,而非运行时逻辑依据:

  • 可用于 DevTools 中快速识别 Symbol 用途,比如 console.log(sym.description)
  • 避免在条件判断、键名生成或缓存策略中依赖它(应使用 Symbol 本身作 key 或标识)
  • Object.getOwnPropertySymbols() 配合,方便排查对象上有哪些 Symbol 属性:Object.getOwnPropertySymbols(obj).map(s => ({ key: s, desc: s.description }))

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

564

2023.09.20

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1568

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

651

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1204

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

193

2025.07.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.4万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号