# Pages Web – JavaScript – Promesses

En JavaScript, la notation Promise, ou promesse, est utilisée pour le traitement des fonctions asynchrones. Une promesse peut se trouver dans trois états : en attente, respectée ou refusée. Elle peut prendre deux arguments : un gestionnaire de résultats et un gestionnaire d’erreurs ; l’un ou l’autre n’est appelé qu’une seule fois et renvoie une valeur une fois la fonction asynchrone traitée. Cela permet d’enchaîner plusieurs appels de fonctions qui s’exécutent de manière séquentielle. Elle est également nécessaire lorsque le résultat d’une fonction est exigé, par exemple lorsqu’on affecte le résultat à une variable, comme illustré ci-après.

Exemple : Les cas d’erreur peuvent également être traités en spécifiant un second argument avec une fonction de rappel :

    asyncCallToDesigner(parameters).then(function(result) {
    	//handle result here
    },
    function(error) {
    	//handle error here
    });

Remarque :

- Lors du traitement des fonctions de rappel d’erreur, un objet d’erreur JavaScript est transmis.
- La branche de rappel then n’est pas nécessaire ; elle est requise uniquement pour gérer le résultat d’un appel asynchrone. En outre, à l’intérieur de la branche then, la gestion des erreurs n’est pas obligatoire.
- Les noms des paramètres dans les rappels de fonction peuvent être des noms arbitraires, et non uniquement result ou error. Les paramètres ne sont pas obligatoires ; vous pouvez plutôt exécuter une fonction function.