Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

return — terminer une fonction et renvoyer une valeur

L’instruction return met fin à l’exécution d’une fonction et peut transmettre un résultat à l’appelant. Découvrez return sans expression, les sorties anticipées et le piège du saut de ligne.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

return;
return expression;

return est un mot-clé réservé. Dans une fonction ordinaire, return expression; évalue l’expression et renvoie sa valeur à l’appelant. return; renvoie undefined ; on obtient le même résultat en atteignant la fin d’une fonction ordinaire sans return. Cette instruction n’est pas autorisée au niveau supérieur d’un script standard ou d’un module.

Utilisez un return anticipé pour quitter une fonction après avoir vérifié une condition. Il quitte toute la fonction courante, et pas seulement une boucle qui l’englobe. Dans l’exemple, doublePositive(0) quitte la fonction avant la multiplication, tandis que doublePositive(3) renvoie 6.

Ne placez pas de saut de ligne entre return et l’expression renvoyée. L’insertion automatique de points-virgules peut alors terminer l’instruction sous la forme return;. Pour une expression sur plusieurs lignes, commencez par exemple par return ( et poursuivez aux lignes suivantes.

Un bloc finally s’exécute avant qu’un retour en attente ne soit terminé. Son propre return ou throw peut remplacer ce résultat ; évitez donc de tels remplacements. return relève de la syntaxe ECMAScript, et non d’une API Web ; l’exemple ne nécessite aucune API de navigateur.

Exemples

function doublePositive(value) {
  if (value <= 0) return;
  return value * 2;
}

console.log(doublePositive(3));
console.log(doublePositive(0));

Résultat

6
undefined

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources