Webpack node、output.jsonpFunction 配置详解
最近尝试给一些用到 webpack 的项目升级到最新 webpack5 版本，其中遇到了一些问题，我挑了两个比较典型的问题，其中主要涉及到了 webpack 的 node 属性跟 output.jsonpFunction （webpack5 以前版本）属性，下面我们结合 webpack 的源码来分析一下这两个属性。
开始
这里使用的 webpack 版本为：
- webpack@^4.46.0
- webpack@^5.88.2
首先我们创建一个 webpack4 的项目：
webpack-node1:
mkdir webpack-node2 && cd webpack-node2 && npm init -y
接着安装 webpack4 ：
npm install -D webpack@4.46.0 webpack-cli@4.10.0
创建创建一个 src/index.js 入口文件：
mkdir src && touch src/index.js
在项目根目录 webpack-node1 目录下创建一个 webpack 配置文件 webpack.config.js：
cd .. && touch webpack.config.js
// webpack.config.js
module.exports = {output: {publicPath: "./dist/",},devtool: false, // 关闭 source-map 功能
};
ok，我们在项目根目录 webpack-node1 下执行一下 webpack 打包命令看效果：
npx webpack build --mode=development
可以看到，因为我们的入口文件 src/index.js 是一个空文件，所以打包后的 dist/main.js 文件除了一些 webpack 的辅助函数外，入口文件里面为空。
最后我们创建一个 test.html 文件来测试：
touch test.html
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>webpack4</title><script src="./dist/main.js"></script>
</head>
<body></body>
</html>
ok，项目我们就创建完了，接下来我们看一下 webpack.node 配置。
Node 配置
我们先看一下 webpack官网 对它的介绍:
这些选项可以配置是否 polyfill 或 mock 某些 Node.js 全局变量。
此功能由 webpack 内部的
NodeStuffPlugin插件提供。Warning
从 webpack 5 开始，你只能在
node选项下配置global、__filename或__dirname。如果需要在 webpack 5 下的 Node.js 中填充fs，请查阅 resolve.fallback 获取相关帮助。node
boolean: false` `objectwebpack.config.js
module.exports = {//...node: {global: false,__filename: false,__dirname: false,}, };从 webpack 3.0.0 开始，
node选项可能被设置为false，以完全关闭NodeStuffPlugin插件。node.global
boolean` `'warn'Tip
如果你正在使用一个需要全局变量的模块，请使用
ProvidePlugin替代global。关于此对象的准确行为，请查看Node.js 文档。
选项：
true: 提供 polyfill.false: 不提供任何 polyfill。代码可能会出现ReferenceError的崩溃。'warn': 当使用global时展示一个警告。node.__filename
boolean` `'mock' | 'warn-mock' | 'eval-only'选项：
true: 输入文件的文件名，是相对于context选项。false: webpack 不会更改__filename的代码。在 Node.js 环境中运行时，出文件的文件名。'mock': value 填充为'index.js'。'warn-mock': 使用'/index.js'但是会展示一个警告。'eval-only'node.__dirname
boolean` `'mock' | 'warn-mock' | 'eval-only'选项：
true: 输入 文件的目录名，是相对于context选项。false: webpack 不会更改__dirname的代码，这意味着你有常规 Node.js 中的__dirname的行为。在 Node.js 环境中运行时，输出 文件的目录名。'mock': value 填充为'/'。'warn-mock': 使用'/'但是会显示一个警告。'eval-only'
以上是 webpack5 的 node 配置的描述。
webpack4
ok，看完了官网的描述，我们来用一下这个 node 配置。
我们修改一下 src/index.js 文件：
// 判断是浏览器环境
const isBrowser = process.browser; // 使用 nodejs 的 process 对象
console.log(isBrowser);
console.log(__dirname); // 使用 nodejs 的 __dirname 全局属性
console.log(global); // 使用 nodejs 全局对象 global
我们重新执行打包命令看效果：
npx webpack build --mode=development
浏览器打开 test.html 文件：
可以看到，即使是 nodejs 环境中的变量，我们在浏览器中仍然可以访问，这是为什么呢？
因为 webpack 提前给我们注入了这些 nodejs 的全局变量，我们来找一下 webpack4 的源码。
node_modules/webpack/lib/node/NodeSourcePlugin.js：
/*MIT License http://www.opensource.org/licenses/mit-license.phpAuthor Tobias Koppers @sokra
*/
"use strict";
const AliasPlugin = require("enhanced-resolve/lib/AliasPlugin");
const ParserHelpers = require("../ParserHelpers");
const nodeLibsBrowser = require("node-libs-browser");module.exports = class NodeSourcePlugin {constructor(options) {this.options = options;}apply(compiler) {const options = this.options;// 当 webpack.node 配置为 false 的时候关闭该插件if (options === false) {// allow single kill switch to turn off this pluginreturn;}// 获取 nodepollyfill 的依赖地址const getPathToModule = (module, type) => {// 配置成 true 的话就去找到对应的 pollyfill 库if (type === true || (type === undefined && nodeLibsBrowser[module])) {if (!nodeLibsBrowser[module]) {throw new Error(`No browser version for node.js core module ${module} available`);}return nodeLibsBrowser[module];// 配置成 mock 就简单模拟一下} else if (type === "mock") {return require.resolve(`node-libs-browser/mock/${module}`);// 配置成 empty 就返回 undeifned} else if (type === "empty") {return require.resolve("node-libs-browser/mock/empty");} else {return module;}};// 修改变量为依赖引入const addExpression = (parser, name, module, type, suffix) => {suffix = suffix || "";parser.hooks.expression.for(name).tap("NodeSourcePlugin", () => {if (parser.state.module &&parser.state.module.resource === getPathToModule(module, type))return;const mockModule = ParserHelpers.requireFileAsExpression(parser.state.module.context,getPathToModule(module, type));return ParserHelpers.addParsedVariableToModule(parser,name,mockModule + suffix);});};compiler.hooks.compilation.tap("NodeSourcePlugin",(compilation, { normalModuleFactory }) => {const handler = (parser, parserOptions) => {if (parserOptions.node === false) return;let localOptions = options;if (parserOptions.node) {localOptions = Object.assign({}, localOptions, parserOptions.node);}// 对 global 变量进行替换if (localOptions.global) {parser.hooks.expression.for("global").tap("NodeSourcePlugin", () => {const retrieveGlobalModule = ParserHelpers.requireFileAsExpression(parser.state.module.context,require.resolve("../../buildin/global"));return ParserHelpers.addParsedVariableToModule(parser,"global",retrieveGlobalModule);});}// 对 process 变量进行替换if (localOptions.process) {const processType = localOptions.process;addExpression(parser, "process", "process", processType);}//...};normalModuleFactory.hooks.parser.for("javascript/auto").tap("NodeSourcePlugin", handler);normalModuleFactory.hooks.parser.for("javascript/dynamic").tap("NodeSourcePlugin", handler);});// 替换 nodejs-pollyfill 依赖为第三方库compiler.hooks.afterResolvers.tap("NodeSourcePlugin", compiler => {for (const lib of Object.keys(nodeLibsBrowser)) {if (options[lib] !== false) {compiler.resolverFactory.hooks.resolver.for("normal").tap("NodeSourcePlugin", resolver => {new AliasPlugin("described-resolve",{name: lib,onlyModule: true,alias: getPathToModule(lib, options[lib])},"resolve").apply(resolver);});}}});}
};代码有点多，看着估计有点晕，我们先看一下我们的入口文件 src/index.js：
// 判断是浏览器环境
const isBrowser = process.browser;
console.log(isBrowser);
console.log(__dirname);
console.log(global);
再看一下打包过后的 dist/main.js 文件：
/******/ (function(modules) { // webpackBootstrap//...
/******/ })
/************************************************************************/
/******/ ({/***/ "./node_modules/process/browser.js":
/*!*****************************************!*\!*** ./node_modules/process/browser.js ***!\*****************************************/
/*! no static exports found */
/***/ (function(module, exports) {// shim for using process in browser
var process = module.exports = {};
//...
process.title = 'browser';
process.browser = true;
process.env = {};
process.argv = [];
process.version = ''; // empty string to avoid regexp issues
process.versions = {};
//.../***/ "./src/index.js":
/*!**********************!*\!*** ./src/index.js ***!\**********************/
/*! no static exports found */
/***/ (function(module, exports, __webpack_require__) {/* WEBPACK VAR INJECTION */(function(process, __dirname, global) {// 判断是浏览器环境
const isBrowser = process.browser;
console.log(isBrowser);
console.log(__dirname);
console.log(global);/* WEBPACK VAR INJECTION */}.call(this, __webpack_require__(/*! ./../node_modules/process/browser.js */ "./node_modules/process/browser.js"), "/", __webpack_require__(/*! ./../node_modules/webpack/buildin/global.js */ "./node_modules/webpack/buildin/global.js")))/***/ })/******/ });
可以看到：
__dirname变量变成了/字符串process变量变成了node_modules/process/browser.js模块导出内容global变量变成了node_modules/webpack/buildin/global.js模块导出内容
那么在 webpack4 中，除了我们用到的这些变量外，我们还可以默认使用哪些全局变量呢？
我们找到 node_modules/node-libs-browser/index.js 文件：
exports.assert = require.resolve('assert/');
exports.buffer = require.resolve('buffer/');
exports.child_process = null;
exports.cluster = null;
exports.console = require.resolve('console-browserify');
exports.constants = require.resolve('constants-browserify');
exports.crypto = require.resolve('crypto-browserify');
exports.dgram = null;
exports.dns = null;
exports.domain = require.resolve('domain-browser');
exports.events = require.resolve('events/');
exports.fs = null;
exports.http = require.resolve('stream-http');
exports.https = require.resolve('https-browserify');
exports.module = null;
exports.net = null;
exports.os = require.resolve('os-browserify/browser.js');
exports.path = require.resolve('path-browserify');
exports.punycode = require.resolve('punycode/');
exports.process = require.resolve('process/browser.js');
exports.querystring = require.resolve('querystring-es3/');
exports.readline = null;
exports.repl = null;
exports.stream = require.resolve('stream-browserify');
exports._stream_duplex = require.resolve('readable-stream/duplex.js');
exports._stream_passthrough = require.resolve('readable-stream/passthrough.js');
exports._stream_readable = require.resolve('readable-stream/readable.js');
exports._stream_transform = require.resolve('readable-stream/transform.js');
exports._stream_writable = require.resolve('readable-stream/writable.js');
exports.string_decoder = require.resolve('string_decoder/');
exports.sys = require.resolve('util/util.js');
exports.timers = require.resolve('timers-browserify');
exports.tls = null;
exports.tty = require.resolve('tty-browserify');
exports.url = require.resolve('url/');
exports.util = require.resolve('util/util.js');
exports.vm = require.resolve('vm-browserify');
exports.zlib = require.resolve('browserify-zlib');
可以看到，有这么些 nodejs 全局变量，我们可以正常的在浏览器端访问，以至于程序不会报错。
要关掉这些默认的 nodejs-pollyfill 也很简单，我们修改一下 webpack.config.js 配置：
module.exports = {output: {publicPath: "./dist/",},devtool: false,node: false, // 关闭 nodejs-polyfill
};
我们关掉后再次打包运行代码：
可以看到，程序第一行就报错了，说 process 变量不存在，因为 process 变量为 nodejs 中的全局变量。
ok，看完 webpack4 后，我们试一下 webpack5 看会有什么不一样？
webpack5
跟前面的 webpack4 项目创建一样，我们创建一个 webpack-node1 的项目。
安装 webpack 依赖的时候不一样，我们要安装 webpack5 版本，其它操作都一样，我就不一步一步演示了。
安装 webpack5 版本：
npm install -D webpack@5.88.2 webpack-cli@5.1.4
我们把 webpack4 项目的 src/index.js 文件的内容也复制一份：
// 判断是浏览器环境
const isBrowser = process.browser;
console.log(isBrowser);
console.log(__dirname);
console.log(global);
然后我们打包看效果：
npx webpack build --mode=development
可以看到，直接报错了！
因为在 webpack5 中，默认只给 global、__filename、__dirname 这三个全局变量添加了 polyfill：
module.exports = {devtool: false,output: {publicPath: "./dist/"},// 默认 node 配置node: {global: true,__dirname: true,__filename: true,}
};
我们找到 webpack5 的 NodeStuffPlugin 插件。
node_modules/webpack/lib/NodeStuffPlugin.js:
//...
class NodeStuffPlugin {/*** @param {NodeOptions} options options*/constructor(options) {this.options = options;}/*** Apply the plugin* @param {Compiler} compiler the compiler instance* @returns {void}*/apply(compiler) {const options = this.options;compiler.hooks.compilation.tap(PLUGIN_NAME,(compilation, { normalModuleFactory }) => {//...// 替换 global 变量if (localOptions.global !== false) {const withWarning = localOptions.global === "warn";parser.hooks.expression.for("global").tap(PLUGIN_NAME, expr => {const dep = new ConstDependency(RuntimeGlobals.global,/** @type {Range} */ (expr.range),[RuntimeGlobals.global]);dep.loc = /** @type {DependencyLocation} */ (expr.loc);parser.state.module.addPresentationalDependency(dep);// TODO webpack 6 removeif (withWarning) {parser.state.module.addWarning(new NodeStuffInWebError(dep.loc,"global","The global namespace object is a Node.js feature and isn't available in browsers."));}});parser.hooks.rename.for("global").tap(PLUGIN_NAME, expr => {const dep = new ConstDependency(RuntimeGlobals.global,/** @type {Range} */ (expr.range),[RuntimeGlobals.global]);dep.loc = /** @type {DependencyLocation} */ (expr.loc);parser.state.module.addPresentationalDependency(dep);return false;});}/*** @param {string} expressionName expression name* @param {(module: NormalModule) => string} fn function* @param {string=} warning warning* @returns {void}*/const setModuleConstant = (expressionName, fn, warning) => {parser.hooks.expression.for(expressionName).tap(PLUGIN_NAME, expr => {const dep = new CachedConstDependency(JSON.stringify(fn(parser.state.module)),/** @type {Range} */ (expr.range),expressionName);dep.loc = /** @type {DependencyLocation} */ (expr.loc);parser.state.module.addPresentationalDependency(dep);// TODO webpack 6 removeif (warning) {parser.state.module.addWarning(new NodeStuffInWebError(dep.loc, expressionName, warning));}return true;});};// 替换 __filename 变量const setConstant = (expressionName, value, warning) =>setModuleConstant(expressionName, () => value, warning);const context = compiler.context;if (localOptions.__filename) {switch (localOptions.__filename) {case "mock":setConstant("__filename", "/index.js");break;case "warn-mock":setConstant("__filename","/index.js","__filename is a Node.js feature and isn't available in browsers.");break;case true:setModuleConstant("__filename", module =>relative(compiler.inputFileSystem, context, module.resource));break;}parser.hooks.evaluateIdentifier.for("__filename").tap(PLUGIN_NAME, expr => {if (!parser.state.module) return;const resource = parseResource(parser.state.module.resource);return evaluateToString(resource.path)(expr);});}// 替换 __filename 变量if (localOptions.__dirname) {switch (localOptions.__dirname) {case "mock":setConstant("__dirname", "/");break;case "warn-mock":setConstant("__dirname","/","__dirname is a Node.js feature and isn't available in browsers.");break;case true:setModuleConstant("__dirname", module =>relative(compiler.inputFileSystem, context, module.context));break;}parser.hooks.evaluateIdentifier.for("__dirname").tap(PLUGIN_NAME, expr => {if (!parser.state.module) return;return evaluateToString(parser.state.module.context)(expr);});}parser.hooks.expression.for("require.extensions").tap(PLUGIN_NAME,expressionIsUnsupported(parser,"require.extensions is not supported by webpack. Use a loader instead."));};normalModuleFactory.hooks.parser.for(JAVASCRIPT_MODULE_TYPE_AUTO).tap(PLUGIN_NAME, handler);normalModuleFactory.hooks.parser.for(JAVASCRIPT_MODULE_TYPE_DYNAMIC).tap(PLUGIN_NAME, handler);});}
}module.exports = NodeStuffPlugin;
可以看到，webpack5 的 NodeStuffPlugin 插件比 webpack4 的 NodeSourcePlugin 插件简单多了，默认只给 global、__filename、__dirname 这三个全局变量添加了 polyfill。
那有些小伙伴要说了，我要使用 process 全局变量的话该怎么用呢？官网也说了，如果要使用这三个全局变量外的全局变量的话，你可以使用查阅 resolve.fallback 获取相关帮助。
官方这种解释也不太对，因为 process 是一个全局变量，又不是一个依赖库，resolve.fallback 是当依赖找不到的时候会进行 fallback 替换。所以我们只能通过 DefinePlugin 插件去替换掉 process.browser 这种方式去实现我们的需求了，或者重写一个 webpack4 的 NodeSourcePlugin 插件，或者还可以扩展一下webpack5 的 NodeStuffPlugin 插件。
哈哈，其实完全没必要去做额外的一些扩展了，既然 webpack5 默认只给 global、__filename、__dirname 这三个全局变量添加了 polyfill，说明经过长时间的项目经验来看，其它的变量很少用到，所以干脆去掉得了，既然这样做了还是有它自己的道理的，如果实在要用其它变量的话，可以尝试一下我上面提到的几个方法哦！
output.jsonpFunction 配置
webpack 处理异步依赖声明的全局变量名称。
我们还是拿我们项目来说明一下吧。
webpack4
我们在 webpack4 项目 webpack-node2/src 目录下创建一个 hello.js：
touch ./src/hello.js
然后简单导出一个默认 hello 函数：
export default function (name){console.log(`hello ${name}!`);
}
可以看到，我们在入口文件 index.js 中异步导入了 hello.js ，然后执行了导出的 hello 方法。
ok，我们重新打包运行看效果：
npx webpack build --mode=development
可以看到，浏览器正常打印了执行结果。
我们看一下打包过后的 dist/main.js 文件：
// ....
/******/
// window 中声明一个全局 webpackJsonp 用来存储异步依赖
var jsonpArray = window["webpackJsonp"] = window["webpackJsonp"] || [];
/******/ var oldJsonpFunction = jsonpArray.push.bind(jsonpArray);
/******/ jsonpArray.push = webpackJsonpCallback;
/******/ jsonpArray = jsonpArray.slice();
/******/ for(var i = 0; i < jsonpArray.length; i++) webpackJsonpCallback(jsonpArray[i]);
/******/ var parentJsonpFunction = oldJsonpFunction;
/******/
/******/
/******/ // Load entry module and return exports
/******/ return __webpack_require__(__webpack_require__.s = "./src/index.js");
/******/ })
/************************************************************************/
/******/ ({/***/ "./src/index.js":
/*!**********************!*\!*** ./src/index.js ***!\**********************/
/*! no static exports found */
/***/ (function(module, exports, __webpack_require__) {// 异步导入该 hello 函数
__webpack_require__.e(/*! import() */ 0).then(__webpack_require__.bind(null, /*! ./hello */ "./src/hello.js")).then(({default: hello})=>{// 执行异步函数hello("小虫");
});/***/ })/******/ });
可以看到，webpack4 在全局 window 中声明一个全局 webpackJsonp 变量用来存储异步依赖。
有小伙伴要说了，这有什么问题呢？
如果你导入的是一个第三方依赖，它在全局 window 中声明一个全局 webpackJsonp 变量用来存储异步依赖，而你的项目中也是一样的操作，那么这个全局 webpackJsonp 变量就会被污染了，程序就会出现异常情况。
所以为了避免这种异常情况的发生，当我们开发一个第三方依赖库给别人用的时候，如果我们的库中有异步模块，我们就需要修改一下这个默认全局 webpackJsonp 变量的名称。
修改起来也是很简单，我们直接修改一下 webpack.config.js 配置：
module.exports = {output: {publicPath: "./dist/",jsonpFunction: "webpackJsonp_webpack_node2", // 替换全局 webpackJsonp 变量的名称，名字最好能唯一},devtool: false,node: false, // 关闭 nodejs-polyfill
};
这样打包出来后，就不会出现全局 webpackJsonp 变量污染的情况了，小伙伴可以试试哦！
webpack5
正因为全局 webpackJsonp 变量经常被污染，webpack5 去除了 jsonpFunction 配置，换成了 output.chunkLoadingGlobal 配置：
output.chunkLoadingGlobal
string = 'webpackChunkwebpack'webpack 用于加载 chunk 的全局变量。
webpack.config.js
module.exports = {//...output: {//...chunkLoadingGlobal: 'myCustomFunc',}, };
默认为 webpackChunk+(package.json 中的 name 属性值)，在我们 webpack-node1 项目中， 全局 webpackJsonp 变量的名称为 webpackChunkwebpack_node1，小伙伴可以试一下哦！
webpack5 源码 node_modules/webpack/lib/config/defaults.js 第 885 行：
F(output, "chunkLoadingGlobal", () =>Template.toIdentifier("webpackChunk" +Template.toIdentifier(/** @type {NonNullable<Output["uniqueName"]>} */ (output.uniqueName))));
总结
不得不说，webpack5 修复了很多之前留下的坑，配置变得更简单了，如果可以的话，建议升级一下项目的 webpack 版本，可以带来很多性能的优化和避免一些程序异常的发生。
希望以上的分享能够给你带来一些小小的帮助。
