编程随笔（五）

最近我们为 OSome 做了一次兼容性更新，使其能够兼容新主楼机房的 Firefox 70。

背景

上周四（3 月 27 日）是我第一次去新主楼上机，我被那里的环境震惊到了：

• 讲台上没有教师机，也不能统一控制所有机器开关机。
• 助教说课程平台只能用 Chrome 浏览器访问，跳板机和 GitLab 仓库只能用火狐浏览器访问。（什么规则怪谈）
• 电脑无法联网校准时间，只能手动校准。时间过快过慢都进入不了系统。

开始考试的前几分钟，好几个同学反映无法正常访问系统。经过一番排查，我们最终通过换浏览器、校准时间、换座位等方法解决了这些问题。在接下来的一个多小时里，倒是没有多少同学寻求帮助，于是我打算趁机研究一下上面说到的那条“规则怪谈”。

首先看一下电脑配置：

• Windows 7 Service Pack 1
• Google Chrome 79.0.3945.117
• Mozilla Firefox 70.0.1

Google Chrome 和 Mozilla Firefox 的关于页面

再看一下症状：

• 对于课程平台，使用 Chrome 可以正常打开，使用 Firefox 打开后显示为空白。
• 对于跳板机和 GitLab，使用 Firefox 可以正常打开，使用 Chrome 打开时提示证书错误，但是选择继续访问后可以正常访问。

原因

使用 Firefox 打开课程平台，然后打开控制台，可以看到一条报错信息：

SyntaxError: invalid regular expression flag s

我根据旁边提供的代码行列坐标定位到了出错的语句，然后复制到控制台重新运行了一遍，确认是这条语句导致的错误。

使用控制台定位和运行出错的语句

然后我上网搜索了一下。MDN 的报错信息解释页面上说是正则表达式写错了，FreeCodeCamp 上说换成 Chrome 就能解决……还是看看 Bugzilla 和 MDN 浏览器兼容性数据是怎么说的吧：

正则表达式的 s 旗标于 ES2018 加入。对 s 旗标的支持早在 2017 年就已提出，但直到 2020 年 6 月的 Firefox 78 才支持。反观 Chrome，早在 2017 年 10 月发布的 Chrome 62 中就已支持了这一功能。

考试结束后，我对错误的来源展开了调查。首先我需要安装 Firefox 70 来稳定复现这一漏洞。由于在 Linux 上直接安装旧版可能会破坏系统环境，我暂时换到了 Windows。（有人向我推荐了 mozregression，日后可以试一下。）确认稳定复现之后，就可以开始深入调查了。

启动开发服务器（debug 构建），并在 chunk-vendors.js 中查找出问题的正则表达式 /^-{3}\\s*[\\n\\r](.*?)[\\n\\r]-{3}\\s*[\\n\\r]+/s，可以找到来源文件：

/***/ "./node_modules/mermaid/dist/mermaid.min.js":
/*!**************************************************!*\
  !*** ./node_modules/mermaid/dist/mermaid.min.js ***!
  \**************************************************/
/***/ (function(module, exports, __webpack_require__) {

eval("...");

/***/ }),

然后使用 npm list mermaid 来检查 mermaid 的版本：

> npm list mermaid
pendulum-frontend@0.1.0 D:\Code\osome\pendulum-frontend
└─┬ @wekanteam/markdown-it-mermaid@0.6.2
  └── mermaid@9.3.0

可以看到，mermaid 作为 @wekanteam/markdown-it-mermaid 的依赖项被安装，且版本为 9.3.0。

我直接在 mermaid 的 GitHub 仓库上开了个 GitHub Codespaces。经过一番 blame，确定相关正则表达式引入自 mermaid-js/mermaid#3706，于 2022 年 11 月 21 日合并，于 v9.3.0 发布。另外，通过搜索构建成品，可以发现 v9.3.0 含有相关正则表达式，而上一个版本 v9.2.2 不含，从而得出相同的结论。

因此将 mermaid 降级到 v9.2.2 即可解决问题。

解决方案

为了确保不会出现依赖问题，我们在降级 mermaid 的同时还要降级 @wekanteam/markdown-it-mermaid。以下是二者的版本对应关系：

@wekanteam/markdown-it-mermaid	mermaid
0.6.4（最新版）	^10.0.0
0.6.3	^9.4.0
0.6.2（正在使用的版本）	^9.3.0
0.6.1	^9.2.2

因此，我们需要将 mermaid 锁定在 9.2.2，同时将 @wekanteam/markdown-it-mermaid 锁定在 0.6.1。package.json 的配置如下：

  "dependencies": {
    "@wekanteam/markdown-it-mermaid": "0.6.1",
    // ...
  },
  "overrides": {
    "mermaid": "9.2.2"
  },

使用 Firefox 70 访问，网站内容可以正常显示了。

另外控制台还有两处报错，它们的原因也很快被找到了：

• 打开教程时报错：SyntaxError: invalid regular expression flag s——这是因为教程中的某些组件会加载远程服务器上的 OSome，从而引发相同的报错。
• 报错：SyntaxError: invalid identity escape in regular expression——这是因为依赖项 mavon-editor 尝试加载高版本的 highlight.min.js。由于目测讨论区的 Markdown 编辑器没有受到影响，加上考试时并不需要用到讨论区功能，因此暂时不予修复。