Коротко
Перед показом браузерной 2D-игры хватает 10 проверок примерно на 1 час: от запуска с локального сервера до первого игрока, которому ничего не объясняют. Пункты отвечают на вопрос «можно показывать или нет», а искать причину сбоя — уже работа отладки и профайлера. Часть пунктов автоматизируется: прогон минуты игры в Node.js ловит утечку объектов и подписок до того, как её заметит зритель.
Содержание
- Чек-лист: 10 пунктов и критерий «готово»
- Пункты 1–2: сервер и чистая загрузка
- Пункты 3–4: звук и скрытая вкладка
- Пункты 5–7: экраны, управление, сохранение
- Пункты 8–9: кадр и перезапуски
- Пункт 10: первый игрок без подсказок
- Код на JavaScript: автоматическая часть
- Практический сценарий: час до показа на джеме
- Когда вам это не подойдёт
Чек-лист: 10 пунктов и критерий «готово»
Каждый пункт — одно действие и один проверяемый признак, который даёт ответ «да» или «нет». Пороги в таблице — наш ориентир для показа учебной или джемовой игры, а не стандарт:
| № | Что проверить | Как | Готово, если |
|---|---|---|---|
| 1 | Запуск с сервера | python3 -m http.server 8000 или npx serve в папке игры | игра открывается по http://localhost:8000 |
| 2 | Чистая загрузка | DevTools → Network, флажок Disable cache, перезагрузка | 0 красных строк в консоли, 0 ответов 404 |
| 3 | Звук | первое нажатие «Играть» | звук есть с первого действия |
| 4 | Скрытая вкладка | переключиться на другую вкладку на 10 секунд | игра на паузе, звук стих, игрок жив |
| 5 | Три экрана | 1280×720, 844×390, 390×844 и поворот | HUD на месте, картинка не размыта |
| 6 | Управление | русская раскладка, геймпад, касание | все действия работают на каждом устройстве |
| 7 | Сохранение | перезагрузка страницы посреди уровня | прогресс на месте |
| 8 | Кадр на слабой машине | замедление CPU в 4 раза | не больше 1% кадров длиннее 16,67 мс |
| 9 | Перезапуски | 10 раз «заново» и 1 минута игры | число объектов и подписок не растёт |
| 10 | Первый игрок | 3 человека, 5 минут молча | каждый понял цель без слов |
Пункты 1–2: сервер и чистая загрузка
Игру проверяют с локального сервера, потому что страница, открытая как файл, ведёт себя не как на хостинге. По MDN Firefox и Chrome считают локальные файлы непрозрачным источником, и загрузка соседних файлов через fetch из file:// падает с ошибкой CORS; MDN прямо советует для проверки поднять локальный сервер. Обратная ловушка тоже бывает: в одних браузерах с диска что-то работает, а на хостинге — нет.
Чистая загрузка — это первый запуск глазами нового игрока, без файлов в кэше. В DevTools на вкладке Network включите Disable cache и перезагрузите страницу. Готово, если в консоли нет красных строк, а в списке запросов нет ответов 404: чаще всего это файл, названный Hero.png, а в коде — hero.png. Windows и macOS по умолчанию находят такой файл без учёта регистра, а сервер, различающий регистр, — нет; так это описывает и документация itch.io. Как сделать честный экран загрузки, — в статье про загрузку ресурсов.
Пункты 3–4: звук и скрытая вкладка
Звук должен появиться с первого действия игрока, а не при загрузке страницы. По MDN браузеры разрешают автоматическое воспроизведение со звуком, только если пользователь уже взаимодействовал с сайтом (клик, касание, клавиша), звук выключен или сайт в списке разрешённых. Поэтому звук запускают в обработчике кнопки «Играть»; как устроен звуковой движок с шинами и голосами — в статье про Web Audio API.
Скрытая вкладка проверяется так: начните уровень, переключитесь на другую вкладку на 10 секунд и вернитесь. Готово, если игра стоит на паузе, звук стих, а герой не погиб, пока вас не было. Сигнал для паузы — событие visibilitychange и document.hidden; оно же — хороший момент для сохранения.
Пункты 5–7: экраны, управление, сохранение
Три размера окна ловят большинство ошибок раскладки: ноутбук 1280×720, телефон в альбомной ориентации 844×390 и в портретной 390×844. В DevTools это режим эмуляции устройства. Готово, если счётчик очков и кнопки не уехали за край и не спрятались под вырез, пиксель-арт не размыт, а после поворота игра пересчитала размер. Подробно — в статьях про HUD, пиксель-арт и сегодняшней дневной статье про ориентацию экрана.
Управление проверяют в русской раскладке, с геймпадом и касанием. Самая частая ошибка — проверка event.key === 'w': в русской раскладке эта клавиша даёт «ц», и герой стоит. Готово, если каждое действие из меню управления срабатывает на каждом устройстве, которое вы обещаете.
Сохранение проверяют перезагрузкой посреди уровня. Готово, если после F5 прогресс на месте, а в приватном окне игра хотя бы не падает при пустом хранилище.
Пункты 8–9: кадр и перезапуски
Кадр проверяют на замедленной машине: в панели Performance включите замедление CPU в 4 раза и сыграйте трудный участок. При 60 кадрах в секунду бюджет кадра — 1000 / 60 ≈ 16,67 мс. Наш порог для показа — не больше 1% кадров длиннее бюджета; если больше, причину ищут по методике статьи про просадки FPS, а не на глаз.
Перезапуски проверяют 10 раз подряд: «заново», «в меню», снова уровень. Готово, если число объектов на сцене и число подписчиков событий после 10 кругов такое же, как после первого. Эту проверку и ещё пять удобно отдать коду — он ниже.
Пункт 10: первый игрок без подсказок
Последний пункт проверяет не код, а понятность: 3 человека, которые игру не видели, играют 5 минут, а вы молчите. Запишите для каждого, через сколько секунд он понял цель, где застрял и что нажимал зря. Готово, если все трое поняли цель без слов. Если нет — помогает структура уровня, где механика сначала показана безопасно, — она разобрана в утренней статье про кисётэнкэцу.
Код на JavaScript: автоматическая часть
Код прогоняет 1 минуту учебной игры (3600 кадров по 1/60 секунды) с записанным вводом и проверяет 6 признаков: числа конечны, игрок в границах поля, два прогона с одним зерном совпадают, объектов не больше 200, сохранение читается обратно, а после 10 перезапусков подписчик ровно один. Игра содержит две спрятанные ошибки под флагом leak: пули за экраном не удаляются и подписка не снимается при выходе из сцены. Код запускается в Node.js 24 (как модуль .mjs), вывод совпадает с комментарием после кода.
// Генератор случайных чисел с зерном: один и тот же прогон при каждом запуске
function rng(seed) {
let a = seed >>> 0;
return () => { a = (a + 0x6d2b79f5) >>> 0; let t = a; t = Math.imul(t ^ (t >>> 15), t | 1); t ^= t + Math.imul(t ^ (t >>> 7), t | 61); return ((t ^ (t >>> 14)) >>> 0) / 4294967296; };
}
// Учебная игра: игрок стреляет вверх, монеты падают сверху. Ошибка спрятана в флаге leak
function createGame({ seed = 1, leak = false } = {}) {
const rand = rng(seed);
const W = 320, H = 180;
const st = { player: { x: 160, y: 160 }, bullets: [], coins: [], score: 0, t: 0 };
const listeners = [];
return {
W, H, st, listeners,
start() { listeners.push(() => {}); }, // подписка на ввод при входе в сцену
stop() { if (!leak) listeners.length = 0; }, // утечка: забыли отписаться
step(dt, input) {
st.t += dt;
st.player.x = Math.min(W - 8, Math.max(8, st.player.x + input.dx * 120 * dt));
if (input.fire) st.bullets.push({ x: st.player.x, y: st.player.y });
if (rand() < 0.05) st.coins.push({ x: 8 + rand() * (W - 16), y: 0 });
for (const b of st.bullets) b.y -= 240 * dt;
for (const c of st.coins) c.y += 60 * dt;
if (!leak) st.bullets = st.bullets.filter((b) => b.y > -8); // утечка: пули за экраном не удаляются
st.coins = st.coins.filter((c) => {
if (Math.abs(c.x - st.player.x) < 10 && Math.abs(c.y - st.player.y) < 10) { st.score += 10; return false; }
return c.y < H + 8;
});
},
save() { return JSON.stringify({ x: st.player.x, score: st.score }); },
load(json) { const d = JSON.parse(json); st.player.x = d.x; st.score = d.score; },
};
}
// Автоматическая часть чек-листа: 5 проверок без браузера
function smoke(make) {
const dt = 1 / 60, frames = 60 * 60; // 1 минута игры
const input = (i) => ({ dx: Math.sin(i / 50), fire: i % 10 === 0 });
const run = (g) => { g.start(); for (let i = 0; i < frames; i++) g.step(dt, input(i)); return g; };
const a = run(make()), b = run(make());
const res = {};
res.finite = [a.st.player.x, a.st.player.y, ...a.st.bullets.map((x) => x.y)].every(Number.isFinite);
res.bounds = a.st.player.x >= 8 && a.st.player.x <= a.W - 8;
res.repeat = a.st.score === b.st.score && a.st.coins.length === b.st.coins.length;
res.objects = a.st.bullets.length + a.st.coins.length <= 200;
const saved = a.save(); const c = make(); c.load(saved);
res.saveLoad = c.save() === saved;
for (let i = 0; i < 10; i++) { a.stop(); a.start(); } // 10 перезапусков сцены
res.restart = a.listeners.length === 1;
return { res, score: a.st.score, objects: a.st.bullets.length + a.st.coins.length, listeners: a.listeners.length };
}
const report = (name, r) => console.log(name, Object.entries(r.res).filter(([, v]) => !v).map(([k]) => k).join(',') || 'PASS', r.score, r.objects, r.listeners);
report('с ошибками:', smoke(() => createGame({ seed: 42, leak: true })));
report('исправлено:', smoke(() => createGame({ seed: 42 })));
Ожидаемый вывод программы (имя прогона, проваленные проверки, очки, объекты на сцене, подписчики):
с ошибками: objects,restart 200 363 11
исправлено: PASS 200 7 1
С ошибками прогон провалил две проверки: на сцене 363 объекта вместо 7 и 11 подписчиков вместо 1 — по подписчику на каждый перезапуск. Очки совпали, то есть игра «работает», и без счёта объектов ошибку легко не заметить. Чтобы подключить прогон к своей игре, нужно отделить логику от отрисовки: функция step(dt, input) не должна трогать canvas и document.
Практический сценарий: час до показа на джеме
Возьмём джем: через час показ, игра — аркада со сбором монет, проверяющий — один автор. Распределение времени:
- 5 минут — автоматика. Прогон
smokeиз кода выше. Провалы чинятся первыми: утечка объектов к концу показа превратится в просадку кадра. - 10 минут — пункты 1–2. Локальный сервер, Disable cache, консоль и
404. - 10 минут — пункты 3–4. Звук по первому нажатию, вкладка на 10 секунд.
- 15 минут — пункты 5–7. Три размера окна, русская раскладка и геймпад,
F5посреди уровня. - 5 минут — пункт 8. Замедление CPU в 4 раза на самом насыщенном участке.
- 15 минут — пункт 10. Три соседа по столу, по 5 минут каждый, вы молчите и записываете.
Если на всё не хватает времени, порядок важности такой: 2, 10, 3, 4. Ошибка в консоли или игрок, не понявший цель, видны зрителю сразу; кадр при замедлении CPU — нет.
Когда вам это не подойдёт
Этот чек-лист рассчитан на показ небольшой браузерной игры, а не на выпуск продукта:
- Выпуск в магазин или на площадку с модерацией. Там свои требования: возрастная маркировка, политика данных, размеры обложек. Список нужно расширять под площадку.
- Сетевая игра. Задержка сети, обрыв соединения и два игрока в одной комнате требуют отдельных проверок с сервером.
- Логика не отделена от отрисовки. Автоматическая часть тогда не запустится в Node.js; сначала вынесите
stepиsaveв модуль безcanvasиdocumentили проверяйте пункт 9 руками в панели Memory. - Нужна статистика, а не впечатление. Три игрока покажут грубые ошибки понятности; чтобы сравнить два варианта уровня, нужны десятки прохождений и запись времени.
Мы разрабатываем J2DRU — браузерный 2D игровой движок, где логика собирается из событий, условий и действий, а проект можно углублять на TypeScript. Движок в разработке и публично пока не открыт, заявку можно оставить на странице раннего доступа (подача заявки не гарантирует приглашение).
Источники (проверено: 09.11.2026): MDN — Reason: CORS request not HTTP (локальные файлы — непрозрачный источник в Firefox и Chrome, совет поднять локальный сервер); MDN — Autoplay guide for media and Web Audio APIs (условия автоматического воспроизведения); MDN — Document: visibilitychange event; itch.io — Uploading HTML5 games (раздел Common Pitfalls: регистр имён файлов на сервере и в Windows и macOS). Пороги в таблице (1% кадров, 3 игрока, 5 минут, 200 объектов), учебная игра и вывод — наш ориентир и наш прогон в Node.js 24.
Читайте также:
- Как найти просадку FPS в браузерной 2D-игре: бюджет кадра, Chrome DevTools Performance, долгие задачи и сборка мусора
- Ориентация экрана и полноэкранный режим в браузерной игре: Fullscreen API и Screen Orientation
- Сохранения в браузерной игре: localStorage или IndexedDB, версии формата и защита от потери прогресса