Socket
Socket
Sign inDemoInstall

jiti

Package Overview
Dependencies
0
Maintainers
1
Versions
82
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    jiti

Runtime typescript and ESM support for Node.js (CommonJS)


Version published
Weekly downloads
14M
increased by2.82%
Maintainers
1
Install size
1.17 MB
Created
Weekly downloads
 

Package description

What is jiti?

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.

What are jiti's main functionalities?

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')

Other packages similar to jiti

Changelog

Source

1.6.2 (2021-03-05)

Bug Fixes

  • support class property syntax for esm (64b1636)

Readme

Source

jiti

Runtime typescript and ESM support for Node.js (CommonJS)

version downloads size

Features

  • Stable typescript and esm syntax support
  • Provide sync interface to replace require
  • Super slim and zero dependency
  • Syntax detect to avoid extra transform
  • CommonJS cache integration
  • Filesystem transpile cache + V8 compile cache

Usage

Programmatic

const jiti = require('jiti')(__filename)

jiti('./path/to/file.ts')

You can also pass options as second argument:

const jiti = require('jiti')(__filename, { debug: true })

CLI

jiti index.ts
# or npx jiti index.ts

Register require hook

node -r jiti/register index.ts

Alternatively, you can register jiti as a require hook programmatically:

const jiti = require('jiti')()
const unregister = jiti.register()

Options

debug

  • Type: Boolean
  • Default: false
  • Environment Variable: JITI_DEBUG

Enable debug to see which files are transpiled

cache

  • Type: Boolean | String
  • Default: true
  • Environment Vriable: JITI_CACHE

Use transpile cache

If set to true will use node_modules/.cache/jiti (if exists) or {TMP_DIR}/node-jiti

transform

  • Type: Function
  • Default: Babel (lazy loaded)

Transform function. See src/babel for more details

Compared to Alternatives

standard-things/esm

  • + Much more stable thanks to babel
  • + Less low level operations
  • + Typescript support
  • - Slower (without cache)

babel-register

  • + Smaller install size (~1M vs ~11M with same plugins)
  • + Configured out of the box
  • + Smart syntax detect to avoid unnecessary transpilation
  • + Does not ignores node_modules. ESM everywhere yay!
  • + Embeddable

esbuild

  • + No native dependency
  • + More stable thanks to babel
  • - Slower
  • + Embeddable

ts-node

  • + Support both esm and typescript
  • / No typechecking support / Faster
  • + Smart syntax detect to avoid unnecessary transpilation

Native ESM Support (MJS)

  • It is not (yet) landed as a stable feature
  • No typescript support
  • Limitted to .mjs files with different executation context (no __filename, require, etc)

Bundlers (rollup, webpack, snowpack, etc)

Meanwhile it would be much better making an optimized bundle to deploy to production or as npm package, using bundler setup and watching is frustrating during project development that's where jiti (or similar tools like ts-node) would be more convenient.

Note: However currently only babel transform is supported, configurable transform support is in the roadmap so using esbuild or other solutions would be possible.

Development

  • Clone Repo
  • Run yarn
  • Run yarn build
  • Run yarn dev
  • Run node ./test/jiti.js

Roadmap

  • Basic working
  • Syntax detect and fallback to CJS require
  • Improve project build system
  • File system cache
  • Configurable transform
  • Add tests
  • Support node -r jiti
  • esbuild support

License

MIT. Made with 💖

FAQs

Last updated on 05 Mar 2021

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.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc