Accueil › TypeScript › Typer l'état, les événements et les refs
Typer l'état, les événements et les refs
TypeScript avec React et Nodeavance
useState : annoter seulement quand l'inférence est insuffisante
const [quantite, setQuantite] = useState(0); // number — rien à écrire
const [nom, setNom] = useState(""); // string
const [client, setClient] = useState<Client | null>(null);
La valeur initiale sert de source à l'inférence. Quand elle est plus pauvre que
l'état réel — null au départ, un objet ensuite — il faut l'écrire.
Le piège du tableau vide
const [lignes, setLignes] = useState([]); // never[]
setLignes([{ id: "a" }]); // ❌ TS2345
const [lignes, setLignes] = useState<Ligne[]>([]); // ✅
Un tableau vide n'offre aucun candidat : le compilateur retient never[], dans
lequel rien ne peut entrer. L'erreur n'apparaît pas à la déclaration mais au
premier ajout.
Les événements : un type précis, jamais any
function onSaisie(e: React.ChangeEvent<HTMLInputElement>) {
setNom(e.target.value); // string
}
Le paramètre de type est l'élément. Sans lui, e.target est un
EventTarget générique, qui n'a pas de value.
Mais en ligne, le contexte suffit
<input onChange={(e) => setNom(e.target.value)} />
La prop onChange impose la signature, donc e est déjà
ChangeEvent<HTMLInputElement>. Annoter ici est du bruit. Le type explicite
redevient nécessaire dès que la fonction est extraite et nommée.
useRef
const champ = useRef<HTMLInputElement>(null);
champ.current?.focus(); // current : HTMLInputElement | null
Les termes à connaître
- useState inféré
useState(0)déduitnumberde la valeur initiale. L'annotation n'est utile que quand l'initiale ne décrit pas tout l'état.- Le piège du tableau vide
useState([])déduitnever[]: on ne peut rien y mettre. Il faut annoter,useState<Client[]>([]).- ChangeEvent<T>
Le type d'un événement de saisie. Le paramètre de type est l'élément :
ChangeEvent<HTMLInputElement>donneevent.target.valuetypé.- Typage contextuel
Un gestionnaire écrit en ligne dans le JSX reçoit son type de la prop qui l'accueille. Annoter son paramètre est alors inutile.
- RefObject et current
useRef<HTMLInputElement>(null)rend un objet dontcurrentestHTMLInputElement | null: lenullest obligatoire à lire, parce que la ref est vide avant le montage.- useReducer
Son type vient de celui du réducteur. Une union discriminée d'actions rend l'aiguillage exhaustif et les charges utiles vérifiées.
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.