Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Math.hypot : longueur euclidienne

Math.hypot convertit un nombre quelconque de composantes en Number et calcule de façon stable la racine de leur somme de carrés.

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

Syntaxe

Math.hypot(...values)

Math.hypot(...values) renvoie √(x₁² + x₂² + …) comme Number non négatif. Sans argument, elle renvoie +0 et les signes n’affectent pas la longueur. Son calcul mis à l’échelle évite mieux débordement et sous-débordement prématurés que Math.sqrt(x*x + y*y).

Chaque argument passe par ToNumber dans l’ordre. Symbol ou BigInt lève TypeError même avec un autre argument infini. Après conversion, ±Infinity donne Infinity même avec NaN ; sans infini, tout NaN donne NaN. Les chaînes numériques sont converties et les objets peuvent exécuter du code.

Pas un constructeur, standard depuis ECMAScript 2015. Pour norme de vecteur ou distance Math.hypot(x2-x1, y2-y1) dans plusieurs dimensions. Le Number reste soumis aux limites de précision IEEE 754.

Exemples

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

Résultat

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

Sources