语法
js
new String(thing)
String(thing)
参数
thing-
任何要转换为字符串的内容。
返回值
当 String 作为构造函数（使用 new）被调用时，它会创建一个 String 对象，该对象不是原始类型。
当 String 作为函数被调用时，它会将参数强制转换为一个字符串原始类型。Symbol 值会被转换成 "Symbol(description)"，其中 description 是该 Symbol 的 description 属性值，而不会抛出错误。
警告：你应该很少需要使用 String 作为构造函数。
示例
String 构造函数和 String 函数
String 函数和 String 构造函数产生不同的结果：
js
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"
在这里，该函数生成了一个字符串（即原始值），如其所述。然而，构造函数生成了一个类型为 String 的实例（即一个对象包装器），这就是为什么你很少需要使用 String 作为构造函数的原因。
使用 String() 将 Symbol 转换为字符串：
String() 是唯一一种可以将 Symbol 转换为字符串而不抛出异常的方式，因为它非常明确。
js
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
js
const sym = Symbol("示例");
String(sym); // "Symbol(示例)"
规范
| 规范 |
|---|
| ECMAScript® 2027 Language Specification # sec-string-constructor |
浏览器兼容性
参见
- 数字与字符串指南