Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.acos: arcus cosinus

Math.acos zwraca arcus cosinus liczby w radianach, z dziedziną rzeczywistą od -1 do 1 i wynikiem od 0 do π.

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

Składnia

Math.acos(x)

Math.acos(x) stosuje ToNumber, a następnie oblicza główną wartość odwrotną cosinusa. Dla x z przedziału [-1, 1] wynik należy do [0, π] radianów: acos(1) daje +0, acos(0) daje około π/2, a acos(-1) około π. Wynik jest Number i zwykle przybliżeniem.

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

Funkcja nie jest konstruktorem i jest standardowa od ECMAScript 1. Wynik jest w radianach, więc stopnie oblicza się jako radians * 180 / Math.PI. Przy kącie z iloczynu skalarnego praktycznie ogranicz iloraz do [-1, 1], aby drobny błąd zmiennoprzecinkowy nie dał przypadkowego NaN.

Przykłady

function angleBetween([ax, ay], [bx, by]) {
  const quotient = (ax * bx + ay * by) / (Math.hypot(ax, ay) * Math.hypot(bx, by));
  return Math.acos(Math.max(-1, Math.min(1, quotient)));
}
const angle = angleBetween([1, 0], [0, 1]);
console.log(angle.toFixed(6), (angle * 180 / Math.PI).toFixed(1));
console.log(Math.acos(1), Math.acos(-1).toFixed(6));
console.log(Number.isNaN(Math.acos(1.1)), Number.isNaN(Math.acos()));
try { Math.acos(1n); } catch (error) { console.log(error instanceof TypeError); }

Wynik

1.570796 90.0
0 3.141593
true true
true

Źródła