Un homme derrière son écran d'ordinateur.

Comprendre le mot-clé return en JavaScript

Mis à jour le

Vous débutez en JavaScript et le mot-clé return vous donne du fil à retordre ? Vous n'êtes pas seul ! C'est un concept de base mais pas si évident que ça au début. En JavaScript, return est le moyen pour une fonction de communiquer un résultat ou une valeur au reste de votre code. Sans return, vos fonctions peuvent effectuer des actions, mais elles ne peuvent pas "donner" de données pour les utiliser ailleurs. Voyons cela en détail.

return : La "sortie" de votre fonction

Imaginez une fonction comme une tâche spécifique que vous demandez à JavaScript d'effectuer. Par exemple, calculer quelque chose, traiter des informations, ou préparer des données.

Le mot-clé return est comme la "réponse" ou le "produit fini" de cette tâche. Une fois que la fonction a terminé son travail, si elle doit vous donner un résultat pour que vous puissiez l'utiliser ailleurs, elle utilise return. Sans return, la fonction ferait son travail en interne, mais le résultat resterait "à l'intérieur", inaccessible pour le reste de votre programme.

En gros, si votre fonction calcule quelque chose mais n'a pas de return, c'est comme faire un calcul dans votre tête sans le dire à personne - le résultat reste coincé dans la fonction.

return en action : Exemples concrets

1. Quand une fonction NE retourne rien (ou retourne undefined)

Considérons une fonction simple qui se contente d'afficher un message dans la console :

// Cette fonction salue un utilisateur, mais ne "rend" aucune valeur
function greetUser(name) {
  console.log("Hello, " + name + "!");
}

let greetingResult = greetUser("Chris"); // La fonction affiche "Hello, Chris!"
console.log(greetingResult); // Résultat : undefined

Dans cet exemple, la fonction greetUser exécute bien console.log. Vous verrez "Hello, Chris!" dans votre console. Cependant, comme il n'y a pas de mot-clé return explicite, la fonction ne "donne" aucune valeur. Par défaut, JavaScript retourne alors undefined. C'est pourquoi la variable greetingResult contient undefined.

2. Quand une fonction RETOURNE une valeur utile

Prenons maintenant une fonction qui calcule la somme de deux nombres et nous "donne" ce résultat :

// Cette fonction calcule une somme et "renvoie" la valeur
function addNumbers(num1, num2) {
  let sum = num1 + num2;
  return sum; // On retourne la somme calculée
}

let total = addNumbers(10, 5); // La fonction est appelée et son résultat est stocké
console.log(total); // Résultat : 15

Ici, lorsque vous appelez addNumbers(10, 5), la fonction calcule sum (qui devient 15). La ligne return sum; prend cette valeur (15) et la "renvoie" à l'endroit où la fonction a été appelée. La variable total reçoit donc la valeur 15.

3. Utiliser la valeur retournée

Quand une fonction retourne une valeur, vous pouvez :

  • Stocker le résultat dans une variable (comme let total = addNumbers(10, 5);).
  • L'utiliser dans un autre calcul :
let doubleSum = addNumbers(2, 3) * 2; // La fonction retourne 5, puis 5 * 2 = 10
console.log(doubleSum); // Résultat : 10
  • Le passer en argument à une autre fonction :
function displayMessage(msg) {
  console.log("Message: " + msg);
}
displayMessage(addNumbers(7, 3)); // La fonction retourne 10, puis "Message: 10" est affiché

return : La fin de l'exécution d'une fonction

Important à savoir : dès que JavaScript rencontre un return dans une fonction, celle-ci s'arrête immédiatement. Tout code qui se trouve après un return dans la même fonction ne sera jamais exécuté.

function checkAge(age) {
  if (age < 18) {
    return "Minor"; // Si l'âge est inférieur à 18, on retourne "Minor" et la fonction s'arrête ici
    console.log("Ce message ne s'affichera jamais si l'âge est < 18.");
  }
  return "Adult"; // Cette ligne est atteinte seulement si l'âge est >= 18
}

console.log(checkAge(16)); // Résultat : Minor
console.log(checkAge(20)); // Résultat : Adult

Dans cet exemple, si age est 16, la condition age < 18 est vraie. return "Minor"; est exécuté, et la fonction s'arrête là. La ligne console.log qui suit le return n'est jamais atteinte. Si age est 20, la première condition est fausse, et la fonction continue jusqu'à return "Adult";.

Conclusion

En résumé, return c'est juste le moyen pour une fonction de vous donner un résultat que vous pourrez utiliser ailleurs. Sans ça, votre fonction fait son boulot mais vous n'avez aucun moyen de récupérer ce qu'elle a calculé.

Voilà, vous savez maintenant comment fonctionne return en JavaScript.

Sources

🧮 Maîtrisez les subtilités de JavaScript !

Vous voulez aller plus loin dans l'utilisation de JavaScript et perfectionner vos compétences en manipulation de nombres et d'autres fonctionnalités avancées ? Découvrez comment optimiser vos scripts et créer des applications performantes avec un accompagnement adapté.

Contactez-moi pour un coaching JavaScript sur mesure
Ecran d'ordinateur avec du code React affiché React : La bibliothèque JavaScript qui révolutionne les interfaces utilisateur

C'est quoi React ? À quoi ça sert ? Découvrez la bibliothèque JavaScript qui permet de créer des interfaces utilisateur modernes et dynamiques.

Développeur buvant dans une tasse devant son écran avec du code affiché useEffect : Gérez les effets de bord dans vos composants React

Découvrez le hook useEffect de React : apprenez à gérer les effets de bord comme les appels API, les abonnements ou les mises à jour DOM dans vos composants.

écran d'ordinateur affichant du code React React Router : Gérez la navigation dans vos applications React

Découvrez les bases de React Router, la bibliothèques qui vous permettra de gérer la navigation et les routes dans vos applications React.