return - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

return

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

L'instruction return met fin à l'exécution d'une fonction et définit une valeur à renvoyer à la fonction appelante.

Dans cet article

Exemple interactif

function getRectArea(width, height) {
  if (width > 0 && height > 0) {
    return width * height;
  }
  return 0;
}

console.log(getRectArea(3, 4));
// Expected output: 12

console.log(getRectArea(-3, 4));
// Expected output: 0

Syntaxe

return [expression];

expression

L'expression dont on souhaite renvoyer la valeur. Si elle est absente, la valeur renvoyée par défaut sera undefined.

Lorsqu'une instruction return est utilisée dans une fonction, l'exécution de la fonction se termine. Si une valeur est fournie, elle sera renvoyée à l'appelant de la fonction. Si l'expression définissant la valeur de retour de la fonction est absente, la valeur undefined sera renvoyée. Par exemple, voici une fonction qui renvoie le carré de son argument x (où x est un nombre) :

js
function carre(x) {
  return x * x;
}
var demo = carre(3);
// demo vaudra alors 9

Les instructions qui suivent causeront chacune l'arrêt de l'exécution d'une fonction :

js
return;
return true;
return false;
return x;
return x + y / 3;

Ajout automatique de point-virgule

L'instruction return peut être impactée par l'ajout automatique de point-virgule (ASI en anglais). Il est interdit d'avoir un caractère de fin de ligne entre le mot-clé return et l'expression :

js
return;
a + b;

Après ASI, cela sera transformé en :

js
return;
a + b;
// Avertissement console : "expression non accessible
// après une instruction return sans point-virgule"

Note : À partir de Gecko 40, un avertissement sera affiché dans la console si l'analyse du code trouve une instruction semblable à une expression après une instruction return sans point-virgule. Voir le bug Firefox 1005110 pour plus d'informations.

Pour éviter ce problème et l'insertion automatique, on peut, si besoin, utiliser des parenthèses.

js
return (
  a + b;
);

Exemples

Utiliser return

La fonction suivante renvoie le carré de son argument :

js
function carré(x) {
  return x * x;
}

Interrompre une fonction

Une fonction s'arrête immédiatement à l'instant où l'instruction return est traitée.

js
function compteur() {
  for (var compte = 1; ; compte++) {
    // boucle infinie
    console.log(compte + "A"); // jusqu'à 5
    if (compte === 5) {
      return;
    }
    console.log(compte + "B"); // jusqu'à 4
  }
  console.log(compte + "C"); // cette instruction n'est jamais utilisée
}

compteur();

// Résultat dans la console :
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A

Renvoyer une fonction

Pour en savoir plus sur les fermetures (closures), voir cet article sur les fermetures.

js
function magique() {
  return function calc(x) {
    return x * 42;
  };
}

var réponse = magique();
réponse(1337); // 56154

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 7 sept. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu