Formations — 1 037 leçons en français

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éduit number de 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éduit never[] : 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> donne event.target.value typé.

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 dont current est HTMLInputElement | null : le null est 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.

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.