|
|
- /*
- MIT License http://www.opensource.org/licenses/mit-license.php
- Author Tobias Koppers @sokra
- */
- "use strict";
-
- const Compiler = require("./Compiler");
- const MultiCompiler = require("./MultiCompiler");
- const NodeEnvironmentPlugin = require("./node/NodeEnvironmentPlugin");
- const WebpackOptionsApply = require("./WebpackOptionsApply");
- const WebpackOptionsDefaulter = require("./WebpackOptionsDefaulter");
- const validateSchema = require("./validateSchema");
- const WebpackOptionsValidationError = require("./WebpackOptionsValidationError");
- const webpackOptionsSchema = require("../schemas/WebpackOptions.json");
- const RemovedPluginError = require("./RemovedPluginError");
- const version = require("../package.json").version;
-
- /** @typedef {import("../declarations/WebpackOptions").WebpackOptions} WebpackOptions */
-
- /**
- * @param {WebpackOptions} options options object
- * @param {function(Error=, Stats=): void=} callback callback
- * @returns {Compiler | MultiCompiler} the compiler object
- */
- const webpack = (options, callback) => {
- const webpackOptionsValidationErrors = validateSchema(
- webpackOptionsSchema,
- options
- );
- if (webpackOptionsValidationErrors.length) {
- throw new WebpackOptionsValidationError(webpackOptionsValidationErrors);
- }
- let compiler;
- if (Array.isArray(options)) {
- compiler = new MultiCompiler(
- Array.from(options).map(options => webpack(options))
- );
- } else if (typeof options === "object") {
- options = new WebpackOptionsDefaulter().process(options);
-
- compiler = new Compiler(options.context);
- compiler.options = options;
- new NodeEnvironmentPlugin({
- infrastructureLogging: options.infrastructureLogging
- }).apply(compiler);
- if (options.plugins && Array.isArray(options.plugins)) {
- for (const plugin of options.plugins) {
- if (typeof plugin === "function") {
- plugin.call(compiler, compiler);
- } else {
- plugin.apply(compiler);
- }
- }
- }
- compiler.hooks.environment.call();
- compiler.hooks.afterEnvironment.call();
- compiler.options = new WebpackOptionsApply().process(options, compiler);
- } else {
- throw new Error("Invalid argument: options");
- }
- if (callback) {
- if (typeof callback !== "function") {
- throw new Error("Invalid argument: callback");
- }
- if (
- options.watch === true ||
- (Array.isArray(options) && options.some(o => o.watch))
- ) {
- const watchOptions = Array.isArray(options)
- ? options.map(o => o.watchOptions || {})
- : options.watchOptions || {};
- return compiler.watch(watchOptions, callback);
- }
- compiler.run(callback);
- }
- return compiler;
- };
-
- exports = module.exports = webpack;
- exports.version = version;
-
- webpack.WebpackOptionsDefaulter = WebpackOptionsDefaulter;
- webpack.WebpackOptionsApply = WebpackOptionsApply;
- webpack.Compiler = Compiler;
- webpack.MultiCompiler = MultiCompiler;
- webpack.NodeEnvironmentPlugin = NodeEnvironmentPlugin;
- // @ts-ignore Global @this directive is not supported
- webpack.validate = validateSchema.bind(this, webpackOptionsSchema);
- webpack.validateSchema = validateSchema;
- webpack.WebpackOptionsValidationError = WebpackOptionsValidationError;
-
- const exportPlugins = (obj, mappings) => {
- for (const name of Object.keys(mappings)) {
- Object.defineProperty(obj, name, {
- configurable: false,
- enumerable: true,
- get: mappings[name]
- });
- }
- };
-
- exportPlugins(exports, {
- AutomaticPrefetchPlugin: () => require("./AutomaticPrefetchPlugin"),
- BannerPlugin: () => require("./BannerPlugin"),
- CachePlugin: () => require("./CachePlugin"),
- ContextExclusionPlugin: () => require("./ContextExclusionPlugin"),
- ContextReplacementPlugin: () => require("./ContextReplacementPlugin"),
- DefinePlugin: () => require("./DefinePlugin"),
- Dependency: () => require("./Dependency"),
- DllPlugin: () => require("./DllPlugin"),
- DllReferencePlugin: () => require("./DllReferencePlugin"),
- EnvironmentPlugin: () => require("./EnvironmentPlugin"),
- EvalDevToolModulePlugin: () => require("./EvalDevToolModulePlugin"),
- EvalSourceMapDevToolPlugin: () => require("./EvalSourceMapDevToolPlugin"),
- ExtendedAPIPlugin: () => require("./ExtendedAPIPlugin"),
- ExternalsPlugin: () => require("./ExternalsPlugin"),
- HashedModuleIdsPlugin: () => require("./HashedModuleIdsPlugin"),
- HotModuleReplacementPlugin: () => require("./HotModuleReplacementPlugin"),
- IgnorePlugin: () => require("./IgnorePlugin"),
- LibraryTemplatePlugin: () => require("./LibraryTemplatePlugin"),
- LoaderOptionsPlugin: () => require("./LoaderOptionsPlugin"),
- LoaderTargetPlugin: () => require("./LoaderTargetPlugin"),
- MemoryOutputFileSystem: () => require("./MemoryOutputFileSystem"),
- Module: () => require("./Module"),
- ModuleFilenameHelpers: () => require("./ModuleFilenameHelpers"),
- NamedChunksPlugin: () => require("./NamedChunksPlugin"),
- NamedModulesPlugin: () => require("./NamedModulesPlugin"),
- NoEmitOnErrorsPlugin: () => require("./NoEmitOnErrorsPlugin"),
- NormalModuleReplacementPlugin: () =>
- require("./NormalModuleReplacementPlugin"),
- PrefetchPlugin: () => require("./PrefetchPlugin"),
- ProgressPlugin: () => require("./ProgressPlugin"),
- ProvidePlugin: () => require("./ProvidePlugin"),
- SetVarMainTemplatePlugin: () => require("./SetVarMainTemplatePlugin"),
- SingleEntryPlugin: () => require("./SingleEntryPlugin"),
- SourceMapDevToolPlugin: () => require("./SourceMapDevToolPlugin"),
- Stats: () => require("./Stats"),
- Template: () => require("./Template"),
- UmdMainTemplatePlugin: () => require("./UmdMainTemplatePlugin"),
- WatchIgnorePlugin: () => require("./WatchIgnorePlugin")
- });
- exportPlugins((exports.dependencies = {}), {
- DependencyReference: () => require("./dependencies/DependencyReference")
- });
- exportPlugins((exports.optimize = {}), {
- AggressiveMergingPlugin: () => require("./optimize/AggressiveMergingPlugin"),
- AggressiveSplittingPlugin: () =>
- require("./optimize/AggressiveSplittingPlugin"),
- ChunkModuleIdRangePlugin: () =>
- require("./optimize/ChunkModuleIdRangePlugin"),
- LimitChunkCountPlugin: () => require("./optimize/LimitChunkCountPlugin"),
- MinChunkSizePlugin: () => require("./optimize/MinChunkSizePlugin"),
- ModuleConcatenationPlugin: () =>
- require("./optimize/ModuleConcatenationPlugin"),
- OccurrenceOrderPlugin: () => require("./optimize/OccurrenceOrderPlugin"),
- OccurrenceModuleOrderPlugin: () =>
- require("./optimize/OccurrenceModuleOrderPlugin"),
- OccurrenceChunkOrderPlugin: () =>
- require("./optimize/OccurrenceChunkOrderPlugin"),
- RuntimeChunkPlugin: () => require("./optimize/RuntimeChunkPlugin"),
- SideEffectsFlagPlugin: () => require("./optimize/SideEffectsFlagPlugin"),
- SplitChunksPlugin: () => require("./optimize/SplitChunksPlugin")
- });
- exportPlugins((exports.web = {}), {
- FetchCompileWasmTemplatePlugin: () =>
- require("./web/FetchCompileWasmTemplatePlugin"),
- JsonpTemplatePlugin: () => require("./web/JsonpTemplatePlugin")
- });
- exportPlugins((exports.webworker = {}), {
- WebWorkerTemplatePlugin: () => require("./webworker/WebWorkerTemplatePlugin")
- });
- exportPlugins((exports.node = {}), {
- NodeTemplatePlugin: () => require("./node/NodeTemplatePlugin"),
- ReadFileCompileWasmTemplatePlugin: () =>
- require("./node/ReadFileCompileWasmTemplatePlugin")
- });
- exportPlugins((exports.debug = {}), {
- ProfilingPlugin: () => require("./debug/ProfilingPlugin")
- });
- exportPlugins((exports.util = {}), {
- createHash: () => require("./util/createHash")
- });
-
- const defineMissingPluginError = (namespace, pluginName, errorMessage) => {
- Object.defineProperty(namespace, pluginName, {
- configurable: false,
- enumerable: true,
- get() {
- throw new RemovedPluginError(errorMessage);
- }
- });
- };
-
- // TODO remove in webpack 5
- defineMissingPluginError(
- exports.optimize,
- "UglifyJsPlugin",
- "webpack.optimize.UglifyJsPlugin has been removed, please use config.optimization.minimize instead."
- );
-
- // TODO remove in webpack 5
- defineMissingPluginError(
- exports.optimize,
- "CommonsChunkPlugin",
- "webpack.optimize.CommonsChunkPlugin has been removed, please use config.optimization.splitChunks instead."
- );
|