Fungsi asinkron: membuat promise lebih ramah

Fungsi asinkron memungkinkan Anda menulis kode berbasis promise seolah-olah kode tersebut adalah sinkron.

Jake Archibald

Fungsi asinkron diaktifkan secara default di Chrome, Edge, Firefox, dan Safari, dan fungsi tersebut sangat luar biasa. Fungsi tersebut memungkinkan Anda menulis kode berbasis promise seolah-olah kode tersebut adalah sinkron, tetapi tanpa memblokir thread utama. Fungsi ini membuat kode asinkron Anda kurang "cerdas" dan lebih mudah dibaca.

Fungsi asinkron bekerja seperti ini:

async function myFirstAsyncFunction() {
  try {
    const fulfilledValue = await promise;
  } catch (rejectedValue) {
    // …
  }
}

Jika menggunakan kata kunci async sebelum definisi fungsi, Anda dapat menggunakan await dalam fungsi tersebut. Saat Anda melakukan await promise, fungsi tersebut akan dijeda dengan cara yang tidak memblokir hingga promise selesai. Jika promise itu terpenuhi, Anda akan mendapatkan nilainya kembali. Jika promise ditolak, nilai yang ditolak akan ditampilkan.

Dukungan browser

Contoh: mencatat pengambilan ke dalam log

Misalnya Anda ingin mengambil URL dan mencatat respons sebagai teks. Berikut adalah tampilannya dengan menggunakan promise:

function logFetch(url) {
  return fetch(url)
    .then((response) => response.text())
    .then((text) => {
      console.log(text);
    })
    .catch((err) => {
      console.error('fetch failed', err);
    });
}

Dan berikut adalah fungsi yang sama dengan menggunakan fungsi asinkron:

async function logFetch(url) {
  try {
    const response = await fetch(url);
    console.log(await response.text());
  } catch (err) {
    console.log('fetch failed', err);
  }
}

Jumlah barisnya sama, tetapi semua callback hilang. Hal ini membuat membaca menjadi lebih mudah, terutama bagi mereka yang kurang memahami promise.

Nilai yang ditampilkan asinkron

Fungsi asinkron selalu menampilkan promise, baik Anda menggunakan await atau tidak. Promise tersebut di-resolve dengan fungsi asinkron apa pun yang ditampilkan, atau ditolak dengan apa pun yang ditampilkan fungsi asinkron. Jadi dengan:

// wait ms milliseconds
function wait(ms) {
  return new Promise((r) => setTimeout(r, ms));
}

async function hello() {
  await wait(500);
  return 'world';
}

...memanggil hello() menampilkan promise yang memenuhi dengan "world".

async function foo() {
  await wait(500);
  throw Error('bar');
}

...memanggil foo() menampilkan promise yang ditolak dengan Error('bar').

Contoh: menstreaming respons

Manfaat fungsi asinkron meningkat dalam contoh yang lebih kompleks. Misalnya Anda ingin melakukan streaming respons sambil logout dari potongan, dan menampilkan ukuran akhir.

Ini dia dengan promise:

function getResponseSize(url) {
  return fetch(url).then((response) => {
    const reader = response.body.getReader();
    let total = 0;

    return reader.read().then(function processResult(result) {
      if (result.done) return total;

      const value = result.value;
      total += value.length;
      console.log('Received chunk', value);

      return reader.read().then(processResult);
    });
  });
}

Lihat saya, Jake "wielder of promises" Archibald. Lihat cara saya memanggil processResult() dalam dirinya sendiri untuk menyiapkan loop asinkron? Menulis hal yang membuat saya merasa sangat cerdas. Tapi seperti kebanyakan kode "cerdas", Anda harus menatapnya berusia dewasa untuk mencari tahu apa yang dilakukannya, seperti salah satu gambar mata ajaib dari tahun 90-an.

Mari kita coba lagi dengan fungsi asinkron:

async function getResponseSize(url) {
  const response = await fetch(url);
  const reader = response.body.getReader();
  let result = await reader.read();
  let total = 0;

  while (!result.done) {
    const value = result.value;
    total += value.length;
    console.log('Received chunk', value);
    // get the next result
    result = await reader.read();
  }

  return total;
}

Semua "kecerdasan" hilang. Loop asinkron yang membuat saya merasa begitu puas diganti dengan sementara-loop yang terpercaya dan membosankan. Jauh lebih baik. Di masa mendatang, Anda akan mendapatkan iterator asinkron, yang akan menggantikan loop while dengan loop for-of, sehingga membuatnya lebih rapi.

Sintaksis fungsi asinkron lainnya

Saya sudah menunjukkan async function() {} kepada Anda, tetapi kata kunci async dapat digunakan dengan sintaksis fungsi lainnya:

Fungsi panah

// map some URLs to json-promises
const jsonPromises = urls.map(async (url) => {
  const response = await fetch(url);
  return response.json();
});

Metode objek

