Polyfill方式解决前端兼容性问题:core-js包结构与各种配置策略

Polyfill方式解决前端兼容性问题:core-js包结构与各种配置策略

简介

在之前我介绍过Babel:解锁Babel核心功能:从转义语法到插件开发,Babel是一个使用AST转义JavaScript语法,提高代码在浏览器兼容性的工具。但有些ECMAScript并不是新的语法,而是一些新对象,新方法等等,这些并不能使用AST抽象语法树来转义。因此Babel利用core-js实现这些代码的兼容性。

core-js是一个知名的前端工具库,里面包含了ECMAScript标准中提供的新对象/新方法等,而且是使用旧版本支持的语法来实现这些新的API。这样即使浏览器没有实现标准中的新API,也能通过注入core-js代码来提供对应的功能。

像这种通过注入代码实现浏览器没有提供的API特性,叫做Polyfill。这个单词的本意是填充材料,在JavaScript领域中,这些注入的代码就类似“填充材料”一样,帮助我们提高代码的兼容性。另外core-js还提供了一些还在提议中的API的实现。

core-js使用方式

使用前后对比

要想看到core-js使用前后的效果对比,首先需要确定某个特性和对应的执行环境,在这个环境中对应的特性不存在。我本地是Node.js v18.19.1版本,这个版本并没有实现Promise.try这个方法,因此我们就用这个方法进行实验。首先是没有引入core-js的场景:

Promise.try(()=>{ console.log('jzplp!')})/* 执行结果 Promise.try(() => { ^ TypeError: Promise.try is not a function */

可以看到没有引入core-js,直接使用Promise.try时,会因为没有该方法而报错。然后再试试引入core-js的效果:

require('core-js') Promise.try(()=>{ console.log('jzplp!')})/* 输出结果 jzplp! */

可以看到引入core-js后,原本不存在的API被填充了,我们的代码可以正常执行并拿到结果了。这就是core-js提高兼容性的效果。

单个API引入

core-js不仅可以直接引入全部语法,还可以仅引入单个API,比如某个对象或某个方法。首先看下只引入Promise对象:

// require('core-js/full') 等于 require('core-js')require('core-js/full/promise') Promise.try(()=>{ console.log('jzplp!')})/* 输出结果 jzplp! */

然后再看下直接引入对象中的某个方法:

require('core-js/full/promise/try') Promise.try(()=>{ console.log('jzplp!')})/* 输出结果 jzplp! */

不注入全局对象

前面展示的场景,core-js都是将API直接注入到全局,这样使用这些API就如环境本身支持一样,基本感受不到区别。但如果我们不希望直接注入到全局时,core-js也提供了使用方式:

const promise =require('core-js-pure/full/promise'); promise.try(()=>{ console.log('jzplp!')}) Promise.try(()=>{ console.log('jzplp!2')})/* 输出结果 jzplp! Promise.try(() => { ^ TypeError: Promise.try is not a function */

可以看到,使用core-js-pure这个包之后,可以直接导出我们希望要的API,而不直接注入到全局。此时直接使用全局对象方法依然报错。而core-js这个包虽然也能导出,但它还是会直接注入全局,我们看下例子:

const promise =require('core-js/full/promise'); promise.try(()=>{ console.log('jzplp!')}) Promise.try(()=>{ console.log('jzplp!2')})/* 输出结果 jzplp! jzplp!2 */

因此,如果希望仅使用导出对象,还是需要使用core-js-pure这个包。core-js-pure也可以仅导出对象方法:

const try2 =require("core-js-pure/full/promise/try"); Promise.try = try2; Promise.try(()=>{ console.log("jzplp!");});/* 输出结果 jzplp! */

因为导出的对象方法不能独立使用,因此在例子中我们还是将其注入到Promise对象后使用。

特性分类引入

