萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript Math.acos() 方法詳解:計算反餘弦值

Math.acos() 方法簡介

Math.acos(x) 返回數字 x 的反餘弦值(反余弦),結果以弧度表示,範圍為 [0, π](即 0 到 180°)。

語法

Math.acos(x)

參數與返回值

  • x:必須在 [-1, 1] 範圍內的數字
  • 返回:0 到 π 之間的弧度值;若 x 超出範圍,返回 NaN

核心示例

// 標準值
console.log(Math.acos(-1));   // 3.141592653589793 (π, 180°)
console.log(Math.acos(0));    // 1.5707963267948966 (π/2, 90°)
console.log(Math.acos(1));    // 0 (0°)
console.log(Math.acos(0.5));  // 1.0471975511965979 (π/3, 60°)
console.log(Math.acos(-0.5)); // 2.0943951023931953 (2π/3, 120°)

// 邊界與異常
console.log(Math.acos(1.1));    // NaN (超出定義域)
console.log(Math.acos(-1.1));   // NaN
console.log(Math.acos(null));   // 1.5707963267948966 (null → 0)
console.log(Math.acos('0.5'));  // 1.0471975511965979 (字符串轉換)
console.log(Math.acos('abc'));  // NaN

弧度轉角度

const radToDeg = rad => rad * 180 / Math.PI;

console.log(radToDeg(Math.acos(0.5)));   // 60
console.log(radToDeg(Math.acos(-0.5)));  // 120
console.log(radToDeg(Math.acos(0)));     // 90

實戰應用場景

1. 計算兩向量夾角

function angleBetween(v1, v2) {
    // 向量點積公式:cosθ = (v1·v2) / (|v1||v2|)
    const dot = v1[0]*v2[0] + v1[1]*v2[1];
    const mag1 = Math.hypot(...v1);
    const mag2 = Math.hypot(...v2);
    const cos = dot / (mag1 * mag2);
    // 限制在 [-1,1] 避免浮點誤差導致 NaN
    const clamped = Math.max(-1, Math.min(1, cos));
    return Math.acos(clamped);
}

console.log(angleBetween([1,0], [0,1])); // 1.5708 (90°)
console.log(angleBetween([1,0], [1,1])); // 0.7854 (45°)

2. 三角形三邊求角(餘弦定理)

// 已知三邊 a,b,c 求角 C (對邊 c)
function angleFromSides(a, b, c) {
    // cos(C) = (a² + b² - c²) / (2ab)
    const cosC = (a*a + b*b - c*c) / (2*a*b);
    return Math.acos(Math.max(-1, Math.min(1, cosC)));
}

console.log(radToDeg(angleFromSides(3, 4, 5))); // 90° (直角三角形)

3. 球面距離計算

// 兩經緯度點的大圓距離
function haversineDistance(lat1, lon1, lat2, lon2) {
    const R = 6371; // 地球半徑 km
    const φ1 = lat1 * Math.PI/180;
    const φ2 = lat2 * Math.PI/180;
    const Δφ = (lat2-lat1) * Math.PI/180;
    const Δλ = (lon2-lon1) * Math.PI/180;
    
    const a = Math.sin(Δφ/2)**2 + Math.cos(φ1)*Math.cos(φ2)*Math.sin(Δλ/2)**2;
    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a));
    return R * c;
}

常見錯誤與避坑

  1. 傳入超出 [-1,1] 的值:浮點運算可能產生 1.0000000002 等,必須 clamp 限制範圍
  2. 混淆弧度/角度:返回值是弧度,顯示需轉角度
  3. 參數類型:非數字會嘗試轉換,失敗返回 NaN

相關方法

  • Math.asin(x) - 反正弦,範圍 [-π/2, π/2]
  • Math.atan(x) - 反正切,範圍 [-π/2, π/2]
  • Math.atan2(y, x) - 反正切(帶象限判斷),範圍 [-π, π],**推薦用於向量角度**
  • Math.cos(x) - 餘弦(正向操作)

掌握 Math.acos() 及其夥伴,是進行幾何計算、遊戲物理、數據可視化的關鍵技能。

copyright © 萬盛學電腦網 all rights reserved