Les lectures d'un écran
Un écran, un aller-retour : le patron à suivre et ce qu'il ne faut pas faire.
Entre l’application et la base, chaque appel coûte une cinquantaine de millisecondes. Un écran qui fait quarante-cinq appels met plus de deux secondes à s’afficher. Ces règles ramènent ce nombre à un.
Lire la base
Section intitulée « Lire la base »LECT-01 · Lisez la base une seule fois par écran
Section intitulée « LECT-01 · Lisez la base une seule fois par écran »Pourquoi. Un écran qui fait quarante-cinq appels met plus de deux secondes à s’afficher avant même de calculer quoi que ce soit.
// app/suivi/page.tsxconst lignes = await db.lire("operation").select("*");const compteurs = await db.appeler("compteurs_du_suivi");const alertes = await db.appeler("alertes_du_suivi");// app/suivi/page.tsxconst { data } = await db.appeler("page_suivi", { p_annee: annee, p_suivi: suivi });const { lignes, compteurs, alertes } = data;Outil Chaque route a un budget de lectures ; un contrôle compte les appels réels et refuse la mise en ligne s’il est dépassé.
Voir aussi. Nommer les fonctions d’écran
LECT-02 · Lancez en parallèle ce qui est indépendant
Section intitulée « LECT-02 · Lancez en parallèle ce qui est indépendant »const page = await db.appeler("page_suivi", { p_annee: annee });const portefeuille = await db.appeler("mon_portefeuille");const [{ data: page }, { data: portefeuille }] = await Promise.all([ db.appeler("page_suivi", { p_annee: annee }), db.appeler("mon_portefeuille"),]);Relecture Un await de plus sur une lecture est un aller-retour de plus.
LECT-03 · Ne lisez jamais dans une boucle
Section intitulée « LECT-03 · Ne lisez jamais dans une boucle »Pourquoi. Chaque tour de boucle est un aller-retour : quarante-cinq opérations, quarante-cinq appels.
for (const op of operations) { const { data } = await db.lire("piece").select("*").eq("operation_id", op.id);}// une lecture regroupée côté base (nom de fonction donné en exemple)const { data } = await db.appeler("pieces_des_operations", { p_ids: operations.map((o) => o.id),});Outil Le budget de lectures de la route échoue.
Relecture Seule la page lit la base : les composants enfants reçoivent leurs données.
LECT-04 · Comptez, sommez et paginez côté serveur
Section intitulée « LECT-04 · Comptez, sommez et paginez côté serveur »Pourquoi. L’API tronque à mille lignes sans erreur : un total calculé dans le navigateur est faux, et personne ne le voit.
const { data } = await db.lire("piece").select("montant_ht");const total = data.reduce((s, p) => s + p.montant_ht, 0); // faux au-delà de 1000 lignesconst { data: total } = await db.appeler("total_des_pieces", { p_annee: annee });Relecture Une liste entière se lit par la fonction qui lève si le compte ne tombe pas.
LECT-05 · N’appelez pas une fonction SQL pour chaque ligne
Section intitulée « LECT-05 · N’appelez pas une fonction SQL pour chaque ligne »select l.*, taux_reel(l.id) from ligne l; -- une exécution par ligneselect l.*, t.valeur from ligne l join taux t on t.ligne_id = l.id; -- calculé une foisRelecture Et jamais de vue en union dans une sous-requête corrélée : agrégez une fois, à part.
Garder en mémoire
Section intitulée « Garder en mémoire »LECT-06 · Mettez la société dans la clé de la mémoire
Section intitulée « LECT-06 · Mettez la société dans la clé de la mémoire »Pourquoi. Sans la société dans la clé, un compte lit la liste d’un autre.
memo("clients", () => lireLesClients());memo(["clients", societeId], () => lireLesClients());Relecture Une page qui lit l’adresse, un cookie ou la session sort du cache.
LECT-07 · Mesurez avant d’optimiser
Section intitulée « LECT-07 · Mesurez avant d’optimiser »Pourquoi. La copie locale compare deux versions, elle ne donne pas les temps de la production.
{ "/suivi": "pas de budget, on verra" }{ "/suivi": { "lectures": 1 } }Outil Le budget de lectures de chaque route est dans tests/vitesse.json ; ajouter une lecture, c’est modifier ce budget et le justifier.
LECT-08 · Répondez au clic tout de suite
Section intitulée « LECT-08 · Répondez au clic tout de suite »Outil Un seul composant du cadre pose l’état « en route » au clic sur un lien ou un envoi.
Référence rapide
Section intitulée « Référence rapide »| Règle | À retenir | Tenue par |
|---|---|---|
| LECT-01 | Lisez la base une seule fois par écran | Outil |
| LECT-02 | Lancez en parallèle ce qui est indépendant | Relecture |
| LECT-03 | Ne lisez jamais dans une boucle | Outil, Relecture |
| LECT-04 | Comptez, sommez et paginez côté serveur | Relecture |
| LECT-05 | N’appelez pas une fonction SQL pour chaque ligne | Relecture |
| LECT-06 | Mettez la société dans la clé de la mémoire | Relecture |
| LECT-07 | Mesurez avant d’optimiser | Outil |
| LECT-08 | Répondez au clic tout de suite | Outil |