添加链接
link之家
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
备案 控制台
学习
实践
活动
专区
工具
TVP
写文章

Node.js API

webpack提供了一个可以直接在Node.js运行时使用的Node.js API。

当你需要自定义构建或开发流程时,Node.js API 非常有用,因为此时所有的报告和错误处理都必须自行实现,webpack 仅仅负责编译的部分。所以 stats 配置选项不会在 webpack() 调用中生效。

Installation

要开始使用webpack Node.js API,如果您尚未安装webpack,请首先安装:

npm install --save-dev webpack

然后在您的Node.js脚本中需要webpack模块:

const webpack = require("webpack");
// Or if you prefer ES2015:
import webpack from "webpack";

webpack()

导入的 webpack 函数需要传入一个 webpack 配置对象 ,当同时传入回调函数时就会执行 webpack compiler:

const webpack = require("webpack");
webpack({
  // Configuration Object
}, (err, stats) => {
  if (err || stats.hasErrors()) {
    // Handle errors here
  // Done processing
});

编译错误 err 对象内,而是需要使用 stats.hasErrors() 单独处理,你可以在指南的 错误处理 部分查阅到更多细节。 err 对象只会包含 webpack 相关的问题,比如配置错误等。

请注意 ,您可以 webpack 使用一组配置来提供该功能:

webpack([
  { /* Configuration Object */ },
  { /* Configuration Object */ },
  { /* Configuration Object */ }
], (err, stats) => {
  // ...
});

webpack 不会 并行运行多个配置。每个配置仅在前一个配置完成处理后才处理。要让webpack并行处理它们,您可以使用第三方解决方案,如 parallel-webpack

编译器实例

如果你不向 webpack 执行函数传入回调函数,就会得到一个 webpack Compiler 实例。你可以通过它手动触发 webpack 执行器,或者是让它执行构建并监听变更。和 CLI API 很类似。 Compiler 实例提供了以下方法:

  • .run(callback)
  • .watch(watchOptions, handler)