Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Constructeur Function()
Baseline Widely available
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.
LeconstructeurFunction() permet de créer un nouvelobjetFunction. Appeler le constructeur directement permet de créer des fonctions de façon dynamique, mais souffre des mêmes problèmes de sécurité et de performance, néanmoins dans une moindre mesure, queeval(). Toutefois, à la différence deeval(), le constructeurFunction crée des fonctions qui s'exécutent uniquement dans la portée locale.
Dans cet article
Exemple interactif
const sum = new Function("a", "b", "return a + b");console.log(sum(2, 6));// Expected output: 8Syntaxe
new Function(corpsFonction)new Function(arg1, corpsFonction)new Function(arg1, … argN, corpsFonction)Paramètres
arg1, … argNLes noms à utiliser par la fonction comme noms formels d'arguments. Chacun doit être une chaîne de caractères qui correspond à un paramètre JavaScript valide (un identifiant,un paramètre du reste, ouune décomposition en paramètres, éventuellement avec une valeur par défaut), ou une liste de telles chaînes, séparées par des virgules.
Les paramètres étant analysés de la même façon que les déclarations de fonction, les espaces et les commentaires sont acceptés. Ainsi, on pourra écrire
"x", "laValeur = 42", "[a, b] /* nombres */"— ou"x, laValeur = 42, [a, b] /* nombres */"("x, laValeur = 42", "[a, b]"est également correct, mais porte plus à confusion.)corpsFonctionUne chaîne de caractères contenant les instructions JavaScript qui forment la définition de la fonction.
Description
Les objetsFunction créés avec le constructeurFunction() sont analysés lors de la création de la fonction. Cette méthode est moins efficace que de déclarer une fonction en utilisant uneexpression de fonction ouune instruction de fonction pour l'appeler ensuite dans le code, car de telles fonctions sont analysées avec le reste du code.
Tous les arguments passés à la fonction sont traités comme les noms des identifiants des paramètres de la fonction à créer, dans l'ordre selon lequel ils sont passés. Omettre un argument fera que la valeur de ce paramètre seraundefined.
Appeler le constructeurFunction() comme une fonction, c'est-à-dire sans utiliser l'opérateurnew, aura le même effet que de l'utiliser comme un constructeur.
Exemples
>Définir des arguments avec le constructeurFunction()
Le code qui suit crée un objetFunction qui prend deux arguments.
// Crée une fonction qui prend deux arguments et qui en renvoie la sommeconst additionneur = new Function("a", "b", "return a + b");// Appeler la fonctionadditionneur(2, 6);// 8Les arguments"a" et"b" sont les noms formels des arguments utilisés dans le corps de la fonction :"return a + b".
Créer un objetFunction avec une déclaration ou une expression de fonction
// Le constructeur Function() peut prendre plusieurs instructions séparées par des points-virgules.// Une expression de fonction doit contenir une instruction return avec le nom de la fonction.// On peut voir ici que le résultat de new Function est appelé.// Ainsi, on peut invoquer juste après la fonction qui vient d'être créée.const sommeTableau = new Function( "const sommeTableau = (arr) => arr.reduce((precedente, courante) => precedente + courante); return sommeTableau",)();// On appelle la fonctionsommeTableau([1, 2, 3, 4]);// 10// Si on n'appelle pas new Function au moment de la création,// on peut toujours utiliser la méthode Function.call() ensuiteconst plusGrandNombre = new Function( "function plusGrandNombre (arr) { return Math.max(...arr) }; return plusGrandNombre",);// On appelle la fonctionplusGrandNombre.call({}).call({}, [2, 4, 1, 8, 5]);// 8// Une déclaration de fonction ne nécessite pas d'instruction returnconst direCoucou = new Function( "return function (nom) { return `Coucou, ${nom}` }",)();// On appelle la fonctiondireCoucou("monde");// Coucou, mondeSpécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-function-constructor> |