大网数据广告活动
Web 标准与前端开发

String() 构造函数

· 52CE 我爱测

**`String()`** 构造函数创建 String 对象。当作为函数调用时,它返回 String 类型的原始值。

String() 构造函数创建 String 对象。当作为函数调用时,它返回 String 类型的原始值。

语法

new String(thing)
String(thing)

[!NOTE] String() 被调用时可以带或不带 new,但会有不同的效果。请参见返回值。

参数

  • thing
    • : 任何要转换为字符串的内容。

返回值

当 String 作为构造函数(使用 new)被调用时,它会创建一个 String 对象,该对象不是原始类型。

当 String 作为函数被调用时,它会将参数强制转换为一个字符串原始类型。Symbol 值会被转换成 "Symbol(description)",其中 description 是该 Symbol 的 description 属性值,而不会抛出错误。

[!WARNING] 你应该很少需要使用 String 作为构造函数。

示例

String 构造函数和 String 函数

String 函数和 String 构造函数产生不同的结果:

const a = new String("Hello world"); // a === "Hello world" 为 false
const b = String("Hello world"); // b === "Hello world" 为 true
a instanceof String; // 为 true
b instanceof String; // 为 false
typeof a; // "object"
typeof b; // "string"

在这里,该函数生成了一个字符串(即primitive),如其所述。然而,构造函数生成了一个类型为 String 的实例(即一个对象包装器),这就是为什么你很少需要使用 String 作为构造函数的原因。

使用 String() 将 Symbol 转换为字符串:

String() 是唯一一种可以将 Symbol 转换为字符串而不抛出异常的方式,因为它非常明确。

const sym = Symbol("示例");
`${sym}`; // TypeError: Cannot convert a Symbol value to a string
"" + sym; // TypeError: Cannot convert a Symbol value to a string
"".concat(sym); // TypeError: Cannot convert a Symbol value to a string
const sym = Symbol("示例");
String(sym); // "Symbol(示例)"

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。