99 lines
3.1 KiB
JavaScript
99 lines
3.1 KiB
JavaScript
/*
|
|
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<EXPECTED_ANY, EXPECTED_ANY, EXPECTED_ANY>} CompileOptions */
|
|
/** @typedef {import("./Hook").UnsetAdditionalOptions} UnsetAdditionalOptions */
|
|
/** @typedef {import("./HookCodeFactory").ContentOptions} ContentOptions */
|
|
/**
|
|
* @template {EXPECTED_ANY[]} T
|
|
* @typedef {import("./Hook").ArgumentNames<T>} ArgumentNames
|
|
*/
|
|
/**
|
|
* @template T
|
|
* @typedef {import("./Hook").AsArray<T>} 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<T>[0]]
|
|
* @template [AdditionalOptions=UnsetAdditionalOptions]
|
|
* @typedef {import("../tapable").AsyncSeriesWaterfallHook<T, R, AdditionalOptions>} 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<EXPECTED_ANY, EXPECTED_ANY, EXPECTED_ANY>}
|
|
* @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<T>[0]]
|
|
* @template [AdditionalOptions=UnsetAdditionalOptions]
|
|
* @param {ArgumentNames<AsArray<T>>=} args argument names of the hook
|
|
* @param {string=} name name of the hook
|
|
* @returns {AsyncSeriesWaterfallHookType<T, R, AdditionalOptions>} a new AsyncSeriesWaterfallHook instance
|
|
*/
|
|
function AsyncSeriesWaterfallHook(
|
|
args = /** @type {ArgumentNames<AsArray<T>>} */ (/** @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<T, R, AdditionalOptions>} */ (
|
|
/** @type {unknown} */ (hook)
|
|
);
|
|
}
|
|
|
|
/** @type {EXPECTED_ANY} */
|
|
AsyncSeriesWaterfallHook.prototype = null;
|
|
|
|
module.exports = AsyncSeriesWaterfallHook;
|