Symbol.prototype.toString()

Try it

console.log(Symbol("desc").toString());
// Expected output: "Symbol(desc)"

console.log(Symbol.iterator.toString());
// Expected output: "Symbol(Symbol.iterator)

console.log(Symbol.for("foo").toString());
// Expected output: "Symbol(foo)"

// console.log(Symbol('foo') + 'bar');
// Expected output: Error: Can't convert symbol to string

Cú pháp

toString()

Tham số

Không có.

Giá trị trả về

Một chuỗi đại diện cho giá trị symbol đã chỉ định.

Mô tả

Đối tượng Symbol ghi đè phương thức toString của Object; nó không kế thừa Object.prototype.toString(). Đối với các giá trị Symbol, phương thức toString trả về chuỗi mô tả có dạng "Symbol(description)", trong đó description là mô tả của symbol.

Phương thức toString() yêu cầu giá trị this của nó là một nguyên thủy Symbol hoặc đối tượng bao bọc. Nó ném TypeError cho các giá trị this khác mà không cố gắng ép kiểu chúng thành giá trị symbol.

Vì Symbol có phương thức [Symbol.toPrimitive](), phương thức đó luôn có độ ưu tiên cao hơn toString() khi một đối tượng Symbol được ép kiểu thành chuỗi. Tuy nhiên, vì Symbol.prototype[Symbol.toPrimitive]() trả về một nguyên thủy symbol, và các nguyên thủy symbol ném TypeError khi được chuyển đổi ngầm định thành chuỗi, phương thức toString() không bao giờ được ngôn ngữ gọi ngầm định. Để stringify một symbol, bạn phải gọi rõ ràng phương thức toString() của nó hoặc dùng hàm String().

Ví dụ

Sử dụng toString()

Symbol("desc").toString(); // "Symbol(desc)"

// well-known symbols
Symbol.iterator.toString(); // "Symbol(Symbol.iterator)"

// global symbols
Symbol.for("foo").toString(); // "Symbol(foo)"

Gọi toString() ngầm định

Cách duy nhất để JavaScript gọi ngầm định toString() thay vì [Symbol.toPrimitive]() trên một đối tượng bao bọc symbol là bằng cách xóa phương thức [Symbol.toPrimitive]() trước.

delete Symbol.prototype[Symbol.toPrimitive];
console.log(`${Object(Symbol("foo"))}`); // "Symbol(foo)"

Đặc tả

Tương thích trình duyệt

Xem thêm

• Object.prototype.toString()