Math.f16round()

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

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

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

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

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

Показать браузеры
Совместимостьjavascript.builtins.Math.f16round
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
f16round✓135✓135✓129✓120✓18.2✓135✓129✓89✓18.2✓29.0✓135✓18.2

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

Синтаксис

JavaScript
Math.f16round(value)

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

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

Округление выполняется по двоичной точности. На середине выбирается значение с чётным младшим битом. Это не округление до двух десятичных знаков. Например, целые числа тоже могут измениться, если между соседними представимыми значениями уже есть промежуток.

Переполнение даёт Infinity или -Infinity. Слишком маленькое число может округлиться до нуля. NaN и знак нуля сохраняются. Для сравнения с более широким форматом используйте Math.fround().

Проверка поддержки

Перед вызовом проверяйте typeof Math.f16round === "function". При отсутствии API пример сообщает об этом. Замена на Math.round() изменила бы смысл вычисления, поэтому пример не делает такую подмену.

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

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

Исключения

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

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

ECMAScript: Math.f16round.

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

Половинная точность и переполнение

Запустите пример с числом 2049. Затем попробуйте заменить его на 2050 и на 2051, каждый раз запуская код заново. Сравните вторую строку результата с переданным числом: в каких случаях оно изменилось и в какую сторону? Если API отсутствует, вместо исключения появится сообщение о поддержке.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Половинная точность и переполнение</title>
  </head>
  <body>
    <p>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
if (typeof Math.f16round === 'function') {
    console.log(Math.f16round(0.5))
    console.log(Math.f16round(2049))
    console.log(Math.f16round(70000))
    console.log(Object.is(Math.f16round(-0), -0))
} else {
    console.log('Math.f16round() не поддерживается этим браузером')
}