void
Le type renvoyé par les fonctions qui ne renvoient rien.
Exemple
#function logProgress(done: number, total: number): void {
const percent = Math.round((done / total) * 100)
console.log(`Progression : ${percent}%`)
}
const result = logProgress(3, 8)
console.log(result)Progression : 38% undefined
Définition et utilisation
#Le type void signifie l’absence de valeur de retour utile. Une fonction qui se contente de faire quelque chose (afficher, enregistrer, changer un état) sans renvoyer de résultat a le type de retour void.
En pratique, une telle fonction renvoie undefined, mais void communique une intention : « n’utilisez pas le résultat ». Le compilateur signale une erreur si vous essayez d’en renvoyer une valeur concrète.
Dans le type d’une fonction de rappel, void est plus permissif : (item: string) => void permet de passer une fonction qui renvoie effectivement quelque chose. Le résultat est simplement ignoré, ce qui rend par exemple arr.forEach(x => list.push(x)) correct.
Syntaxe
#function name(): void {
…
}Plus d’exemples
#const saved: string[] = []
const onSave: (value: string) => void = (value) => saved.push(value)
onSave('Module 1')
console.log(saved)['Module 1']
Bonnes pratiques
#- Ajoutez le type de retour
voiden particulier aux fonctions publiques et aux gestionnaires d’événements. Le code indique alors directement que le résultat n’a pas d’importance. - Une fonction asynchrone sans résultat a le type
Promise<void>.
Entrées associées
#- void vs nevervoid signifie qu’une fonction ne renvoie pas de valeur utile, tandis que never signifie qu’une fonction ne revient jamais : elle lève une erreur ou tourne indéfiniment.
- Types de fonctionsTyper les paramètres, la valeur de retour et les fonctions elles-mêmes en tant que valeurs.
- neverLe type d’une valeur qui ne se produit jamais : des fonctions qui ne se terminent pas normalement, et des cas impossibles.
- null et undefinedLes types pour l’absence de valeur, contrôlés par strictNullChecks.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.