nodejs require-override

Helper functions to override the require logic of nodejs.

How to use

Override

With this function you can override the load logic with a custom logic. The method needs to return the loaded module. To revert back to the previous logic use the current function.

1/**
2 * Override the current load logic.
3 *
4 * @param isOverride A condition used to check whether to override Module._load.
5 * @param resolveOverride A function used to override Module._load result.
6 * @returns A restore to previous state method.
7 */
8function override(
9  isOverride: (request: string, parent: ParentType) => boolean,
10  resolveOverride: (request: string, parent: ParentType, current: () => unknown) => unknown
11): () => void;

Log

With this function you can log out the loaded packages. The filter regexp is used to filter out the names of the logged packages.

1/**
2 * Logs resolve requests for given packages.
3 *
4 * @param filter Filter for package requests.
5 * @returns A restore to previous state method.
6 */
7function log(filter: RegExp): () => void;

Cache

With this function you can cache and return the packages. The filter regexp is used to filter out the names of the cached packages. If a package is not cached, the previous logic is used, if it was cached it will return the cached package.

Already cached packages will ignore the node_modules structure.

This is useful to make sure that packages loaded by any package will be the same version, this way static variables, decorators will be working across loaded instances.

1/**
2 * Cache resolve results for given packages.
3 *
4 * @param filter Filter for package requests.
5 * @returns A restore to previous state method.
6 */
7function cache(filter: RegExp): () => void;