L'oprateur function

Exemple interactif

const getRectArea = function (width, height) {
  return width * height;
};

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

Syntaxe

function [nom]([param1[, param2[, , paramN]]]) {
  instructions
}

Paramtres

nom

Le nom de la fonction. Peut tre omis, auquel cas on parlera d'une fonction anonyme.

paramN

Le nom d'un paramtre passer la fonction.

instructions

Les instructions constituant le corps de la fonction.

Description

Une expression de fonction est trs similaire et a presque la mme syntaxe qu'une dclaration de fonction (consultez la page sur l'instruction function pour plus de dtails). La diffrence principale entre une expression de fonction et une instruction est le nom de la fonction. En effet, pour les expressions, celui peut tre omis (on parle alors d'une fonction anonyme). Consultez l'article Fonctions pour des informations concernant les diffrences entre les instructions de fonctions et les expressions de fonctions. Une fonction peut tre appele immdiatement aprs sa dfinition (on parle alors de fonction invoque immdiatement ou IIFE pour Immediately Invoked Function Expression en anglais).

Remonte (hoisting) des expressions de fonction

En JavaScript, les expressions de fonction ne sont pas remontes ( la diffrence des dclarations de fonction). Il est donc impossible d'utiliser les expressions de fonction avant leur dfinition :

nonRemonte(); // TypeError: nonRemonte is not a function

var nonRemonte = function () {
  console.log("truc");
};

Exemples

L'exemple qui suit dfinit une fonction anonyme et l'assigne une variable x. La fonction renvoie le carr de son paramtre :

var x = function (y) {
  return y * y;
};

Expression nomme

Si on souhaite faire rfrence une fonction au sein du corps de la fonction, il faudra crer une expression de fonction nomme. Le nom sera alors local au corps de la fonction (porte). Cela permet entre autres d'viter d'utiliser la proprit non-standard arguments.callee.

var math = {
  factorielle: function factorielle(n) {
    if (n <= 1) {
      return 1;
    }
    return n * factorielle(n - 1);
  },
};

La variable affecte l'expression de fonction aura une proprit name. Ce nom n'est pas modifi si la variable est raffecte. Si le nom de la fonction est absent, ce sera celui de la variable (nom implicite ). Cela vaut galement pour les fonctions flches :

var toto = function () {};
console.log(toto.name); // "toto"

var toto2 = toto;
console.log(toto2.name); // "toto"

var truc = function machin() {};
console.log(truc.name); // "machin"

IIFE pour Immediately Invoked Function Expression ou expression de fonction immdiatement appele

On peut utiliser une expression de fonction pour crer une IIFE , c'est--dire une expression de fonction qu'on appelle ds sa dfinition :

var a = "coucou";
var b = "monde";

// IIFE
(function (x, y) {
  console.log(x + " " + y);
})(a, b);
// coucou monde

Spcifications

Compatibilit des navigateurs

Voir aussi

• Fonctions et porte des fonctions
• L'objet Function
• Instruction function
• Instruction function*
• Expression function*
• GeneratorFunction
• Les fonctions flches
• Les expressions de fonctions asynchrones (l'oprateur async function)
• Les dclarations de fonctions asynchrones (l'instruction async function)