Aturan widget: ukuran, batas performa, dan kode pengecekan
Ukuran, tipe file, batas performa, dan semua kode yang bisa membuat pengecekan gagal.
Widget berjalan di overlay bersama semua elemen lain, sering di PC yang lebih lambat. Karena itu ada batas tetap. Livedeck memakai angka yang sama di tiga tempat: di dokumentasi ini, di tes otomatis sebelum persetujuan, dan di overlay selama LIVE.
Paket
File ZIP
5 MB
Total setelah diekstrak
5 MB
Satu file
2 MB
File
200
Panjang path
180 karakter
Kedalaman folder
8
manifest.json
64 KB
| Batas | Nilai |
|---|---|
| File ZIP | 5 MB |
| Total setelah diekstrak | 5 MB |
| Satu file | 2 MB |
| File | 200 |
| Panjang path | 180 karakter |
| Kedalaman folder | 8 |
| manifest.json | 64 KB |
Tipe file yang diizinkan: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. File teks harus UTF-8. Gambar, suara, dan font harus benar-benar sesuai ekstensinya.
Yang tidak diizinkan
- Alamat situs lain di HTML, CSS, JavaScript, SVG, atau JSON (http://, https://, ws://, wss:// atau //host). Alamat di komentar tidak membuat pengecekan gagal, tapi admin bisa melihatnya.
- iframe, frame, object, embed, portal, base, dan meta refresh di HTML
- WebRTC (RTCPeerConnection, server STUN atau TURN), frame dari JavaScript (createElement("iframe") atau "<iframe" di string), dan petunjuk koneksi seperti dns-prefetch atau preconnect. Livedeck juga mematikan fitur-fitur ini di dalam widget.
- Script, event handler, atau foreignObject di file SVG
- File ZIP terenkripsi, symbolic link, dan arsip di dalam arsip
Admin juga melihat petunjuk soal eval, new Function, WebAssembly, WebSocket, akses ke storage atau jendela overlay, pola mining, serta kode yang di-obfuscate atau di-minify. Petunjuk tidak langsung membuat pengecekan gagal, tapi butuh alasan yang kuat. Sertakan kode minified bersama source yang mudah dibaca di folder src/.
manifest.json, folder src/, dan file .md atau .txt hanya untuk review. Livedeck tidak pernah mengirimkannya ke overlay, jadi kodemu tidak bisa memuatnya. Setiap pengguna mendapat widgetmu di alamatnya masing-masing.
Batas performa
Siap setelah halaman dimuat
3000 ms
Memuat halaman selama LIVE
15.000 ms
CPU tanpa event (rata-rata)
2 %
CPU dengan event sangat banyak (rata-rata)
15 %
Memori (JavaScript)
64 MB
Elemen di halaman
3000
Blok terlama sekaligus
200 ms
| Pengukuran | Batas |
|---|---|
| Siap setelah halaman dimuat | 3000 ms |
| Memuat halaman selama LIVE | 15.000 ms |
| CPU tanpa event (rata-rata) | 2 % |
| CPU dengan event sangat banyak (rata-rata) | 15 % |
| Memori (JavaScript) | 64 MB |
| Elemen di halaman | 3000 |
| Blok terlama sekaligus | 200 ms |
Selama LIVE
- Overlay mengecek setiap 2000 ms. 3 jawaban berturut-turut yang lebih lambat dari 1000 ms, atau 6000 ms tanpa jawaban sama sekali, akan mematikan widget.
- Kalau overlay-nya sendiri yang macet (misalnya karena tab ada di background), itu tidak pernah dihitung sebagai kesalahan widgetmu.
- Widget yang dimatikan tetap mati sampai halaman dimuat ulang. Editor lalu menampilkan "Widget dihentikan".
Kode pemeriksaan
Kalau pemeriksaan gagal, editor atau seller studio menampilkan daftar alasannya. Semua kode tercantum di sini.
File ZIP
zip_too_large
File ZIP lebih besar dari 5 MB.
zip_total_too_large
Lebih besar dari 5 MB setelah diekstrak.
zip_file_too_large
Ada file yang lebih besar dari 2 MB.
zip_too_many_files
Lebih dari 200 file.
zip_not_zip
Bukan file ZIP, atau ZIP-nya kosong.
zip_multi_disk
Terbagi jadi beberapa bagian. Gabungkan semuanya dalam satu file.
zip64_unsupported
ZIP64 tidak didukung.
zip_trailing_data
Ada data tambahan setelah akhir file ZIP.
zip_corrupt
File ZIP rusak.
zip_encrypted
File ZIP dilindungi kata sandi.
zip_unsupported_method
Metode kompresi tidak didukung. Yang diizinkan: Stored (tanpa kompresi) dan Deflate (default).
zip_header_mismatch
Isi arsip saling bertentangan.
zip_overlap
Ada file yang tumpang-tindih di dalam arsip.
zip_crc_mismatch
Checksum salah, ada file yang rusak.
zip_symlink
Ada symbolic link di dalam paket.
zip_bad_name
Nama file tidak valid: non-ASCII tanpa UTF-8, ../, path absolut, karakter khusus, lebih dari 180 karakter, atau lebih dalam dari 8 folder.
zip_duplicate_name
Ada file yang muncul dua kali di arsip.
zip_nested_archive
Ada arsip di dalam arsip (misalnya ZIP di dalam ZIP).
| Kode | Arti |
|---|---|
| zip_too_large | File ZIP lebih besar dari 5 MB. |
| zip_total_too_large | Lebih besar dari 5 MB setelah diekstrak. |
| zip_file_too_large | Ada file yang lebih besar dari 2 MB. |
| zip_too_many_files | Lebih dari 200 file. |
| zip_not_zip | Bukan file ZIP, atau ZIP-nya kosong. |
| zip_multi_disk | Terbagi jadi beberapa bagian. Gabungkan semuanya dalam satu file. |
| zip64_unsupported | ZIP64 tidak didukung. |
| zip_trailing_data | Ada data tambahan setelah akhir file ZIP. |
| zip_corrupt | File ZIP rusak. |
| zip_encrypted | File ZIP dilindungi kata sandi. |
| zip_unsupported_method | Metode kompresi tidak didukung. Yang diizinkan: Stored (tanpa kompresi) dan Deflate (default). |
| zip_header_mismatch | Isi arsip saling bertentangan. |
| zip_overlap | Ada file yang tumpang-tindih di dalam arsip. |
| zip_crc_mismatch | Checksum salah, ada file yang rusak. |
| zip_symlink | Ada symbolic link di dalam paket. |
| zip_bad_name | Nama file tidak valid: non-ASCII tanpa UTF-8, ../, path absolut, karakter khusus, lebih dari 180 karakter, atau lebih dalam dari 8 folder. |
| zip_duplicate_name | Ada file yang muncul dua kali di arsip. |
| zip_nested_archive | Ada arsip di dalam arsip (misalnya ZIP di dalam ZIP). |
File dan konten
manifest_missing
manifest.json tidak ada. File ini harus ada di level teratas ZIP atau di dalam satu-satunya folder di ZIP.
manifest_invalid
manifest.json tidak valid. Error-nya tercantum di bawahnya (kode ada di "Referensi manifest.json").
entry_missing
File awal yang disebut di entry tidak ada di paket.
file_type_not_allowed
Jenis file ini tidak diizinkan.
file_content_mismatch
Isi file tidak cocok dengan ekstensinya (misalnya JPG yang dinamai .png).
file_not_utf8
File teks tidak disimpan dalam UTF-8.
file_empty
File kosong.
external_reference
File berisi alamat situs lain (beserta barisnya).
forbidden_markup
HTML yang tidak diizinkan (iframe, frame, object, embed, portal, base, meta refresh) atau script di dalam file SVG.
forbidden_api
Kode yang bisa mengakali blokir jaringan: WebRTC (RTCPeerConnection, STUN/TURN), frame dari JavaScript (createElement("iframe"), "<iframe" di dalam string) atau petunjuk koneksi (dns-prefetch, preconnect, prerender, prefetch).
| Kode | Arti |
|---|---|
| manifest_missing | manifest.json tidak ada. File ini harus ada di level teratas ZIP atau di dalam satu-satunya folder di ZIP. |
| manifest_invalid | manifest.json tidak valid. Error-nya tercantum di bawahnya (kode ada di "Referensi manifest.json"). |
| entry_missing | File awal yang disebut di entry tidak ada di paket. |
| file_type_not_allowed | Jenis file ini tidak diizinkan. |
| file_content_mismatch | Isi file tidak cocok dengan ekstensinya (misalnya JPG yang dinamai .png). |
| file_not_utf8 | File teks tidak disimpan dalam UTF-8. |
| file_empty | File kosong. |
| external_reference | File berisi alamat situs lain (beserta barisnya). |
| forbidden_markup | HTML yang tidak diizinkan (iframe, frame, object, embed, portal, base, meta refresh) atau script di dalam file SVG. |
| forbidden_api | Kode yang bisa mengakali blokir jaringan: WebRTC (RTCPeerConnection, STUN/TURN), frame dari JavaScript (createElement("iframe"), "<iframe" di dalam string) atau petunjuk koneksi (dns-prefetch, preconnect, prerender, prefetch). |
Tes otomatis
test_failed berarti tes otomatis melanggar setidaknya satu batas. Alasan-alasannya tercantum di bawahnya, masing-masing dengan nilai terukur dan batasnya.
perf_no_ready
Widget tidak pernah melapor ke overlay setelah dimuat. Biasanya <script src="/sdk/v1.js"> tidak ada atau halaman tidak pernah selesai dimuat.
perf_ready_slow
Terlambat siap: lebih dari 3000 ms setelah halaman dimuat.
perf_unresponsive
Tidak merespons pemeriksaan overlay, atau terlalu lambat (kode memblokir browser).
perf_navigated
Widget berpindah halaman atau memuat ulang halamannya.
perf_flood
Widget mengirim terlalu banyak pesan ke overlay.
perf_idle_cpu
Lebih dari 2 % CPU saat tidak ada yang terjadi.
perf_storm_cpu
Lebih dari 15 % CPU saat ada banyak event.
perf_heap
Lebih dari 64 MB memori.
perf_dom
Lebih dari 3000 elemen di halaman.
perf_long_task
Memblokir browser lebih dari 200 ms sekaligus.
network_attempt
Mencoba memuat sesuatu dari situs lain (host-nya ditampilkan).
runtime_errors
Hanya catatan, bukan alasan gagal: error JavaScript selama tes. Admin melihat error pertama.
| Kode | Arti |
|---|---|
| perf_no_ready | Widget tidak pernah melapor ke overlay setelah dimuat. Biasanya <script src="/sdk/v1.js"> tidak ada atau halaman tidak pernah selesai dimuat. |
| perf_ready_slow | Terlambat siap: lebih dari 3000 ms setelah halaman dimuat. |
| perf_unresponsive | Tidak merespons pemeriksaan overlay, atau terlalu lambat (kode memblokir browser). |
| perf_navigated | Widget berpindah halaman atau memuat ulang halamannya. |
| perf_flood | Widget mengirim terlalu banyak pesan ke overlay. |
| perf_idle_cpu | Lebih dari 2 % CPU saat tidak ada yang terjadi. |
| perf_storm_cpu | Lebih dari 15 % CPU saat ada banyak event. |
| perf_heap | Lebih dari 64 MB memori. |
| perf_dom | Lebih dari 3000 elemen di halaman. |
| perf_long_task | Memblokir browser lebih dari 200 ms sekaligus. |
| network_attempt | Mencoba memuat sesuatu dari situs lain (host-nya ditampilkan). |
| runtime_errors | Hanya catatan, bukan alasan gagal: error JavaScript selama tes. Admin melihat error pertama. |
Apakah artikel ini membantu?