babel兼容低版本游览器

1. webpack项目的搭建

1. npm init 初始化项目，并一路回车

│  └─ package.json

2. webpack与webpack-cli 安装

   执行命令 npm i webpack webpack-cli -D

│  ├─ package.json
│  ├─ node_modules // webpack-cli创建

3. 安装编译模板并配置入口和出口文件

1. 安装编译模板 npm i html-webpack-plugin

项目结构

│     ├─ build 
│     │  ├─ build.js
│     │  └─ index.html
│     ├─ node_modules
│     └─ src
│        ├─ index.js | main.js
│     ├─ index.html // 入口文件
|     ├─ package.json
|     ├─ webpack.config.js	

• 配置 webpack.config.js 新建入口文件index.js, 出口文件 build

const path = require('path')
// 模板编译
const HtmlWeabpckPlugin = require("html-webpack-plugin")
module.exports = {
	mode: 'development',
	devtool: false,   // 取消eval且不生成soucremap,代码清晰不转换
	entry: './src/index.js',
	output: {
		path: path.resolve(__dirname, './build'),
		filename: 'bundle.js',
		// 重新打包时, 先将之前打包的文件夹删除掉
		clean: true
	},
	resolve: {
		extensions: ['.js', '.json', '.wasm', '.jsx', '.ts']
	},
	module: {
	},
	plugins: [
		new HtmlWeabpckPlugin({
			template: "./index.html"
		})
	]
}

• 修改package.json 打包命令

  "scripts": {
    "build":"webpack"
  },

4. 配置webpack-dev-server 热更新

安装 npm i webpack-dev-server -D

修改package.json

 "scripts": {
    "build": "webpack",
    "serve": "webpack serve"
  },

2. babel 命令行使用

• babel本身可以作为一个独立的工具（和postcss一样），不和webpack等构建工具配置来单独使用
• 如果要在命令行尝试使用babel，需要安装库
  • @babel/core：babel的核心代码，必须安装；
  • @babel/cli：可以让我们在命令行使用babel；

 安装 npm install @babel/cli @babel/core

1. 使用babel来处理写的ES6代码

   src：是源文件的目录；
   --out-dir：指定要输出的文件夹dist；
   npx babel src --out-dir dist

• 执行 npx babel ./src/index.js --out-dir dist

会发现代码输出到dist 文件夹了，但是并没有进行降级

• 上述代码没有降级是因为babel在这里只进行了抽象语法解析
• 如果要想对代码进行降级必须使用插件 plugin

安装插件 npm install @babel/plugin-transform-block-scoping -D

• 在执行命令 npx babel ./src/index.js --out-dir dist --plugins=@babel/plugin-transform-block-scoping

• 这时就会把es6 代码中的const 转换为var
  

3. babel的预设与编译器流程

• 上面代码中可以实现es6转es5 ，但是要转换的内容过多，一个个设置是比较麻烦的，这时就可以使用预设（preset）

1. 安装 npm install @babel/preset-env -D
2. 使用 npx babel ./src/index.js --out-dir dist --presets=@babel/preset-env

• 代码中的转换并自动开启严格模式
  

• babel的底层原理解析 github解析

4. babel项目中配置

4.1 babel-loader与插件的使用

• 在实际开发中，我们通常会在构建工具中通过配置babel来对其进行使用的，比如在webpack中。

1. 安装依赖 npm install babel-loader @babel/core
2. 在webpack中配置与指定插件

• 添加配置

module: {
		rules: [
			{
				test: /\.m?js$/,
				use: {
					loader: "babel-loader",
					options:{
						plugins: [
							"@babel/plugin-transform-block-scoping",
						]
					}
				}
			}]
	},

4.2 babel-preset使用

• 上述代码中单独配置太麻烦了，可以直接给webpack提供一个preset，webpack会根据我们的预设来加载对应的插件列表，并且将其传递给babel。

• 安装 npm install @babel/preset-env

• 修改plugin中的配置

	rules: [
			{
				test: /\.m?js$/,
				use: {
					loader: "babel-loader",
					options: {
						presets:[
							["@babel/preset-env"]
						]
					}
				}
			}]

