此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

View in English Always switch to English

Math.acos()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

Math.acos() 靜態方法會回傳一個數值的反餘弦值(以弧度表示)。也就是說,

x[1,1],𝙼𝚊𝚝𝚑.𝚊𝚌𝚘𝚜(𝚡)=arccos(x)=the unique y[0,π] such that cos(y)=x\forall x \in [{-1}, 1],\;\mathtt{\operatorname{Math.acos}(x)} = \arccos(x) = \text{the unique } y \in [0, \pi] \text{ such that } \cos(y) = x

嘗試一下

// 計算直角三角形的角度(以弧度表示)
function calcAngle(adjacent, hypotenuse) {
  return Math.acos(adjacent / hypotenuse);
}

console.log(calcAngle(8, 10));
// 預期輸出:0.6435011087932843

console.log(calcAngle(5, 3));
// 預期輸出:NaN

語法

js
Math.acos(x)

參數

x

一個介於 -1 和 1(包含邊界)的數字,代表角度的餘弦值。

回傳值

x 的反餘弦值(0 到 π 之間的角度,以弧度表示,包含邊界)。如果 x 小於 -1 或大於 1,則回傳 NaN

描述

由於 acos()Math 的靜態方法,你必須使用 Math.acos() 來呼叫它,而非呼叫你建立的 Math 物件的方法(Math 並非建構子)。

範例

使用 Math.acos()

js
Math.acos(-2); // NaN
Math.acos(-1); // 3.141592653589793 (π)
Math.acos(0); // 1.5707963267948966 (π/2)
Math.acos(0.5); // 1.0471975511965979 (π/3)
Math.acos(1); // 0
Math.acos(2); // NaN

規範

Specification
ECMAScript® 2026 Language Specification
# sec-math.acos

瀏覽器相容性

參見