diff options
Diffstat (limited to 'files/es/web/javascript/referencia/objetos_globales/promise/resolve/index.html')
-rw-r--r-- | files/es/web/javascript/referencia/objetos_globales/promise/resolve/index.html | 150 |
1 files changed, 150 insertions, 0 deletions
diff --git a/files/es/web/javascript/referencia/objetos_globales/promise/resolve/index.html b/files/es/web/javascript/referencia/objetos_globales/promise/resolve/index.html new file mode 100644 index 0000000000..e91dc7b80d --- /dev/null +++ b/files/es/web/javascript/referencia/objetos_globales/promise/resolve/index.html @@ -0,0 +1,150 @@ +--- +title: Promise.resolve() +slug: Web/JavaScript/Referencia/Objetos_globales/Promise/resolve +tags: + - ECMAScript 2015 + - JavaScript + - Promise + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Promise/resolve +--- +<div>{{JSRef}}</div> + +<p>El método <code><strong>Promise.resolve(value)</strong></code> retorna un objeto {{jsxref("Promise")}} que es resuelto con el valor dado. Si el valor es una <em>promise</em>, esa <em>promise </em>es devuelta; si el valor es un <em>thenable </em>(si tiene un {{jsxref("Promise.then", "método \"then\"")}}), el valor devuelto le seguirá a ese <em>thenable</em>, adoptando su estado; de otro modo la <em>promise</em> devuelta estará completada con el valor.</p> + +<div>{{EmbedInteractiveExample("pages/js/promise-resolve.html")}}</div> + +<p class="hidden">La fuente para esta demostración interactiva se encuentra en un repositorio de GitHub. Si te gustaría contribuir al proyecto de la demostración interactiva, por favor clona <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> y envíanos una <em>pull request</em>.</p> + +<h2 id="Sintáxis">Sintáxis</h2> + +<pre class="brush: js">Promise.resolve(value); +Promise.resolve(promise); +Promise.resolve(thenable); +</pre> + +<h3 id="Parámetros">Parámetros</h3> + +<dl> + <dt>value</dt> + <dd>Argumento por resolver por esta <code>Promise</code>. También puede ser una <code>Promise</code> o un <em>thenable</em> por resolver.</dd> +</dl> + +<h3 id="Valor_retornado">Valor retornado</h3> + +<p>Una {{jsxref("Promise")}} que es resuelta con el valor dado, o con la <em>promise </em>pasada como valor, si el valor era un objeto <em>promise</em>.</p> + +<h2 id="Descripción">Descripción</h2> + +<p>La función estática <code>Promise.resolve</code> retorna una <code>Promise</code> que es resuelta.</p> + +<h2 id="Ejemplos">Ejemplos</h2> + +<h3 id="Utilizando_el_método_estático_Promise.resolve">Utilizando el método estático <code>Promise.resolve</code></h3> + +<pre class="brush: js">Promise.resolve('Éxito').then(function(value) { + console.log(value); // "Éxito" +}, function(value) { + // no es llamada +}); +</pre> + +<h3 id="Resolviendo_un_arreglo">Resolviendo un arreglo</h3> + +<pre class="brush: js">var p = Promise.resolve([1,2,3]); +p.then(function(v) { + console.log(v[0]); // 1 +});</pre> + +<h3 id="Resolviendo_otra_Promise">Resolviendo otra <code>Promise</code></h3> + +<pre class="brush: js">var original = Promise.resolve(33); +var cast = Promise.resolve(original); +cast.then(function(value) { + console.log('valor: ' + value); +}); +console.log('original === cast ? ' + (original === cast)); + +// registros, en orden: +// original === cast ? true +// valor: 33 +</pre> + +<p>El orden invertido de los registros se debe al hecho de que los <em>handler </em><code>then</code> sean llamados asíncronamente. Vea cómo funciona <code>then</code> <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/then#Return_value">aquí</a>.</p> + +<h3 id="Resolviendo_thenables_y_arrojando_Errores">Resolviendo thenables y arrojando Errores</h3> + +<pre class="brush: js">// Resolviendo un objeto thenable +var p1 = Promise.resolve({ + then: function(onFulfill, onReject) { onFulfill('¡Completada!'); } +}); +console.log(p1 instanceof Promise) // true, objeto convertido en una Promise +j +p1.then(function(v) { + console.log(v); // "¡Completada!" + }, function(e) { + // no es llamada +}); + +// Thenable arroja antes del callback +// Rechaza la Promise +var thenable = { then: function(resolve) { + throw new TypeError('Arrojando'); + resolve('Resolviendo'); +}}; + +var p2 = Promise.resolve(thenable); +p2.then(function(v) { + // no es llamada +}, function(e) { + console.log(e); // TypeError: Arrojando +}); + +// Thenable arroja después del callback +// Resuelve la Promise +var thenable = { then: function(resolve) { + resolve('Resolviendo'); + throw new TypeError('Arrojando'); +}}; + +var p3 = Promise.resolve(thenable); +p3.then(function(v) { + console.log(v); // "Resolviendo" +}, function(e) { + // no es llamada +}); +</pre> + +<h2 id="Especificaciones">Especificaciones</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificación</th> + <th scope="col">Estado</th> + <th scope="col">Comentario</th> + </tr> + <tr> + <td>{{SpecName('ES2015', '#sec-promise.resolve', 'Promise.resolve')}}</td> + <td>{{Spec2('ES2015')}}</td> + <td>Definición inicial en un estándar de ECMA.</td> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-promise.resolve', 'Promise.resolve')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilidad_con_navegadores">Compatibilidad con navegadores</h2> + +<p class="hidden">Para contribuir a esta información de compatibilidad, porfavor haz una <em>pull request</em> contra este repositorio: <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</p> + +<p>{{Compat("javascript.builtins.Promise.resolve")}}</p> + +<h2 id="Véase_también">Véase también</h2> + +<ul> + <li>{{jsxref("Promise")}}</li> +</ul> |