const storage = {
  async getAvatar(name) {
    const cache = await caches.open('avatars');
    return cache.match(`/avatars/${name}.jpg`);
  }
};

storage.getAvatar('jaffathecake').then(…);

Metode class

class Storage {
  constructor() {
    this.cachePromise = caches.open('avatars');
  }

  async getAvatar(name) {
    const cache = await this.cachePromise;
    return cache.match(`/avatars/${name}.jpg`);
  }
}

const storage = new Storage();
storage.getAvatar('jaffathecake').then(…);

Hati-hati! Hindari terlalu berurutan

Meskipun Anda menulis kode yang terlihat sinkron, pastikan Anda tidak melewatkan kesempatan untuk melakukan hal-hal secara paralel.

async function series() {
  await wait(500); // Wait 500ms…
  await wait(500); // …then wait another 500ms.
  return 'done!';
}

Fungsi di atas membutuhkan waktu 1.000 md untuk diselesaikan, sedangkan:

async function parallel() {
  const wait1 = wait(500); // Start a 500ms timer asynchronously…
  const wait2 = wait(500); // …meaning this timer happens in parallel.
  await Promise.all([wait1, wait2]); // Wait for both timers in parallel.
  return 'done!';
}

Fungsi di atas memerlukan waktu 500 md untuk diselesaikan, karena kedua proses tunggu terjadi secara bersamaan. Mari kita lihat sebuah contoh praktis.

Contoh: membuat output pengambilan secara berurutan

Misalnya Anda ingin mengambil serangkaian URL dan mencatatnya sesegera mungkin, dalam urutan yang benar.

napas dalam-dalam - berikut ini tampilannya dengan promise:

function markHandled(promise) {
  promise.catch(() => {});
  return promise;
}

function logInOrder(urls) {
  // fetch all the URLs
  const textPromises = urls.map((url) => {
    return markHandled(fetch(url).then((response) => response.text()));
  });

  // log them in order
  return textPromises.reduce((chain, textPromise) => {
    return chain.then(() => textPromise).then((text) => console.log(text));
  }, Promise.resolve());
}

Ya, benar, saya menggunakan reduce untuk merangkai urutan promise. Saya sangat cerdas. Tapi ini adalah coding yang sangat cerdas, yang akan lebih baik jika Anda tidak melakukannya.

Namun, saat mengonversi di atas menjadi fungsi asinkron, Anda mungkin ingin menggunakan terlalu berurutan:

async function logInOrder(urls) {
  for (const url of urls) {
    const response = await fetch(url);
    console.log(await response.text());
  }
}

function markHandled(...promises) {
  Promise.allSettled(promises);
}

async function logInOrder(urls) {
  // fetch all the URLs in parallel
  const textPromises = urls.map(async (url) => {
    const response = await fetch(url);
    return response.text();
  });

  markHandled(...textPromises);

  // log them in sequence
  for (const textPromise of textPromises) {
    console.log(await textPromise);
  }
}

Solusi dukungan browser: generator

Jika menargetkan browser yang mendukung generator (yang mencakup versi terbaru dari setiap browser utama), Anda dapat mengurutkan fungsi asinkron polyfill.

Babel akan melakukannya untuk Anda, berikut contohnya melalui Babel REPL

• perhatikan betapa miripnya kode yang ditranspilasi. Transformasi ini adalah bagian dari preset es2017 Babel.

Saya merekomendasikan pendekatan transpiling, karena Anda dapat menonaktifkannya setelah browser target mendukung fungsi asinkron, tetapi jika Anda benar-benar tidak ingin menggunakan transpiler, Anda dapat mengambil polyfill Babel dan menggunakannya sendiri. Jangan gunakan:

async function slowEcho(val) {
  await wait(1000);
  return val;
}

...Anda akan menyertakan polyfill dan menulis:

const slowEcho = createAsyncFunction(function* (val) {
  yield wait(1000);
  return val;
});

Perhatikan bahwa Anda harus meneruskan generator (function*) ke createAsyncFunction, dan menggunakan yield, bukan await. Selain itu, cara kerjanya sama.

Solusi: regenerator

Jika Anda menargetkan browser lama, Babel juga dapat melakukan transpilasi generator, sehingga Anda dapat menggunakan fungsi asinkron hingga ke IE8. Untuk melakukannya, Anda memerlukan preset es2017 Babel dan preset es2015.

Outputnya tidak terlalu bagus, jadi berhati-hatilah terhadap code-bloat.

Sinkronkan semua hal.

Setelah fungsi asinkron ditempatkan di semua browser, gunakan fungsi tersebut di setiap fungsi yang menampilkan promise. Fungsi ini tidak hanya membuat kode Anda lebih rapi, tetapi juga memastikan bahwa fungsi tersebut akan selalu menampilkan promise.

Saya sangat tertarik dengan fungsi asinkron pada 2014, dan senang sekali melihat fungsi tersebut muncul, sungguhan, di browser. Wah!