Zasady widgetów: rozmiary, limity wydajności i kody sprawdzania

Rozmiary, typy plików, limity wydajności i wszystkie kody, przez które sprawdzanie może się nie udać.

8 min czytania Zaktualizowano 4 lis 2026

Widget działa w overlayu obok wszystkiego innego, często na słabszych komputerach. Dlatego obowiązują stałe limity. Livedeck używa tych samych wartości w trzech miejscach: tutaj w dokumentacji, w automatycznym teście przed zatwierdzeniem i w overlayu w trakcie LIVE.

Paczka

Plik ZIP

5 MB

Łącznie po rozpakowaniu

5 MB

Pojedynczy plik

2 MB

Pliki

200

Długość ścieżki

180 znaków

Głębokość folderów

8

manifest.json

64 KB

Dozwolone typy plików: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Pliki tekstowe muszą być w UTF-8. Obrazy, dźwięki i czcionki muszą faktycznie być tym, co wskazuje ich rozszerzenie.

Co jest niedozwolone

  • Adresy innych stron w HTML, CSS, JavaScript, SVG lub JSON (http://, https://, ws://, wss:// lub //host). Adresy w komentarzach nie powodują niezaliczenia sprawdzania, ale admin je widzi.
  • iframe, frame, object, embed, portal, base i meta refresh w HTML
  • WebRTC (RTCPeerConnection, serwery STUN lub TURN), ramki z JavaScriptu (createElement("iframe") lub "<iframe" w stringach) i wskazówki połączeń, takie jak dns-prefetch czy preconnect. Livedeck dodatkowo wyłącza te funkcje wewnątrz widgetu.
  • Skrypty, event handlery lub foreignObject w plikach SVG
  • Zaszyfrowane pliki ZIP, dowiązania symboliczne i archiwa wewnątrz archiwum

Admin widzi też wskazówki dotyczące eval, new Function, WebAssembly, WebSockets, dostępu do pamięci lub okna overlayu, wzorców kopania kryptowalut oraz zaciemnionego lub zminifikowanego kodu. Wskazówki nie powodują od razu niezaliczenia, ale wymagają dobrego uzasadnienia. Zminifikowany kod dołączaj razem z czytelnymi źródłami w folderze src/.

manifest.json, folder src/ oraz pliki .md i .txt służą tylko do weryfikacji. Livedeck nigdy nie udostępnia ich overlayowi, więc twój kod nie może ich wczytać. Każdy użytkownik dostaje twój widget pod własnym adresem.

Limity wydajności

Gotowość po załadowaniu strony

3000 ms

Ładowanie strony w trakcie LIVE

15 000 ms

CPU bez zdarzeń (średnio)

2 %

CPU przy bardzo wielu zdarzeniach (średnio)

15 %

Pamięć (JavaScript)

64 MB

Elementy na stronie

3000

Najdłuższa pojedyncza blokada

200 ms

W trakcie LIVE

  • Overlay sprawdza co 2000 ms. 3 odpowiedzi z rzędu wolniejsze niż 1000 ms albo 6000 ms bez żadnej odpowiedzi wyłączają widget.
  • Gdy to sam overlay się zawiesił (np. bo karta była w tle), nigdy nie liczy się to na niekorzyść twojego widgetu.
  • Wyłączony widget pozostaje wyłączony do następnego przeładowania. Edytor pokazuje wtedy „Widget zatrzymany”.
Wskazówka: Dbaj o lekką stronę: usuwaj stare elementy (starter kit pokazuje maksymalnie maxCards kart), używaj animacji CSS zamiast pętli w JavaScripcie i nie uruchamiaj timerów, gdy nic się nie dzieje.

Kody sprawdzania

Gdy sprawdzanie się nie powiedzie, edytor lub studio sprzedawcy pokazuje listę powodów. Tutaj znajdziesz wszystkie kody.

Plik ZIP

zip_too_large

Plik ZIP jest większy niż 5 MB.

zip_total_too_large

Po rozpakowaniu większy niż 5 MB.

zip_file_too_large

Jeden z plików jest większy niż 2 MB.

zip_too_many_files

Ponad 200 plików.

zip_not_zip

To nie jest plik ZIP albo jest pusty.

zip_multi_disk

Podzielony na kilka części. Spakuj wszystko do jednego pliku.

zip64_unsupported

ZIP64 nie jest obsługiwany.

zip_trailing_data

Za końcem pliku ZIP są dodatkowe dane.

zip_corrupt

Plik ZIP jest uszkodzony.

zip_encrypted

Plik ZIP jest chroniony hasłem.

zip_unsupported_method

Nieobsługiwana metoda kompresji. Dozwolone są Stored (bez kompresji) i Deflate (domyślna).

zip_header_mismatch

Archiwum zawiera sprzeczne dane.

zip_overlap

Pliki w archiwum nakładają się na siebie.

zip_crc_mismatch

Błędna suma kontrolna, plik jest uszkodzony.

zip_symlink

Dowiązanie symboliczne w paczce.

zip_bad_name

Nieprawidłowa nazwa pliku: znaki spoza ASCII bez UTF-8, ../, ścieżki bezwzględne, znaki specjalne, ponad 180 znaków lub ponad 8 poziomów folderów.

zip_duplicate_name

Plik występuje w archiwum dwa razy.

zip_nested_archive

Archiwum w archiwum (np. ZIP w ZIP-ie).

Pliki i zawartość

manifest_missing

Brak manifest.json. Musi być na najwyższym poziomie ZIP-a lub w jego jedynym folderze.

manifest_invalid

manifest.json jest nieprawidłowy. Błędy są wymienione pod spodem (kody w „Dokumentacji manifest.json”).

entry_missing

Pliku startowego podanego w entry nie ma w paczce.

file_type_not_allowed

Ten typ pliku jest niedozwolony.

file_content_mismatch

Zawartość nie pasuje do rozszerzenia (np. JPG nazwany .png).

file_not_utf8

Plik tekstowy nie jest zapisany w UTF-8.

file_empty

Plik jest pusty.

external_reference

Plik zawiera adres innej strony (z numerem linii).

forbidden_markup

Niedozwolony HTML (iframe, frame, object, embed, portal, base, meta refresh) lub skrypt w pliku SVG.

forbidden_api

Kod, który omija blokady sieci: WebRTC (RTCPeerConnection, STUN/TURN), ramki z JavaScriptu (createElement("iframe"), "<iframe" w stringach) lub wskazówki połączeń (dns-prefetch, preconnect, prerender, prefetch).

Test automatyczny

test_failed oznacza, że automatyczny test przekroczył co najmniej jeden limit. Poszczególne powody są wymienione pod spodem, każdy ze zmierzoną wartością i limitem.

perf_no_ready

Widget po załadowaniu nie zgłosił się do overlayu. Zwykle brakuje <script src="/sdk/v1.js"> albo strona nigdy nie kończy ładowania.

perf_ready_slow

Gotowy za późno: ponad 3000 ms po załadowaniu strony.

perf_unresponsive

Nie odpowiada na sprawdzenie overlayu albo odpowiada za wolno (kod blokuje przeglądarkę).

perf_navigated

Widget przeszedł na inną stronę lub przeładował swoją stronę.

perf_flood

Widget wysyła do overlayu o wiele za dużo wiadomości.

perf_idle_cpu

Ponad 2 % CPU, gdy nic się nie dzieje.

perf_storm_cpu

Ponad 15 % CPU przy dużej liczbie zdarzeń.

perf_heap

Ponad 64 MB pamięci.

perf_dom

Ponad 3000 elementów na stronie.

perf_long_task

Blokuje przeglądarkę na dłużej niż 200 ms naraz.

network_attempt

Próbuje wczytać coś z innej strony (host jest wyświetlany).

runtime_errors

Tylko wskazówka, nie powód odrzucenia: błędy JavaScriptu podczas testu. Admin widzi pierwszy z nich.

Czy ten artykuł był pomocny?