ConteneurJS

TypeScript Inversion of Control container for Dependency Injection.

It supports Functions and Classes, Scoped Containers, Transient and Singleton Strategies, and Cyclic Dependency Detection.

• 🪶 0.9KB minified
• 🧩 Zero dependencies
• 📦 TypeScript and ESM
• 🧪 100% Test Coverage
• 🌐 Runtime Agnostic (Browser, Node, Deno, Bun, AWS, Vercel, Cloudflare, ..)

🚀 Usage

import { createContainer } from 'conteneur'

const container = createContainer()

container.register({
  dataService: [createDataService],
  reportService: [createReportService],
})

const reportService = container.resolve('reportService')

reportService.getReport() // Report: data from DataService

Full TypeScript example with resolution, injection, scoping: docs/typescript-example.md

🔋 APIs

Creates a new container.

createContainer(options?: ContainerOptions): Container

options.defaultStrategy : transient (default) - singleton

register

Registers multiple resolvers within the container.

container.register(entries: ResolverEntries): void

options.strategy : transient (default) - singleton

resolve

Injects a function or a class registered in the container with its dependencies and returns the result.

container.resolve<Key  extends keyof Container>(key: Key): Container[Key]

inject

Injects a function or a class not registered in the container with its dependencies and returns the result.

container.inject<T>(target: FunctionFactory<T>): T

createScope

Creates a new scope within the container.

container.createScope():  void

📊 Comparisons

| | ConteneurJS | InversifyJS | TSyringe | TypeDI | Awilix | |---------------------|-------------|-------------|-----------|----------|-----------| | TS + ESM + Tests | ✅ | ✅ | ✅ | ✅ | ✅ | | Dependency Count | 🥇 0 | 🥈 1 | 🥈 1 | 🥇 0 | 🥉 2 | | Runtime Agnostic | ✅ | ❌ | ❌ | ❌ | ❌ | | Function Support | ✅ | ❌ | ❌ | ❌ | ✅ | | Class Support | ✅ | ✅ | ✅ | ✅ | ✅ | | Value Support | ✅ | ❌ | ❌ | ❌ | ✅ | | Decorator Free | ✅ | ❌ | ❌ | ❌ | ✅ | | Lifetime Management | ✅ | ✅ | ✅ | ✅ | ✅ | | Scoped Container | ✅ | ✅ | ✅ | ❌ | ✅ | | Size (min) | 🥇 1.1kb | ➖ 49.9kb | ➖ 15.6kb | 🥈 9.5kb | 🥉 12.5kb | | Size (min + gzip) | 🥇 0.6kb | ➖ 11.1kb | ➖ 4.7kb | 🥈 2.7kb | 🥉 4.6kb |

📃 Inspiration

This project was inspired by jeffijoe/awilix and builds upon its core concepts.