Un budget de performance est un accord d'équipe. La CI est ce qui le tient.
La revue a duré quarante minutes et n'a produit aucune décision. Un sélecteur de dates de 214 Ko avait atterri dans une pull request, le relecteur a demandé si le produit en avait besoin, l'auteur a répondu que le tree-shaking l'éliminerait, et les deux décrivaient le fichier différemment sans un chiffre entre eux. Deux ingénieurs, une dépendance, et nulle part pour loger l'argument.
Le budget est l'endroit où cet argument va, et le fichier de configuration n'en est la moitié la plus facile. Notre position, en une phrase : un budget de performance est un document sur ce que les utilisateurs doivent pouvoir faire sur chaque route et sur quel appareil. Il ne sert que de procès-verbal de l'accord que l'équipe a déjà conclu. Les équipes qui partent d'une page de chiffres recommandés sur le web et sautent la réunion obtiennent un pipeline rouge que tout le monde contourne, ce qui est pire que pas de budget du tout, parce que rouge ne veut plus rien dire au troisième mardi de suite. Décider d'abord, imposer ensuite.
Budgéter la route, pas la base de code
La première décision précède tout outillage : un chiffre par route, parce que la route est l'unité que l'utilisateur charge réellement. Une page de tarifs, un éditeur de carte et un parcours de paiement ne portent pas le même contenu, donc ils ne peuvent pas porter un même plafond sans que ce plafond soit faux pour les trois. Posez deux budgets dans votre première heure : le chiffre le plus strict que vous puissiez défendre pour les routes d'atterrissage, où des inconnus décident s'ils vous font confiance, et un chiffre plus souple pour les routes d'application, où un utilisateur connecté a déjà payé le coût de la session.
Le budget de l'éditeur de carte valant trois fois celui de la page de tarifs n'a rien d'un scandale. C'est l'accord, écrit. Le scandale, c'est de le découvrir au fil des revues, route par route, cent fois par an.
{
"budgets": [
{
"path": "/pricing",
"resourceSizes": [
{ "resourceType": "script", "budget": 90 }
],
"timings": [
{ "metric": "largest-contentful-paint", "budget": 2500 }
]
},
{
"path": "/app/map",
"resourceSizes": [
{ "resourceType": "script", "budget": 280 }
]
}
]
}
La forme ci-dessus est le format budgets de Lighthouse CI : des kilo-octets de script par route, plus un timing quand la route le mérite. Enregistrez-le sous budget.json et pointez ci.assert.budgetsFile dessus. Les valeurs sont des espaces réservés pour votre propre décision. Un LCP de 2 500 ms sur la route d'atterrissage est le seuil Good publié par Google ; il existe pour être contesté vers le bas, et la contestation est le but.
Mesurer sur le téléphone, pas sur la station de travail
Un budget posé depuis la machine du développeur est un budget pour un portable sur une connexion rapide avec un cache plein, appareil dont aucun client n'est propriétaire. Le montage honnête teste sur un Android de milieu de gamme en 4G avec bridage, cache froid, parce que c'est la configuration dans laquelle arrive votre nouveau visiteur. Chrome DevTools le fait dans son panneau Performance. La première fois que vous bridez en 4G fast et que vous regardez les 214 Ko du sélecteur se parser, l'argument du tree-shaking prend fin, parce qu'un bundle minifié mais non scindé part en entier et que le téléphone paie chaque octet, que le bundler ait ou non pu en principe en retirer une partie.
Ce passage sur téléphone appartient à la réunion où l'on fixe les budgets, pas seulement à la CI ensuite. On négocie avec des chiffres qu'on a vu se produire. Personne ne défend un budget de 280 Ko sur une route d'application à un collègue qui vient de le regarder ramper dans le bus.
Le contrôle qui consigne l'accord
L'imposition vient en troisième, et c'est la moitié ennuyeuse, signe que la partie difficile était bien l'accord. Deux outils publics portent l'essentiel. Lighthouse CI lit le fichier de budgets ci-dessus et fait échouer l'exécution quand une route le dépasse. size-limit fait échouer une pull request quand un point d'entrée franchit son chiffre, ce qui en fait le bon outil pour le cas des routes d'application, où le diff de bundle compte plus qu'un audit complet.
Le troisième outil est un commentaire, pas un verrou. Faites tourner source-map-explorer en CI sur le bundle de la route modifiée et collez le détail par module dans la pull request. Le relecteur cesse d'argumenter sur le tree-shaking et se met à lire une liste de paquets avec des comptes d'octets à côté. L'imposition fonctionne parce qu'elle déplace l'argument des adjectifs vers l'arithmétique.
Comment 214 Ko deviennent zéro
L'argument des dépendances tient en trois questions, et y répondre est la revue entière. Que coûte-t-elle sur le téléphone que l'utilisateur tient, temps de parse et de compilation compris, que la minification ne retire pas ? Qu'a-t-elle remplacé, nommé dans le vocabulaire du produit ; ici, des plages de dates que le site marketing ne filtre jamais ? Est-ce qu'une partie de son code se charge avant le clic qu'elle sert ?
Pour le sélecteur, l'arithmétique s'est passée ainsi : le filtre par plage n'existait que dans un panneau de réglages, sous une route que la plupart des sessions n'ouvrent jamais. Le composant est passé derrière un import dynamique, si bien que ses 214 Ko ne voyagent que quand le panneau s'ouvre, et le budget de la route qui le porte a cessé d'être le problème de quelqu'un. La meilleure réponse suivante, si le panneau avait été sur la route d'atterrissage, aurait été quarante lignes de comparaison entre deux dates, parce que le calcul de dates est le genre de dépendance que la bibliothèque standard a déjà résolu. Le chargement paresseux est la résolution qui garde le code du fournisseur et votre bundle séparés. La réécriture est la résolution qui met fin à la maintenance. La route décide de ce que vous pouvez vous payer.
C'est le budget qui a réduit cette revue de quarante minutes à cinq. Pas parce que les chiffres sont intouchables, mais parce que celui qui comptait avait été convenu par des gens qui l'avaient vu ramper.
Ce qu'un contrôle vert ne veut pas dire
Les limites honnêtes, avant que quiconque fasse trop confiance au fichier. La CI mesure des charges synthétiques : votre 4G bridée en CI est une simulation de téléphone, pas un téléphone, et aucun profil de bridage ne capture proprement le temps de compilation d'un chipset de milieu de gamme, donc un budget respecté ne certifie rien de rapide sur les appareils que vos utilisateurs tiennent. Les budgets verrouillent les octets sur le fil, pas ce que fait le thread principal après, et un bundle maigre peut encore porter une longue tâche qui démolit la latence d'interaction. Et chaque budget du fichier expire, parce que les routes gagnent des fonctions et que les chiffres cessent de se défendre tout seuls si personne ne les réexamine.
Le contournement qui garde le fichier honnête est petit : revoyez chaque budget contre un vrai téléphone dans de vraies conditions au moment où une route part en production, et laissez les chiffres à l'endroit où un nouvel ingénieur peut lire le raisonnement à côté. Les données de terrain répondent à la question de savoir si vos accords valent quelque chose. Le budget répond à la question de savoir si quelqu'un en a brisé un.
Tout le dossier tient là : les budgets sont une culture parce que la décision est la réunion, le fichier en est le procès-verbal, et la CI est la seule employée qui ne laisse jamais passer une dépendance de 214 Ko sur la force du mot « tree-shakes ».
AngoraTek pose des budgets de performance au niveau des routes avec de petites équipes et laisse les contrôles tourner dans leurs pipelines. Si vos revues ré-argumentent le poids des bundles à coups d'adjectifs, [apportez-nous la route où cela arrive](/fr/#contact) et nous écrirons les deux premiers budgets avec vous.Merci d'avoir lu jusqu'ici. Si cela ressemble au problème sur lequel vous butez, parlez-nous-en. L'équipe lit chaque message.
Engager la conversation