https://github.com/ts-stack/di
Dependency injection library for TypeScript projects.
https://github.com/ts-stack/di
dependency-injection di typescript
Last synced: 14 days ago
JSON representation
Dependency injection library for TypeScript projects.
- Host: GitHub
- URL: https://github.com/ts-stack/di
- Owner: ts-stack
- Created: 2018-09-16T11:45:02.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2023-01-05T07:13:06.000Z (over 2 years ago)
- Last Synced: 2025-05-04T09:40:33.616Z (17 days ago)
- Topics: dependency-injection, di, typescript
- Language: TypeScript
- Homepage:
- Size: 1.02 MB
- Stars: 9
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
Dependency injection library for JavaScript and TypeScript. It is an extraction of the Angular's dependency injection which means that it's feature complete, fast, reliable and well tested. Also - retrieve all API documentation with example code.
Up-to-date with Angular 4.4.7, but with support DI to inherited class (when the child class does not have a constructor, while the parent class has it), and with exported `makeDecorator()`, `makeParamDecorator()`, `makePropDecorator()`, `makePropTypeDecorator()`, `reflector`, `Type` (see [reflector test](test/reflector.spec.ts)).
## Install
```bash
npm i @ts-stack/di
```
Also you need to install `reflect-metadata` module:
```bash
npm i reflect-metadata
```
Then, in `tsconfig.json` file, for `compilerOptions` you need to set `experimentalDecorators` and `emitDecoratorMetadata` to `true`:
```json
{
"compilerOptions": {
// ...
"experimentalDecorators": true,
"emitDecoratorMetadata": true
}
}
```
## Example usage
```ts
import 'reflect-metadata';
import { ReflectiveInjector, Injectable } from '@ts-stack/di';
@Injectable()
class UsefulService {
}
@Injectable()
class NeedsService {
constructor(public service: UsefulService) {}
}
const injector = ReflectiveInjector.resolveAndCreate([NeedsService, UsefulService]);
const needsService = injector.get(NeedsService);
expect(needsService instanceof NeedsService).toBe(true);
expect(needsService.service instanceof UsefulService).toBe(true);
```
For more examples, see the [tests for @ts-stack/di](test/reflective_injector.spec.ts).
## API
For full documentation check Angular DI docs:
- [Dependency Injection](https://v4.angular.io/guide/dependency-injection)
- [Hierarchical Dependency Injectors](https://v4.angular.io/guide/hierarchical-dependency-injection)
- [Dependency Injection in action](https://v4.angular.io/guide/dependency-injection-in-action)