p5.js 浏览器支持策略:从支持目标、已知兼容性问题到 Babel/browserslist 实现机制
p5.js 浏览器支持策略:从支持目标、已知兼容性问题到 Babel/browserslist 实现机制
p5.js 作为面向创意编码的客户端 JavaScript 平台,其运行效果高度依赖宿主浏览器的 WebGL、Canvas、WebAudio 等 Web 能力。本文以仓库存档文档 contributor_docs/ko/archive/supported_browsers.md 为核心,系统梳理 p5.js 的浏览器支持目标、历史上明确记录的兼容性风险清单与 2018 年的支持矩阵,并结合仓库现行源码与 英文版现行文档 说明这套策略如今如何由 browserslist 与 Babel 自动化落实。读完本文,你将理解 p5.js 承诺支持哪些浏览器、哪些功能无法靠转译兜底、以及如何自查某个浏览器特性能否放心使用。
文档定位:一份标注了“已过时”的存档说明
仓库中这份韩文存档文档开头即注明“此页面已不是最新版本,请帮助更新”,属于 p5.js 早期(2018 年前后)的浏览器支持声明。它虽然过时,却完整记录了 p5.js 在 WebGL/Canvas/WebAudio 生态早期的真实兼容性决策与踩坑清单,与仓库内更新的 英文版、中文版 文档形成演进对照,是理解 p5.js 兼容性策略的珍贵史料。下文先还原这份文档的原始内容,再逐项与当前仓库源码交叉印证。
支持目标:当前版本 + 上一主要版本
存档文档明确写出的支持策略为:支持各浏览器的当前版本及其上一个主要版本(previous major release),同时附两条例外:
- Internet Explorer:自 2013 年起未发布新的主要版本,因此仅支持最新的主要版本 v.11;
- Safari:自 2015 年起未发布新的主要版本,因此仅支持最新的主要版本 v.11。
也就是说,p5.js 历史上对“主流”浏览器的定义为“最近两个大版本”,但对停止快速迭代的浏览器退而求其次,只承诺最新一个主要版本。
这一“尽量跟随最新、保留一个旧版本缓冲”的思路,在现行英文文档中演化为更精确的自动化规则:p5.js 使用 browserslist 配置 last 2 versions, not dead,即“任何浏览器的最近两个发布版本”且“过去 24 个月内仍有官方支持或更新的浏览器”,两个条件必须同时满足才纳入支持范围。可以看到,现行规则在继承“最近两个版本”内核的同时,用 not dead 条件自动淘汰 IE、旧版 Safari 这类已停止更新的浏览器,正是对存档文档两条例外的制度化升级。
适用范围:哪些代码必须遵守该要求
存档文档虽未单独成节,但从项目现行的 contributor_docs/archive/supported_browsers.md 可以明确其适用边界:
- 必须遵守:p5.js 源代码、所有示例(包括网站示例页与文档中的示例)、所有官方教程;
- 鼓励但不强制:第三方附加库(add-on libraries)不必遵循同一要求,但官方鼓励其遵守;
- 兜底原则:许多未被官方支持的浏览器实际上仍可能正常运行 p5.js,但官方对此不提供任何保证。
在仓库的贡献流程中,这一要求的落地由各模块的维护者(steward)负责——凡涉及代码变更的 Pull Request,需确保符合浏览器支持要求。
已知潜在问题:存档文档的风险清单与源码印证
存档文档列出四类历史上已知的兼容性风险,逐一与当前仓库源码对照如下。
1. WebGL 在部分浏览器中支持受限
原文档记录:WebGL 在 IE10、Firefox、Android 浏览器中支持受限。WebGL 属于浏览器 Web API,不属于核心 JavaScript 语言,Babel 无法将其转译或 polyfill,只能按个案评估。
从当前源码看,p5.js 的 WebGL 渲染器 src/webgl/p5.RendererGL.js 已支持 WebGL2:它会优先尝试 canvas.getContext('webgl2', ...),失败后再回退到 getContext('webgl', ...),并在着色器层面通过 webgl2Compatibility.glsl 前缀做版本兼容。这说明 p5.js 对 WebGL 的支持深度取决于浏览器是否实现 WebGL 标准,而这正是“需要个案评估”的典型场景。
2. IE10 与 IE Mobile 10/11 缺少 Uint8ClampedArray
原文档记录:p5.js 使用类型化数组(typed arrays),而 IE10 及 IE Mobile 10/11 不支持 Uint8ClampedArray。这一点在今天看来仍是源码的硬依赖——仓库在多个核心路径直接构造 Uint8ClampedArray:
- 图像滤镜模块 src/image/filters.js 中,多个滤镜方法的返回值与入参均声明为
Uint8ClampedArray; - 图像加载显示模块 src/image/loading_displaying.js 中,GIF 解码时通过
new Uint8ClampedArray(pImg.width * pImg.height * 4)构造像素缓冲; - WebGL 渲染器 src/webgl/p5.RendererGL.js 在读取像素数据时同样使用
new Uint8ClampedArray(...)。
可以推断:一旦宿主环境缺少 Uint8ClampedArray,p5.js 的像素级操作将无法工作,这也是存档文档将其列为已知风险的原因。
3. IE 不支持 Canvas 混合模式
原文档记录:IE 不支持 Canvas 的 blend 模式。当前仓库中,混合模式由 src/color/setting.js 的 blendMode() 方法提供,支持 BLEND、ADD、DARKEST、LIGHTEST、MULTIPLY、SCREEN、OVERLAY、REPLACE、REMOVE、DIFFERENCE、EXCLUSION、DODGE、BURN、HARD_LIGHT、SOFT_LIGHT、SUBTRACT 等大量模式。这些模式依赖浏览器 Canvas 2D 的 globalCompositeOperation 能力,底层能力缺失时上层 API 自然无法生效,与存档文档的记录一致。
4. WebAudio 在 IE 与 Android 浏览器中不可用
原文档记录:WebAudio 在 IE 或 Android 浏览器中不受支持。这一项属于浏览器 Web API 范畴,同样无法通过 JavaScript 转译弥补。p5.js 的音频扩展(见 lib/addons/p5.sound.js)依赖宿主提供 WebAudio API,因此在缺少该 API 的环境下音频功能不可用。
2018 年 9 月支持矩阵
存档文档给出了截至 2018 年 9 月的具体支持列表(“Current Version”为当前版本,“Previous Version”为上一版本,Notes 为备注):
| 浏览器 | 当前版本 | 上一版本 | 备注 |
|---|---|---|---|
| Internet Explorer | v.11 | 不支持 | 不支持 WebAudio |
| Microsoft Edge | v.42 | v.41 | |
| Chrome | v.68 | v.67 | |
| Chrome for Android | v.68 | v.67 | |
| Firefox | v.61 | v.60 | |
| Safari | v.11 | 不支持 | |
| iOS Safari | v.11.4 | v.11.2 | |
| Opera | v.54 | v.53 |
该表格直观体现了“当前版本 + 上一版本”策略:Edge、Chrome、Chrome for Android、Firefox、iOS Safari、Opera 均同时覆盖两个版本,而停止迭代的 IE 与 Safari 仅保留最新版。需要强调的是,这份矩阵为 2018 年 9 月的快照,仅用于展示当时策略的执行形态,不代表当前支持状态;现行兼容范围请以 browserslist 的 last 2 versions, not dead 规则为准。
现行实现机制:browserslist + Babel 自动化
随着 p5.js 构建体系的演进(仓库现使用 rolldown 构建,见 rolldown.config.js,产物输出至 lib/p5.js、lib/p5.min.js 等),浏览器支持策略已由“人工维护版本表格”升级为“构建工具自动推导”:
- browserslist 定义目标:配置为
last 2 versions, not dead,自动追踪各浏览器最近两个发布版本,并排除已停止维护的浏览器; - Babel 负责转译与 polyfill:绝大多数最新 JavaScript 语法与内置 API 都能被转译或填充到与兼容列表匹配的形态,因此开发者日常可以放心使用最新语言特性;
- Web API 需个案评估:WebGL、WebAudio、Canvas 混合模式等不属于核心 JavaScript 语言的浏览器能力,Babel 无法处理,必须像存档文档那样逐项人工评估——这正是 contributor_docs/archive/supported_browsers.md 与存档文档一脉相承的核心理念。
如何自查某个浏览器特性能否使用
存档文档与现行文档给出的实操建议一致:当你不确定某个特性(例如新的 WebGL 能力、某个 Canvas API)在支持范围内是否可用时:
- 到 caniuse.com 按特性名搜索,查看各浏览器版本的支持情况;
- 对照 MDN 的兼容性表格确认 API 细节;
- 结合上述判断框架:属于核心 JavaScript 语言的特性,通常可由 Babel 兜底;属于 Web API 的特性,则需结合 p5.js 的 browserslist 目标逐一核实。
结语
从 2018 年的“当前版本 + 上一版本”人工表格,到今天 browserslist + Babel 的自动化策略,p5.js 的浏览器支持哲学一以贯之:尽量贴近最新能力,为旧浏览器保留一个版本的缓冲,同时对 Babel 无法触及的 Web API 保持清醒的个案评估。理解这份策略,无论是为 p5.js 贡献代码(由模块维护者在 PR 中把关兼容性),还是在自己的创意项目中判断某个浏览器特性能否放心使用,都至关重要。仓库中的 英文版文档 与 韩文存档版 分别代表这一策略的“现在”与“过去”,对照阅读可以完整看到它的演进脉络。