Правила виджетов: размеры, лимиты производительности и коды проверки

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

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 мс без ответа — и виджет отключается.
  • Если завис сам оверлей (например, потому что вкладка была в фоне), это никогда не засчитывается против вашего виджета.
  • Отключённый виджет остаётся выключенным до следующей перезагрузки. В редакторе при этом отображается «Виджет остановлен».
Совет: Держите страницу лёгкой: удаляйте старые элементы (стартовый набор показывает не больше maxCards карточек), используйте CSS-анимации вместо циклов на JavaScript и не запускайте таймеры, когда ничего не происходит.

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

Если проверка не пройдена, редактор или студия продавца показывает список причин. Здесь перечислены все коды.

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).

Автотест

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 во время теста. Админ видит первую из них.

Статья была полезной?