Package description
The jiti npm package is a runtime TypeScript and ES Module (ESM) loader that allows you to import TypeScript files, ESM, or JSON modules dynamically in a Node.js environment without the need for prior compilation. It is designed to be a zero-config, drop-in replacement for dynamic imports and require calls, providing just-in-time transpilation of code.
Dynamic Import of TypeScript Files
This feature allows you to dynamically import TypeScript files at runtime. The jiti function is called with the current filename to create a context, and then it is used to import a TypeScript module, which is transpiled just-in-time.
const jiti = require('jiti')(__filename)
const myModule = jiti('./my-module.ts')Dynamic Import of ESM
With this feature, jiti can dynamically import ES Module files. The 'esmResolve' option enables proper resolution of ESM modules, allowing them to be loaded at runtime without prior compilation.
const jiti = require('jiti')(__filename, { esmResolve: true })
const myESMModule = jiti('./my-esm-module.mjs')Dynamic Import of JSON Modules
This feature enables the dynamic import of JSON modules. By using jiti, you can load JSON files at runtime, which can be useful for configuration files or other data that needs to be imported into your application.
const jiti = require('jiti')(__filename)
const config = jiti('./config.json')esbuild-register is a package that uses the esbuild bundler to transpile TypeScript and modern JavaScript on the fly for Node.js. It is similar to jiti in that it allows just-in-time transpilation, but it leverages the fast esbuild compiler.
ts-node is a TypeScript execution engine and REPL for Node.js. It provides on-the-fly transpilation of TypeScript into JavaScript, allowing developers to execute TypeScript directly without pre-compilation. ts-node is widely used and has more configuration options compared to jiti.
babel-register is a Babel hook that transpiles files on the fly when they are required. It is similar to jiti in providing just-in-time transpilation, but it uses Babel, which has a wide range of plugins and is highly configurable.
Changelog
v1.21.0
jiti.import function for async import (#170)jiti.import (#175)v1 branch (0200f63)v1 to renovate branches (2358645)Readme
Runtime Typescript and ESM support for Node.js.
[!IMPORTANT] This is the support branch for jiti v1. Check out jiti/main for the latest version and unjs/jiti#174 for the roadmap.
requireconst jiti = require("jiti")(__filename);
jiti("./path/to/file.ts");
You can also pass options as second argument:
const jiti = require("jiti")(__filename, { debug: true });
jiti index.ts
# or npx jiti index.ts
node -r jiti/register index.ts
Alternatively, you can register jiti as a require hook programmatically:
const jiti = require("jiti")();
const unregister = jiti.register();
debugfalseJITI_DEBUGEnable debug to see which files are transpiled
cachetrueJITI_CACHEUse transpile cache
If set to true will use node_modules/.cache/jiti (if exists) or {TMP_DIR}/node-jiti
esmResolvefalseJITI_ESM_RESOLVEUsing esm resolution algorithm to support import condition.
transformTransform function. See src/babel for more details
sourceMapsfalseJITI_SOURCE_MAPSAdd inline source map to transformed source for better debugging.
interopDefaultfalseReturn the .default export of a module at the top-level.
aliasJITI_ALIASCustom alias map used to resolve ids.
nativeModulesJITI_NATIVE_MODULESList of modules (within node_modules) to always use native require for them.
transformModulesJITI_TRANSFORM_MODULESList of modules (within node_modules) to transform them regardless of syntax.
experimentalBunprocess.versions.bun exists (Bun runtime)JITI_EXPERIMENTAL_BUNEnable experimental native Bun support for transformations.
corepack enablepnpm installpnpm devpnpm jiti ./test/path/to/file.tsMIT. Made with 💖
FAQs
Runtime typescript and ESM support for Node.js
The npm package jiti receives a total of 12,303,663 weekly downloads. As such, jiti popularity was classified as popular.
We found that jiti demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.