Configurer HttpClient

HttpClient est disponible par défaut pour l'injection à partir d'Angular v21.

Fournir HttpClient via l'injection de dépendances

Vous pouvez utiliser la fonction utilitaire provideHttpClient pour configurer l'ensemble de fonctionnalités HTTP par défaut ou ajouter des fonctionnalités dans les providers de l'application, dans app.config.ts.

export const appConfig: ApplicationConfig = {
  providers: [provideHttpClient(/* add features here, such as withInterceptors(...) */)],
};

Si votre application utilise plutôt un bootstrap basé sur les NgModules, vous pouvez inclure provideHttpClient dans les providers du NgModule de votre application pour configurer l'ensemble de fonctionnalités HTTP par défaut ou ajouter des fonctionnalités :

@NgModule({
  providers: [provideHttpClient(/* add features here, such as withInterceptors(...) */)],
  // ... other application configuration
})
export class AppModule {}

Vous pouvez ensuite injecter le service HttpClient en tant que dépendance de vos composants, services ou autres classes :

@Service()
export class ConfigService {
  private http = inject(HttpClient);
  // This service can now make HTTP requests via `this.http`.
}

Configurer les fonctionnalités de HttpClient

provideHttpClient accepte une liste de configurations de fonctionnalités optionnelles pour activer ou configurer différents aspects du client. Cette section détaille ces fonctionnalités optionnelles et leur utilisation.

withXhr

export const appConfig: ApplicationConfig = {
  providers: [provideHttpClient(withXhr())],
};

Par défaut, HttpClient utilise l'API fetch pour effectuer les requêtes. La fonctionnalité withXhr fait plutôt utiliser au client l'API XMLHttpRequest.

fetch est une API plus moderne, disponible dans quelques environnements où XMLHttpRequest n'est pas pris en charge. Elle présente toutefois quelques limitations, comme l'absence d'événements de progression pour l'envoi (upload).

withInterceptors(...)

withInterceptors configure l'ensemble des fonctions intercepteurs qui traiteront les requêtes effectuées via HttpClient. Consultez le guide des intercepteurs pour plus d'informations.

withInterceptorsFromDi()

withInterceptorsFromDi inclut l'ancien style d'intercepteurs à base de classes dans la configuration de HttpClient. Consultez le guide des intercepteurs pour plus d'informations.

withRequestsMadeViaParent()

Par défaut, lorsque vous configurez HttpClient avec provideHttpClient dans un injector donné, cette configuration remplace toute configuration de HttpClient éventuellement présente dans l'injector parent.

Lorsque vous ajoutez withRequestsMadeViaParent(), HttpClient est au contraire configuré pour transmettre les requêtes à l'instance de HttpClient de l'injector parent, une fois qu'elles sont passées par les intercepteurs configurés à ce niveau. C'est utile si vous voulez ajouter des intercepteurs dans un injector enfant tout en faisant passer la requête par les intercepteurs de l'injector parent.

withJsonpSupport()

Inclure withJsonpSupport active la méthode .jsonp() de HttpClient, qui effectue une requête GET via la convention JSONP pour charger des données entre domaines.

withXsrfConfiguration(...)

Inclure cette option permet de personnaliser la fonctionnalité de sécurité XSRF intégrée à HttpClient. Consultez le guide de sécurité pour plus d'informations.

withNoXsrfProtection()

Inclure cette option désactive la fonctionnalité de sécurité XSRF intégrée à HttpClient. Consultez le guide de sécurité pour plus d'informations.

Configuration basée sur HttpClientModule

Certaines applications configurent HttpClient avec l'ancienne API basée sur les NgModules.

Ce tableau liste les NgModules disponibles dans @angular/common/http et leur correspondance avec les fonctions de configuration de provider ci-dessus.