BAB 53: Web API - Pengenalan
Pengenalan Web API yang bisa diakses langsung dari browser tanpa library.
Portofolio Budi sudah bisa menampilkan video YouTube, memutar audio, menggambar grafik di canvas, dan menyematkan dokumen PDF. Semua itu dilakukan dengan elemen HTML dan sedikit JavaScript. Tapi kemampuan browser tidak berhenti di situ.
Browser modern menyediakan ratusan Web API: antarmuka pemrograman yang memungkinkan halaman web berinteraksi dengan fitur perangkat dan sistem operasi secara langsung. Lokasi geografis pengguna, penyimpanan data di browser, komunikasi real-time dengan server, bahkan menjalankan kode di thread terpisah, semua bisa dilakukan tanpa menginstal library tambahan. API ini sudah ada di dalam browser, menunggu untuk dipanggil.
Apa Itu Web API
API adalah singkatan dari Application Programming Interface. Dalam konteks web, Web API adalah sekumpulan method dan properti yang disediakan oleh browser agar JavaScript bisa mengakses fitur-fitur yang tidak mungkin dijangkau oleh HTML dan CSS saja.
Kamu sudah menggunakan Web API tanpa menyadarinya. Setiap kali menulis document.getElementById() di bab-bab sebelumnya, itu adalah pemanggilan DOM API: Web API yang paling mendasar. Canvas yang kita gambar di Bab 46 juga menggunakan Canvas API. Keduanya adalah Web API, hanya saja kita belum menyebutnya secara eksplisit.
Perbedaan Web API dengan library atau framework:
| Aspek | Web API | Library/Framework |
|---|---|---|
| Sumber | Bawaan browser | Diinstal terpisah |
| Kebutuhan download | Tidak perlu | Perlu download file JS |
| Standarisasi | Diatur oleh W3C dan WHATWG | Diatur oleh pembuatnya |
| Contoh | Geolocation, Web Storage | jQuery, React, Vue |
Cara Kerja Web API
Setiap Web API menyediakan objek yang bisa diakses melalui JavaScript. Objek ini memiliki method (fungsi) dan properti (data) yang bisa kamu panggil. Pola umumnya:
<!-- contoh-api.html -->
<script>
// 1. Akses objek API
// 2. Panggil method yang dibutuhkan
// 3. Tangani hasilnya (biasanya lewat callback atau Promise)
</script>
Sebagian besar Web API bersifat asinkron: artinya hasilnya tidak langsung tersedia saat dipanggil. Ini masuk akal karena operasi seperti meminta izin lokasi atau menunggu data dari server membutuhkan waktu. Browser menggunakan callback function atau Promise untuk memberitahu kode kamu saat hasilnya sudah siap.
Contoh paling sederhana, mengecek lebar dan tinggi layar menggunakan objek screen:
<!-- info-layar.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Info Layar</title>
</head>
<body>
<h1>Informasi Layar</h1>
<p id="info"></p>
<script>
var lebar = screen.width;
var tinggi = screen.height;
var kedalaman = screen.colorDepth;
document.getElementById("info").innerHTML =
"Resolusi: " + lebar + " x " + tinggi + " piksel<br>" +
"Kedalaman warna: " + kedalaman + " bit";
</script>
</body>
</html>
Objek screen adalah bagian dari Screen API: salah satu Web API yang paling sederhana. Ia tidak membutuhkan izin pengguna dan hasilnya langsung tersedia tanpa callback.
Web API yang Akan Kita Pelajari
Di bab-bab selanjutnya, kita akan mempraktikkan lima Web API yang paling berguna dan sering digunakan:
-
Geolocation API: Mendapatkan koordinat lokasi pengguna (latitude dan longitude) dari GPS atau jaringan. Berguna untuk aplikasi peta, pencarian tempat terdekat, atau personalisasi konten berdasarkan lokasi.
-
Drag and Drop API: Membuat elemen di halaman bisa diseret dan dijatuhkan ke area tertentu. Digunakan untuk antarmuka yang intuitif seperti mengatur urutan item, mengunggah file dengan menyeretnya, atau memindahkan kartu antar kolom.
-
Web Storage API: Menyimpan data langsung di browser pengguna menggunakan
localStoragedansessionStorage. Data tetap ada meskipun halaman ditutup, cocok untuk menyimpan preferensi tema, data form yang belum dikirim, atau keranjang belanja. -
Web Workers API: Menjalankan JavaScript di thread terpisah agar tugas berat (perhitungan kompleks, pemrosesan data besar) tidak membuat halaman menjadi lambat atau tidak responsif.
-
Server-Sent Events: Menerima update data secara real-time dari server tanpa harus terus-menerus melakukan request. Berguna untuk notifikasi, feed berita, atau dashboard yang menampilkan data terkini.
Memeriksa Dukungan Browser
Tidak semua browser mendukung semua Web API. Sebelum menggunakan API tertentu, ada baiknya memeriksa apakah browser pengguna mendukungnya. Caranya dengan mengecek apakah objek API tersebut ada di dalam objek window atau navigator:
<!-- cek-dukungan.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Cek Dukungan API</title>
</head>
<body>
<h1>Dukungan Web API di Browser Ini</h1>
<ul id="daftar"></ul>
<script>
var daftar = document.getElementById("daftar");
var apiList = [
{ nama: "Geolocation", cek: "geolocation" in navigator },
{ nama: "Local Storage", cek: typeof Storage !== "undefined" },
{ nama: "Web Workers", cek: typeof Worker !== "undefined" },
{ nama: "Drag and Drop", cek: "draggable" in document.createElement("div") },
{ nama: "Server-Sent Events", cek: typeof EventSource !== "undefined" }
];
for (var i = 0; i < apiList.length; i++) {
var item = document.createElement("li");
var status = apiList[i].cek ? "Didukung" : "Tidak didukung";
item.textContent = apiList[i].nama + ": " + status;
daftar.appendChild(item);
}
</script>
</body>
</html>
Buka file ini di browser, dan kamu akan melihat daftar Web API beserta status dukungannya. Di browser modern seperti Chrome, Firefox, dan Edge, semua API di daftar ini seharusnya didukung.
Untuk pengecekan dukungan browser yang lebih detail, situs Can I Use menyediakan data kompatibilitas lengkap untuk setiap fitur web, termasuk versi browser mana yang mulai mendukungnya.
Pola Umum: Izin Pengguna
Beberapa Web API menyentuh data sensitif, lokasi, kamera, mikrofon. Untuk API seperti ini, browser meminta izin eksplisit dari pengguna sebelum memberikan akses. Kamu tidak bisa mengakses lokasi pengguna diam-diam; browser akan menampilkan dialog izin terlebih dahulu.
+--------------------------------------------+
| abdasis.dev ingin mengetahui lokasi Anda |
| |
| [Izinkan] [Blokir] |
+--------------------------------------------+
Jika pengguna menolak, API akan mengembalikan error, dan kode kamu harus siap menangani penolakan ini dengan baik. Ini adalah pola yang akan sering kita jumpai mulai dari bab Geolocation.
Latihan
-
Buka file
cek-dukungan.htmldi browser. Tambahkan pengecekan untuk dua API lain: Canvas (cek dengandocument.createElement("canvas").getContext) dan Fetch (cek dengantypeof fetch !== "undefined"). Tampilkan hasilnya di daftar yang sama. -
Buat halaman
info-browser.htmlyang menampilkan informasi tentang browser dan perangkat pengguna menggunakan objeknavigator. Tampilkannavigator.userAgent,navigator.language, dannavigator.onLinedi dalam elemen paragraf. -
Coba buka file
cek-dukungan.htmldi browser yang berbeda (Chrome, Firefox, Safari jika tersedia) dan bandingkan hasilnya.
Sekarang kamu sudah memahami apa itu Web API dan bagaimana cara kerjanya secara umum. Di bab berikutnya, kita akan langsung mempraktikkan salah satu Web API yang paling menarik (Geolocation API) yang memungkinkan halaman web mengetahui posisi fisik pengguna di dunia nyata.