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 quandparamschange. 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 pourHttpClient(@angular/common/http) : elle prend une URL (ou une requête complète) réactive, envoie la requête viaHttpClient, 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()ethttpResource()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 auloader. 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 deparams. Elle reçoit un objet contenantparams,previous(état précédent) etabortSignal(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 (ouundefined),status()un état parmiidle,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.
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.