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-tscet l'extension d'éditeur correspondante, jamais partscni par la construction Vite.- strictTemplates
Option de
vueCompilerOptionsdans letsconfig. 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
refliée au niveau supérieur de<script setup>s'affiche sans.value. Unerefrangé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 unerefannotée.- GlobalComponents
Interface du module
vuequ'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.
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.