5. 游览器兼容性使用

• 代码的要不要转换取决于适配的游览器
• bowserlistrc 文件解析
  

> 0.05%   表示现在使用的游览器市场占有率   （这里默认值是0.5%, 0.1%可兼容谷歌游览器79 ）
last 2 versions     表示最近的两个版本
not dead     //表示最近24个月浏览器是否进行更新

• 使用命令 npx browserslist 可查看兼容的浏览器
• 游览器市场占有率 ： 使用的游览器占有率

5.1 browserslist工具与编写规则

• browserslist工具可以在css兼容性和js兼容性下共享我们配置的兼容性条件

• 当设置了一个条件： > 1%；的意思是css要兼容市场占有率大于1%的浏览器，js也要兼容市场占有率大于1%的浏览器；

• Browserslist是一个在不同的前端工具之间，共享目标浏览器和Node.js版本的配置
  • Autoprefixer
  • babel
  • postcss-normalize

• 编写规则
  
  
• 命令行使用browserslist

npx browserslist ">1%, last 2 version, not dead"

5.2 browserslist配置

1. 可以在package.json配置
2. 在.browserslistrc文件中配置

> 5%
last 2 versions
not dead

• 多个配置的条件关系
  

• 注意多个游览器兼容配置生效规则
• 在这里配置的target 会直接覆盖掉browserslistrc文件的配置

		rules: [
			{
				test: /\.m?js$/,
				use: {
					loader: "babel-loader",
					options: {
						presets: [
							["@babel/preset-env",{
								targets: ">5%"
							}]
						]
					}
				}
			}]

5.3 优化babel的配置文件

• 现在的项目是将babel的配置信息放到一个独立的文件中，babel给我们提供了两种配置文件的编写：

  • babel.config.json（或者.js，.cjs，.mjs）文件；
  • babelrc.json（或者.babelrc，.js，.cjs，.mjs）文件；

• 它们两个有什么区别呢？目前很多的项目都采用了多包管理的方式（babel本身、element-plus、umi等）

  • .babelrc.json：早期使用较多的配置方式，但是对于配置Monorepos项目是比较麻烦的
  • babel.config.json（babel7）：可以直接作用于Monorepos项目的子包，更加推荐；

• json与js的文件配置只是写法不同而已，功能一致

module.exports = {
	presets: [
		["@babel/preset-env", {
		}
		]
	]
}

6. polyfill

• polyfill 其实就是给代码打一个补丁，可以帮助我们更好的使用JavaScript；
• 为什么时候会用到polyfill呢？
  • 比如我们使用了一些语法特性（例如：Promise, Generator, Symbol等以及实例方法例如Array.prototype.includes等
  • 但是某些浏览器压根不认识这些特性，必然会报错；
    

注意点 在babel7.4.0之前，可以使用 @babel/polyfill的包，但是该包现在已经不推荐使用了

• babel7.4.0之后，可以通过单独引入core-js和regenerator-runtime来完成polyfill的使用：

npm install core-js regenerator-runtime --save

1. 配置babel.config.js
   • useBuiltIns：设置以什么样的方式来使用polyfill；
   • corejs：设置corejs的版本，目前使用较多的是3.x的版本，比如我使用的是3.8.x的版本；
     • 另外corejs可以设置是否对提议阶段的特性进行支持；
     • 设置 proposals属性为true即可；

6.1 useBuiltIns属性设置

1. fasle值 ，不设置默认值
   • 打包后的文件不使用polyfill来进行适配； 并且这个时候是不需要设置corejs属性的；
2. usage
   • 会根据源代码中出现的语言特性，自动检测所需要的polyfill； 这样可以确保最终包里的polyfill数量的最小化，打包的包相对会小一些；

• 不设置
  
• 设置
  

3. entry
   • 如果要依赖的某一个库本身使用了某些polyfill的特性，但是因为我们使用的是usage，所以之后用户浏览器可能会报错； 就可以使用 entry；

// 入口文件引入
import 'core-js/stable';
import 'regenerator-runtime/runtime';

• 完整配置