core-js中包含非常多API特性的兼容代码,有些是已经稳定的特性,有些是还处在提议阶段的,不稳定的特性。我们直接引入core-js会把这些特性全部引入,但如果不需要那些不稳定特性,core-js也提供了多种引入方式:

  • core-js 引入所有特性,包括早期的提议
  • core-js/full 等于引入core-js
  • core-js/actual 包含稳定的ES和Web标准特性,以及stage3的特性
  • core-js/stable 包含稳定的ES和Web标准特性
  • core-js/es 包含稳定的ES特性

这里我们举两个例子尝试下。首先由于ECMAScript标准一直在更新中,有些特性现在是提议,未来可能就已经被列入正式特性了。因此这里的例子需要明确环境和core-js版本。这里我们使用Node.js v18.19.1和[email protected]版本,以写这篇文章的时间为准。

首先第一个特性是:数组的lastIndex属性,这是一个stage1阶段的API,这里针对不同的引入方式进行尝试:

// 不引入core-js尝试const arr =["jz","plp"]; console.log(arr.lastIndex);/* 输出结果 undefined */// 引入core-js/fullrequire("core-js/full");const arr =["jz","plp"]; console.log(arr.lastIndex);/* 输出结果 1 */// 引入core-js/actualrequire("core-js/actual");const arr =["jz","plp"]; console.log(arr.lastIndex);/* 输出结果 undefined */

首先当不引入core-js时,因为不支持这个API,所以输出undefined。core-js/full支持stage1阶段的API,可以正确输出结果。但core-js/actual仅支持stage3阶段的API,因此还是不支持这个API。

然后我们再看下另外一个API,数组的groupBy方法。这是一个stage3阶段的API:

// 不引入core-js尝试const arr =[{group:1,value:"jz"},{group:2,value:"jz2"},{group:1,value:"plp"},];const arrNew = arr.groupBy(item=> item.group); console.log(arrNew)/* 输出结果 const arrNew = arr.groupBy(item => item.group); ^ TypeError: arr.groupBy is not a function */// 引入core-js/actualrequire("core-js/actual");const arr =[{group:1,value:"jz"},{group:2,value:"jz2"},{group:1,value:"plp"},];const arrNew = arr.groupBy(item=> item.group); console.log(arrNew)/* 输出结果 [Object: null prototype] { '1': [ { group: 1, value: 'jz' }, { group: 1, value: 'plp' } ], '2': [ { group: 2, value: 'jz2' } ] } */// 引入core-js/stablerequire("core-js/stable");const arr =[{group:1,value:"jz"},{group:2,value:"jz2"},{group:1,value:"plp"},];const arrNew = arr.groupBy(item=> item.group); console.log(arrNew)/* 输出结果 const arrNew = arr.groupBy(item => item.group); ^ TypeError: arr.groupBy is not a function */

可以看到,不引入core-js时不支持,引入了core-js/actual(包含stage3阶段的API)后支持并能输出正确的结果。core-js/stable中不支持又报错了。

core-js源码结构

前面描述了很多core-js的引入方式,这里我们看一下源码结构,看看core-js内部是如何组织的。

core-js源码目录

core-js ├─actual │ ├─array │ │ ├─at.js │ │ ├─concat.js │ │ └─... │ ├─set │ │ └─... │ └─... ├─es │ └─... ├─features │ └─... ├─index.js └─... 

首先列出core-js源码目录的示意图,可以看到core-js内部有很多目录,对应前面的各种引入方式。这里我们列出每个目录的内容:

  • actual 包含稳定的ES和Web标准特性,以及stage3的特性
  • es 包含稳定的ES特性
  • features 没有说明,猜测和full类似
  • full 所以特性包括早期提议
  • internals 包内部使用的逻辑
  • modules 实际特性的代码实现
  • proposals 包含提议的特性
  • stable 包含稳定的ES和Web标准特性
  • stage 按照stage阶段列出提议特性
  • web 包含Web标准特性
  • configurator.js 是否强制引入逻辑,后面会描述
  • index.js 内容为导出full目录,因此导入core-js等于导入core-js/full

层层引用

在目录中actual, es, full, stable, es是我们已经介绍过的。另外还有web目录仅包含web标准的特性,features和full类似(index.js中直接导出full目录)。

