---
title: 'Symbol.prototype[@@toPrimitive]'
slug: Web/JavaScript/Reference/Global_Objects/Symbol/@@toPrimitive
tags:
  - ECMAScript 2015
  - ECMAScript6
  - JavaScript
  - Method
  - Prototype
  - Symbol
translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/@@toPrimitive
---
<div>{{JSRef}}</div>

<div></div>

<p>Метод <code><strong>[@@toPrimitive]()</strong></code>  <span style="font-size: 1rem; letter-spacing: -0.00278rem;">преобразует объект Symbol в примитивное значение.</span></p>

<h2 id="Синтаксис">Синтаксис</h2>

<pre class="syntaxbox"><var>Symbol()[Symbol.toPrimitive](hint)
</var></pre>

<h3 id="Возвращаемое_значение">Возвращаемое значение</h3>

<p>Примитивное значение указанного объекта Symbol {{jsxref("Symbol")}}.</p>

<h2 id="Описание">Описание</h2>

<p>Метод <code>[@@toPrimitive]()</code><span style="font-size: 1rem; letter-spacing: -0.00278rem;"> возвращает примитивное значение объекта Symbol как тип данных Symbol. Аргумент </span><code style="font-size: 1rem; letter-spacing: -0.00278rem;">hint</code><span style="font-size: 1rem; letter-spacing: -0.00278rem;"> не используется.</span></p>

<p>JavaScript вызывает метод<code style="font-size: 1rem; letter-spacing: -0.00278rem;">[@@toPrimitive] ()</code><span style="font-size: 1rem; letter-spacing: -0.00278rem;"> для преобразования объекта в примитив. </span><span style="font-size: 1rem; letter-spacing: -0.00278rem;">JavaScript автоматически вызывает метод, когда на месте</span><span style="font-size: 1rem; letter-spacing: -0.00278rem;"> объекта ожидается примитивное значение.</span></p>

<h2 id="Спецификации">Спецификации</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Спецификация</th>
   <th scope="col">Статус</th>
   <th scope="col">Комментарий</th>
  </tr>
  <tr>
   <td>{{SpecName('ES2015', '#sec-symbol.prototype-@@toprimitive', 'Symbol.prototype.@@toPrimitive')}}</td>
   <td>{{Spec2('ES2015')}}</td>
   <td>Изначальное определение.</td>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-symbol.prototype-@@toprimitive', 'Symbol.prototype.@@toPrimitive')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2>



<p>{{Compat("javascript.builtins.Symbol.@@toPrimitive")}}</p>

<h2 id="Смотрите_также">Смотрите также</h2>

<ul>
 <li>{{jsxref("Symbol.toPrimitive")}}</li>
</ul>