Правила виджетов: размеры, лимиты производительности и коды проверки
Размеры, типы файлов, лимиты производительности и все коды, с которыми может не пройти проверка.
Виджет работает в оверлее вместе со всем остальным, часто на слабых ПК. Поэтому действуют фиксированные лимиты. 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 мс без ответа — и виджет отключается.
- Если завис сам оверлей (например, потому что вкладка была в фоне), это никогда не засчитывается против вашего виджета.
- Отключённый виджет остаётся выключенным до следующей перезагрузки. В редакторе при этом отображается «Виджет остановлен».
Коды проверки
Если проверка не пройдена, редактор или студия продавца показывает список причин. Здесь перечислены все коды.
ZIP-файл
zip_too_large
ZIP-файл больше 5 МБ.
zip_total_too_large
В распакованном виде больше 5 МБ.
zip_file_too_large
Один из файлов больше 2 МБ.
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 МБ. |
| zip_total_too_large | В распакованном виде больше 5 МБ. |
| zip_file_too_large | Один из файлов больше 2 МБ. |
| 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
Виджет так и не сообщил оверлею о загрузке. Обычно не хватает <script src="/sdk/v1.js"> или страница никогда не догружается.
perf_ready_slow
Готов слишком поздно: больше 3000 мс после загрузки страницы.
perf_unresponsive
Не отвечает на проверку оверлея или отвечает слишком медленно (код блокирует браузер).
perf_navigated
Виджет ушёл со страницы или перезагрузил её.
perf_flood
Виджет отправляет оверлею слишком много сообщений.
perf_idle_cpu
Больше 2 % CPU, когда ничего не происходит.
perf_storm_cpu
Больше 15 % CPU при большом количестве событий.
perf_heap
Больше 64 МБ памяти.
perf_dom
Больше 3000 элементов на странице.
perf_long_task
Блокирует браузер дольше 200 мс за раз.
network_attempt
Пытается загрузить что-то с другого сайта (хост указан).
runtime_errors
Только подсказка, а не причина отказа: ошибки JavaScript во время теста. Админ видит первую из них.
| Код | Значение |
|---|---|
| perf_no_ready | Виджет так и не сообщил оверлею о загрузке. Обычно не хватает <script src="/sdk/v1.js"> или страница никогда не догружается. |
| perf_ready_slow | Готов слишком поздно: больше 3000 мс после загрузки страницы. |
| perf_unresponsive | Не отвечает на проверку оверлея или отвечает слишком медленно (код блокирует браузер). |
| perf_navigated | Виджет ушёл со страницы или перезагрузил её. |
| perf_flood | Виджет отправляет оверлею слишком много сообщений. |
| perf_idle_cpu | Больше 2 % CPU, когда ничего не происходит. |
| perf_storm_cpu | Больше 15 % CPU при большом количестве событий. |
| perf_heap | Больше 64 МБ памяти. |
| perf_dom | Больше 3000 элементов на странице. |
| perf_long_task | Блокирует браузер дольше 200 мс за раз. |
| network_attempt | Пытается загрузить что-то с другого сайта (хост указан). |
| runtime_errors | Только подсказка, а не причина отказа: ошибки JavaScript во время теста. Админ видит первую из них. |
Статья была полезной?