proposals目录包含提议的特性,以特性名来命名文件名。而stage目录中包含0.js, 1.js, 2.js等等,是根据stage阶段来整理的,方便整理和引入对应阶段的特性。

这样整理目录虽然清晰,但这些目录中的特性都是重复的,不可能在每个目录中把特性都实现一遍。因此上面这些目录的文件中,存放的都是实现的引用,并不是特性代码实现本身。真正的实现在modules目录中。modules目录中是以特性名作为命名的文件,文件有固定的前缀名:es.表示ES标准;esnext.表示提议中的标准;web.表示web标准。

这里以我们上面提到过的两个特性为例,看看引用路径,首先是Promise.try:

  • 使用者引入 core-js/full/promise/try.js
  • 引入 actual/promise/try.js
  • 引入 actual/promise/try.js
  • 引入 stable/promise/try.js
  • 引入 es/promise/try.js
  • 最终引入 modules/es.promise.try.js

然后是groupBy方法:

  • 使用者引入 core-js/actual/array/group-by.js
  • 最终引入 modules/esnext.array.group-by.js

可以看到,core-js内部的特性是经过层层引入,最终引入具体的实现代码的。

core-js-pure与core-js-bundle

除了core-js之外,core-js-pure与core-js-bundle这两个包也提供了兼容性。core-js-pure内部的目录结构与core-js一致,只不过core-js-pure不将特性注入到全局。core-js-bundle比较特殊,它是将core-js代码经过打包后再提供,它的结构如下:

core-js-bundle ├─index.js ├─minified.js ├─minified.js.map └─... 

其中index.js是打包过后的特性集合代码,minified.js是经过压缩混淆后的代码。core-js-bundle只能全部引入并注入到全局,不能引入部分目录或者导出某个属性。

打包和浏览器效果

创建Webpack示例

首先创建一个Webapck项目,方便后续打包查看效果。首先执行:

# 创建项目npm init -y # 安装webpack依赖npmadd webpack webpack-cli html-webpack-plugin # 安装core-js依赖npmadd core-js core-js-pure core-js-bundle 

创建src/index.js,内容如下:

const arr =["jz","plp"]; console.log(arr.lastIndex);

在package.json文件的scripts中增加命令:“build”: “webpack”。最后是Webpack配置文件webpack.config.js:

