聊聊 node 如何優雅地獲取 mac 系統版本

背景

今天突然碰到了一個相容性需求，需要根據不同 macOS 版本，進行不同的相容性處理。

沒想到看似簡單的需求，中間也經歷了一番波折，好在最後解決了問題。

在此記錄一下解決問題的過程，也方便其他有類似需求的同學參考。

獲取系統類型

既然需要針對 mac 系統進行相容性處理，首先需要區分系統類型，好在 node 提供了相關的 API，只需使用 os.platform() 即可直接獲取系統類型。

import { platform } from 'os';

console.log(platform()); // 'darwin'

值得一提的是，macOS 對應的名稱不是 macOS 而是 darwin。

除了可以通過 os 這個包獲取系統類型，我們還可以通過 process.platform 來獲取。

import { platform } from 'process';

console.log(platform); // 'darwin'

獲取系統版本

很多熟悉 node 的同學這時候會說了，可以通過 os.release() 快速獲取系統版本。但是，當你執行 os.release() ，你會發現，它的結果並符合常規認知。

比如，我的系統版本是 12.0.1，但是，os.release() 的執行結果卻是 21.1.0。

查看 node 官方文檔可以發現，node 是通過 uname(3) 來確定操作系統的，所以執行結果比較違背常規認知。

通過命令行獲取系統版本

既然 os.release() 獲取的系統版本很難讓人理解，那麼有沒有什麼方案可以直接獲取實際的系統版本號呢？

mac 上存在 sw_vers 命令，可以直接獲取系統信息。

$ sw_vers
ProductName:    macOS
ProductVersion: 12.0.1
BuildVersion:   21A559

可以看到 sw_vers 命令直接獲取到了系統版本：12.0.1 。

如果不需要其他系統信息，我們可以通過添加命令行參數，過濾命令行結果，直接獲取系統版本。

$ sw_vers -ProductVersion
12.0.1

由於命令行不區分大小寫，所以命令行參數無所謂大小寫，你也可以寫成 -productversion 或者 -ProductVersion。

既然知道命令行怎麼寫，接下來我們只需要在 node 中調用命令行即可。

import { execSync } from 'child_process';
console.log(execSync('sw_vers -ProductVersion', { encoding: 'utf-8' })); // 12.0.1

優雅地獲取系統版本

通過 node 子進程執行命令行命令，可以獲取正確的系統版本。但是這種方式有著性能方面的缺陷，需要創建子進程執行命令行，相對於 os.release() 的方式，開銷較大。

之前使用 os.release() 的問題在於返回結果比較違反常規認知，但是它的結果其實是正確的，只不過需要進行一次映射。

所以，通過 os.release() 配合映射表即可優雅地獲取系統版本。

import os from 'os';

const macVersionMap = new Map([
  [21, ['Monterey', '12']],
  [20, ['Big Sur', '11']],
  [19, ['Catalina', '10.15']],
  [18, ['Mojave', '10.14']],
  [17, ['High Sierra', '10.13']],
  [16, ['Sierra', '10.12']],
  [15, ['El Capitan', '10.11']],
  [14, ['Yosemite', '10.10']],
  [13, ['Mavericks', '10.9']],
  [12, ['Mountain Lion', '10.8']],
  [11, ['Lion', '10.7']],
  [10, ['Snow Leopard', '10.6']],
  [9, ['Leopard', '10.5']],
  [8, ['Tiger', '10.4']],
  [7, ['Panther', '10.3']],
  [6, ['Jaguar', '10.2']],
  [5, ['Puma', '10.1']],
]);

const getMacRelease = (release: string) => {
  const macRelease = release ?? os.release();
  const firstReleaseVersion = Number(macRelease.split('.')[0]);
  const [name, version] = macVersionMap.get(firstReleaseVersion) || [
    'Unknown',
    '',
  ];

  return {
    name,
    version,
  };
};

console.log(getMacRelease()) // 12

為了方便 mac 新發佈系統後依然能夠識別，將新系統版本名稱識別為 Unknow，新版本識別為空字元串。

此舉是學習移動端機型打分平臺，如果出現版本為空時，預設為高版本，不影響低版本的相容性處理。

現在，我們就能夠通過 node 優雅地獲取系統版本啦。