Node.js require() hook for loading ESM & TypeScript using esbuild.
- Transforms ESM & TypeScript to CommonJS on demand
- Supports TS extensions
.cjs&.mjs(.cts&.mts) - Cached for performance boost
- Supports Node.js v12.16.2+
- Handles
node:import prefixes - Resolves
tsconfig.jsonpaths
Tip:
cjs-loader doesn't hook into dynamic
import()calls.Use this with esm-loader for
import()support. Alternatively, use tsx to handle them both automatically.
npm install --save-dev @esbuild-kit/cjs-loaderPass @esbuild-kit/cjs-loader into the --require flag
node -r @esbuild-kit/cjs-loader ./file.jsThe following properties are used from tsconfig.json in the working directory:
strict: Whether to transform to strict modejsx: Whether to transform JSXWarning: When set to
preserve, the JSX syntax will remain untransformed. To prevent Node.js from throwing a syntax error, chain another Node.js loader that can transform JSX to JS.jsxFactory: How to transform JSXjsxFragmentFactory: How to transform JSX FragmentsjsxImportSource: Where to import JSX functions fromallowJs: Whether to apply the tsconfig to JS filespaths: For resolving aliases
By default, tsconfig.json will be detected from the current working directory.
To set a custom path, use the ESBK_TSCONFIG_PATH environment variable:
ESBK_TSCONFIG_PATH=./path/to/tsconfig.custom.json node -r @esbuild-kit/cjs-loader ./file.js
Modules transformations are cached in the system cache directory (TMPDIR). Transforms are cached by content hash so duplicate dependencies are not re-transformed.
Set environment variable ESBK_DISABLE_CACHE to a truthy value to disable the cache:
ESBK_DISABLE_CACHE=1 node -r @esbuild-kit/cjs-loader ./file.js-
tsx - Node.js runtime powered by esbuild using
@esbuild-kit/cjs-loaderand@esbuild-kit/esm-loader. -
@esbuild-kit/esm-loader - TypeScript to ESM transpiler using the Node.js loader API.
