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ć.
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
| Limit | Wartość |
|---|---|
| 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
| Pomiar | Limit |
|---|---|
| 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”.
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).
| Kod | Znaczenie |
|---|---|
| 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).
| Kod | Znaczenie |
|---|---|
| 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.
| Kod | Znaczenie |
|---|---|
| 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?