Memperkenalkan Pengambilan Latar Belakang

Jake Archibald

Pada tahun 2015 kami memperkenalkan Sinkronisasi Latar Belakang yang memungkinkan pekerja layanan untuk menunda pekerjaan hingga pengguna memiliki konektivitas. Ini berarti pengguna bisa mengetik pesan, tekan kirim, dan tinggalkan situs bahwa pesan akan dikirim sekarang atau saat mereka memiliki konektivitas.

Ini adalah fitur yang berguna, tetapi mengharuskan pekerja layanan hidup selama durasi pengambilan. Itu bukan masalah untuk pekerjaan singkat seperti mengirim pesan, tetapi jika tugas itu terlalu lama browser akan mematikan pekerja layanan, jika tidak, ini merupakan risiko bagi privasi pengguna dan daya baterai.

Jadi, bagaimana jika Anda perlu mengunduh sesuatu yang mungkin memakan waktu lama, seperti film, podcast, atau level game. Itulah kegunaan Background Fetch.

Pengambilan Latar Belakang tersedia secara default sejak Chrome 74.

Berikut ini demo singkat dua menit yang menunjukkan status biasanya, vs menggunakan Pengambilan Latar Belakang:

Coba demo sendiri lalu jelajahi kodenya.

Cara kerjanya

Pengambilan latar belakang berfungsi seperti ini:

1. Anda memberi tahu browser untuk melakukan sekelompok pengambilan di latar belakang.
2. Browser mengambil hal-hal tersebut, menampilkan progres kepada pengguna.
3. Setelah pengambilan selesai atau gagal, browser akan membuka pekerja layanan Anda dan mengaktifkan peristiwa untuk memberi tahu Anda apa yang terjadi. Di sinilah Anda memutuskan apa yang akan dilakukan dengan respons, jika ada.

Jika pengguna menutup halaman ke situs Anda setelah langkah 1, tidak apa-apa, download akan dilanjutkan. Karena pengambilan sangat terlihat dan mudah dibatalkan, tidak ada masalah privasi yang terlalu panjang tugas sinkronisasi latar belakang. Karena pekerja layanan tidak terus-menerus berjalan, jangan khawatir bahwa itu dapat menyalahgunakan sistem, seperti menambang bitcoin di latar belakang.

Pada beberapa platform (seperti Android) browser dapat ditutup setelah langkah 1, karena browser dapat menyerahkan pengambilan ke sistem operasi.

Jika pengguna memulai download saat offline, atau offline selama download, latar belakang pengambilan akan dijeda dan dilanjutkan nanti.

API

Deteksi fitur

Seperti fitur baru lainnya, Anda perlu mendeteksi apakah browser mendukungnya. Untuk Pengambilan Latar Belakang, sesederhana:

if ('BackgroundFetchManager' in self) {
  // This browser supports Background Fetch!
}

Memulai pengambilan latar belakang

API utama menghentikan pendaftaran service worker, jadi pastikan Anda telah mendaftarkan pekerja layanan terlebih dahulu. Lalu:

navigator.serviceWorker.ready.then(async (swReg) => {
  const bgFetch = await swReg.backgroundFetch.fetch('my-fetch', ['/ep-5.mp3', 'ep-5-artwork.jpg'], {
    title: 'Episode 5: Interesting things.',
    icons: [{
      sizes: '300x300',
      src: '/ep-5-icon.png',
      type: 'image/png',
    }],
    downloadTotal: 60 * 1024 * 1024,
  });
});

backgroundFetch.fetch menggunakan tiga argumen:

backgroundFetch.fetch menampilkan promise yang di-resolve dengan BackgroundFetchRegistration. Saya akan membahasnya secara detail nanti. Promise akan ditolak jika pengguna memilih untuk tidak ikut mendownload, atau satu parameter yang diberikan tidak valid.

Menyediakan banyak permintaan untuk satu pengambilan di latar belakang memungkinkan Anda menggabungkan hal-hal yang secara logis satu hal kepada pengguna. Misalnya, sebuah film dapat dibagi menjadi ribuan sumber daya (biasanya MPEG-DASH), dan dilengkapi dengan sumber daya tambahan seperti gambar. Satu level game dapat tersebar di banyak Referensi JavaScript, gambar, dan audio. Namun, bagi pengguna, ini hanyalah "film", atau "level".

Mendapatkan pengambilan latar belakang yang ada

Anda dapat memperoleh pengambilan latar belakang yang ada seperti ini:

