Widget kuralları: boyutlar, performans sınırları ve kontrol kodları

Boyutlar, dosya türleri, performans sınırları ve bir kontrolün başarısız olabileceği tüm kodlar.

8 dk okuma Güncellendi: 4 Kas 2026

Bir widget overlay’de diğer her şeyin yanında, çoğu zaman daha yavaş PC’lerde çalışır. Bu yüzden sabit sınırlar geçerlidir. Livedeck aynı değerleri üç yerde kullanır: burada dokümanlarda, onay öncesi otomatik testte ve LIVE sırasında overlay’de.

Paket

ZIP dosyası

5 MB

Açılmış toplam boyut

5 MB

Tek dosya

2 MB

Dosyalar

200

Yol uzunluğu

180 karakter

Klasör derinliği

8

manifest.json

64 KB

İzin verilen dosya türleri: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Metin dosyaları UTF-8 olmalı. Resimler, sesler ve fontlar gerçekten uzantılarının belirttiği türde olmalı.

İzin verilmeyenler

  • HTML, CSS, JavaScript, SVG veya JSON içinde başka sitelerin adresleri (http://, https://, ws://, wss:// veya //host). Yorumlardaki adresler kontrolü başarısız yapmaz, ama admin bunları görür.
  • HTML’de iframe, frame, object, embed, portal, base ve meta refresh
  • WebRTC (RTCPeerConnection, STUN veya TURN sunucuları), JavaScript’ten frame’ler (createElement("iframe") veya string’lerde "<iframe") ve dns-prefetch ya da preconnect gibi bağlantı ipuçları. Livedeck bu özellikleri widget içinde de kapatır.
  • SVG dosyalarında script’ler, event handler’lar veya foreignObject
  • Şifreli ZIP dosyaları, sembolik bağlantılar ve arşiv içinde arşivler

Admin ayrıca eval, new Function, WebAssembly, WebSocket’ler, depolamaya veya overlay penceresine erişim, madencilik kalıpları ve karartılmış ya da küçültülmüş kodla ilgili uyarıları da görür. Uyarılar kontrolü hemen başarısız yapmaz, ama iyi bir gerekçe gerektirir. Küçültülmüş kodu, okunabilir kaynaklarla birlikte bir src/ klasöründe gönder.

manifest.json, src/ klasörü ve .md veya .txt dosyaları yalnızca inceleme içindir. Livedeck bunları overlay’e asla sunmaz, yani kodun bunları yükleyemez. Her kullanıcı widget’ını kendine ait bir adresten alır.

Performans sınırları

Sayfa yüklendikten sonra hazır olma

3000 ms

LIVE sırasında sayfanın yüklenmesi

15,000 ms

Event yokken CPU (ortalama)

2 %

Çok fazla event varken CPU (ortalama)

15 %

Bellek (JavaScript)

64 MB

Sayfadaki öğeler

3000

Tek seferde en uzun kilitlenme

200 ms

LIVE sırasında

  • Overlay her 2000 ms’de kontrol eder. Art arda 1000 ms’den yavaş 3 yanıt veya 6000 ms boyunca hiç yanıt olmaması widget’ı kapatır.
  • Overlay’in kendisi takıldıysa (örneğin sekme arka planda olduğu için), bu asla widget’ının aleyhine sayılmaz.
  • Kapatılan bir widget bir sonraki yenilemeye kadar kapalı kalır. Editör bu durumda "Widget durduruldu" gösterir.
İpucu: Sayfayı küçük tut: eski öğeleri kaldır (başlangıç kiti en fazla maxCards kart gösterir), JavaScript döngüleri yerine CSS animasyonları kullan ve hiçbir şey olmazken zamanlayıcı çalıştırma.

Kontrol kodları

Bir kontrol başarısız olursa editör veya satıcı stüdyosu nedenlerin listesini gösterir. Tüm kodlar burada tek tek listelenir.

ZIP dosyası

zip_too_large

ZIP dosyası 5 MB’tan büyük.

zip_total_too_large

Açıldığında 5 MB’tan büyük.

zip_file_too_large

Bir dosya 2 MB’tan büyük.

zip_too_many_files

200’den fazla dosya var.

zip_not_zip

ZIP dosyası değil ya da boş.

zip_multi_disk

Birden fazla parçaya bölünmüş. Her şeyi tek bir dosyada paketle.

zip64_unsupported

ZIP64 desteklenmiyor.

zip_trailing_data

ZIP dosyasının sonundan sonra fazladan veri var.

zip_corrupt

ZIP dosyası bozuk.

zip_encrypted

ZIP dosyası parola korumalı.

zip_unsupported_method

Sıkıştırma yöntemi desteklenmiyor. Stored (sıkıştırmasız) ve Deflate (varsayılan) kullanılabilir.

zip_header_mismatch

Arşiv kendi içinde çelişkili.

zip_overlap

Arşivdeki dosyalar çakışıyor.

zip_crc_mismatch

Sağlama toplamı yanlış, bir dosya bozuk.

zip_symlink

Pakette sembolik bağlantı var.

zip_bad_name

Geçersiz dosya adı: UTF-8 olmadan ASCII dışı karakterler, ../, mutlak yollar, özel karakterler, 180 karakterden uzun ya da 8 klasörden derin.

zip_duplicate_name

Bir dosya arşivde iki kez var.

zip_nested_archive

Arşiv içinde arşiv (örneğin ZIP içinde ZIP).

Dosyalar ve içerik

manifest_missing

manifest.json eksik. ZIP’in en üst düzeyinde veya içindeki tek klasörde olmalı.

manifest_invalid

manifest.json geçersiz. Hatalar altında listelenir (kodlar "manifest.json referansı" bölümünde).

entry_missing

entry’de belirtilen başlangıç dosyası pakette yok.

file_type_not_allowed

Bu dosya türüne izin verilmiyor.

file_content_mismatch

İçerik uzantıyla uyuşmuyor (örneğin .png adlı bir JPG).

file_not_utf8

Metin dosyası UTF-8 olarak kaydedilmemiş.

file_empty

Dosya boş.

external_reference

Dosya başka bir sitenin adresini içeriyor (satırıyla birlikte).

forbidden_markup

İzin verilmeyen HTML (iframe, frame, object, embed, portal, base, meta refresh) veya SVG dosyasında script.

forbidden_api

Ağ engellerini aşmaya yarayacak kod: WebRTC (RTCPeerConnection, STUN/TURN), JavaScript’ten frame’ler (createElement("iframe"), metinlerde "<iframe") veya bağlantı ipuçları (dns-prefetch, preconnect, prerender, prefetch).

Otomatik test

test_failed, otomatik testin en az bir sınırı aştığı anlamına gelir. Tek tek nedenler altında, ölçülen değer ve sınırla birlikte listelenir.

perf_no_ready

Widget yüklendikten sonra overlay’e hiç bildirimde bulunmadı. Genelde <script src="/sdk/v1.js"> eksiktir ya da sayfa yüklenmeyi hiç bitirmez.

perf_ready_slow

Çok geç hazır: sayfa yüklendikten 3000 ms’den sonra.

perf_unresponsive

Overlay’in kontrolüne yanıt vermiyor ya da çok yavaş veriyor (kod tarayıcıyı kilitliyor).

perf_navigated

Widget başka bir sayfaya geçti veya sayfasını yeniden yükledi.

perf_flood

Widget overlay’e çok fazla mesaj gönderiyor.

perf_idle_cpu

Hiçbir şey olmazken %2’den fazla CPU.

perf_storm_cpu

Çok sayıda olayda %15’ten fazla CPU.

perf_heap

64 MB’tan fazla bellek.

perf_dom

Sayfada 3000’den fazla öğe.

perf_long_task

Tarayıcıyı tek seferde 200 ms’den uzun süre kilitliyor.

network_attempt

Başka bir siteden bir şey yüklemeye çalışıyor (host gösterilir).

runtime_errors

Sadece bir uyarı, başarısızlık nedeni değil: test sırasında JavaScript hataları. Admin ilkini görür.

Bu makale işine yaradı mı?