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

CKTIS / JavaScript

Math.acos : arc cosinus

Math.acos renvoie l’arc cosinus d’un nombre en radians, avec domaine réel de -1 à 1 et résultat de 0 à π.

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

Syntaxe

Math.acos(x)

Math.acos(x) applique ToNumber puis calcule la valeur principale du cosinus inverse. Pour x dans [-1, 1], le résultat est dans [0, π] : acos(1) vaut +0, acos(0) environ π/2 et acos(-1) environ π. Le Number est généralement approximatif.

Une valeur finie hors [-1, 1], ±Infinity, NaN ou l’absence d’argument produit NaN. Une chaîne numérique est convertie, mais Symbol ou BigInt lève TypeError ; un objet peut exécuter valueOf ou toString. L’approximation peut dépendre de l’implémentation.

La fonction n’est pas un constructeur et est standard depuis ECMAScript 1. Le résultat est en radians ; degrés = radians * 180 / Math.PI. Pour un angle issu d’un produit scalaire, bornez le quotient à [-1, 1] afin qu’une petite erreur flottante ne produise pas NaN.

Exemples

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

Résultat

1.570796 90.0
0 3.141593
true true
true

Sources