CKTIS / JavaScript
Math.asin: arco seno
Math.asin devolve o arco seno de um número em radianos, com domínio real de -1 a 1 e resultado de -π/2 a π/2.
Versão: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaxe
Math.asin(x)Math.asin(x) aplica ToNumber e calcula o valor principal do seno inverso. Para x em [-1, 1], o resultado fica em [-π/2, π/2]: asin(1) é cerca de π/2 e asin(-1) cerca de -π/2. Preserva o sinal de zero: +0 dá +0 e -0 dá -0.
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 Number pode depender da implementação.
Não é construtor e é padrão desde ECMAScript 1. O resultado está em radianos; graus = radians * 180 / Math.PI. Limite uma componente normalizada calculada a [-1, 1] para que um erro de arredondamento não transforme um ângulo válido em NaN.
Exemplos
function pitchFromVerticalComponent(y) {
return Math.asin(Math.max(-1, Math.min(1, y)));
}
const angle = pitchFromVerticalComponent(0.5);
console.log(angle.toFixed(6), (angle * 180 / Math.PI).toFixed(1));
console.log(Math.asin(1).toFixed(6), Math.asin(-1).toFixed(6));
console.log(Object.is(Math.asin(-0), -0));
console.log(Number.isNaN(Math.asin(1.1)), Number.isNaN(Math.asin()));
try { Math.asin(1n); } catch (error) { console.log(error instanceof TypeError); }Resultado
0.523599 30.0 1.570796 -1.570796 true true true true