WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Math.hypot: euklidische Länge

Math.hypot wandelt beliebig viele Komponenten in Number um und berechnet stabil die Quadratwurzel ihrer Quadratsumme.

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

Syntax

Math.hypot(...values)

Math.hypot(...values) liefert √(x₁² + x₂² + …) als nichtnegatives Number. Ohne Argumente ist es +0, Vorzeichen ändern die Länge nicht. Skalierung vermeidet vorzeitigen Über- und Unterlauf besser als Math.sqrt(x*x + y*y).

Jedes Argument durchläuft ToNumber der Reihe nach. Symbol oder BigInt löst TypeError aus, selbst neben Unendlichkeit. Nach erfolgreicher Umwandlung ergibt ±Infinity stets Infinity, auch neben NaN; ohne Unendlichkeit ergibt jedes NaN NaN. Numerische Zeichenketten werden umgewandelt, Objekte können Code ausführen.

Kein Konstruktor, seit ECMAScript 2015 Standard. Für Vektorlänge oder Math.hypot(x2-x1, y2-y1) in beliebig vielen Dimensionen. Das Number-Ergebnis bleibt den IEEE-754-Präzisionsgrenzen unterworfen.

Beispiele

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); }

Ergebnis

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

Quellen