You've successfully subscribed to
Great! Next, complete checkout for full access to
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.
Success! Your billing info is updated.
Billing info update failed.

Using Angular HttpInterceptor with the new HttpClient

Paul Halliday
Paul Halliday

If you haven't seen already, a new HttpClient was shipped with Angular 4.x and this allows us to interact with the HttpInterceptor relatively easy. Why do we need it? Well, you've most likely ran into this issue before...

  • What's the best way to add an Authorization header across all my requests?
  • How can I pre/post process a HTTP request/response?
  • I want to add global error handling, logging, or some other behaviour attached to my HTTP requests.

We'll be looking at how we can best achieve these goals within this article. Let's take the GitHub API as an example.

If I wanted to GET users by a particular username, I could make a Http request like so:

// github.service.ts
import { User } from './../models/user.model';
import { Injectable } from '@angular/core';
import { HttpClient } from '@angular/common/http';

export class GitHubService {
  ROOT_URL = '';
  constructor(private http: HttpClient) {}

  getUserInformation(userId: string) {
    return this.http.get<User>(`${this.ROOT_URL}/users/${userId}`);

This would work fine unauthenticated, but we'd potentially run into rate limiting issues and/or may want to do something that requires authentication. Let's look at how we can intercept this request and add an Authorization token using the HttpInterceptor.

// github.interceptor.ts
import { User } from './../models/user.model';
import { HttpInterceptor, HttpRequest } from '@angular/common/http/';
import { HttpHandler } from '@angular/common/http';

export class GitHubHttpInterceptor implements HttpInterceptor {
  intercept(req: HttpRequest<User>, next: HttpHandler) {
    const newReq = req.clone({
      headers: req.headers.set(
        'token your-auth-token'

    return next.handle(newReq);

Notice how our interceptor is simply just a class that implements the HttpInterceptor interface. This is a function that takes our HttpRequest and returns a new request with the HttpHandler.handle(request) call. We're cloning the request and setting a new header, but arguably we could do anything we wanted to here.

To add this within our application, we'll need to register it within our module's providers array.

import { GitHubHttpInterceptor } from './modules/github/services/github.interceptor';
import { HTTP_INTERCEPTORS } from '@angular/common/http';

  providers: [
      provide: HTTP_INTERCEPTORS,
      useClass: GitHubHttpInterceptor,
      multi: true
export class AppModule {}

The awesome thing about the new HttpClient is that we can create as many HttpInterceptors as we want. If we want to intercept multiple requests, we can set multi: true! :)


Paul Halliday

👋 Want to see more content? Head over to the YouTube channel:!