CKTIS / JavaScript
Math.hypot: comprimento euclidiano
Math.hypot converte qualquer número de componentes para Number e calcula de forma estável a raiz da soma dos quadrados.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
Math.hypot(...values)Math.hypot(...values) devolve √(x₁² + x₂² + …) como Number não negativo. Sem argumentos devolve +0 e os sinais não alteram o comprimento. A escala evita overflow e underflow prematuros melhor que Math.sqrt(x*x + y*y).
Cada argumento passa por ToNumber em ordem. Symbol ou BigInt lança TypeError mesmo junto a infinito. Após conversão, ±Infinity dá Infinity mesmo com NaN; sem infinito, qualquer NaN dá NaN. Strings numéricas são convertidas e objetos podem executar código.
Não é construtor e é padrão desde ECMAScript 2015. Para magnitude vetorial ou distância Math.hypot(x2-x1, y2-y1) em várias dimensões. O Number continua sujeito aos limites de precisão IEEE 754.
Exemplos
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); }Resultado
5 0 true 4.9999999999999995e+200 true Infinity Infinity true true