Правила віджетів: розміри, ліміти продуктивності й коди перевірки
Розміри, типи файлів, ліміти продуктивності й усі коди, з якими може не пройти перевірка.
Віджет працює в оверлеї поряд з усім іншим, часто на слабших ПК. Тому діють фіксовані ліміти. Livedeck використовує ті самі значення у трьох місцях: тут у документації, в автоматичній перевірці перед схваленням і в оверлеї під час LIVE.
Пакет
ZIP-файл
5 MB
Усього в розпакованому вигляді
5 MB
Окремий файл
2 MB
Файли
200
Довжина шляху
180 символів
Глибина папок
8
manifest.json
64 KB
| Ліміт | Значення |
|---|---|
| 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 мс
| Вимірювання | Ліміт |
|---|---|
| Готовність після завантаження сторінки | 3000 мс |
| Завантаження сторінки під час LIVE | 15 000 мс |
| CPU без подій (у середньому) | 2 % |
| CPU за дуже великої кількості подій (у середньому) | 15 % |
| Пам’ять (JavaScript) | 64 MB |
| Елементи на сторінці | 3000 |
| Найдовше блокування за раз | 200 мс |
Під час LIVE
- Оверлей перевіряє кожні 2000 мс. 3 відповіді поспіль, повільніші за 1000 мс, або 6000 мс без жодної відповіді вимикають віджет.
- Якщо завис сам оверлей (наприклад, через те, що вкладка була у фоні), це ніколи не зараховується проти вашого віджета.
- Вимкнений widget залишається вимкненим до наступного перезавантаження. Тоді редактор показує «Widget зупинено».
Коди перевірки
Якщо перевірку не пройдено, редактор або студія продавця показує список причин. Тут перелічено всі коди.
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).
| Код | Значення |
|---|---|
| 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).
| Код | Значення |
|---|---|
| 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 під час тесту. Адмін бачить першу з них.
| Код | Значення |
|---|---|
| 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 під час тесту. Адмін бачить першу з них. |
Ця стаття була корисною?