Partager via


Function, objet

Crée une nouvelle fonction.

function Function( [[param1 : String, [..., paramN : String,]] body : String ])

Arguments

  • param1, ..., paramN
    Facultatif. Paramètres de la fonction. Chaque paramètre peut disposer d'une annotation de type. Le dernier paramètre peut être un parameterarray, indiqué par trois points (...) suivis du nom d'un tableau de paramètres et de l'annotation de type tableau typé.

  • body
    Facultatif. Chaîne contenant le bloc de code JScript à exécuter lors de l'appel de la fonction.

Notes

Le constructeur Function permet à un script de créer des fonctions au moment de l'exécution. Les paramètres passés au constructeur Function (tous à l'exception du dernier paramètre) sont utilisés comme paramètres de la nouvelle fonction. Le dernier paramètre passé au constructeur est interprété comme le code du corps de la fonction.

JScript compile l'objet créé par le constructeur Function au moment de l'appel du constructeur. Votre script bénéficie ainsi d'une plus grande souplesse dans la redéfinition de fonctions au moment de l'exécution ; en revanche, le code est beaucoup plus lent. Évitez dans la mesure du possible d'utiliser le constructeur Function pour ne pas être confronté à des scripts lents.

Lorsque vous appelez une fonction à évaluer, veillez à toujours inclure les parenthèses ainsi que tous les arguments requis. L'appel d'une fonction sans parenthèses retourne un objet Function pour cette fonction. Il est possible d'obtenir le texte d'une fonction en utilisant la méthode toString de l'objet Function.

Notes

Seul JScript fournit l'objet Function. Dans la mesure où il n'est pas dérivé d'un type du .NET Framework, les autres langages CLS (Common Language Specification) ne peuvent pas l'utiliser. En conséquence, lors de l'annotation de type des paramètres et des types de retour des méthodes conformes à CLS, assurez-vous d'utiliser le type de données System.EventHandler plutôt que l'objet Function. Vous pouvez néanmoins utiliser l'objet Function pour annoter le type d'identificateurs autres que des paramètres et des types de retour. Pour plus d'informations, consultez Écriture d'un code conforme CLS.

Exemple

L'exemple suivant illustre une utilisation de l'objet Function.

var add : Function = new Function("x", "y", "return(x+y)");
print(add(2, 3));

Ce code génère le résultat suivant :

5

Propriétés et méthodes

Function, objet - méthodes et propriétés

Configuration requise

Version 2

Voir aussi

Référence

function, instruction

new, opérateur

var, instruction