Math.asin()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

A função Math.asin() retorna o arco seno (em radianos) de um número, onde

∀x∊[-1;1],Math.asin(x)=arcsin(x)=o único valor y∊[-π2;π2]tal que sin(y)=x\forall x \in [{-1};1],;\mathtt{\operatorname{Math.asin}(x)} = \arcsin(x) = \text{ the unique } ; y \in \left[-\frac{\pi}{2}; \frac{\pi}{2}\right] , \text{such that} ; \sin(y) = x

Sintaxe

Math.asin(x)

Parâmetros

x

Um número.

Valor retornado

O arco seno (em radianos) do parâmetro recebido se o parâmetro estiver entre -1 e 1; senão, NaN.

Descrição

O método Math.asin() retorna um valor numérico entre -π2-\frac{\pi}{2} e π2\frac{\pi}{2} radianos para todo x entre -1 e 1. Se o valor de x estiver fora deste intervalo NaN é retornado.

Por asin() ser um método estático de Math, deve-se sempre usá-lo como Math.asin(), e não como um método de um objeto Math que você criou.

Exemplos

Usando Math.asin()

js
Math.asin(-2); // NaN
Math.asin(-1); // -1.5707963267948966 (-pi/2)
Math.asin(0); // 0
Math.asin(0.5); // 0.5235987755982989
Math.asin(1); // 1.5707963267948966 (pi/2)
Math.asin(2); // NaN

Para valores menores que -1 ou maiores que 1, Math.asin() retorna NaN.

Especificações

Specification
ECMAScript Language Specification
# sec-math.asin

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também