Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.asin: arcus sinus

Math.asin zwraca arcus sinus liczby w radianach, z dziedziną rzeczywistą od -1 do 1 i wynikiem od -π/2 do π/2.

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

Składnia

Math.asin(x)

Math.asin(x) stosuje ToNumber i oblicza główną wartość odwrotną sinusa. Dla x w [-1, 1] wynik należy do [-π/2, π/2] radianów: asin(1) daje około π/2, a asin(-1) około -π/2. Funkcja zachowuje znak zera: asin(+0) to +0, a asin(-0) to -0.

Wartość skończona spoza [-1, 1], ±Infinity, NaN albo brak argumentu daje NaN. Łańcuch liczbowy jest konwertowany przez ToNumber, natomiast Symbol i BigInt powodują TypeError; obiekt może uruchomić valueOf lub toString. Wynik jest Number i przybliżenie może zależeć od implementacji.

Funkcja nie jest konstruktorem i jest standardowa od ECMAScript 1. Wynik jest w radianach; stopnie to radians * 180 / Math.PI. Gdy wejście pochodzi z obliczeń znormalizowanej składowej, ogranicz je do [-1, 1], aby błąd zaokrąglenia nie zmienił poprawnego kąta w NaN.

Przykłady

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

Wynik

0.523599 30.0
1.570796 -1.570796
true
true true
true

Źródła