Security News
NIST Misses 2024 Deadline to Clear NVD Backlog
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.
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.
Just-in-Time Typescript and ESM support for Node.js.
[!IMPORTANT] This is the development branch for jiti v2. Check out jiti/v1 for latest stable docs and unjs/jiti#174 for the v2 roadmap.
require()
import()
You can use jiti
CLI to quickly run any script with Typescript and native ESM support!
npx jiti ./index.ts
# or
jiti ./index.ts
// ESM
import { createJiti } from "jiti";
const jiti = createJiti(import.meta.url);
// CommonJS
const { createJiti } = require("jiti");
const jiti = createJiti(__filename);
// jiti.import() acts like import() with Typescript support
await jiti.import("./path/to/file.ts");
// jiti() acts like require() with Typescript and (non async) ESM support
jiti("./path/to/file.ts");
You can also pass options as second argument:
const jiti = createJiti(import.meta.url, { debug: true });
You can globally register jiti using global hooks.
Note: This is an experimental approach and only tested to work on Node.js > 20. I don't recommend it and unless you have to, please prefer explicit method.
import "jiti/register";
Or:
node --import jiti/register index.ts
debug
false
JITI_DEBUG
Enable debug to see which files are transpiled
fsCache
true
JITI_FS_CACHE
Filesystem source cache (enabled by default)
By default (when is true
), jiti uses node_modules/.cache/jiti
(if exists) or {TMP_DIR}/node-jiti
.
Note: It is recommended to keep this option enabled for better performance.
moduleCache
true
JITI_MODULE_CACHE
Runtime module cache (enabled by default).
Disabling allows editing code and importing same module multiple times.
When enabled, jiti integrates with Node.js native CommonJS cache store.
transform
Transform function. See src/babel for more details
sourceMaps
false
JITI_SOURCE_MAPS
Add inline source map to transformed source for better debugging.
interopDefault
false
Return the .default
export of a module at the top-level.
alias
JITI_ALIAS
Custom alias map used to resolve ids.
nativeModules
JITI_NATIVE_MODULES
List of modules (within node_modules
) to always use native require for them.
transformModules
JITI_TRANSFORM_MODULES
List of modules (within node_modules
) to transform them regardless of syntax.
experimentalBun
process.versions.bun
exists (Bun runtime)JITI_EXPERIMENTAL_BUN
Enable experimental native Bun support for transformations.
corepack enable
pnpm install
pnpm dev
pnpm jiti ./test/path/to/file.ts
Published under the MIT license.
Made by @pi0 and community 💛
FAQs
Runtime typescript and ESM support for Node.js
The npm package jiti receives a total of 13,294,327 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
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.
Security News
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
Security News
The Socket Research team breaks down a malicious npm package targeting the legitimate DOMPurify library. It uses obfuscated code to hide that it is exfiltrating browser and crypto wallet data.