Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes