CKTIS / JavaScript
Math.atan2: ángulo desde dos componentes
Math.atan2 devuelve en radianes el ángulo dirigido del punto (x, y) desde el eje x positivo, conservando el cuadrante.
Versión: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaxis
Math.atan2(y, x)Math.atan2(y, x) convierte primero y y luego x con ToNumber y devuelve un ángulo en [-π, π]. La componente vertical va antes que la horizontal. Los signos eligen el cuadrante, distinguiendo puntos con el mismo cociente y / x.
Un argumento NaN da NaN. Los ceros con signo seleccionan el borde: atan2(+0, -1) es +π, atan2(-0, -1) es -π y atan2(-0, +1) es -0. También se definen combinaciones con ±Infinity. Symbol o BigInt lanza TypeError; objetos pueden ejecutar conversión y la aproximación depender de la implementación.
No es constructor y es estándar desde ECMAScript 1. Úselo para dirección vectorial, rotación de puntero o rumbo, pues maneja x cero y cuadrantes mejor que Math.atan(y / x). Grados = angle * 180 / Math.PI. En (0, 0), los signos de cero deciden el resultado, no una dirección geométrica única.
Ejemplos
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); }Resultado
45,135,-135,-45 3.141593 -3.141593 true true true