Math.hypot()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Math.hypot() gibt die Quadratwurzel der Summe der Quadrate ihrer Argumente zurück. Das heißt,

𝙼𝚊𝚝𝚑.𝚑𝚢𝚙𝚘𝚝(v1,v2,…,vn)=∑i=1nvi2=v12+v22+…+vn2\mathtt{\operatorname{Math.hypot}(v_1, v_2, \dots, v_n)}} = \sqrt{\sum_{i=1}^n v_i^2} = \sqrt{v_1^2 + v_2^2 + \dots + v_n^2}

Probieren Sie es aus

console.log(Math.hypot(3, 4));
// Expected output: 5

console.log(Math.hypot(5, 12));
// Expected output: 13

console.log(Math.hypot(3, 4, 5));
// Expected output: 7.0710678118654755

console.log(Math.hypot(-5));
// Expected output: 5

Syntax

js
Math.hypot()
Math.hypot(value1)
Math.hypot(value1, value2)
Math.hypot(value1, value2, /* …, */ valueN)

Parameter

value1, …, valueN

Zahlen.

Rückgabewert

Die Quadratwurzel der Summe der Quadrate der angegebenen Argumente. Gibt Infinity zurück, wenn eines der Argumente ±Infinity ist. Wenn mindestens eines der Argumente NaN ist oder in NaN umgewandelt wird, gibt es NaN zurück. Gibt 0 zurück, wenn keine Argumente angegeben oder alle Argumente ±0 sind.

Beschreibung

Die Berechnung der Hypotenuse eines rechtwinkligen Dreiecks oder die Größe einer komplexen Zahl verwendet die Formel Math.sqrt(v1*v1 + v2*v2), wobei v1 und v2 die Längen der Schenkel des Dreiecks oder die realen und komplexen Komponenten der komplexen Zahl sind. Der entsprechende Abstand in 2 oder mehr Dimensionen kann berechnet werden, indem mehr Quadrate unter der Quadratwurzel hinzugefügt werden: Math.sqrt(v1*v1 + v2*v2 + v3*v3 + v4*v4).

Diese Funktion macht die Berechnung einfacher und schneller; Sie rufen Math.hypot(v1, v2) oder Math.hypot(v1, /* …, */, vN) auf.

Math.hypot vermeidet auch Überlauf-/Unterlaufprobleme, wenn die Größe Ihrer Zahlen sehr groß ist. Die größte Zahl, die Sie in JS darstellen können, ist Number.MAX_VALUE, welche ungefähr 10308 beträgt. Wenn Ihre Zahlen größer als etwa 10154 sind, führt das Quadrieren zu Infinity. Zum Beispiel: Math.sqrt(1e200*1e200 + 1e200*1e200) = Infinity. Wenn Sie stattdessen hypot() verwenden, erhalten Sie eine bessere Antwort: Math.hypot(1e200, 1e200) = 1.4142...e+200. Dies gilt auch für sehr kleine Zahlen. Math.sqrt(1e-200*1e-200 + 1e-200*1e-200) = 0, aber Math.hypot(1e-200, 1e-200) = 1.4142...e-200.

Mit einem Argument ist Math.hypot() äquivalent zu Math.abs(). Math.hypot.length ist 2, was schwach signalisiert, dass es für die Verarbeitung von mindestens zwei Parametern ausgelegt ist.

Da hypot() eine statische Methode von Math ist, verwenden Sie sie immer als Math.hypot(), anstatt als Methode eines von Ihnen erstellten Math-Objekts (Math ist kein Konstruktor).

Beispiele

Verwendung von Math.hypot()

js
Math.hypot(3, 4); // 5
Math.hypot(3, 4, 5); // 7.0710678118654755
Math.hypot(); // 0
Math.hypot(NaN); // NaN
Math.hypot(NaN, Infinity); // Infinity
Math.hypot(3, 4, "foo"); // NaN, since +'foo' => NaN
Math.hypot(3, 4, "5"); // 7.0710678118654755, +'5' => 5
Math.hypot(-3); // 3, the same as Math.abs(-3)

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-math.hypot

Browser-Kompatibilität

Siehe auch