База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Symbol.toStringTag — персонализиран етикет на обект

Symbol.toStringTag е добре познат символ, използван като ключ на свойство, което задава етикета в резултата от Object.prototype.toString(). Той променя описанието на обекта, а не действителния му тип.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const value = { [Symbol.toStringTag]: "Widget" };
Object.prototype.toString.call(value);

Symbol.toStringTag е добре познат символ, а не метод. Свойство на обект с този ключ може да предостави низа, който Object.prototype.toString.call(value) използва, за да създаде резултат като [object Widget]. Символният ключ не е същото като низовия ключ "Symbol.toStringTag".

Методът чете това свойство и по веригата на прототипите. Ако стойността му не е низ, използва етикета по подразбиране, например Object за обикновен обект; не преобразува стойността в низ. Getter може да се изпълни и всяко изключение, което той предизвика, се предава нататък.

Етикетът служи за описание, а не за надеждна проверка на типа: може да бъде фалшифициран. Той не променя typeof, прототипа или вътрешните възможности на обекта. Не замества и персонализиран метод toString(), нито управлява преобразуването към примитивна стойност като цяло — това е ролята на Symbol.toPrimitive.

Примери

const item = { [Symbol.toStringTag]: "Widget" };
console.log(Object.prototype.toString.call(item));

item[Symbol.toStringTag] = 42;
console.log(Object.prototype.toString.call(item));
console.log(typeof item);

Резултат

[object Widget]
[object Object]
object

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници