Math.fround()

Определение и применение

Math.fround() возвращает ближайшее к аргументу число, представимое в 32-битном формате с плавающей точкой. Результат остаётся обычным number. Это полезно при сравнении расчётов с данными ограниченной двоичной точности.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Math.fround
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
fround✓38✓12✓26✓25✓8✓38✓26✓25✓8✓3.0✓38✓8

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис

JavaScript
Math.fround(value);

value — число для вычисления. Метод вызывается у встроенного объекта Math; создавать экземпляр не нужно. Возвращается новое значение number, исходная переменная не изменяется.

Особенности результата

Если исходное число точно представимо в таком формате, оно не изменится. Иначе округляется двоичная значащая часть; на равной дистанции выбирается вариант с чётным младшим битом. Метод не задаёт количество знаков после запятой и не превращает число в строку.

Слишком большое по модулю значение даёт бесконечность, очень маленькое может стать нулём с сохранением знака. NaN, Infinity, -Infinity и оба нуля сохраняются. Более узкую точность демонстрирует Math.f16round().

Преобразование аргумента

Аргумент преобразуется в число: числовая строка подходит, null становится нулём, а undefined или нечисловая строка дают NaN. Преобразование не проверяет, допустимы ли такие данные по условию вашей задачи. Подробнее — преобразование типов.

Исключения

Исключения Math.fround()
Тип исключения Условие
TypeError Передан BigInt или Symbol. Ошибка пользовательского преобразования объекта в число также не подавляется.

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

ECMAScript: Math.fround.

Примеры, попробуйте сами

Какие числа сохраняются при переходе к float32

Замените дробь или большое число. 0.5 представимо точно; разница для другой дроби показывает потерю двоичной точности.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Какие числа сохраняются при переходе к float32</title>
  </head>
  <body>
    <p>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
console.log(Math.fround(0.5))
console.log(Math.fround(0.1) === 0.1)
console.log(Math.fround(16777217))
console.log(Math.fround(1e40))
console.log(Object.is(Math.fround(-0), -0))