---
title: BigInt.prototype.toString()
slug: Web/JavaScript/Reference/Global_Objects/BigInt/toString
tags:
  - BigInt
  - JavaScript
  - Metodă
  - Prototyp
  - toString()
translation_of: Web/JavaScript/Reference/Global_Objects/BigInt/toString
original_slug: Web/JavaScript/Referencje/Obiekty/BigInt/toString
---
<div>{{JSRef}}</div>

<p>Metoda <strong><code>toString()</code></strong> zwraca ciąg znaków (<em>string</em>), reprezentujący dany obiekt {{jsxref("BigInt")}}. Końcowy znak "n" nie jest częścią wynikowego ciągu znaków.</p>

<div>{{EmbedInteractiveExample("pages/js/bigint-tostring.html")}}</div>



<h2 id="Składnia">Składnia</h2>

<pre class="syntaxbox"><code><var>bigIntObj</var>.toString([podstawa])</code></pre>

<h3 id="Parametry">Parametry</h3>

<dl>
 <dt><code>podstawa</code>{{optional_inline}}</dt>
 <dd>Argument opcjonalny. Liczba całkowita w zakresie od 2 do 36, reprezentująca bazę systemu liczbowego, w którym ma być przedstawiona dana wartość {{jsxref("BigInt")}}.</dd>
</dl>

<h3 id="Zwracana_wartość">Zwracana wartość</h3>

<p>Ciąg znaków reprezentujący dany obiekt {{jsxref("BigInt")}}.</p>

<h3 id="Wyjątki">Wyjątki</h3>

<dl>
 <dt>{{jsxref("RangeError")}}</dt>
 <dd>Jeśli do metody <code>toString()</code> przekazana jest podstawa systemu mniejsza niż 2 lub większa niż 36, wyrzucany jest błąd {{jsxref("RangeError")}}.</dd>
</dl>

<h2 id="Opis">Opis</h2>

<p>Obiekt {{jsxref("BigInt")}} nadpisuje metodę <code>toString()</code> obiektu {{jsxref("Object")}}; nie dziedziczy metody {{jsxref("Object.prototype.toString()")}}. Dla obiektów {{jsxref( "BigInt")}}, metoda <code>toString()</code> zwraca ciąg znaków reprezentujący daną wartość w systemie pozycyjnym o zadanej bazie.</p>

<p>Metoda <code>toString()</code> parsuje pierwszy argument i próbuje zwrócić ciąg znaków reprezentujący daną wartość w systemie o zadanej podstawie (bazie). Dla systemów o podstawie większej niż 10, do reprezentacji cyfr większych niż 9 używane są kolejne litery alfabetu łacińskiego. Przykładowo, dla wartości w systemie szesnastkowym (o podstawie równej 16), używane są litery od <code>a</code> do <code>f</code>.</p>

<p>Jeśli <code>podstawa</code> nie jest podana, zakłada się, że preferowaną bazą systemu jest 10.</p>

<p>Jeśli wartość <code>bigIntObj</code> jest ujemna, znak jest zachowywany. Dzieje się tak nawet wtedy, gdy podstawą jest 2; zwracany ciąg cyfr jest dodatnią reprezentacją <code>bigIntObj</code>, poprzedzoną znakiem <code>-</code>, <strong>nie</strong> dopełnieniem dwójkowym <code>bigIntObj</code>.</p>

<h2 id="Przykłady">Przykłady</h2>

<h3 id="Użycie_toString">Użycie <code>toString</code></h3>

<pre class="brush: js">17n.toString();      // '17'
66n.toString(2);     // '1000010'
254n.toString(16);   // 'fe'
-10n.toString(2);    // -1010'
-0xffn.toString(2);  // '-11111111'
</pre>

<h3 id="BigInt_z_ujemnym_zerem"><code>BigInt</code> z ujemnym zerem</h3>

<p>Nie ma obiektów <code>BigInt</code> reprezentujących ujemne zero, tak jak nie ma ujemnych zer wśród liczb całkowitych.. <code>-0.0</code> jest zmiennoprzecinkową koncepcją zmiennoprzecinkową IEEE, która pojawia się w języku JavaScript jedynie w typie {{jsxref("Number")}}.</p>

<pre class="brush: js">(-0n).toString();      // '0'
BigInt(-0).toString(); // '0'</pre>

<h2 id="Specyfikacje">Specyfikacje</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specyfikacja</th>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-bigint.prototype.tostring', 'BigInt.prototype.toString()')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Wsparcie_przeglądarek">Wsparcie przeglądarek</h2>

<p>{{Compat("javascript.builtins.BigInt.toString")}}</p>

<h2 id="Zobacz_też">Zobacz też</h2>

<ul>
 <li>{{jsxref("BigInt.prototype.toLocaleString()")}}</li>
 <li>{{jsxref("BigInt.prototype.valueOf()")}}</li>
 <li>{{jsxref("Number.prototype.toString()")}}</li>
</ul>