const path =require('path');const HtmlWebpackPlugin =require('html-webpack-plugin'); module.exports ={mode:'production',// 生产模式entry:'./src/index.js',// 源码入口plugins:[newHtmlWebpackPlugin({// 生成HTML页面入口title:'jzplp的core-js实验',// 页面标题}),],output:{filename:'main.js',// 生成文件名path: path.resolve(__dirname,'dist'),// 生成文件目录clean:true,// 生成前删除dist目录内容},};

命令行运行npm run build,即可使用Webpack打包。在dist目录中生成了两个文件,一个是main.js,里面是打包后的js代码;index.html可以让我们在浏览器查看效果。由于我们没有引入core-js,浏览器没有预置lastIndex这个提议中的特性,因此输出undefined。

core-js打包

这里引入core-js,然后打包查看效果。首先是全量引入:

require("core-js");const arr =["jz","plp"]; console.log(arr.lastIndex);

此时浏览器输出1,表示core-js注入成功,lastIndex特性生效了。但是我们查看main.js,发现居然有267KB。这是因为它把所有特性都引入了。

如果引入require("core-js/full/array"),此时新特性也可以生效。因为只引入了数组相关特性,因此main.js的大小为59.3KB,比全量引入小很多。

如果引入require("core-js/full/array/last-index"),此时新特性也可以生效。因为只引入了这一个特性,因此main.js的大小为12.2KB。

Babel与core-js

从前面打包的例子中可以看到,core-js整个打包进项目中是非常巨大的,可能比你正常项目的大小还要更大。这样明显会造成占用资源更多,页面加载时间变慢等问题。一个解决办法是,只引入我们代码中使用到的特性,以及我们要适配的浏览器版本中不兼容的特性,用不到的特性不打包进代码中。Babel就提供了这样的功能。

创建Babel示例

# 创建项目npm init -y # 安装webpack依赖npmadd @babel/core @babel/cli @babel/preset-env # 安装core-js依赖npmadd core-js core-js-pure core-js-bundle 

创建src/index.js,内容如下:

require('core-js');const jzplp =1;

在package.json文件的scripts中增加命令:“babel”: “babel src --out-dir lib”。最后是Babel配置文件babel.config.json:

{"presets":[["@babel/preset-env",{"targets":{"chrome":"100"}}]]}

targets中表示我们需要兼容的浏览器版本。执行npm run babel,生成结果再lib/index.js中,内容如下。可以看到未对core-js做任何处理。

"use strict";require('core-js');const jzplp =1;

preset-env配置entry

@babel/preset-env是一个Babel预设,可以根据配置为代码增加兼容性处理。前面创建Babel示例时已经增加了这个预设,但是没有增加core-js配置。这里我们加一下:

{"presets":[["@babel/preset-env",{"targets":{"chrome":"100"},"useBuiltIns":"entry","corejs":"3.47.0"}]]}

这里增加了corejs版本和useBuiltIns配置,值为entry。配置这个值,会使得@babel/preset-env根据配置的浏览器版本兼容性,选择引入哪些core-js中的特性。这里再执行命令行,结果如下:

"use strict";require("core-js/modules/es.symbol.async-dispose.js");require("core-js/modules/es.symbol.dispose.js");// ... 更多es特性省略require("core-js/modules/esnext.array.filter-out.js");require("core-js/modules/esnext.array.filter-reject.js");// ... 更多esnext特性省略require("core-js/modules/web.dom-exception.stack.js");require("core-js/modules/web.immediate.js");// ... 更多web特性省略const jzplp =1;

可以看到core-js被拆开,直接引入了特性本身。在配置chrome: 100版本时,引入的特性为215个。我们修改配置chrome: 140版本时,再重新生成代码,此时引入的特性为150个。可以看到确实时根据浏览器版本选择不同的特性引入。这对于其它core-js的引入方式也生效:

// 源代码require('core-js/stable');const jzplp =1;// 生成代码"use strict";require("core-js/modules/es.symbol.async-dispose.js");require("core-js/modules/es.symbol.dispose.js");// ... 更多es特性省略require("core-js/modules/web.dom-exception.stack.js");require("core-js/modules/web.immediate.js");// ... 更多web特性省略const jzplp =1;

我们引入core-js/stable,可以看到生成代码中不引入esnext特性了。在配置chrome: 100版本时,引入的特性为71个,配置chrome: 100版本时,引入的特性为6个。同样的,如果引入换成core-js/full/array,就会只引入数组相关特性,而且也是根据浏览器兼容版本引入。

preset-env配置usage

@babel/preset-env的useBuiltIns配置值为usage时,Babel不仅会跟根据配置的浏览器版本兼容性,还会根据代码中实际使用的特性来选择引入哪些core-js中的特性。首先是Babel配置:

{"presets":[["@babel/preset-env",{"targets":{"chrome":"100"},"useBuiltIns":"usage","corejs":"3.47.0"}]]}

然后是要处理的代码,注意配置usage时是不需要手动引入core-js的。我们配置不同的Chrome浏览器版本,看看输出结果如何:

// 源代码const jzplp =newPromise();const b =newMap();// chrome 50 生成代码 "use strict";require("core-js/modules/es.array.iterator.js");require("core-js/modules/es.map.js");require("core-js/modules/es.promise.js");require("core-js/modules/web.dom-collections.iterator.js");const jzplp =newPromise();const b =newMap();// chrome 100 生成代码 "use strict";const jzplp =newPromise();const b =newMap();

首先可以看到,引入core-js中的特性数量变得非常少了,代码中没有用到的特性不再引入。其次不同的浏览器版本引入的特性不一样,因此还是会根据浏览器兼容性引入特性。我们再修改一下源代码试试:

// 源代码const jzplp =newPromise();const b =newMap(); Promise.try(()=>{});// chrome 50 生成代码 "use strict";require("core-js/modules/es.array.iterator.js");require("core-js/modules/es.map.js");require("core-js/modules/es.promise.js");require("core-js/modules/es.promise.try.js");require("core-js/modules/web.dom-collections.iterator.js");const jzplp =newPromise();const b =newMap(); Promise.try(()=>{});// chrome 100 生成代码 "use strict";require("core-js/modules/es.promise.try.js");const jzplp =newPromise();const b =newMap(); Promise.try(()=>{});

可以看到,源代码中增加了Promise.try,引入的特性也随之增加了对应的core-js特性引入。因此,使用@babel/preset-env的usage配置,可以保证兼容性的同时,最小化引入core-js特性。另外这个配置并不会自动引入提议特性,如果需要则额外配置proposals为true。

@babel/polyfill

@babel/polyfill是一个已经被弃用的包,推荐直接使用core-js/stable。查看@babel/polyfill源码,发现他就是引入了core-js特性与regenerator-runtime这个包。regenerator-runtime也是一个兼容性相关的包,可以帮助添加generatore和async/await相关语法。作为替代可以这样引入:

import'core-js/stable';import'regenerator-runtime/runtime';

@babel/runtime

@babel/runtime就像自动引入版的core-js-pure。它还是根据代码实际使用的特性来注入core-js特性,但它不注入到全局,而是引入这些API再调用。这里我们使用@babel/plugin-transform-runtime插件,里面包含了@babel/runtime相关逻辑。首先看下Babel配置:

{"plugins":[["@babel/plugin-transform-runtime",{"corejs":3}]]}

再转义上一节中的代码,结果如下:

// 源代码const jzplp =newPromise();const b =newMap(); Promise.try(()=>{});// 生成代码import _Promise from"@babel/runtime-corejs3/core-js-stable/promise";import _Map from"@babel/runtime-corejs3/core-js-stable/map";const jzplp =new_Promise();const b =new_Map(); _Promise.try(()=>{});

可以看到,虽然没有直接引入core-js-pure,但效果是一样的。打开@babel/runtime-corejs3这个包查看,里面实际上就是导出了core-js-pure中的特性。例如:

// @babel/runtime-corejs3/core-js-stable/map.js 文件内容 module.exports =require("core-js-pure/stable/map");

core-js/configurator强制控制

如果希望在正常引入core-js时,对于部分特殊属性进行引入或者不引入的控制,就需要用到core-js/configurator。这个工具可以配置三种选项:

  • useNative: 当环境中有这个特性时不引入,当确定没有时才引入
  • usePolyfill: 明确引入这个特性
  • useFeatureDetection: 默认行为,和不使用core-js/configurator一致

useNative不引入

首先试试不引入特性,这里我们使用Promise这个特性为例。首先是不引入core-js的效果,可以看到全局Promise对象被我们改掉了。

const jzplp ={}; Promise = jzplp; console.log(Promise, Promise === jzplp);/* 输出结果 {} true */

然后在中间引入core-js试试。可以看到我们改掉的Promise,被core-js给改回去了。

const jzplp ={}; Promise = jzplp;require("core-js/actual"); console.log(Promise, Promise === jzplp);/* 输出结果 [Function: Promise] false */

这时候,如果不希望core-js改掉我们自定义的Promise,可以利用useNative配置,强制core-js不引入这个特性。看结果core-js引入之后,我们自定义的Promise依然存在。

const configurator =require("core-js/configurator");configurator({useNative:["Promise"],});const jzplp ={}; Promise = jzplp;require("core-js/actual"); console.log(Promise, Promise === jzplp);/* 输出结果 {} true */

usePolyfill强制引入

想要验证usePolyfill的效果,需要找一个环境中本来存在的特性,core-js即使引入也不会修改的特性。Promise不行,因为core-js引入时会对这个Promise增加子特性。Promise.try也不行,因为原来环境中不存在。这里试一下Promise.any,这是环境中本来就存在的特性:

console.log(Promise.any);constjzplp=()=>{}; Promise.any = jzplp; console.log(Promise.any, Promise.any === jzplp);/* 输出结果 [Function: any] [Function: jzplp] true */

可以看到,Promise.any原来就存在,但是被我们修改成了新函数。再引入core-js试试:

console.log(Promise.any);constjzplp=()=>{}; Promise.any = jzplp;require('core-js'); console.log(Promise.any, Promise.any === jzplp);/* 输出结果 [Function: any] [Function: jzplp] true */

引入了core-js之后,结果没有变化。这说明core-js并不会修改我们自定义的函数。这时候就可以试一下usePolyfill的效果了:

const configurator =require("core-js/configurator");configurator({usePolyfill:["Promise.any"],}); console.log(Promise.any);constjzplp=()=>{}; Promise.any = jzplp;require('core-js'); console.log(Promise.any, Promise.any === jzplp);/* 输出结果 [Function: any] [Function: any] false */

可以看到,Promise.any又被改为了真正起效果的函数,这说明usePolyfill的强制引入特性是有效的。

core-js中的特性选择

前面我们体验了Babel根据浏览器兼容性,选择不同的core-js特性引入,那么不同浏览器兼容哪些特性的数据是从哪里获取呢?core-js本身就提供了这个功能。

core-js-compat

core-js-compat提供了不同浏览器对应特性的兼容性数据。它有好几个参数,这里先列举一下含义:

  • targets: Browserslist格式的浏览器兼容配置
  • modules: 需要设置兼容性配置的模块,可以是core-js/full,也可以是某个特性,甚至是正则
  • exclude: 需要排除的模块
  • version: 使用的core-js版本
  • inverse: 反向输出,即输出不需要兼容的特性列表

这里举几个例子试一下:

const compat =require("core-js-compat");const data =compat({targets:"> 10%",modules:["core-js/actual"],version:"3.47",}); console.log(data);/* 输出结果 { list: [ 'es.iterator.concat', 'es.math.sum-precise', 'es.async-iterator.async-dispose', 'esnext.array.group', 'esnext.array.group-by', ...其它特性 ], targets: { 'es.iterator.concat': { 'chrome-android': '143' }, 'es.math.sum-precise': { 'chrome-android': '143' }, 'es.async-iterator.async-dispose': { 'chrome-android': '143' }, 'esnext.array.group': { 'chrome-android': '143' }, 'esnext.array.group-by': { 'chrome-android': '143' }, ...其它特性 } } */

compat会根据我们设置的浏览器兼容性配置,输出特性列表,包含两个字段:list是一个特性名称列表;targets是一个Map结构,key为特性名,值为可以兼容的浏览器。假设我们把上面的 targets改成 > 50%,此时会输出空值:

const compat =require("core-js-compat");const data =compat({targets:"> 50%",modules:["core-js/actual"],version:"3.47",}); console.log(data);/* 输出结果 { list: [], targets: {} } */

我们增加exclude,排除部分属性,可以看到特性数量大大减少:

const compat =require("core-js-compat");const data =compat({targets:"> 10%",modules:["core-js/actual"],exclude:["esnext"],version:"3.47",}); console.log(data);/* 输出结果 { list: [ 'es.iterator.concat', 'es.math.sum-precise', 'es.async-iterator.async-dispose', 'web.dom-exception.stack', 'web.immediate', 'web.structured-clone' ], targets: { 'es.iterator.concat': { 'chrome-android': '143' }, 'es.math.sum-precise': { 'chrome-android': '143' }, 'es.async-iterator.async-dispose': { 'chrome-android': '143' }, 'web.dom-exception.stack': { 'chrome-android': '143' }, 'web.immediate': { 'chrome-android': '143' }, 'web.structured-clone': { 'chrome-android': '143' } } } */

再试一下inverse的效果:

const compat =require("core-js-compat");const data =compat({targets:"> 10%",modules:["core-js/actual"],version:"3.47",inverse:true}); console.log(data);/* 输出结果 { list: [ 'es.symbol', 'es.symbol.description', ...其它特性 ], targets: { 'es.symbol': {}, 'es.symbol.description': {}, ...其它特性 } } */

因为输出的是不需要引入core-js兼容的特性,所以特性数量非常多,而且targets中没有列出支持的浏览器版本。

core-js-builder

前面介绍的core-js-compat是接收参数之后,输出core-js的特性列表数组。而core-js-builder接收类似的参数,直接输出引用core-js的代码。我们首先列举一下参数:

  • targets: Browserslist格式的浏览器兼容配置
  • modules: 需要设置兼容性配置的模块,可以是core-js/full,也可以是某个特性,甚至是正则
  • exclude: 需要排除的模块
  • format: 'bundle’输出打包后的源码;'cjs’和’esm’输出对应格式的引用代码
  • filename: 输出的文件名

我们先试一下例子。首先是format格式的:

const builder =require("core-js-builder");asyncfunctionfunJzplp(){const data =awaitbuilder({targets:"> 30%",modules:["core-js/actual"],format:'bundle',}); console.log(data);}funJzplp();/* 输出结果 ...代码很长,这里节选部分 (function(module, exports, __webpack_require__) { "use strict"; var NATIVE_BIND = __webpack_require__(8); var FunctionPrototype = Function.prototype; */

可以看到,builder函数输出了非常长的代码,内容实际为输出的特性经过打包之后的结果代码。再试一下’cjs’和’esm’,输出的是对应木块的引用代码:

// format: 'cjs' 输出结果...代码很长,这里节选部分 require('core-js/modules/es.iterator.concat');require('core-js/modules/es.math.sum-precise');require('core-js/modules/es.async-iterator.async-dispose');*/// format: 'esm' 输出结果...代码很长,这里节选部分 import'core-js/modules/es.iterator.concat.js';import'core-js/modules/es.math.sum-precise.js';import'core-js/modules/es.async-iterator.async-dispose.js';*/

如果设置了filename,core-js-builder会创建该名称的文件,并将代码写入到文件中。

总结

这篇文章描述了core-js相关包的代码内容和使用方式。core-js实际上就是提供了JavaScript中一些API特性的兼容实现方式。它与实现语法兼容的Babel一起,可以做到大部分JavaScript的兼容性。当然core-js和Babel也不是万能的,它们都有各自无法转义和兼容的语法和特性。

core-js这个包名字起的非常好,一听就是JavaScript的“核心”包。由于它实现了很多API特性,而且引用数量非常非常大,因此叫“核心”也不为过。虽然这个包引用量很大,但不如React/Vue或者一些其它包出名。因为这个包是处理的更底层的兼容性有问题,因此用户感知不强。core-js包的作者还因为没有钱而遇到很多问题,这个包并没有让他变的富有。

参考

  • core-js 文档
    https://core-js.io/
  • Github core-js
    https://github.com/zloirock/core-js
  • 解锁Babel核心功能:从转义语法到插件开发
    https://jzplp.github.io/2025/babel-intro.html
  • @babel/preset-env 文档
    https://babeljs.io/docs/babel-preset-env
  • @babel/polyfill 文档
    https://babeljs.io/docs/babel-polyfill
  • @babel/runtime 文档
    https://babeljs.io/docs/babel-runtime
  • Github regenerator-runtime
    https://github.com/facebook/regenerator/tree/main/packages/runtime
  • Github core-js-compat
    https://github.com/zloirock/core-js/blob/master/packages/core-js-compat
  • Github core-js-builder
    https://github.com/zloirock/core-js/tree/master/packages/core-js-builder
  • So, what’s next?
    https://github.com/zloirock/core-js/blob/master/docs/2023-02-14-so-whats-next.md

Read more

Web Streams 的隐性开销与JavaScript 流处理新方案

Web Streams 的隐性开销与JavaScript 流处理新方案

处理视频流时突然卡顿?处理大文件时内存爆表?这些看似奇怪的问题,可能源于 JavaScript 中一个被广泛采用但设计复杂的标准 API——Web Streams。当你的 Node.js 应用突然因为未消费的 body 耗尽连接池,或者处理大文件时内存爆表,你可能已经踩过 Web Streams 的坑了。 问题:Web Streams 的设计缺陷 Web Streams 是 JavaScript 中处理数据流的标准 API,2014-2016 年设计,旨在统一浏览器和服务器的数据流处理。它被用于 fetch()、Node.js、Cloudflare Workers 等场景,成为现代 Web 应用的数据传输基础。WHATWG Streams Standard 文档 定义了这套机制,初衷是让开发者能以统一方式处理实时数据、大文件、

第五届“长城杯”初赛 2025 Web WP 全

第五届“长城杯”初赛 2025 Web WP 全

文曲签学 上来给了一个 寻词器 的页面,然后根据提示 要进入调试模式 查看网页源码, 看到 通过长按Fn即可进入调试模式 进入调试模式 根据页面提示, 输入 #help,查看可以执行的指令 #list 查看笔记列表 (为了方便输入指令,后续就直接在BP中操作了) 看到 提示 flag在根目录下. #about 提示要关注公众号 双写绕过的,目录穿越读取flag #read ....//....//....//....//flag 成功获取flag. EZ_upload 是一道文件上传题目, 网站只有一个文件上传点.任意上传一个文件后显示了源码. 接受 文件后,对文件名做了简单的过滤. 然后把文件保存在了/tmp目录下,并且对文件执行了tar解包的操作. 文件上传,一般就是要写入 webshell. 但是文件都保存在了/tmp下,所以我们要想办法修改文件的保存位置. 题目隐藏知识 ✅ 关键点:tar 解压符号链接时,默认会保留符号链接(

对比测试:OPENWEBUI vs 传统开发效率提升300%

快速体验 1. 打开 InsCode(快马)平台 https://www.inscode.net 2. 输入框内输入如下内容: 构建一个电商产品详情页对比项目:1. 传统手工开发版本 2. OPENWEBUI生成版本。比较指标包括:开发时长、代码行数、性能指标、可维护性。要求两个版本功能完全一致,包含商品展示、规格选择、购物车等功能。使用Kimi-K2模型自动优化生成代码。 1. 点击'项目生成'按钮,等待项目生成完整后预览效果 最近在做一个电商产品详情页的开发,正好有机会对比了一下传统手工开发和OPENWEBUI自动生成的效率差异。结果让我大吃一惊,忍不住想分享一下这个对比测试的过程和发现。 1. 项目背景 电商产品详情页看似简单,但实际开发中要考虑很多细节:商品图片展示、规格选择、价格计算、购物车功能等。传统开发方式下,前端要写大量HTML/CSS/JS代码,

零基础搭建OCR文字检测系统:科哥开发的WebUI一键启动指南

零基础搭建OCR文字检测系统:科哥开发的WebUI一键启动指南 你是不是也遇到过这些场景: * 手里有一堆发票、合同、证件照片,想快速提取上面的文字,却要一张张手动敲? * 截图里的操作说明看不清,放大后更模糊,复制又不支持? * 做电商运营,每天要处理上百张商品图,光是找图中文字就耗掉半天? 别再靠截图+人工抄写了。今天带你用零代码、零配置、零环境依赖的方式,5分钟内跑起一个专业级OCR文字检测系统——它不是调用API,而是本地部署、完全可控、永久免费的WebUI工具,由开发者“科哥”亲手打造,开箱即用。 这不是Demo,不是演示,而是一个真正能放进工作流、每天稳定运行的OCR检测服务。下面我们就从按下第一个命令开始,手把手带你走完全部流程。 1. 为什么选这个镜像:轻量、精准、开箱即用 cv_resnet18_ocr-detection 这个名字听起来有点技术味,但它的设计哲学非常朴素:把OCR检测这件事,做成和打开网页一样简单。 它不像传统OCR方案那样需要装CUDA、编译OpenCV、下载预训练权重、改配置文件…