Formations — 1 037 leçons en français

Accueil › Vue.js › Le build et le découpage du paquet

Le build et le découpage du paquet

Mise en productionavance

vite build produit un dossier dist/ : un index.html, et des fichiers JavaScript et CSS dont le nom contient une empreinte dérivée du contenu, du type index-Ba7x9Kd2.js. Cette empreinte est le pivot de toute la stratégie de cache : le nom change quand le contenu change, donc on peut garder le fichier très longtemps.

Par défaut, tout votre code applicatif finit dans un seul fichier. Un visiteur qui ouvre la page d'accueil télécharge aussi l'écran d'administration, l'éditeur de texte riche et la bibliothèque de graphiques. Le levier est l'import() dynamique.

// router/index.js
const routes = [
  { path: '/', component: () => import('../pages/Accueil.vue') },
  { path: '/admin', component: () => import('../pages/Admin.vue') }
]

Rollup, qui fait le build de Vite, voit ces import() et place chaque page dans un fichier distinct, chargé au moment de la navigation. Le même geste existe hors routage avec defineAsyncComponent.

import { defineAsyncComponent } from 'vue'

const EditeurRiche = defineAsyncComponent(
  () => import('./EditeurRiche.vue')
)

La fonction est appelée, pas évaluée tout de suite : c'est ce qui fait la différence. component: import('./Admin.vue') chargerait le module dès la lecture du fichier et supprimerait le découpage, sans aucun message d'erreur.

Les termes à connaître

vite build

La commande qui produit le paquet de production dans dist/. Elle compile les composants, applique la minification et écrit des noms de fichiers empreintés.

Empreinte

Le segment de caractères inséré dans le nom d'un fichier produit, par exemple index-Ba7x9Kd2.js. Il change dès que le contenu change, ce qui permet de mettre le fichier en cache sans risque.

Découpage dynamique

L'effet d'un import() dans le code : Rollup place le module importé dans un fichier séparé, chargé seulement quand l'expression est évaluée.

manualChunks

Option de sortie de Rollup, sous build.rollupOptions.output, qui permet de décider à quel fichier appartient un module. Elle accepte un objet ou une fonction.

defineAsyncComponent

Fonction de Vue qui enveloppe un import() de composant. Le composant n'est résolu qu'au moment où il doit être rendu.

Secouage d'arbre

L'élimination, au build, du code exporté mais jamais importé. Il suppose des modules ES et des imports nommés, et un effet de bord au niveau du module le neutralise.

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.