Formations — 1 037 leçons en français

Accueil › Vue.js › Les limites de l'inférence

Les limites de l'inférence

Vue et TypeScriptavance

Le typage d'une application Vue n'est pas uniforme. Le bloc <script setup> est du TypeScript ordinaire, et l'inférence y est aussi bonne qu'ailleurs. Le template, lui, est un langage à part que seule une chaîne d'outils dédiée sait vérifier.

Trois frontières méritent d'être connues.

La première est l'outillage. tsc ignore les fichiers .vue, et vite build transpile sans vérifier. Un template faux se construit sans un mot.

vue-tsc --noEmit        # la seule commande qui lit les templates

La deuxième est le déballage. Une ref liée au niveau supérieur du script s'affiche sans .value dans le template. Rangée dans un objet ordinaire, elle ne l'est plus — et le type reste correct, donc rien n'alerte.

const direct = ref(1)
const groupe = { compteur: ref(2) }   // {{ groupe.compteur }} affiche un objet

La troisième est la frontière entre les types et l'exécution. Les types disparaissent à la compilation. Une réponse réseau convertie en Produit n'a jamais été vérifiée : seul un schéma d'exécution peut le faire.

const produit = (await reponse.json()) as Produit   // aucune garantie

Le reste des limites se contourne par une annotation explicite : une référence de template, une conversion après rétrécissement, une déclaration de composant global.

Les termes à connaître

Analyse statique du template

La vérification des expressions écrites entre accolades et dans les directives. Elle n'est assurée que par vue-tsc et l'extension d'éditeur correspondante, jamais par tsc ni par la construction Vite.

strictTemplates

Option de vueCompilerOptions dans le tsconfig. Activée, elle transforme en erreur une prop inconnue ou un composant non résolu dans un template ; désactivée, ces cas passent en silence.

Déballage automatique

Dans le template, une ref liée au niveau supérieur de <script setup> s'affiche sans .value. Une ref rangée dans un objet ordinaire ne bénéficie pas de ce déballage.

Rétrécissement de type

Le fait, pour TypeScript, de resserrer un type après un test — v-if="produit". Dans un template, ce resserrement ne franchit pas toutes les frontières, notamment celles d'un emplacement ou d'une fonction.

Référence de template

Une variable pointant vers un élément du DOM ou un composant enfant. Son type n'est pas déduit du template : on l'écrit, avec useTemplateRef<T> depuis Vue 3.5 ou avec une ref annotée.

GlobalComponents

Interface du module vue qu'on augmente pour déclarer les composants enregistrés globalement. Sans cette déclaration, ils sont inconnus de l'analyse du template.

Conversion de type

as Produit. Elle affirme un type sans le vérifier. Sur une donnée venue du réseau, elle ne garantit rien à l'exécution : c'est une promesse faite au compilateur, pas un contrôle.

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.