@runopencode/ngx-http-client

This library provides Angular module for easy integration of @runopencode/http into Angular project. You can read more about @runopencode/http in its README.md file.

Installation

Library is available on NPM, so you can install it via NPM or Yarn.

npm i --save @runopencode/ngx-http-client

Within your Angular project, you can import HttpClientModule from @runopencode/ngx-http-client module and register it.

import {NgxHttpClientModule} from '@runopencode/ngx-http-client';

@NgModule({
    imports: [
        NgxHttpClientModule.forRoot({
            // optional configuration
        }),
    ],
})
export class AppModule {
}

Note that NgxHttpClientModule should be imported only once in your application with forRoot method (usually in your top application module).

Configuration

NgxHttpClientModule.forRoot method accepts optional configuration object. Configuration object has the following properties:

• adapter, default value is fetch - by default, fetch API is used as HTTP adapter. However, you may choose to use angular adapter instead, or any other adapter which implements HttpAdapterInterface from @runopencode/http package. In that case, you must register your adapter within Angular's DI container and pass its name/injection token as a value.
• interceptors, default value is empty array - you may create your own interceptors and register them here. Interceptors must be decorated with @Injectable decorator and must implement HttpInterceptorInterface from @runopencode/http package. For each provided interceptor, module will register it within Angular's DI container. You may also use functions as interceptors. In that case, function will be registered as interceptor within Angular's DI. Do note that functional interceptors are useful only for simple tasks, and if you need to inject some dependencies into your interceptor, you should use class-based interceptor instead (function with the state, or using inject() does not conform with functional programing paradigm).
• guessContentType, default value is true - when set to true, ContentTypeInterceptor from @runopencode/http package will be registered as interceptor automatically. This interceptor will set Content-Type header based on request body.

Available injection tokens

• NGX_HTTP_CLIENT - injection token for HTTP client. You may use this token to inject HTTP client into your classes if you want to typehint client using interface instead of concrete implementation.
• NGX_HTTP_CLIENT_ADAPTER - injection token for HTTP adapter. Instead of configuring adapter via adapter configuration parameter, you may register your adapter within Angular's DI container with this injection token to be used by HTTP client. However, configuration is preferred way of doing this.
• NGX_HTTP_CLIENT_INTERCEPTOR - injection token for HTTP interceptors. Instead of configuring interceptors via interceptors configuration parameter, you may register your interceptors within Angular's DI container with this injection token to be used by HTTP client. Make sure that you register your interceptors as multi-injection tokens (multi: true).

Usage

Once you have imported NgxHttpClientModule into your application, you can inject HttpClientInterface into your classes and use it to execute HTTP requests.

import {
    HttpClientInterface,
    HttpResponseInterface
} from '@runopencode/http';
import {
    Inject,
    Injectable,
} from '@angular/core';

import { NGX_HTTP_CLIENT } from '@runopencode/ngx-http-client';
import { Observable }      from 'rxjs';
import { map }             from 'rxjs/operators';

@Injectable()
export class PostRepository {

    private readonly _client: HttpClientInterface;

    public constructor(@Inject(NGX_HTTP_CLIENT) client: HttpClientInterface) {
        this._client = client;
    }

    public async getPosts(): Observable<Post[]> {
        return this._client.get<PostPayload[]>('https://jsonplaceholder.typicode.com/posts').pipe(map(/* ... */));
    }

}

TODO

• [ ] Write tests.