From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../global_objects/promise/resolve/index.md | 114 +++++++++------------ 1 file changed, 48 insertions(+), 66 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/promise/resolve') diff --git a/files/fr/web/javascript/reference/global_objects/promise/resolve/index.md b/files/fr/web/javascript/reference/global_objects/promise/resolve/index.md index 7f9e6d1ea9..9bf6a9dc3f 100644 --- a/files/fr/web/javascript/reference/global_objects/promise/resolve/index.md +++ b/files/fr/web/javascript/reference/global_objects/promise/resolve/index.md @@ -10,60 +10,58 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Promise/resolve original_slug: Web/JavaScript/Reference/Objets_globaux/Promise/resolve --- -
{{JSRef}}
+{{JSRef}} -

La méthode Promise.resolve(valeur) renvoie un objet {{jsxref("Promise")}} qui est résolu avec la valeur donnée. Si cette valeur est une promesse, la promesse est renvoyée, si la valeur possède une méthode {{jsxref("Promise.then","then")}}, la promesse renvoyée « suivra » cette méthode et prendra son état ; sinon, la promesse renvoyée sera tenue avec la valeur.

+La méthode **`Promise.resolve(valeur)`** renvoie un objet {{jsxref("Promise")}} qui est résolu avec la valeur donnée. Si cette valeur est une promesse, la promesse est renvoyée, si la valeur possède une méthode {{jsxref("Promise.then","then")}}, la promesse renvoyée « suivra » cette méthode et prendra son état ; sinon, la promesse renvoyée sera tenue avec la valeur. -
{{EmbedInteractiveExample("pages/js/promise-resolve.html")}}
+{{EmbedInteractiveExample("pages/js/promise-resolve.html")}} -
-

Attention : Promise.resolve() ne doit pas être appelée sur un objet thenable qui se résout en lui-même. Cela provoquera une récursion infinie et resolve() tentera d'aplatir ce qui ressemble à une promesse imbriquée à l'infini.

-
+> **Attention :** `Promise.resolve()` ne doit pas être appelée sur un objet _thenable_ qui se résout en lui-même. Cela provoquera une récursion infinie et `resolve()` tentera d'aplatir ce qui ressemble à une promesse imbriquée à l'infini. -

Syntaxe

+## Syntaxe -
Promise.resolve(valeur);
-Promise.resolve(promesse);
-Promise.resolve(suivant);
-
+ Promise.resolve(valeur); + Promise.resolve(promesse); + Promise.resolve(suivant); -

Paramètres

+### Paramètres -
-
valeur
-
L'argument qu'on souhaite résoudre avec cette promesse (Promise). Cet argument peut être un objet Promise ou un objet avec une méthode then à résoudre à la suite.
-
+- `valeur` + - : L'argument qu'on souhaite résoudre avec cette promesse (`Promise`). Cet argument peut être un objet `Promise` ou un objet avec une méthode `then` à résoudre à la suite. -

Valeur de retour

+### Valeur de retour -

Une promesse ({{jsxref("Promise")}}) qui est résolue avec la valeur indiquée en argument ou la promesse passée en argument si celui-ci est une promesse.

+Une promesse ({{jsxref("Promise")}}) qui est résolue avec la valeur indiquée en argument ou la promesse passée en argument si celui-ci est une promesse. -

Description

+## Description -

La fonction statique Promise.resolve renvoie un objet Promise qui est résolu.

+La fonction statique `Promise.resolve` renvoie un objet `Promise` qui est résolu. -

Exemples

+## Exemples -

Utilisation de la méthode statique Promise.resolve

+### Utilisation de la méthode statique `Promise.resolve` -
Promise.resolve("Succès").then(function(valeur) {
+```js
+Promise.resolve("Succès").then(function(valeur) {
   console.log(valeur); // "Succès"
 }, function(valeur) {
   // n'est pas appelée
 });
-
+``` -

Résoudre un tableau

+### Résoudre un tableau -
var p = Promise.resolve([1,2,3]);
+```js
+var p = Promise.resolve([1,2,3]);
 p.then(function(v) {
   console.log(v[0]); // 1
 });
-
+``` -

Résoudre une autre Promise

+### Résoudre une autre `Promise` -
var original = Promise.resolve(33);
+```js
+var original = Promise.resolve(33);
 var cast = Promise.resolve(original);
 cast.then(function(value) {
   console.log("value: " + value);
@@ -73,13 +71,14 @@ console.log("original === cast ? " + (original === cast));
 // affiche ceci dans la console (dans cet ordre) :
 // original === cast ? true
 // value: 33
-
+``` -

L'ordre des traces dans la console est dû au fait que les gestionnaires then() sont appelés de façon asynchrone (plus de détails sur then dans cet article).

+L'ordre des traces dans la console est dû au fait que les gestionnaires `then()` sont appelés de façon asynchrone (plus de détails sur `then` [dans cet article](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise/then#Valeur_de_retour)). -

Résoudre des objets avec then et renvoyer des erreurs

+### Résoudre des objets avec `then` et renvoyer des erreurs -
// Résoudre un objet avec then
+```js
+// Résoudre un objet avec then
 var p1 = Promise.resolve({
   then: function(onFulfill, onReject) { onFulfill("tenue !"); }
 });
@@ -118,36 +117,19 @@ p3.then(function(v) {
 }, function(e) {
   // n'est pas appelée
 });
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-promise.reject', 'Promise.reject')}}{{Spec2('ES2015')}}Définition initiale au sein d'un standard ECMA.
{{SpecName('ESDraft', '#sec-promise.resolve', 'Promise.resolve')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Promise.resolve")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------- | +| {{SpecName('ES2015', '#sec-promise.reject', 'Promise.reject')}} | {{Spec2('ES2015')}} | Définition initiale au sein d'un standard ECMA. | +| {{SpecName('ESDraft', '#sec-promise.resolve', 'Promise.resolve')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Promise.resolve")}} + +## Voir aussi + +- {{jsxref("Promise")}} -- cgit v1.2.3-54-g00ecf