Number.prototype.toString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Сводка

Метод toString() возвращает строковое представление указанного объекта Number.

Синтаксис

numObj.toString([radix])

Параметры

radix: Необязательный параметр. Целое число между 2 и 36, определяющее основание системы счисления, используемой для представления числового значения.

Выбрасываемые исключения

RangeError: Если в метод toString() передано основание не в диапазоне от 2 до 36, будет выброшено исключение RangeError.

Объект Number переопределяет метод toString, унаследованный из объекта Object; он не наследует метод Object.prototype.toString. Для объектов Number метод toString() возвращает строку, представляющую объект в определённой системе счисления.

Метод toString() разбирает свой первый аргумент и пытается вернуть строковое представление в системе счисления с указанным основанием. Для оснований, больших 10, при обозначении цифр, больших 9, используются буквы латинского алфавита. Например, для шестнадцатеричных чисел (основание 16), используются буквы с a по f.

Если параметр radix не указан, предпочитаемое основание предполагается равным 10.

Если число numObj отрицательно, его знак сохраняется. Это правило действует даже если основание равно 2; возвращённая строка является двоичным представлением положительного числа numObj, перед которым ставится знак -, а не дополнительным кодом числа numObj.

Примеры

Пример: использование `toString`

var count = 10;

console.log(count.toString()); // Выведет '10'
console.log((17).toString()); // Выведет '17'

var x = 6;

console.log(x.toString(2)); // Выведет '110'
console.log((254).toString(16)); // Выведет 'fe'

console.log((-10).toString(2)); // Выведет '-1010'
console.log((-0xff).toString(2)); // Выведет '-11111111'

Спецификации

Specification
ECMAScript® 2026 Language Specification # sec-number.prototype.tostring