module.exports = {
	presets: [
		["@babel/preset-env", {
			// corejs:3,
			// useBuiltIns:false   // 默认值就是不使用polyfill
			// corejs:3,
			// useBuiltIns:"usage"   //自动检测需要的polyfill， 会把使用string的方法代码全部做个打包

			corejs: 3,
			useBuiltIns: "entry" // 解决 依赖的某一个库本身使用了某些polyfill的特性
			//  需要在入口文件中添加 `import 'core-js/stable'; import 'regenerator-runtime/runtime'
		}
		]
	]
}

• 项目完整目录

│     ├─ build 
│     │  ├─ build.js
│     │  └─ index.html
|     ├─ dist 
│     ├─ node_modules
│     └─ src
│        ├─ index.js | main.js
│     ├─ index.html // 入口文件
|     ├─ package.json
|     ├─ webpack.config.js	
|     ├─.browserslistrc
|     ├─ babel.config.js

参考文章

• coderwhy
• jcat_李小黑
• DevHappy
• github browserslist
• 附加，vue2项目升级到vue3项目执行打包时，build执行两遍
• 项目地址

7. babel对第三方插件的编译

7.1 react的支持

安装 npm i react react-dom

• 编写jsx文件

import React, { memo } from 'react'
const app = memo(() => {
	return (
		<div>app</div>
	)
})
export default app

• 导入react 与react-dom 并插件render 挂载App
• 注意 要在 index.html 中创建类或者id标签

import React from 'react';
import ReactDom from 'react-dom/client';
import App from './react/app.jsx';

const Root = ReactDom.createRoot(document.querySelector('.root'))
Root.render(<App />)

• 配置babel-loader
  

• 对react jsx代码进行处理解析插件：

  • @babel/plugin-syntax-jsx
  • @babel/plugin-transform-react-jsx
  • @babel/plugin-transform-react-display-name

• 但是开发中，我们并不需要一个个去安装这些插件，直接使用preset来配置

npm install @babel/preset-react -D

module.exports = {
	presets: [
		["@babel/preset-env"],
		["@babel/preset-react"]
	]
}

7.2 TS的支持 ts-loader

• 前言 我们可以通过TypeScript的compiler来转换成JavaScript：

npm install typescript -D

• 另外TypeScript的编译配置信息我们通常会编写一个tsconfig.json文件：

tsc --init     // 生成tsconfig.json

• 可以运行 npx tsc来编译自己的ts代码

1. 当在webpack中使用TypeScript，那么我们可以使用ts-loader来处理ts文件：

安装 npm install ts-loader -D

2. 编写TS并使用

export const sum=(num1:number,num2:number)=>{
     return num1+num2
}

3. 配置loader并打包

{
	test: /\.ts$/,
	use: {loader: "ts-loader",}
}

4. 注意 如果打包出现下面错误 要配置 tsconfig.json
   
5. 解决第四步错误

• 执行 tsc --init
• 配置兼容es版本

7.3 babel对TS的支持

• 配置babel-loader

{
	test: /\.ts$/,
	use: {
		loader: "babel-loader",
	}

• 安装 @babel/preset-typescript 与配置

npm install @babel/preset-typescript -D

module.exports = {
	presets: [
		["@babel/preset-env"],
		["@babel/preset-react"],
		["@babel/preset-typescript"]
	]
}

• ts-loader和babel-loader选择
  • 使用ts-loader（TypeScript Compiler）来直接编译TypeScript，那么只能将ts转换成js；
  • 如果我们还希望在这个过程中添加对应的polyfill（兼容Promise，includes这样的语法），那么ts-loader是无能为力的；
    • 我们需要借助于babel来完成polyfill的填充功能；
    • 使用babel-loader（Babel）来直接编译TypeScript，也可以将ts转换成js，并且可以实现polyfill的功能；

["@babel/preset-typescript",{
// corejs:3,
// useBuiltIns:"usage"
}]

• babel-loader在编译的过程中，不会对类型错误进行检测；
  • 执行 npm run type-check可以对ts代码的类型进行检测；
  • 执行 npm run type-check-watch可以实时的检测类型错误；

"ts-check":"tsc --noEmit",
"ts-check-watch":"tsc --noEmit --watch"