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

CKTIS / JavaScript

Math.atan2 : angle à partir de deux composantes

Math.atan2 renvoie en radians l’angle orienté du point (x, y) depuis l’axe x positif tout en conservant le quadrant.

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

Syntaxe

Math.atan2(y, x)

Math.atan2(y, x) convertit d’abord y puis x avec ToNumber et renvoie un angle dans [-π, π]. La composante verticale précède l’horizontale. Les signes choisissent le quadrant, distinguant des points ayant le même quotient y / x.

Un argument NaN donne NaN. Les zéros signés choisissent la frontière : atan2(+0, -1) vaut +π, atan2(-0, -1) vaut -π et atan2(-0, +1) vaut -0. Les combinaisons avec ±Infinity sont aussi définies. Symbol ou BigInt lève TypeError ; les objets peuvent exécuter leur conversion et l’approximation dépendre de l’implémentation.

Pas un constructeur, standard depuis ECMAScript 1. À utiliser pour direction de vecteur, rotation de pointeur ou relèvement, car zéro x et quadrants sont mieux gérés que par Math.atan(y / x). Degrés = angle * 180 / Math.PI. En (0, 0), les signes des zéros décident du résultat, pas une direction géométrique unique.

Exemples

const points = [[1, 1], [-1, 1], [-1, -1], [1, -1]];
console.log(points.map(([x, y]) => (Math.atan2(y, x) * 180 / Math.PI).toFixed(0)).join(","));
console.log(Math.atan2(+0, -1).toFixed(6), Math.atan2(-0, -1).toFixed(6));
console.log(Object.is(Math.atan2(-0, +1), -0));
console.log(Number.isNaN(Math.atan2(undefined, 1)));
try { Math.atan2(1n, 1); } catch (error) { console.log(error instanceof TypeError); }

Résultat

45,135,-135,-45
3.141593 -3.141593
true
true
true

Sources