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

CKTIS / JavaScript

Math.acos: arco cosseno

Math.acos devolve o arco cosseno de um número em radianos, com domínio real de -1 a 1 e resultado de 0 a π.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

Math.acos(x)

Math.acos(x) aplica ToNumber e calcula o valor principal do cosseno inverso. Para x em [-1, 1], o resultado fica em [0, π]: acos(1) é +0, acos(0) cerca de π/2 e acos(-1) cerca de π. O Number é geralmente aproximado.

Valor finito fora de [-1, 1], ±Infinity, NaN ou argumento em falta produz NaN. Uma string numérica é convertida, mas Symbol ou BigInt lança TypeError; um objeto pode executar valueOf ou toString. A aproximação pode depender da implementação.

Não é construtor e é padrão desde ECMAScript 1. O resultado está em radianos; graus = radians * 180 / Math.PI. Para ângulo de produto escalar, limite o quociente a [-1, 1] para que pequeno erro de vírgula flutuante não produza NaN.

Exemplos

function angleBetween([ax, ay], [bx, by]) {
  const quotient = (ax * bx + ay * by) / (Math.hypot(ax, ay) * Math.hypot(bx, by));
  return Math.acos(Math.max(-1, Math.min(1, quotient)));
}
const angle = angleBetween([1, 0], [0, 1]);
console.log(angle.toFixed(6), (angle * 180 / Math.PI).toFixed(1));
console.log(Math.acos(1), Math.acos(-1).toFixed(6));
console.log(Number.isNaN(Math.acos(1.1)), Number.isNaN(Math.acos()));
try { Math.acos(1n); } catch (error) { console.log(error instanceof TypeError); }

Resultado

1.570796 90.0
0 3.141593
true true
true

Fontes