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.
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
| Sınır | Değer |
|---|---|
| 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
| Ölçüm | Sınır |
|---|---|
| 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.
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).
| Kod | Anlamı |
|---|---|
| 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).
| Kod | Anlamı |
|---|---|
| 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.
| Kod | Anlamı |
|---|---|
| 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ı?