Math.acos() 回傳某數字的反餘弦值,結果以弧度表示,範圍落在 0 到 π 之間。輸入值必須在 -1 到 1 之間,超出範圍會回傳 NaN。
Math.acos(x);
<html>
<head>
<title>JavaScript Math acos() Method</title>
</head>
<body>
<script type="text/javascript">
var value = Math.acos(-1);
document.write("First Test Value : " + value);
var value = Math.acos(null);
document.write("<br />Second Test Value : " + value);
var value = Math.acos(30);
document.write("<br />Third Test Value : " + value);
var value = Math.acos("string");
document.write("<br />Fourth Test Value : " + value);
</script>
</body>
</html>
First Test Value : 3.141592653589793
Second Test Value : 1.5707963267948965
Third Test Value : NaN
Fourth Test Value : NaN
逐一對照就很清楚:Math.acos(-1) 得到 π,因為 cos(π) = -1;Math.acos(null) 得到 π/2,因為 null 被轉成 0 而 cos(π/2) = 0;30 超出 [-1, 1] 的定義域,回傳 NaN;非數字字串同樣是 NaN。
反三角函數最常見的用途是「由向量夾角反推角度」。此時務必記得:傳給 acos 的必須是餘弦值,也就是一個落在 -1 到 1 之間的比例,而不是角度或長度。如果計算時因為浮點誤差算出 1.0000000002,就會得到 NaN,這時需要先夾住範圍:
var cos = dotProduct / (lenA * lenB);
cos = Math.min(1, Math.max(-1, cos));
var angle = Math.acos(cos) * 180 / Math.PI; // 轉成度數
在需要同時判斷方向(順時針或逆時針)的場合,Math.atan2() 通常比 acos 更合適,因為它能保留完整的角度資訊且不必擔心定義域問題。