Правила віджетів: розміри, ліміти продуктивності й коди перевірки

Розміри, типи файлів, ліміти продуктивності й усі коди, з якими може не пройти перевірка.

8 хв читання Оновлено 4 лист. 2026 р.

Віджет працює в оверлеї поряд з усім іншим, часто на слабших ПК. Тому діють фіксовані ліміти. Livedeck використовує ті самі значення у трьох місцях: тут у документації, в автоматичній перевірці перед схваленням і в оверлеї під час LIVE.

Пакет

ZIP-файл

5 MB

Усього в розпакованому вигляді

5 MB

Окремий файл

2 MB

Файли

200

Довжина шляху

180 символів

Глибина папок

8

manifest.json

64 KB

Дозволені типи файлів: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Текстові файли мають бути в UTF-8. Зображення, звуки й шрифти мають справді відповідати своєму розширенню.

Що заборонено

  • Адреси інших сайтів у HTML, CSS, JavaScript, SVG або JSON (http://, https://, ws://, wss:// або //host). Адреси в коментарях не провалюють перевірку, але адміністратор їх бачить.
  • iframe, frame, object, embed, portal, base і meta refresh в HTML
  • WebRTC (RTCPeerConnection, сервери STUN або TURN), фрейми з JavaScript (createElement("iframe") або "<iframe" у рядках) і підказки з’єднання на кшталт dns-prefetch чи preconnect. Livedeck також вимикає ці функції всередині віджета.
  • Скрипти, обробники подій або foreignObject у файлах SVG
  • Зашифровані ZIP-файли, символьні посилання й архіви всередині архіву

Адміністратор також бачить підказки щодо eval, new Function, WebAssembly, WebSockets, доступу до сховища чи вікна оверлея, шаблонів майнінгу та обфускованого або мініфікованого коду. Підказки не провалюють перевірку одразу, але потребують вагомої причини. Додавайте до мініфікованого коду читабельні вихідні файли в папці src/.

manifest.json, папка src/ і файли .md чи .txt потрібні лише для перевірки. Livedeck ніколи не віддає їх оверлею, тож ваш код не може їх завантажити. Кожен користувач отримує ваш віджет за власною адресою.

Ліміти продуктивності

Готовність після завантаження сторінки

3000 мс

Завантаження сторінки під час LIVE

15 000 мс

CPU без подій (у середньому)

2 %

CPU за дуже великої кількості подій (у середньому)

15 %

Пам’ять (JavaScript)

64 MB

Елементи на сторінці

3000

Найдовше блокування за раз

200 мс

Під час LIVE

  • Оверлей перевіряє кожні 2000 мс. 3 відповіді поспіль, повільніші за 1000 мс, або 6000 мс без жодної відповіді вимикають віджет.
  • Якщо завис сам оверлей (наприклад, через те, що вкладка була у фоні), це ніколи не зараховується проти вашого віджета.
  • Вимкнений widget залишається вимкненим до наступного перезавантаження. Тоді редактор показує «Widget зупинено».
Порада: Тримайте сторінку легкою: видаляйте старі елементи (starter kit показує щонайбільше maxCards карток), використовуйте CSS-анімації замість циклів JavaScript і не запускайте таймери, коли нічого не відбувається.

Коди перевірки

Якщо перевірку не пройдено, редактор або студія продавця показує список причин. Тут перелічено всі коди.

ZIP-файл

zip_too_large

ZIP-файл більший за 5 MB.

zip_total_too_large

Більше 5 MB після розпакування.

zip_file_too_large

Файл більший за 2 MB.

zip_too_many_files

Понад 200 файлів.

zip_not_zip

Це не ZIP-файл або він порожній.

zip_multi_disk

Архів розбитий на кілька частин. Запакуйте все в один файл.

zip64_unsupported

ZIP64 не підтримується.

zip_trailing_data

Після кінця ZIP-файлу є зайві дані.

zip_corrupt

ZIP-файл пошкоджено.

zip_encrypted

ZIP-файл захищено паролем.

zip_unsupported_method

Метод стиснення не підтримується. Дозволено Stored (без стиснення) і Deflate (стандартний).

zip_header_mismatch

Архів суперечить сам собі.

zip_overlap

Файли в архіві перекриваються.

zip_crc_mismatch

Неправильна контрольна сума, файл пошкоджено.

zip_symlink

У пакеті є символьне посилання.

zip_bad_name

Неприпустима назва файлу: не-ASCII без UTF-8, ../, абсолютні шляхи, спецсимволи, довша за 180 символів або глибше за 8 папок.

zip_duplicate_name

Файл трапляється в архіві двічі.

zip_nested_archive

Архів усередині архіву (наприклад, ZIP у ZIP).

Файли та вміст

manifest_missing

Немає manifest.json. Він має лежати у корені ZIP або в його єдиній папці.

manifest_invalid

manifest.json недійсний. Помилки перелічено під ним (коди в «Довідник manifest.json»).

entry_missing

Стартового файлу, вказаного в entry, немає в пакеті.

file_type_not_allowed

Цей тип файлу не дозволено.

file_content_mismatch

Вміст не відповідає розширенню (наприклад, JPG з назвою .png).

file_not_utf8

Текстовий файл збережено не в UTF-8.

file_empty

Файл порожній.

external_reference

Файл містить адресу іншого сайту (з номером рядка).

forbidden_markup

Заборонений HTML (iframe, frame, object, embed, portal, base, meta refresh) або скрипт у файлі SVG.

forbidden_api

Код, що обходить блокування мережі: WebRTC (RTCPeerConnection, STUN/TURN), фрейми з JavaScript (createElement("iframe"), "<iframe" у рядках) або підказки підключення (dns-prefetch, preconnect, prerender, prefetch).

Автоматичний тест

test_failed означає, що автоматичний тест перевищив щонайменше один ліміт. Окремі причини перелічено під ним, кожна з виміряним значенням і лімітом.

perf_no_ready

Після завантаження widget так і не відгукнувся overlay. Зазвичай бракує <script src="/sdk/v1.js"> або сторінка ніколи не завершує завантаження.

perf_ready_slow

Готовий надто пізно: понад 3000 ms після завантаження сторінки.

perf_unresponsive

Не відповідає на перевірку overlay або відповідає надто повільно (код блокує браузер).

perf_navigated

Widget перейшов на іншу сторінку або перезавантажив свою.

perf_flood

Widget надсилає overlay забагато повідомлень.

perf_idle_cpu

Понад 2 % CPU, коли нічого не відбувається.

perf_storm_cpu

Понад 15 % CPU за великої кількості подій.

perf_heap

Понад 64 MB пам’яті.

perf_dom

Понад 3000 елементів на сторінці.

perf_long_task

Блокує браузер довше ніж на 200 ms за раз.

network_attempt

Намагається завантажити щось з іншого сайту (показано хост).

runtime_errors

Лише підказка, не причина відмови: помилки JavaScript під час тесту. Адмін бачить першу з них.

Ця стаття була корисною?