core-js
是前端生态中一个重要的 JavaScript 标准库 polyfill,它的主要作用是为不同浏览器环境提供 ECMAScript 最新特性 和 API 的兼容性支持。以下是其核心作用的详细解析:
一、core-js
是什么?
- 本质:一个模块化的 JavaScript 标准库 polyfill。
- 功能:实现 ECMAScript 从 ES5 到最新版本(如 ES2023)的特性,包括:
- 新增语法(如
Promise
、Array.prototype.includes
) - 新增 API(如
Object.entries
、String.prototype.padStart
) - 提案阶段的特性(如装饰器、
Array.prototype.groupBy
)
- 新增语法(如
二、核心作用
1. 浏览器兼容性填坑
- 让旧浏览器(如 IE 11)支持现代 JavaScript 特性。
- 示例:在 IE 11 中实现
Promise
:// 引入 core-js 后 import 'core-js/stable/promise'; const p = new Promise(resolve => resolve(42)); // IE 11 可运行
2. 按需 polyfill
- 避免全量引入,只加载项目实际用到的特性。
- 配置示例(通过
@babel/preset-env
):// babel.config.js module.exports = { presets: [ [ '@babel/preset-env', { useBuiltIns: 'usage', // 按需引入 corejs: '3.32' // 指定 core-js 版本 } ] ] };
3. 支持实验性提案
- 提供尚未被浏览器实现的 TC39 提案特性。
- 示例:使用
Array.prototype.groupBy
(ES2023 提案):import 'core-js/proposals/array-grouping'; const users = [{ age: 25 }, { age: 30 }]; users.groupBy(user => user.age > 28 ? 'old' : 'young');
三、core-js
的三种使用方式
1. 全量引入(不推荐)
import 'core-js'; // 引入所有 polyfill(体积大)
2. 按需引入特定功能
import 'core-js/stable/array/find'; // 只引入 Array.prototype.find
import 'core-js/features/set'; // 引入 Set 相关 polyfill
3. 通过 Babel 自动按需引入(推荐)
- 结合
@babel/preset-env
的useBuiltIns: 'usage'
选项,根据.browserslistrc
配置自动按需引入。
四、与 @babel/polyfill
的关系
- 历史背景:
@babel/polyfill
(已废弃)底层实际引用了core-js
+regenerator-runtime
。 - 现代方案:直接使用
core-js
和regenerator-runtime
:npm install core-js regenerator-runtime --save
// 入口文件顶部引入 import 'core-js/stable'; import 'regenerator-runtime/runtime';
五、版本选择
版本 | 特点 |
---|---|
core-js@2 |
已停止维护,仅支持到 ES2015 |
core-js@3 |
当前主流版本,支持 ES2015+ 和提案特性,模块化更精细 |
core-js-pure |
纯版本(不污染全局作用域),适合库开发 |
六、实际应用示例
1. 项目中的典型配置
// babel.config.js
module.exports = {
presets: [
[
'@babel/preset-env',
{
useBuiltIns: 'usage', // 按需加载 polyfill
corejs: { version: '3.32', proposals: true } // 启用提案特性
}
]
]
};
2. 兼容 IE 11 的必备 polyfill
// 入口文件
import 'core-js/stable/array/find';
import 'core-js/stable/promise';
import 'core-js/stable/object/assign';
import 'core-js/stable/string/includes';
七、注意事项
- 体积控制:全量引入
core-js
可能使 bundle 增加 200KB+,务必按需加载。 - 污染全局:默认会修改全局对象的原型(如
Array.prototype
),库开发建议用core-js-pure
。 - 更新策略:定期升级
core-js
版本以支持最新特性。
八、替代方案对比
方案 | 优点 | 缺点 |
---|---|---|
core-js |
功能全面,持续更新 | 全量引入体积大 |
polyfill.io |
动态按需返回 polyfill | 依赖外部服务,国内访问可能不稳定 |
手动实现 polyfill | 体积最小化 | 维护成本高,易遗漏 |
core-js
是现代前端工程不可或缺的基础设施,尤其在需要兼容旧浏览器的项目中,它能显著降低开发者的兼容性适配成本。合理配置后,可兼顾兼容性和性能。