12.1K ·GitHub
What is this?
InversifyJS is a lightweight inversion of control (IoC) container for TypeScript and JavaScript apps — a library that decides how your classes receive the objects they depend on.
InversifyJS is a lightweight inversion of control (IoC) container for TypeScript and JavaScript apps — a library that decides how your classes receive the objects they depend on.What does an IoC container actually do in practice?It uses a class constructor to identify and inject a class's dependencies, so classes are handed the objects they need instead of creating them internally. The API is built to encourage the best OOP and IoC practices.
It uses a class constructor to identify and inject a class's dependencies, so classes are handed the objects they need instead of creating them internally. The API is built to encourage the best OOP and IoC practices.How do I add it to my project?Install the inversify package from npm, then follow the documentation site linked in the README to declare your bindings and resolve classes. The project ships both CommonJS and ESM builds.
Install the inversify package from npm, then follow the documentation site linked in the README to declare your bindings and resolve classes. The project ships both CommonJS and ESM builds.Do I need TypeScript to use it, or does plain JavaScript work?It targets JavaScript and Node.js apps and is powered by TypeScript, so plain JavaScript works but TypeScript gives you the most. It is an in-app library — there is no server or extra runtime to deploy.
It targets JavaScript and Node.js apps and is powered by TypeScript, so plain JavaScript works but TypeScript gives you the most. It is an in-app library — there is no server or extra runtime to deploy.Anything I should know about this repo before diving in?Yes — the project is moving to the inversify monorepo: new issues, pull requests and releases are published there, so watch github.com/inversify/monorepo instead of this one.
Yes — the project is moving to the inversify monorepo: new issues, pull requests and releases are published there, so watch github.com/inversify/monorepo instead of this one.Is this aimed at framework builders or everyday app developers?Everyday JavaScript developers: the README positions it as a tool that helps them write code with good OO design, with a friendly API and little runtime overhead.
Everyday JavaScript developers: the README positions it as a tool that helps them write code with good OO design, with a friendly API and little runtime overhead.Can I use it for free, including commercially?Yes. It is MIT licensed — free of charge to use, copy, modify, merge, publish and sublicense, with no paid tiers.
Yes. It is MIT licensed — free of charge to use, copy, modify, merge, publish and sublicense, with no paid tiers.Why build a DI container instead of just instantiating classes where you need them?Because class-based OO in JavaScript is easy to get wrong: the README argues these features are dangerous without good OO design (SOLID, Composite Reuse), and since OO design is difficult, the authors created InversifyJS to help.
Because class-based OO in JavaScript is easy to get wrong: the README argues these features are dangerous without good OO design (SOLID, Composite Reuse), and since OO design is difficult, the authors created InversifyJS to help.What did the authors optimize the library for?Four goals: help developers write code that adheres to the SOLID principles, encourage the best OOP and IoC practices, add as little runtime overhead as possible, and provide a state of the art development experience.
Four goals: help developers write code that adheres to the SOLID principles, encourage the best OOP and IoC practices, add as little runtime overhead as possible, and provide a state of the art development experience.Is it battle-tested, or a hobby project?It has been around since 2015 (copyright 2015-2017 by creator Remo H. Jansen), has about 12,000 GitHub stars, and the README lists companies using it in production, though their names appear only as logos.
It has been around since 2015 (copyright 2015-2017 by creator Remo H. Jansen), has about 12,000 GitHub stars, and the README lists companies using it in production, though their names appear only as logos.What do other framework authors say about it?Nate Kohari, author of the Ninject DI framework, praised how its ES7 metadata approach works around JavaScript's lack of RTTI, and MobX creator Michel Weststrate wrote that dependency injection like InversifyJS works nicely.
Nate Kohari, author of the Ninject DI framework, praised how its ES7 metadata approach works around JavaScript's lack of RTTI, and MobX creator Michel Weststrate wrote that dependency injection like InversifyJS works nicely.What are similar projects?domain-driven-hexagon, awesome-low-level-design, nodebestpractices, clean-code-php, Fuse, react-in-patterns, COLA, hono
domain-driven-hexagon, awesome-low-level-design, nodebestpractices, clean-code-php, Fuse, react-in-patterns, COLA, honoWhich topics is it in?object-oriented-programming, dependency-injection, design-patterns, lightweight, best-practices, developers, backend, npm, nodejs, library, typescript, javascript
object-oriented-programming, dependency-injection, design-patterns, lightweight, best-practices, developers, backend, npm, nodejs, library, typescript, javascript