Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Math.acos: arkuskosinus

Math.acos vrátí arkuskosinus čísla v radiánech s reálným oborem -1 až 1 a výsledkem 0 až π.

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

Syntaxe

Math.acos(x)

Math.acos(x) použije ToNumber a vypočte hlavní hodnotu inverzního kosinu. Pro x v [-1, 1] je výsledek v [0, π]: acos(1) je +0, acos(0) asi π/2 a acos(-1) asi π. Number je obvykle aproximace.

Konečná hodnota mimo [-1, 1], ±Infinity, NaN nebo chybějící argument dá NaN. Číselný řetězec se převede, ale Symbol či BigInt vyvolá TypeError; objekt může spustit valueOf nebo toString. Aproximace může záviset na implementaci.

Není konstruktor a je standardní od ECMAScript 1. Výsledek je v radiánech; stupně = radians * 180 / Math.PI. U úhlu ze skalárního součinu omezte podíl na [-1, 1], aby malá chyba nevytvořila NaN.

Příklady

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

Výsledek

1.570796 90.0
0 3.141593
true true
true

Zdroje