Files
OpenMaopaoya/frontend-uni/node_modules/tapable/lib/SyncHook.js
T

96 lines
2.7 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").UnsetAdditionalOptions} UnsetAdditionalOptions */
/** @typedef {import("./Hook").CompileOptions<EXPECTED_ANY, EXPECTED_ANY, EXPECTED_ANY>} CompileOptions */
/** @typedef {import("./HookCodeFactory").ContentOptions} ContentOptions */
/**
* @template T
* @typedef {import("./Hook").AsArray<T>} AsArray
*/
/**
* @template {EXPECTED_ANY[]} T
* @typedef {import("./Hook").ArgumentNames<T>} ArgumentNames
*/
/**
* Mirror of the `SyncHook` class declared in `tapable.d.ts` for use as the
* factory function's return type, so `new SyncHook(...)` resolves to the
* specific subclass type instead of the generic `Hook`.
* @template T
* @template [R=void]
* @template [AdditionalOptions=UnsetAdditionalOptions]
* @typedef {import("../tapable").SyncHook<T, R, AdditionalOptions>} SyncHookType
*/
class SyncHookCodeFactory extends HookCodeFactory {
/**
* @param {ContentOptions} options content generation options
* @returns {string} generated body code
*/
content({ onError, onDone, rethrowIfPossible }) {
return this.callTapsSeries({
onError: (i, err) => onError(err),
onDone,
rethrowIfPossible
});
}
}
const factory = new SyncHookCodeFactory();
const TAP_ASYNC = () => {
throw new Error("tapAsync is not supported on a SyncHook");
};
const TAP_PROMISE = () => {
throw new Error("tapPromise is not supported on a SyncHook");
};
/**
* @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=void]
* @template [AdditionalOptions=UnsetAdditionalOptions]
* @param {ArgumentNames<AsArray<T>>=} args argument names of the hook
* @param {string=} name name of the hook
* @returns {SyncHookType<T, R, AdditionalOptions>} a new SyncHook instance
*/
function SyncHook(
args = /** @type {ArgumentNames<AsArray<T>>} */ (/** @type {unknown} */ ([])),
name = undefined
) {
const hook = new Hook(args, name);
hook.constructor = SyncHook;
hook.tapAsync = TAP_ASYNC;
hook.tapPromise = TAP_PROMISE;
hook.compile = COMPILE;
return /** @type {SyncHookType<T, R, AdditionalOptions>} */ (
/** @type {unknown} */ (hook)
);
}
/** @type {EXPECTED_ANY} */
SyncHook.prototype = null;
module.exports = SyncHook;