Объект Math

Из дробного числа почти всегда нужно получить целое: страниц в списке, пикселей, товаров на складе. За это отвечают четыре метода, и отличаются они только направлением, в которое «уезжает» число.

console.log(Math.floor(4.9));
console.log(Math.ceil(4.1));
console.log(Math.round(4.4));
console.log(Math.round(4.5));
console.log(Math.trunc(4.9));

На положительных числах floor и trunc дают одно и то же, поэтому разницу между ними легко не заметить — до первого минуса. О нём следующий раздел.

const roundTo = (x, digits) => Math.round(x * 10 ** digits) / 10 ** digits;
console.log(roundTo(2.34567, 2));
console.log(roundTo(1.005, 2));

floor и ceil двигают число по числовой прямой: первый — влево, второй — вправо. trunc двигает его к нулю, то есть для отрицательных чисел — вправо. Поэтому Math.floor(-1.2) даёт −2, а Math.trunc(-1.2) даёт −1.

console.log(Math.floor(-1.2));
console.log(Math.trunc(-1.2));
console.log(Math.ceil(-1.2));
console.log(Math.round(-1.5));
console.log(Math.round(-1.6));

У round своя странность: «ровно половина» округляется вверх, а не «от нуля». Из-за этого −1.5 становится −1, хотя 1.5 становится 2.

floor — «ниже по прямой», trunc — «отрезать хвост». Для 1.2 это одно и то же, для -1.2 — уже нет.

Math.random() возвращает дробное число от 0 включительно до 1 не включительно. Аргументов у него нет, диапазон не настраивается — всё остальное вы считаете сами.

const r = Math.random();
console.log(typeof r);
console.log(r >= 0 && r < 1);

Чтобы получить целое от min до max включительно, растягиваем отрезок на нужную длину и отсекаем дробь через floor. Ширина диапазона — max - min + 1: единица добавлена ровно затем, чтобы верхняя граница тоже могла выпасть.

function randomInt(min, max) {
  return Math.floor(Math.random() * (max - min + 1)) + min;
}
const dice = randomInt(1, 6);
console.log(Number.isInteger(dice));
console.log(dice >= 1 && dice <= 6);

const counts = { 1: 0, 2: 0, 3: 0 };
for (let i = 0; i < 30000; i++) {
  counts[Math.round(Math.random() * 2) + 1]++;
}
console.log(counts);

Оба метода принимают сколько угодно аргументов — но именно аргументов, а не массив. Массив разворачивают спредом ....

console.log(Math.min(3, -1, 7));
console.log(Math.max(3, -1, 7));
const prices = [120, 45, 300];
console.log(Math.max(...prices));
console.log(Math.max());

Последняя строка — не шутка, а ловушка: без аргументов Math.max возвращает -Infinity, а Math.min — Infinity. Значит, пустой массив в спреде тихо превратится в бесконечность. И любой NaN среди аргументов делает результат NaN целиком.

Самая частая пара — «зажать значение в границах»: наружный min держит потолок, внутренний max — пол.

const clamp = (x) => Math.min(100, Math.max(0, x));
console.log(clamp(-20));
console.log(clamp(50));
console.log(clamp(140));

Math.pow(a, b) возводит a в степень b, и у него есть более короткий синоним — оператор **. Math.sqrt берёт квадратный корень, Math.abs снимает знак.

console.log(Math.pow(2, 10));
console.log(2 ** 10);
console.log(Math.sqrt(144));
console.log(Math.abs(-7.5));
console.log(Math.sqrt(-1));

Степень не обязана быть целой и положительной: дробная даёт корень, отрицательная — деление. Для кубического корня есть отдельный Math.cbrt, он точнее.

console.log(Math.pow(2, -2));
console.log(Math.pow(9, 0.5));
console.log(Math.cbrt(27));

Math.hypot считает корень из суммы квадратов всех аргументов — ту самую гипотенузу из школы. Это готовая формула расстояния: разница по X, разница по Y, и вот вам длина отрезка.

console.log(Math.hypot(3, 4));
console.log(Math.sqrt(3 ** 2 + 4 ** 2));
console.log(Math.hypot(1, 2, 2));

Ручной вариант короче не становится, зато ломается на больших числах: квадрат может не поместиться в число и стать бесконечностью. Math.hypot внутри масштабирует значения и такой аварии избегает.

console.log(Math.sqrt(1e200 ** 2 + 1e200 ** 2));
console.log(Math.hypot(1e200, 1e200));