Math.f16round()
Определение и применение
Math.f16round() возвращает ближайшее значение 16-битного формата с плавающей точкой. Это ещё более
ограниченная точность, чем у
Math.fround(). Сам результат имеет тип number. Отдельный числовой тип в JavaScript не создаётся.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2025 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
f16round | 135 | 135 | 129 | 120 | 18.2 | 135 | 129 | 89 | 18.2 | 29.0 | 135 | 18.2 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
Синтаксис
Math.f16round(value)
value — число для вычисления. Метод вызывается у встроенного объекта Math. Создавать
экземпляр не нужно. Возвращается новое значение number, исходная переменная не изменяется.
Особенности результата
Округление выполняется по двоичной точности. На середине выбирается значение с чётным младшим битом. Это не округление до двух десятичных знаков. Например, целые числа тоже могут измениться, если между соседними представимыми значениями уже есть промежуток.
Переполнение даёт Infinity или -Infinity. Слишком маленькое число может округлиться до нуля.
NaN и знак нуля сохраняются. Для сравнения с более широким форматом используйте
Math.fround().
Проверка поддержки
Перед вызовом проверяйте typeof Math.f16round === "function". При отсутствии API пример сообщает об этом.
Замена на
Math.round()
изменила бы смысл вычисления, поэтому пример не делает такую подмену.
Преобразование аргумента
Аргумент преобразуется в число: числовая строка подходит, null становится нулём, а
undefined или нечисловая строка дают NaN. Преобразование не проверяет, допустимы ли такие
данные по условию вашей задачи. Подробнее —
преобразование типов.
Исключения
| Тип исключения | Условие |
|---|---|
TypeError |
Передан BigInt или Symbol. Ошибка пользовательского преобразования объекта в число
также не подавляется.
|
Спецификация
Примеры, попробуйте сами
Половинная точность и переполнение
Запустите пример с числом 2049. Затем попробуйте заменить его на 2050 и на 2051, каждый раз запуская код заново. Сравните вторую строку результата с переданным числом: в каких случаях оно изменилось и в какую сторону? Если API отсутствует, вместо исключения появится сообщение о поддержке.
index.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
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() не поддерживается этим браузером')
}
Нажмите , чтобы запустить пример.