aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/javascript/reference/statements/async_function
diff options
context:
space:
mode:
Diffstat (limited to 'files/pt-br/web/javascript/reference/statements/async_function')
-rw-r--r--files/pt-br/web/javascript/reference/statements/async_function/index.html150
1 files changed, 150 insertions, 0 deletions
diff --git a/files/pt-br/web/javascript/reference/statements/async_function/index.html b/files/pt-br/web/javascript/reference/statements/async_function/index.html
new file mode 100644
index 0000000000..506bec9063
--- /dev/null
+++ b/files/pt-br/web/javascript/reference/statements/async_function/index.html
@@ -0,0 +1,150 @@
+---
+title: Funções assíncronas
+slug: Web/JavaScript/Reference/Statements/async_function
+tags:
+ - Função
+ - assíncrono
+translation_of: Web/JavaScript/Reference/Statements/async_function
+original_slug: Web/JavaScript/Reference/Statements/funcoes_assincronas
+---
+<div>{{jsSidebar("Statements")}}</div>
+
+<p>A declaração <code><strong>async function</strong></code> define uma <em>função assíncrona</em>, que retorna um objeto {{jsxref("Global_Objects/AsyncFunction","AsyncFunction")}}.</p>
+
+<div class="noinclude">
+<p>Você também pode definir funções assíncronas usando uma {{jsxref("Operators/async_function", "expressão async function")}}.</p>
+</div>
+
+<h2 id="Sintaxe">Sintaxe</h2>
+
+<pre class="syntaxbox">async function <em>nome</em>([<em>param</em>[, <em>param</em>[, ... <em>param</em>]]]) {
+ <em>instruções</em>
+}
+</pre>
+
+<dl>
+ <dt><code>nome</code></dt>
+ <dd>O nome da função.</dd>
+</dl>
+
+<dl>
+ <dt><code>param</code></dt>
+ <dd>O nome de um parâmetro a ser passado para a função.</dd>
+</dl>
+
+<dl>
+ <dt><code>instruções</code></dt>
+ <dd>As instruções que compõem o corpo da função.</dd>
+</dl>
+
+<h2 id="Descrição">Descrição</h2>
+
+<p>Quando uma função assíncrona é chamada, ela retorna uma {{jsxref("Promise")}}. Quando a função assíncrona retorna um valor, a <code>Promise</code> será resolvida com o valor retornado. Quando a função assíncrona lança uma exceção ou algum valor, a <code>Promise</code> será rejeitada com o valor lançado.</p>
+
+<p>Uma função assíncrona pode conter uma expressão {{jsxref("Operators/await", "await")}}, que pausa a execução da função assíncrona e espera pela resolução da <code>Promise </code>passada, e depois retoma a execução da função assíncrona e retorna o valor resolvido.</p>
+
+<div class="note">
+<p>A proposta das funções <code>async/await</code> é de simplificar o uso de forma síncrona das <code>Promises</code> e executar alguns procedimentos em um grupo de <code>Promises</code>. Assim como <code>Promises</code> são similares a <code>callbacks</code> estruturados, funções <code>async/await</code> são similares à junção de <code>generators</code> com <code>P</code><code>romises</code>.</p>
+</div>
+
+<h2 id="Exemplos">Exemplos</h2>
+
+<h3 id="Exemplo_simples">Exemplo simples</h3>
+
+<pre class="brush: js">function resolverDepoisDe2Segundos(x) {
+ return new Promise(resolve =&gt; {
+ setTimeout(() =&gt; {
+ resolve(x);
+ }, 2000);
+ });
+}
+
+async function adicionar1(x) {
+ var a = resolverDepoisDe2Segundos(20);
+ var b = resolverDepoisDe2Segundos(30);
+ return x + await a + await b;
+}
+
+adicionar1(10).then(v =&gt; {
+ console.log(v); // exibe 60 depois de 2 segundos.
+});
+
+async function adicionar2(x) {
+ var a = await resolverDepoisDe2Segundos(20);
+ var b = await resolverDepoisDe2Segundos(30);
+ return x + a + b;
+}
+
+adicionar2(10).then(v =&gt; {
+ console.log(v); // exibe 60 depois de 4 segundos.
+});
+</pre>
+
+<h3 id="Reescrevendo_uma_cadeia_de_Promise_com_uma_função_async">Reescrevendo uma cadeia de <code>Promise</code> com uma função <code>async</code></h3>
+
+<p>Uma API que retorna uma {{jsxref("Promise")}} vai resultar em uma cadeia de <code>Promises</code> e separa a função em várias partes. Considere o seguinte código:</p>
+
+<pre class="brush: js">function pegarDadosProcessados(url) {
+ return baixarDados(url) // retorna uma Promise
+ .catch(e =&gt; {
+ return baixarDadosReservas(url) // retorna uma Promise
+ })
+ .then(v =&gt; {
+ return processarDadosNoWorker(v); // retorna uma Promise
+ });
+}
+</pre>
+
+<p>pode ser escrita em uma única função <code>async</code> desta forma:</p>
+
+<pre class="brush: js">async function pegarDadosProcessados(url) {
+ let v;
+ try {
+ v = await baixarDados(url);
+ } catch(e) {
+ v = await baixarDadosReservas(url);
+ }
+ return processarDadosNoWorker(v);
+}
+</pre>
+
+<p>Note que no exemplo acima não tem a instrução <code>await</code> na instrução do <code>return</code>, porque o valor retornado de uma função <code>async é </code>implícitamente passado por um {{jsxref("Promise.resolve")}}.</p>
+
+<h2 id="Especificações">Especificações</h2>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">Especificação</th>
+ <th scope="col">Situação</th>
+ <th scope="col">Comentário</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>{{SpecName('ESDraft', '#sec-async-function-definitions', 'async function')}}</td>
+ <td>{{Spec2('ESDraft')}}</td>
+ <td>Definição inicial no ES2017.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilidade_de_browser">Compatibilidade de browser</h2>
+
+<div>{{Compat("javascript.statements.async_function")}}</div>
+
+<div id="compat-desktop"></div>
+
+<h3 id="Notas_específicas_do_Firefox">Notas específicas do Firefox</h3>
+
+<ul>
+ <li>A função <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Expression_closures">expression closure syntax</a> não é permitida com funções assíncronas e irão lançar a exceção <a href="/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError">SyntaxError</a> a partir do Firefox 55.</li>
+</ul>
+
+<h2 id="Veja_também">Veja também</h2>
+
+<ul>
+ <li><a href="/pt-BR/docs/Web/JavaScript/Reference/Operators/async_function">async_function</a></li>
+ <li><a href="/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction">AsyncFunction</a></li>
+ <li><a href="/pt-BR/docs/Web/JavaScript/Reference/Operators/await">await</a></li>
+</ul>