Web/JavaScript/Reference/Global objects/BigInt/toString

From Get docs


The toString() method returns a string representing the specified BigInt object. The trailing "n" is not part of the string.


The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Syntax

bigIntObj.toString([radix])

Parameters

radixOptional
Optional. An integer in the range 2 through 36 specifying the base to use for representing numeric values.

Return value

A string representing the specified BigInt object.

Exceptions

RangeError
If toString() is given a radix less than 2 or greater than 36, a RangeError is thrown.

Description

The BigInt object overrides the toString() method of the Object object; it does not inherit Object.prototype.toString(). For BigInt objects, the toString() method returns a string representation of the object in the specified radix.

The toString() method parses its first argument, and attempts to return a string representation in the specified radix (base). For radixes above 10, the letters of the alphabet indicate numerals greater than 9. For example, for hexadecimal numbers (base 16) a through f are used.

If the radix is not specified, the preferred radix is assumed to be 10.

If the bigIntObj is negative, the sign is preserved. This is the case even if the radix is 2; the string returned is the positive binary representation of the bigIntObj preceded by a - sign, not the two's complement of the bigIntObj.

Examples

Using toString

17n.toString();      // '17'
66n.toString(2);     // '1000010'
254n.toString(16);   // 'fe'
-10n.toString(2);    // -1010'
-0xffn.toString(2);  // '-11111111'

Negative-zero BigInt

There is no negative-zero BigInt as there are no negative zeros in integers. -0.0 is an IEEE floating-point concept that only appears in the JavaScript Number type. 

(-0n).toString();      // '0' 
BigInt(-0).toString(); // '0'

Specifications

Specification
ECMAScript (ECMA-262)The definition of 'BigInt.prototype.toString()' in that specification.

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

Desktop Mobile Server
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet Node.js
toString Chrome

Full support 67

Edge

Full support 79

Firefox

Full support 68

IE

No support No

Opera

Full support 54

Safari

Full support 14

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

Full support 68

Opera Android

Full support 48

Safari iOS

Full support 14

Samsung Internet Android

Full support 9.0

nodejs

Full support 10.4.0

Legend

Full support  
Full support
No support  
No support


See also

Retrieved from "https://getdocs.org/index.php?title=Web/JavaScript/Reference/Global_objects/BigInt/toString&oldid=27991"
Powered by MediaWiki