Aturan widget: ukuran, batas performa, dan kode pengecekan

Ukuran, tipe file, batas performa, dan semua kode yang bisa membuat pengecekan gagal.

8 menit baca Diperbarui 4 Nov 2026

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

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

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".
Tips: Buat halamanmu tetap ringan: hapus elemen lama (starter kit menampilkan maksimal maxCards kartu), pakai animasi CSS alih-alih loop JavaScript, dan jangan jalankan timer saat tidak ada yang terjadi.

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).

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).

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.

Apakah artikel ini membantu?