/* MIT License http://www.opensource.org/licenses/mit-license.php Author Tobias Koppers @sokra */ "use strict"; const Hook = require("./Hook"); const HookCodeFactory = require("./HookCodeFactory"); /** @typedef {import("./Hook").EXPECTED_ANY} EXPECTED_ANY */ /** @typedef {import("./Hook").EXPECTED_FUNCTION} EXPECTED_FUNCTION */ /** @typedef {import("./Hook").CompileOptions} CompileOptions */ /** @typedef {import("./Hook").UnsetAdditionalOptions} UnsetAdditionalOptions */ /** @typedef {import("./HookCodeFactory").ContentOptions} ContentOptions */ /** * @template {EXPECTED_ANY[]} T * @typedef {import("./Hook").ArgumentNames} ArgumentNames */ /** * @template T * @typedef {import("./Hook").AsArray} AsArray */ /** * Mirror of the `AsyncSeriesWaterfallHook` class declared in `tapable.d.ts` * for use as the factory function's return type, so * `new AsyncSeriesWaterfallHook(...)` resolves to the specific subclass type * instead of the generic `Hook`. * @template T * @template [R=AsArray[0]] * @template [AdditionalOptions=UnsetAdditionalOptions] * @typedef {import("../tapable").AsyncSeriesWaterfallHook} AsyncSeriesWaterfallHookType */ class AsyncSeriesWaterfallHookCodeFactory extends HookCodeFactory { /** * @param {ContentOptions} options content generation options * @returns {string} generated body code */ content({ onError, onResult }) { return this.callTapsSeries({ onError: (i, err, next, doneBreak) => onError(err) + doneBreak(true), onResult: (i, result, next) => { let code = ""; code += `if(${result} !== undefined) {\n`; code += `${/** @type {string[]} */ (this._args)[0]} = ${result};\n`; code += "}\n"; code += next(); return code; }, onDone: () => onResult(/** @type {string[]} */ (this._args)[0]) }); } } const factory = new AsyncSeriesWaterfallHookCodeFactory(); /** * @this {Hook} * @param {CompileOptions} options compile options * @returns {EXPECTED_FUNCTION} the compiled call function */ function COMPILE(options) { factory.setup(this, options); return factory.create(options); } /** * @constructor * @template T * @template [R=AsArray[0]] * @template [AdditionalOptions=UnsetAdditionalOptions] * @param {ArgumentNames>=} args argument names of the hook * @param {string=} name name of the hook * @returns {AsyncSeriesWaterfallHookType} a new AsyncSeriesWaterfallHook instance */ function AsyncSeriesWaterfallHook( args = /** @type {ArgumentNames>} */ (/** @type {unknown} */ ([])), name = undefined ) { if (args.length < 1) { throw new Error("Waterfall hooks must have at least one argument"); } const hook = new Hook(args, name); hook.constructor = AsyncSeriesWaterfallHook; hook.compile = COMPILE; // @ts-expect-error for performance reasons hook._call = undefined; hook.call = undefined; return /** @type {AsyncSeriesWaterfallHookType} */ ( /** @type {unknown} */ (hook) ); } /** @type {EXPECTED_ANY} */ AsyncSeriesWaterfallHook.prototype = null; module.exports = AsyncSeriesWaterfallHook;