Formations — 1 037 leçons en français

Accueil › Angular › resource() et httpResource() : l'approche signaux

resource() et httpResource() : l'approche signaux

Communiquer avec une APIdebutant

resource() et httpResource() répondent à un problème récurrent avec HttpClient : relier une requête à un signal demande d'orchestrer soi-même le déclenchement (toObservable + switchMap), l'état de chargement et les erreurs. httpResource() intègre tout ça :

const produitId = signal(1);

const produit = httpResource<Produit>(() => `/api/produits/${produitId()}`);

Dès que produitId change, la ressource relance automatiquement la requête. Elle expose directement des signaux :

produit.value();      // Produit | undefined
produit.isLoading();  // boolean
produit.error();      // erreur éventuelle
produit.status();     // 'idle' | 'loading' | 'reloading' | 'resolved' | 'error' | 'local'

Point important pour un projet réel : ces deux API sont marquées expérimentales dans la documentation d'Angular 21, disponibles depuis la 19.0 (resource()) et la 19.2 (httpResource()). Une API expérimentale peut encore changer avant sa stabilisation, prévue en Angular 22. Beaucoup de contenus trouvés en ligne les présentent comme stables : ils décrivent en réalité la documentation d'Angular 22, pas celle de la 21.

Pour un besoin équivalent, l'alternative stable reste HttpClient combiné à toSignal() — plus verbeuse, mais bâtie sur des API qui ne changeront pas.

Les termes à connaître

resource()

Primitive d'Angular (@angular/core) qui relie un calcul asynchrone (loader) à des signaux réactifs (params) : le loader se relance automatiquement quand params change. Expérimentale en Angular 21 : « resource is experimental. It's ready for you to try, but it might change before it is stable ».

httpResource()

Version de resource() spécialisée pour HttpClient (@angular/common/http) : elle prend une URL (ou une requête complète) réactive, envoie la requête via HttpClient, et expose la réponse sous forme de signaux. Expérimentale depuis Angular 19.2, toujours expérimentale en v21.

Statut expérimental

Signale une API stabilisée dans sa forme générale mais susceptible de changer avant sa version stable. resource() et httpResource() ne deviennent stables qu'en Angular 22 : les utiliser en production en Angular 21 signifie accepter un risque de changement d'API lors d'une future montée de version.

params (resource)

Fonction réactive (comme un computed) qui produit la valeur transmise au loader. Quand les signaux qu'elle lit changent, resource() relance automatiquement le chargement avec les nouveaux paramètres.

loader

Fonction asynchrone appelée par resource() à chaque changement de params. Elle reçoit un objet contenant params, previous (état précédent) et abortSignal (pour annuler une requête devenue obsolète).

value() / status() / isLoading() / error()

Signaux exposés par la ressource retournée : value() la dernière valeur reçue (ou undefined), status() un état parmi idle, loading, reloading, resolved, error, local, isLoading() un booléen pratique, error() la dernière erreur.

reload()

Méthode exposée par la ressource pour relancer le chargement manuellement, avec les mêmes paramètres — utile pour un bouton « Réessayer » après une erreur.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.