navigator.serviceWorker.ready.then(async (swReg) => {
  const bgFetch = await swReg.backgroundFetch.get('my-fetch');
});

...dengan meneruskan id pengambilan latar belakang yang Anda inginkan. get menampilkan undefined jika tidak ada pengambilan di latar belakang aktif dengan ID tersebut.

Pengambilan di latar belakang dianggap "aktif" sejak didaftarkan, hingga berhasil, gagal, atau dibatalkan.

Anda dapat memperoleh daftar semua pengambilan di latar belakang yang aktif menggunakan getIds:

navigator.serviceWorker.ready.then(async (swReg) => {
  const ids = await swReg.backgroundFetch.getIds();
});

Pendaftaran pengambilan latar belakang

BackgroundFetchRegistration (bgFetch dalam contoh di atas) memiliki hal berikut:

Memantau progres

Hal ini dapat dilakukan melalui peristiwa progress. Ingat bahwa downloadTotal adalah nilai berapa pun yang Anda diberikan, atau 0 jika Anda tidak memberikan nilai.

bgFetch.addEventListener('progress', () => {
  // If we didn't provide a total, we can't provide a %.
  if (!bgFetch.downloadTotal) return;

  const percent = Math.round(bgFetch.downloaded / bgFetch.downloadTotal * 100);
  console.log(`Download progress: ${percent}%`);
});

Mendapatkan permintaan dan respons

bgFetch.match('/ep-5.mp3').then(async (record) => {
  if (!record) {
    console.log('No record found');
    return;
  }

  console.log(`Here's the request`, record.request);
  const response = await record.responseReady;
  console.log(`And here's the response`, response);
});

record adalah BackgroundFetchRecord, dan terlihat seperti ini:

Peristiwa pekerja layanan

Objek peristiwa memiliki hal berikut:

Bereaksi terhadap keberhasilan/kegagalan

Kita telah melihat peristiwa progress, tetapi itu hanya berguna saat pengguna memiliki halaman yang terbuka untuk di situs Anda. Manfaat utama pengambilan di latar belakang adalah segala sesuatunya akan terus berfungsi setelah pengguna meninggalkan halaman, atau bahkan menutup browser.

Jika pengambilan di latar belakang berhasil diselesaikan, pekerja layanan Anda akan menerima Peristiwa backgroundfetchsuccess, dan event.registration akan menjadi pendaftaran pengambilan latar belakang.

Setelah peristiwa ini, permintaan dan respons yang diambil tidak lagi dapat diakses, sehingga jika Anda ingin menyimpannya, memindahkannya ke tempat lain seperti cache API.

Seperti kebanyakan peristiwa pekerja layanan, gunakan event.waitUntil agar pekerja layanan tahu kapan peristiwa terjadi sudah lengkap.

Misalnya, dalam pekerja layanan Anda:

addEventListener('backgroundfetchsuccess', (event) => {
  const bgFetch = event.registration;

  event.waitUntil(async function() {
    // Create/open a cache.
    const cache = await caches.open('downloads');
    // Get all the records.
    const records = await bgFetch.matchAll();
    // Copy each request/response across.
    const promises = records.map(async (record) => {
      const response = await record.responseReady;
      await cache.put(record.request, response);
    });

    // Wait for the copying to complete.
    await Promise.all(promises);

    // Update the progress notification.
    event.updateUI({ title: 'Episode 5 ready to listen!' });
  }());
});

Kegagalan mungkin disebabkan oleh satu 404, yang mungkin tidak penting bagi Anda, menyalin beberapa respons ke dalam {i>cache<i} seperti di atas.

Bereaksi terhadap klik

UI yang menampilkan progres download dan hasilnya dapat diklik. Peristiwa backgroundfetchclick di pekerja layanan memungkinkan Anda bereaksi terhadap ini. Seperti di atas, event.registration akan menjadi latar belakang pendaftaran pengambilan.

Hal yang umum dilakukan dengan peristiwa ini adalah membuka jendela:

addEventListener('backgroundfetchclick', (event) => {
  const bgFetch = event.registration;

  if (bgFetch.result === 'success') {
    clients.openWindow('/latest-podcasts');
  } else {
    clients.openWindow('/download-progress');
  }
});

Referensi lainnya

• Penjelasan
• Spesifikasi
• entri chromestatus.com

Koreksi: Versi sebelumnya dari artikel ini salah menyebut Pengambilan Latar Belakang sebagai "standar web". API ini saat ini tidak berada di jalur standar, spesifikasinya dapat ditemukan di WICG sebagai Draf Laporan Grup Komunitas.