Actifs hébergés localement
Le site public devrait pouvoir être inspecté à partir de sa propre sortie de build.
Les polices, images, CSS, JavaScript, icônes et autres actifs d’interface devraient être servis par le site sauf lorsqu’une raison précise exige un service d’exécution distant.
Règle#
Hébergez les actifs localement par défaut. Un actif distant est une exception qui exige une raison, une décision de divulgation et un responsable de maintenance.
S’applique à#
- les polices web
- les bibliothèques JavaScript
- les frameworks CSS ou le CSS généré
- les icônes et images d’interface
- les images de produits téléchargées lorsque la licence permet l’hébergement local
- les fichiers générés comme les index de recherche, les flux et les surfaces lisibles par machine
Pourquoi#
L’hébergement local rend le site :
- plus rapide à afficher
- plus facile à archiver
- plus facile à tester
- moins dépendant de la disponibilité de tiers
- moins exposé au suivi par des tiers
- plus clair sur le code exécuté dans le navigateur
Exceptions#
Une dépendance distante peut être acceptable lorsqu’elle est le produit démontré, une source légalement requise, un service actif qui ne peut pas être représenté localement ou un état temporaire de migration.
Documentez l’exception près de la fonctionnalité et divulguez-la là où un visiteur ou un mainteneur s’attendrait raisonnablement à la trouver.
Entretien#
Lors de l’ajout d’un actif, répondez à trois questions :
- Où est la source locale?
- Quelle licence ou permission autorise son utilisation?
- Cet actif provoque-t-il des requêtes côté navigateur vers l’extérieur du site?