Web Worker Tidak Tersedia? Panduan Pemecahan Masalah Berdasarkan Platform dan Lingkungan

Gejala yang Anda Alami

Banner peringatan kuning muncul di bagian bawah Any3D: "Browser Anda tidak mendukung Web Worker." Penampil 3D mungkin masih berfungsi, namun pemrosesan file besar berisiko membekukan halaman secara total, dan fitur berbasis Worker seperti kompresi tekstur serta konversi gambar ke model 3D tidak dapat digunakan.

Web Worker memungkinkan komputasi berat berjalan di thread latar belakang tanpa mengganggu antarmuka pengguna. Jalur pemrosesan Any3D untuk kompresi tekstur sangat bergantung pada kombinasi trio Worker, OffscreenCanvas, dan createImageBitmap.

Penyebab Umum

Penyebab	Skenario Tipikal
Konteks tidak aman	Dibuka melalui protokol file:// atau koneksi HTTP non-enkripsi
Browser / WebView usang	Browser sistem lawas, halaman web di dalam aplikasi chatting
Pembatasan CSP	Portal iframe enterprise atau klien Zero Trust yang memblokir worker-src
Pemblokiran ekstensi	Ekstensi privasi yang memblokir Worker atau URL blob:
Masalah cache jaringan	Proxy atau VPN yang mengirimkan skrip Worker tidak lengkap
Pengelolaan perangkat	Profil MDM perusahaan yang menonaktifkan skrip latar belakang

Panduan Perbaikan Berdasarkan Platform

Windows

1. Akses Any3D melalui HTTPS (https://any3d.cc) dan hindari membuka file HTML lokal secara langsung.
2. Kebijakan Edge Enterprise: Periksa apakah ada aturan Group Policy yang membatasi Worker atau cookie pihak ketiga.
3. Microsoft Family Safety: Pembatasan konten pada akun anak dapat menggagalkan inisialisasi Worker.

macOS

1. Safari dan Chrome membutuhkan macOS 12 atau yang lebih baru dengan versi browser terbaru.
2. Screen Time → Konten & Privasi: Jika pembatasan situs web aktif, sistem mungkin memblokir domain skrip Worker secara tidak sengaja.
3. Jika profil MDM perusahaan membatasi eksekusi skrip browser, hubungi tim IT perusahaan Anda.

Linux

1. Pastikan URL menggunakan HTTPS, dan konfigurasikan proxy jaringan (seperti Squid) agar mengizinkan request blob: dan worker-src.

iOS / Android

1. Hindari memproses file 3D berukuran besar di dalam browser internal aplikasi perpesanan (WeChat, DingTalk, dll.); buka tautan di browser sistem utama (Safari atau Chrome).
2. Mode Hemat Daya iOS jarang mematikan Worker secara langsung, namun WebKit lawas memiliki keterbatasan API; pastikan iOS selalu diperbarui.
3. Pada Android, perbarui aplikasi Android System WebView melalui Google Play Store.

Jaringan, VPN, dan Intranet Perusahaan

Skenario	Detail Teknis
VPN Perusahaan	Beberapa VPN memberlakukan inspeksi SSL dan menyuntikkan CSP ketat; minta IT mengizinkan Worker
Iframe Portal SSO Intranet	CSP halaman induk mungkin melarang worker-src blob:; buka Any3D di tab baru terpisah
Reverse Proxy	Kesalahan konfigurasi Nginx/gateway dapat mengirim skrip Worker dengan MIME type salah
Parental Control Router	Pemaksaan penurunan protokol ke HTTP akan mematikan fungsionalitas Worker

Pengujian cepat: Putuskan sambungan VPN atau beralihlah ke hotspot seluler untuk melihat apakah peringatan tersebut hilang.

Referensi CSP Enterprise (Untuk Administrator IT)

Jika Any3D disematkan di dalam iframe portal perusahaan, pastikan header CSP berikut diizinkan:

worker-src 'self' blob:;
script-src 'self' 'unsafe-eval' blob:;

Pengguna individu tidak perlu mengubah pengaturan ini secara manual.

Langkah Perbaikan Bertahap (Universal)

1. Pastikan koneksi menggunakan HTTPS dan lakukan hard refresh (Ctrl+F5 / Cmd+Shift+R).
2. Gunakan Tab Incognito / Penyamaran untuk menonaktifkan potensi gangguan dari ekstensi browser.
3. Perbarui browser Anda dan perbarui Android System WebView.
4. Buka Any3D langsung di tab baru, bukan di dalam iframe portal internal perusahaan.

Uji Diagnostik Mandiri

Buka Console di Developer Tools browser dan jalankan:

typeof Worker !== "undefined";

Hasil true menunjukkan API dasar tersedia (meskipun alur kerja penuh di Any3D juga memerlukan dukungan OffscreenCanvas dan createImageBitmap).

Dampak Jika Web Worker Tidak Tersedia

Fitur	Dampak Operasional
Kompresi vertex (Draco, dll.)	Tetap berfungsi di main thread via WebAssembly
Kompresi tekstur & KTX2	Jalur Worker nonaktif; file besar dapat membuat UI freeze sementara
Konversi gambar ke model 3D	Penurunan kecepatan dan responsivitas halaman yang signifikan

Ringkasan

Peringatan Web Worker umumnya dipicu oleh koneksi non-HTTPS, WebView usang, kebijakan CSP/VPN enterprise, atau interferensi ekstensi. Memperbarui browser, menguji di luar jaringan korporat, dan membuka situs di tab mandiri biasanya langsung memulihkan kapabilitas komputasi latar belakang.