Noty 浏览器支持指南:BrowserStack 自动化测试矩阵与跨浏览器兼容性实现
Noty 浏览器支持指南:BrowserStack 自动化测试矩阵与跨浏览器兼容性实现
本文以 Noty 官方文档 docs/browsers.md(即文档站 "Browser Support" 章节)为主体,结合仓库中的 BrowserStack 配置文件、Grunt 自动化任务与源码实现,完整解读 Noty 的浏览器兼容性测试矩阵、测试报告的生成流水线,以及其在旧版 IE、Safari、Firefox、Edge 等浏览器上保持一致的底层兼容手段。读完本文,你将掌握:Noty 官方究竟在哪些浏览器上验证过自身、这些报告是如何自动化产出并沉淀为文档的,以及从源码层面它靠哪些 API 回退与厂商前缀探测来覆盖这些浏览器。
一、文档定位:browsers.md 是一份真实测试结果报告
在 Noty 官方文档的侧边栏 docs/_sidebar.md 中,Browser Support 对应文档文件 docs/browsers.md。它并不是一篇泛泛而谈的兼容性承诺,而是一份由 BrowserStack Automate 生成的自动化测试结果快照——文档首行 !> This data is provided by BrowserStack Automate 明确标注了数据来源。
文档记录了一次名为 Local run 2017 07 27T17:31:03.314Z 的本地测试构建,核心内容是一张 6 行测试矩阵:
| OS | Browser | Result | Details |
|---|---|---|---|
| Windows 10 | opera 46.0 | done | view |
| Windows 10 | chrome 59.0 | done | view |
| OS X El Capitan | safari 9.1 | done | view |
| Windows 10 | firefox 54.0 | done | view |
| Windows 10 | edge 15.0 | done | view |
| Windows 8 | ie 10.0 | done | view |
每一行的 Details 均指向 BrowserStack 对应会话的公开链接(含操作视频、控制台日志、HAR 日志等),Result 全部为 done,表示在该浏览器上测试套件完整通过。
说明:文档中的会话链接指向外部 BrowserStack 服务,本文不转载外部链接,仅解读测试矩阵本身及其生成机制。
二、测试矩阵解读:6 种浏览器覆盖了哪些环境
仓库根目录下的 browserstack.json 定义了与上述结果对应的测试目标矩阵,其配置项包括:
test_framework:qunittest_path:test/index.html
{
"test_framework": "qunit",
"test_path": "test/index.html",
"browsers": [
{ "browser": "ie", "browser_version": "10", "os": "Windows", "os_version": "8" },
{ "browser": "edge", "browser_version": "latest", "os": "Windows", "os_version": "10" },
{ "browser": "firefox", "browser_version": "latest", "os": "Windows", "os_version": "10" },
{ "browser": "chrome", "browser_version": "latest", "os": "Windows", "os_version": "10" },
{ "browser": "opera", "browser_version": "latest", "os": "Windows", "os_version": "10" },
{ "browser": "safari", "browser_version": "latest", "os": "OS X", "os_version": "El Capitan" }
]
}
对照即可发现,browsers.md 中记录的实际执行版本是配置矩阵中部分浏览器的历史快照版本:
| 配置目标(browserstack.json) | 实际执行版本(browsers.md / browserstack-session.json) |
|---|---|
| ie 10 / Windows 8 | IE 10.0,运行时长 30s |
| edge latest / Windows 10 | Edge 15.0,运行时长 47s |
| firefox latest / Windows 10 | Firefox 54.0,运行时长 50s |
| chrome latest / Windows 10 | Chrome 59.0,运行时长 54s |
| opera latest / Windows 10 | Opera 46.0,运行时长 48s |
| safari latest / OS X El Capitan | Safari 9.1,运行时长 45s |
各会话的具体执行时长记录在 browserstack-session.json 中(如 Chrome 会话 duration: 54、IE 会话 duration: 30)。这套矩阵兼顾了:
- 主流桌面浏览器:Chrome、Firefox、Edge、Opera;
- Apple 平台:macOS(OS X El Capitan)上的 Safari;
- 老旧关键浏览器:Windows 8 上的 IE 10——这是最能检验库是否"真正无依赖、兼容旧环境"的靶子。
三、报告生成机制:Grunt 自动化流水线
browsers.md 并非手写,而是由仓库中的 Grunt 任务自动生成。在 Gruntfile.js 中可以找到完整的流水线定义:
grunt.registerTask('bs-create-md', function () {
const session = grunt.file.readJSON('browserstack-session.json')
const file = 'docs/browsers.md'
let contents = '!> This data is provided by BrowserStack Automate \n\n\n'
contents += `#### ${session[0].automation_session.build_name} \n\n`
contents += '| OS | Browser | Result | Details | \n'
contents += '| --- | --- | --- | --- | \n'
session.forEach(function (s) {
contents += `| ${s.automation_session.os} ${s.automation_session.os_version} | ${s.automation_session.browser} ${s.automation_session.browser_version} | ${s.automation_session.status} | view |`
})
grunt.file.write(file, contents)
})
grunt.registerTask('browserstack-md', ['curl:builds', 'curl:session', 'bs-create-md'])
整个链路分为三步:
curl:builds:请求https://www.browserstack.com/automate/builds.json,使用环境变量BROWSERSTACK_USERNAME与BROWSERSTACK_KEY做 Basic Auth,结果写入 browserstack-builds.json(该文件保存了多次历史构建的hashed_id);curl:session:取最新构建的hashed_id请求对应的sessions.json,将会话详情写入 browserstack-session.json;bs-create-md:读取会话 JSON,按模板拼装 Markdown 表格并覆写docs/browsers.md。
在 package.json 的 scripts 中可以看到对应的命令入口:
"browserstack": "node_modules/.bin/browserstack-runner",
"test": "npm run format && standard && grunt test"
其中 npm run browserstack 执行 browserstack-runner(依据根目录 browserstack.json 启动 QUnit 测试并上报 BrowserStack),而 npm test 负责本地代码风格检查(Standard + Prettier)与 QUnit 单元测试。也就是说,官方文档中的浏览器测试结果 = BrowserStack 云测执行 + Grunt 自动生成 Markdown,这一流程保证了文档数据与真实测试会话的一致性。
四、被测对象:QUnit 测试套件覆盖的功能点
BrowserStack 上跑的 test/index.html 是一套完整的 QUnit 测试页(test/index.html):
- 引入 QUnit、
lib/noty.js(打包产物)与test/unit/init.test.js; - 通过
phantom.js注入(test/unit/phantom.js)在 PhantomJS 环境下把 QUnit 结果上报给 Grunt。
test/unit/init.test.js 中的用例覆盖了 Noty 的核心能力,这也正是跨浏览器验证的重点:
- 初始化:
new Noty()返回 Noty 对象、自动生成 45 位 ID、closed/shown/closeTimer等属性初值; - 生命周期回调:
beforeShow、onShow、afterShow、onClose、afterClose、onTemplate、onHover的触发时机与 DOM 状态断言; - 关闭方式:
closeWith: ['click']与closeWith: ['button'](点击×按钮关闭); - 实例 API:
stop()/resume()(计时器暂停与恢复)、setTimeout()、setText()、setType()、setTheme()、close(); - 静态 API:
overrideDefaults()、setMaxVisible()(全局与命名队列)、closeAll()(按队列关闭且不误伤非目标队列)、Noty.button()、Noty.version()。
这些用例同时挂在 BrowserStack 的 6 个浏览器会话上执行,任何一行的 done 都意味着整套用例在该浏览器上通过。
五、源码级兼容性实现:为何能覆盖这些浏览器
从 src/ 目录的源码结构看,Noty 的跨浏览器能力主要建立在三类技术手段上:事件监听回退、厂商前缀探测、CSS 前缀自动生成。
5.1 事件绑定:addEventListener 与 attachEvent 双路径
在 src/utils.js 的 addListener 中,针对旧版 IE(IE8 及更早)提供了 attachEvent 回退:
export function addListener (el, events, cb, useCapture = false) {
events = events.split(' ')
for (let i = 0; i < events.length; i++) {
if (document.addEventListener) {
el.addEventListener(events[i], cb, useCapture)
} else if (document.attachEvent) {
el.attachEvent('on' + events[i], cb)
}
}
}
这是 Noty 能面向 IE 10(乃至更早版本)运行的基础保障之一。
5.2 动画结束事件:统一各浏览器的 vendor 前缀
动画是 Noty 展示效果的核心,而"动画结束"事件的命名在各浏览器中各不相同。src/utils.js 开头定义了统一的事件串:
export const animationEndEvents =
'webkitAnimationEnd mozAnimationEnd MSAnimationEnd oanimationend animationend'
通过一次性监听所有前缀变体,Noty 保证在 WebKit(Safari/Chrome/Opera)、Mozilla(Firefox)、微软(IE/Edge)以及 Opera 旧内核上都能正确感知 CSS 动画的结束时机(例如关闭后的 ghostFix 占位清理)。
5.3 页面可见性:PageVisibility API 的多实现探测
Noty 支持"页面隐藏时暂停倒计时"(visibilityControl),而 PageVisibility API 在不同浏览器中存在不同命名。src/utils.js 的 visibilityChangeFlow 依次探测 document.hidden、document.msHidden、document.webkitHidden,并绑定对应的 visibilitychange / msvisibilitychange / webkitvisibilitychange 事件,同时回退监听 window 的 blur/focus。这正是 docs/options.md 中 visibilityControl: boolean 选项(默认 false)能够跨浏览器工作的底层实现。
5.4 CSS 属性探测:Webkit / O / Moz / ms 前缀
同一文件中的 css 工具函数维护了 ['Webkit', 'O', 'Moz', 'ms'] 四个前缀集合,对每个 CSS 属性先尝试标准名、再逐一尝试厂商前缀写法(见 src/utils.js 的 getVendorProp)。从源码结构看,这让 Noty 在设置 transform、transition 等属性时能自动适配 Safari、Firefox、IE/Edge、Opera 的不同实现。
5.5 样式层:Autoprefixer 自动补全浏览器前缀
postcss.config.js 配置了 Autoprefixer,目标浏览器为 last 8 versions:
require('autoprefixer')({
browsers: ['last 8 versions']
})
配合 webpack.config.js 中的 sass-loader → postcss-loader → css-loader 链,src/noty.scss 中诸如 transform: translateZ(0)、backface-visibility、animation-fill-mode 等属性在构建为 lib/noty.css 时会自动补齐各浏览器前缀,从而让一套 SCSS 同时覆盖 WebKit、Gecko、Blink、Trident/EdgeHTML 等渲染引擎。
5.6 Web Push 通知:按浏览器能力分支探测
Noty 的 Web Push 功能(src/push.js)同样体现了面向多浏览器的设计:isSupported() 依次探测 window.Notification、window.webkitNotifications、navigator.mozNotification 以及 window.external.msIsSiteMode()(IE 的 Site Mode 通知);getPermissionStatus() 则分别处理标准 Notification.permission、WebKit 的 checkPermission() 与旧版 Chrome 的端点补齐逻辑。可见浏览器兼容不只是"渲染通知条",还贯穿到权限获取、Service Worker 订阅等高级能力。
六、如何理解这份报告:时效性与局限
阅读 browsers.md 时有几点需要明确:
- 这是历史快照:报告生成于
2017 07 27,对应 browserstack-builds.json 中记录的历史构建(如Local run 2017 07 27T17:31:03.314Z对应的hashed_id: 7d2483377687d162b9bc20fcaf3cb1bfb8f5bec0)。当时执行的浏览器版本(Chrome 59、Firefox 54、Safari 9.1、Edge 15、Opera 46、IE 10)均为 2017 年的主流/历史版本,不能直接等同于今天各浏览器最新版的实测结论。 - 仓库当前状态:README.markdown 已声明本仓库 DEPRECATED(不再维护),package.json 中版本号为
3.2.0-beta。这意味着该测试矩阵反映的是 v3.2.0-beta 时代的状态,后续浏览器行为变化不在其验证范围内。 - 结论边界:
done只代表该次构建中 QUnit 套件执行完成,不应被夸大为对任意环境、任意版本的无条件兼容承诺。
七、本地复现与验证路径
如果你希望在自己的环境中复现这套验证流程(仓库为只读,以下均为查看/运行/配置说明):
- 本地单元测试:执行
npm install后运行npm test(npm run format && standard && grunt test),其中grunt test即 QUnit 任务,通过 test/index.html 与 test/unit/phantom.js 在 PhantomJS 中跑完全部用例; - 构建产物:
npm run build依 webpack.config.js 将 src/index.js 打包为 UMD 格式的 lib/noty.js 与lib/noty.min.js; - BrowserStack 云测:配置环境变量
BROWSERSTACK_USERNAME/BROWSERSTACK_KEY后运行npm run browserstack,即可依据 browserstack.json 的矩阵在真实浏览器上执行同一套 QUnit 用例; - 生成浏览器报告文档:云测结束后运行
grunt browserstack-md(由curl:builds、curl:session、bs-create-md串联),即可像官方一样把最新会话结果自动渲染进docs/browsers.md。
小结
docs/browsers.md 虽只是一张简短的测试结果表,但它背后是一条"配置矩阵 → BrowserStack 云测 → Grunt 自动生成文档"的完整链路,并且与源码中 addEventListener/attachEvent 回退、动画事件前缀统一、PageVisibility 多实现探测、Autoprefixer 前缀补全等兼容性设计一一对应。理解这份文档,等于同时理解了 Noty 的浏览器支持策略、测试基础设施,以及一个"无依赖通知库"为保持跨浏览器一致性所付出的工程细节。