Bowser 版本比较算法详解：satisfies 方法的实现逻辑

2026-02-05 05:29:03作者：凤尚柏Louis

Bowser 是一个强大的浏览器检测库，其核心功能之一就是版本比较。在 Bowser 中，satisfies 方法提供了智能的版本匹配能力，能够精确判断当前浏览器是否满足特定版本要求。本文将通过深入分析 Bowser 的源码，揭示 satisfies 方法的实现逻辑和工作原理。

🔍 什么是 satisfies 方法？

satisfies 方法是 Bowser 库中最实用的功能之一，它允许开发者检查当前浏览器是否满足特定的版本条件。例如，你可以检查浏览器是否是 Chrome 118 以上版本，或者是否是 Safari 11 以上版本。

核心功能特点

支持多种比较操作符：>、<、=、>=、<=、~（近似匹配）
支持复杂条件组合：可以组合操作系统、平台和浏览器版本
智能别名处理：支持浏览器别名的自动识别和转换
宽松模式支持：提供严格和宽松两种比较模式

🏗️ satisfies 方法的架构设计

Bowser 的 satisfies 方法位于 Parser 类中，其设计非常巧妙：

1. 输入参数解析

satisfies 方法接受一个 checkTree 参数，这是一个可以包含一层或两层结构的对象。第一层可以是平台或操作系统，第二层则是具体的浏览器规格要求。

2. 核心实现逻辑

从 src/parser.js 文件中的实现可以看出，satisfies 方法的主要逻辑包括：

参数分类处理：将输入的条件分为浏览器条件和平台/操作系统条件
递归调用机制：支持多层条件的嵌套处理
版本比较引擎：基于 compareVersion 方法进行精确的版本比对

⚙️ 版本比较算法的核心机制

比较操作符解析

在 compareVersion 方法中，Bowser 首先解析版本字符串中的比较操作符：

if (version[0] === '>' || version[0] === '<') {
  comparableVersion = version.substr(1);
  if (version[1] === '=') {
    isLoose = true;
    comparableVersion = version.substr(2);
}

版本精度处理

Bowser 的版本比较算法非常精细，能够处理不同精度的版本号：

"1.10.2.1" - 4位精度
"1.10" - 2位精度
"1" - 1位精度

宽松模式机制

宽松模式（loose comparison）是 Bowser 的一个重要特性，它允许在版本精度不一致时进行智能匹配。

🎯 实际应用场景

1. 简单版本检查

const browser = Bowser.getParser(window.navigator.userAgent);
if (browser.satisfies({ chrome: '>118.01.1322' })) {
  // 执行 Chrome 118 以上版本的特定代码
}

2. 平台特定检查

// 检查 macOS 上的 Safari 版本
if (browser.satisfies({ macos: { safari: '>11' } })) {
  // 在 macOS 上且 Safari 版本大于 11 时执行

3. 复杂条件组合

// 同时检查操作系统和浏览器版本
if (browser.satisfies({ windows: { chrome: '>118.01.1322' } })) {
  // 在 Windows 上且 Chrome 版本大于 118 时执行

🔧 核心源码分析

satisfies 方法实现

在 src/parser.js 第353-407行，我们可以看到 satisfies 方法的完整实现：

satisfies(checkTree) {
  const platformsAndOSes = {};
  let platformsAndOSCounter = 0;
  const browsers = {};
  let browsersCounter = 0;

  // 将条件分为浏览器条件和平台/操作系统条件
  const allDefinitions = Object.keys(checkTree);
  allDefinitions.forEach((key) => {
    const currentDefinition = checkTree[key];
    if (typeof currentDefinition === 'string') {
      browsers[key] = currentDefinition;
      browsersCounter += 1;
    } else if (typeof currentDefinition === 'object') {
    platformsAndOSes[key] = currentDefinition;
    platformsAndOSCounter += 1;
  }
}

compareVersion 方法

在 src/parser.js 第426-460行，compareVersion 方法负责具体的版本比较逻辑：

compareVersion(version) {
  let expectedResults = [0];
  let comparableVersion = version;
  let isLoose = false;

  const currentBrowserVersion = this.getBrowserVersion();
  
  // 解析比较操作符
  if (version[0] === '>' || version[0] === '<') {
    comparableVersion = version.substr(1);
    if (version[1] === '=') {
      isLoose = true;
      comparableVersion = version.substr(2);
    }
  }
}