Dalam dunia pengembangan web dan aplikasi, sering kali kita menemukan error yang terdengar rumit namun sebenarnya cukup umum. Salah satunya adalah ERR_UNKNOWN_URL_SCHEME. Pesan error ini biasanya muncul pada browser seperti Google Chrome, Microsoft Edge, maupun aplikasi berbasis WebView (misalnya di Android). Bagi seorang developer maupun pengguna biasa, error ini bisa membingungkan karena terkait dengan protokol URL yang tidak dikenali.
Pada artikel ini kita akan membahas secara mendalam tentang error ini, mulai dari pengertian, penyebab utama, cara mengatasinya, hingga praktik terbaik agar tidak terjadi lagi di masa depan.
Apa Itu ERR_UNKNOWN_URL_SCHEME?
Secara sederhana, ERR_UNKNOWN_URL_SCHEME adalah pesan error yang muncul ketika browser atau aplikasi tidak mengenali skema URL (URL scheme) yang digunakan.
Untuk lebih jelas, mari kita pahami dulu apa itu URL scheme.
- URL (Uniform Resource Locator) adalah alamat yang kita gunakan untuk mengakses sesuatu di internet, misalnya https://google.com.
- Scheme adalah bagian awal dari URL yang menjelaskan cara browser atau aplikasi harus menangani alamat tersebut. Misalnya:
- http:// atau https:// → membuka halaman web
- mailto: → membuka aplikasi email
- tel: → melakukan panggilan telepon
- whatsapp:// → membuka aplikasi WhatsApp
Nah, error ERR_UNKNOWN_URL_SCHEME muncul ketika browser atau aplikasi tidak tahu cara menangani scheme tersebut.
Contoh:
- Jika sebuah website punya tombol “Chat via WhatsApp” dengan link whatsapp://send?phone=628123456789, lalu kamu buka lewat browser desktop (yang tidak punya aplikasi WhatsApp), maka akan muncul error ini.
- Atau, jika ada kesalahan penulisan pada link, misalnya htttp:// (dengan tiga huruf “t”), browser juga tidak akan mengenalinya dan memunculkan error.
Mengapa Error Ini Bisa Terjadi?
Ada beberapa penyebab umum mengapa ERR_UNKNOWN_URL_SCHEME terjadi, di antaranya:
1. Skema URL Tidak Dikenal oleh Browser
Setiap URL selalu diawali dengan scheme (skema) yang memberi tahu browser bagaimana cara menangani tautan tersebut. Contohnya:
- http:// → membuka situs dengan protokol standar
- https:// → membuka situs dengan protokol aman
- ftp:// → mengakses file via FTP
- file:// → membuka file lokal di perangkat
Selain skema standar, ada juga skema khusus yang dibuat untuk aplikasi tertentu, misalnya:
- whatsapp:// → untuk membuka WhatsApp
- tg:// → untuk membuka Telegram
- zoommtg:// → untuk membuka aplikasi Zoom
Browser hanya bisa mengenali skema tertentu. Jika menemukan skema yang tidak ia pahami, browser akan menolak membukanya dan menampilkan error ERR_UNKNOWN_URL_SCHEME.
Contoh nyata:
Seseorang mengklik tombol “Hubungi via WhatsApp” di sebuah website dari browser laptop. Karena laptop tersebut tidak punya aplikasi WhatsApp dengan dukungan URL scheme, browser bingung harus berbuat apa. Akhirnya muncullah error ini.
2. Aplikasi yang Dibutuhkan Tidak Terinstal
Beberapa skema URL tidak bisa berdiri sendiri, melainkan butuh aplikasi tertentu di perangkat.
- whatsapp:// hanya bisa dibuka jika aplikasi WhatsApp sudah terpasang.
- tg:// hanya berfungsi jika aplikasi Telegram tersedia.
- intent:// di Android biasanya membutuhkan aplikasi target tertentu.
Jika aplikasi yang dimaksud tidak ada, maka browser tidak dapat melanjutkan perintah. Inilah salah satu alasan umum mengapa error ini sering muncul pada perangkat baru atau browser yang tidak terhubung dengan aplikasi terkait.
Contoh:
Pengguna mengetuk link tg://resolve?domain=channelxyz untuk membuka channel Telegram. Jika Telegram belum terinstal, browser akan langsung menampilkan ERR_UNKNOWN_URL_SCHEME.
3. Kesalahan Penulisan atau Format URL
Typo kecil dalam menulis URL dapat menyebabkan browser gagal mengenali skema. Karena browser bekerja berdasarkan aturan ketat, kesalahan sekecil apa pun dianggap sebagai skema yang tidak valid.
Kesalahan umum misalnya:
- Menulis htttp:// (tiga huruf “t”) alih-alih http://
- Menulis mailtoo: alih-alih mailto:
- Lupa menambahkan :// setelah skema
Bagi manusia, typo ini mungkin masih bisa dimengerti. Namun, bagi browser, kesalahan format adalah hal fatal yang membuatnya tidak tahu apa yang harus dilakukan.
Contoh:
Sebuah tombol email di website memiliki link mailtoo:support@email.com. Karena ada huruf ekstra, browser tidak mengenali perintah tersebut dan memunculkan ERR_UNKNOWN_URL_SCHEME.
4. Keterbatasan Browser atau WebView
Banyak aplikasi mobile menggunakan WebView untuk menampilkan halaman web di dalam aplikasi. WebView pada dasarnya adalah “mini browser”, tetapi sering kali tidak memiliki dukungan penuh untuk semua URL scheme.
Jika developer tidak menambahkan pengaturan khusus, maka link dengan skema non-standar (seperti whatsapp:// atau tel:) tidak akan bisa dibuka. Akibatnya, pengguna akan melihat pesan error.
Contoh:
Sebuah aplikasi e-commerce menampilkan halaman produk melalui WebView. Di dalamnya ada tombol “Chat via WhatsApp”. Saat ditekan, bukannya membuka WhatsApp, justru muncul error ERR_UNKNOWN_URL_SCHEME karena WebView tidak dikonfigurasi untuk menangani link eksternal.
5. Ekstensi atau Pengaturan Keamanan Browser
Selain faktor teknis pada URL dan aplikasi, terkadang error ini juga dipicu oleh pengaturan keamanan atau ekstensi browser.
Beberapa ekstensi, seperti ad blocker atau plugin keamanan, bisa memblokir skema URL tertentu karena dianggap mencurigakan. Hal ini membuat link gagal terbuka meskipun sebenarnya valid.
Contoh:
Pengguna menekan link intent://payment di sebuah website. Namun, ekstensi keamanan di browser mendeteksinya sebagai link berbahaya dan mencegah eksekusi. Akhirnya, browser menampilkan pesan error.
Ringkasan Penyebab ERR_UNKNOWN_URL_SCHEME
| Penyebab | Penjelasan | Contoh Kasus |
|---|---|---|
| Skema tidak dikenal | Browser hanya paham skema standar, skema khusus sering ditolak | whatsapp:// dibuka di laptop tanpa WhatsApp |
| Aplikasi tidak terinstal | Link butuh aplikasi tertentu yang tidak ada di perangkat | tg:// dibuka tanpa aplikasi Telegram |
| Kesalahan penulisan | Typo atau format salah membuat browser gagal mengenali URL | htttp:// atau mailtoo: |
| Keterbatasan WebView | Aplikasi tidak mengatur dukungan skema eksternal di WebView | Tombol WhatsApp di aplikasi gagal terbuka |
| Ekstensi/keamanan | Plugin atau setting keamanan memblokir link tertentu | intent://payment diblokir plugin |
Bagaimana Cara Mengatasi ERR_UNKNOWN_URL_SCHEME?
Solusi untuk mengatasi error ini bergantung pada konteks di mana error terjadi. Berikut beberapa cara yang bisa dilakukan:
1. Cara Mengatasi untuk Pengguna Biasa
Jika kamu menemukan error ini ketika mengklik sebuah link, jangan langsung panik. Berikut langkah-langkah yang bisa dicoba:
a. Pastikan Aplikasi Pendukung Terinstal
Banyak URL scheme yang hanya bisa dibuka dengan aplikasi tertentu.
- Jika link adalah whatsapp://: pastikan aplikasi WhatsApp sudah terpasang.
- Jika link adalah tg://: pastikan aplikasi Telegram sudah ada.
- Jika link adalah zoommtg://: pastikan aplikasi Zoom terinstal.
Solusi: Unduh dan pasang aplikasi yang sesuai, lalu coba klik link kembali.
b. Coba Buka Link di Perangkat yang Tepat
Tidak semua link bisa dibuka di semua perangkat.
- Link WhatsApp biasanya hanya berfungsi di ponsel dengan WhatsApp.
- Link tel: untuk panggilan hanya berfungsi di ponsel, bukan laptop tanpa aplikasi telepon.
Solusi: Jika error muncul di komputer, coba buka link yang sama di ponsel.
c. Periksa Apakah Ada Typo di Link
Kadang masalahnya sesederhana kesalahan penulisan URL.
- htttp:// (tiga huruf “t”): salah.
- mailtoo: alih-alih mailto: salah.
Solusi: Periksa kembali link dan pastikan formatnya benar.
d. Nonaktifkan Sementara Ekstensi Browser
Beberapa ekstensi (misalnya ad blocker atau plugin keamanan) bisa memblokir eksekusi link tertentu.
Solusi: Coba buka link dalam mode Incognito atau Nonaktifkan ekstensi sementara, lalu akses ulang.
e. Update Browser dan Aplikasi
Browser atau aplikasi yang sudah lama tidak diperbarui mungkin tidak kompatibel dengan URL scheme tertentu.
Solusi: Update browser (Chrome, Firefox, Safari, dll.) dan aplikasi yang terkait ke versi terbaru.
2. Cara Mengatasi untuk Developer Website
Bagi pemilik website, error ini bisa mengganggu pengalaman pengguna. Berikut solusi teknis yang bisa dilakukan:
a. Gunakan Skema URL yang Benar dan Valid
Pastikan semua link ditulis dengan benar.
Benar: mailto:support@email.com
Salah: mailtoo:support@email.com
b. Sediakan Fallback Link (Alternatif)
Jangan hanya mengandalkan skema khusus. Misalnya untuk WhatsApp:
<a href="https://wa.me/628123456789">Chat via WhatsApp</a>Link ini akan otomatis diarahkan ke aplikasi WhatsApp di ponsel atau ke WhatsApp Web di browser.
c. Uji Tautan di Berbagai Perangkat dan Browser
Pastikan link bisa dibuka di ponsel, desktop dan browser yang berbeda. Hal ini akan mengurangi risiko error hanya muncul pada perangkat tertentu.
d. Gunakan Redirect yang Sesuai
Jika ingin membuka aplikasi tertentu, pastikan ada fallback redirect. Contoh:
- Jika WhatsApp tidak tersedia: arahkan ke WhatsApp Web.
- Jika aplikasi mobile tidak ada: arahkan ke halaman download aplikasi.
3. Cara Mengatasi untuk Developer Aplikasi Mobile
Bagi developer Android/iOS yang menggunakan WebView, error ini sering terjadi jika tidak menambahkan konfigurasi khusus.
a. Tambahkan Intent Filter di Android
Pada Android, skema custom URL harus didaftarkan dalam file AndroidManifest.xml.
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="whatsapp" />
</intent-filter>
Dengan ini, aplikasi bisa menangani link dengan skema whatsapp://.
b. Gunakan Universal Links di iOS
Di iOS, developer bisa menggunakan Universal Links agar aplikasi langsung terbuka tanpa error ketika pengguna mengklik link khusus.
c. Konfigurasi WebView untuk Menangani URL Khusus
Secara default, WebView hanya bisa membuka http dan https. Untuk menangani skema lain, developer perlu menambahkan logika khusus.
Contoh di Android (Java/Kotlin):
myWebView.setWebViewClient(new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
if (url.startsWith("whatsapp://")) {
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
startActivity(intent);
return true;
}
return false;
}
});
Dengan konfigurasi ini, link whatsapp:// tidak akan memunculkan error, melainkan membuka aplikasi WhatsApp langsung.
Studi Kasus: Error di Aplikasi Mobile
Bayangkan sebuah aplikasi e-commerce yang ingin menambahkan tombol Chat via WhatsApp. Jika developer hanya menambahkan link whatsapp://send?text=Halo, maka:
- Di Android (dengan WhatsApp terinstal): berhasil.
- Di Android (tanpa WhatsApp): error ERR_UNKNOWN_URL_SCHEME.
- Di Desktop browser: error karena browser tidak mengenali whatsapp://.
Solusi yang lebih baik:
- Gunakan Intent URL di Android.
- Gunakan fallback https://wa.me/nomor untuk browser.
- Tambahkan validasi apakah aplikasi WhatsApp tersedia sebelum membuka link.
Kesimpulan
Pada pemabahasan kita diatas dapat kita simpulkan bahwa Error ERR_UNKNOWN_URL_SCHEME sering ditemui ketika browser atau aplikasi mencoba membuka URL dengan skema yang tidak dikenali atau tidak didukung. Penyebabnya bisa karena salah penulisan, tidak ada aplikasi pendukung atau memang skema tersebut tidak standar.
Dengan pemahaman yang baik, error ini bukanlah hambatan besar, melainkan bagian dari proses normal dalam membangun aplikasi dan website yang lebih tangguh.
Artikel ini merupakan bagian seri artikel Programming dari KantinIT.com dan jika ada ide topik yang mau kami bahas silahkan komen di bawah ya..
