Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.hypot: długość euklidesowa

Math.hypot konwertuje dowolną liczbę składowych na Number i stabilnie oblicza pierwiastek z sumy ich kwadratów.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

Math.hypot(...values)

Math.hypot(...values) zwraca √(x₁² + x₂² + …) jako nieujemny Number. Bez argumentów zwraca +0, a znaki składowych nie wpływają na długość. Algorytm skaluje obliczenie, dlatego lepiej unika przedwczesnego przepełnienia i podpełnienia niż bezpośrednie Math.sqrt(x*x + y*y).

Każdy argument przechodzi ToNumber w kolejności. Symbol lub BigInt powoduje TypeError, nawet jeśli inny argument jest nieskończony. Po udanej konwersji obecność ±Infinity daje Infinity, także obok NaN; bez nieskończoności dowolne NaN daje NaN. Łańcuchy liczbowe są konwertowane, a obiekty mogą uruchomić kod konwersji.

Funkcja nie jest konstruktorem i jest standardowa od ECMAScript 2015. Nadaje się do długości wektora lub odległości Math.hypot(x2-x1, y2-y1) i obsługuje więcej niż dwa wymiary. Wynik jest przybliżeniem Number; stabilność zakresu nie usuwa zwykłych ograniczeń precyzji IEEE 754.

Przykłady

console.log(Math.hypot(3, 4), Math.hypot());
console.log(Object.is(Math.hypot(-0), 0));
const stable = Math.hypot(3e200, 4e200);
const naive = Math.sqrt((3e200) ** 2 + (4e200) ** 2);
console.log(stable, Number.isFinite(stable), naive);
console.log(Math.hypot(Infinity, NaN), Number.isNaN(Math.hypot(NaN, 1)));
try { Math.hypot(Infinity, 1n); } catch (error) { console.log(error instanceof TypeError); }

Wynik

5 0
true
4.9999999999999995e+200 true Infinity
Infinity true
true

Źródła