@boost/module

Load and resolve custom file types at runtime with a more powerful Node.js require replacement.

import { requireModule } from '@boost/module';

const result = requireModule('./some/non-js/file.ts');

Or with next-generation loaders.

node --experimental-loader @boost/module/loader.mjs ./path/to/entry-point.mjs

Features

• CommonJS based importing with requireModule()
• CommonJS interoperability with ESM-like files
• ECMAScript module based importing with a custom ESM loader
• Supported file types: TypeScript (.ts, .tsx)

Installation

yarn add @boost/module

Documentation

• https://boostlib.dev/docs/module
• https://boostlib.dev/api/module

Index

Functions

• interopModule
• registerExtensions
• requireModule
• requireTSModule
• unregisterExtensions

Interfaces

• LoadContext
• LoadResult
• ResolveContext
• ResolveResult

Type Aliases

• LoaderDefaultLoad
• LoaderDefaultResolve
• LoaderLoad
• LoaderResolve
• ModuleLike
• PathLike

Type Aliases

LoaderDefaultLoad

LoaderDefaultLoad: (url: string, context: LoadContext) => Promise<LoadResult>

LoaderDefaultResolve

LoaderDefaultResolve: (specifier: string, context: ResolveContext) => Promise<ResolveResult>

LoaderLoad

LoaderLoad: (url: string, context: LoadContext, defaultLoad: LoaderDefaultLoad) => Promise<LoadResult>

LoaderResolve

LoaderResolve: (specifier: string, context: ResolveContext, defaultResolve: LoaderDefaultResolve) => Promise<ResolveResult>

ModuleLike

ModuleLike<D, N>: N & { __esModule?: boolean; default: D extends void ? N : D }

Return shape of a module. The default export can be typed with the D generic slot, and the named exports can be typed with an object in the N generic slot.

If there is no default export (classic Node.js exports pattern), then void can be passed to the D generic, which will populate the default property with the named exports.

---

Type parameters

• D = unknown
• N: object = {}

PathLike

PathLike: string | { toString: () => string }