String() 构造函数

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

语法

js
new String(thing)
String(thing)

备注： String() 被调用时可以带或不带 new，但会有不同的效果。请参见返回值。

参数

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(示例)"

规范

Specification
ECMAScript Language Specification
# sec-string-constructor

浏览器兼容性

BCD tables only load in the browser

参见