---
title: "Чек-лист проверки браузерной 2D-игры перед показом: 10 пунктов"
description: "10 пунктов, которые стоит пройти перед тем, как показать браузерную 2D-игру друзьям, на джеме или в кружке: запуск с сервера вместо файла, чистая загрузка без ошибок, звук после первого нажатия, пауза на скрытой вкладке, три размера экрана, ввод в русской раскладке, сохранение после перезагрузки, кадр при замедлении CPU в 4 раза, 10 перезапусков сцены и первый игрок без подсказок. С автоматическим прогоном на JavaScript, проверенным в Node.js 24."
slug: chek-list-proverki-brauzernoj-2d-igry-pered-pokazom
date: 2026-11-09
updated: 2026-11-09
scheduled_at: "2026-11-09T19:00:00+03:00"
rubric: praktika-i-uroki
tags: ["chek-list", "testirovanie", "brauzernye-igry", "javascript", "novichkam"]
reading_time: 13
draft: false
summary: "Перед показом браузерной 2D-игры хватает 10 проверок примерно на 1 час: запуск с локального сервера, чистая загрузка без ошибок в консоли, звук после первого нажатия, пауза на скрытой вкладке, три размера экрана, управление в русской раскладке, сохранение после перезагрузки, кадр при замедлении CPU в 4 раза, 10 перезапусков сцены и первый игрок без подсказок. Часть проверок автоматизируется: прогон минуты игры в Node.js ловит утечку объектов и подписок — в нашем примере 363 объекта и 11 подписчиков вместо 7 и 1."
---

## Коротко

Перед показом браузерной 2D-игры хватает 10 проверок примерно на 1 час: от запуска с локального сервера до первого игрока, которому ничего не объясняют. Пункты отвечают на вопрос «можно показывать или нет», а искать причину сбоя — уже работа отладки и профайлера. Часть пунктов автоматизируется: прогон минуты игры в Node.js ловит утечку объектов и подписок до того, как её заметит зритель.

## Содержание

1. Чек-лист: 10 пунктов и критерий «готово»
2. Пункты 1–2: сервер и чистая загрузка
3. Пункты 3–4: звук и скрытая вкладка
4. Пункты 5–7: экраны, управление, сохранение
5. Пункты 8–9: кадр и перезапуски
6. Пункт 10: первый игрок без подсказок
7. Код на JavaScript: автоматическая часть
8. Практический сценарий: час до показа на джеме
9. Когда вам это не подойдёт

## Чек-лист: 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`), вывод совпадает с комментарием после кода.

```js
// Генератор случайных чисел с зерном: один и тот же прогон при каждом запуске
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 })));
```

Ожидаемый вывод программы (имя прогона, проваленные проверки, очки, объекты на сцене, подписчики):

```text
с ошибками: objects,restart 200 363 11
исправлено: PASS 200 7 1
```

С ошибками прогон провалил две проверки: на сцене 363 объекта вместо 7 и 11 подписчиков вместо 1 — по подписчику на каждый перезапуск. Очки совпали, то есть игра «работает», и без счёта объектов ошибку легко не заметить. Чтобы подключить прогон к своей игре, нужно отделить логику от отрисовки: функция `step(dt, input)` не должна трогать `canvas` и `document`.

## Практический сценарий: час до показа на джеме

Возьмём джем: через час показ, игра — аркада со сбором монет, проверяющий — один автор. Распределение времени:

1. **5 минут — автоматика.** Прогон `smoke` из кода выше. Провалы чинятся первыми: утечка объектов к концу показа превратится в просадку кадра.
2. **10 минут — пункты 1–2.** Локальный сервер, Disable cache, консоль и `404`.
3. **10 минут — пункты 3–4.** Звук по первому нажатию, вкладка на 10 секунд.
4. **15 минут — пункты 5–7.** Три размера окна, русская раскладка и геймпад, `F5` посреди уровня.
5. **5 минут — пункт 8.** Замедление CPU в 4 раза на самом насыщенном участке.
6. **15 минут — пункт 10.** Три соседа по столу, по 5 минут каждый, вы молчите и записываете.

Если на всё не хватает времени, порядок важности такой: 2, 10, 3, 4. Ошибка в консоли или игрок, не понявший цель, видны зрителю сразу; кадр при замедлении CPU — нет.

## Когда вам это не подойдёт

Этот чек-лист рассчитан на показ небольшой браузерной игры, а не на выпуск продукта:

- **Выпуск в магазин или на площадку с модерацией.** Там свои требования: возрастная маркировка, политика данных, размеры обложек. Список нужно расширять под площадку.
- **Сетевая игра.** Задержка сети, обрыв соединения и два игрока в одной комнате требуют отдельных проверок с сервером.
- **Логика не отделена от отрисовки.** Автоматическая часть тогда не запустится в Node.js; сначала вынесите `step` и `save` в модуль без `canvas` и `document` или проверяйте пункт 9 руками в панели Memory.
- **Нужна статистика, а не впечатление.** Три игрока покажут грубые ошибки понятности; чтобы сравнить два варианта уровня, нужны десятки прохождений и запись времени.

Мы разрабатываем **J2DRU** — браузерный 2D игровой движок, где логика собирается из событий, условий и действий, а проект можно углублять на TypeScript. Движок в разработке и публично пока не открыт, заявку можно оставить на [странице раннего доступа](/early-access?utm_source=blog&utm_medium=article&utm_campaign=chek-list-proverki-brauzernoj-2d-igry-pered-pokazom) (подача заявки не гарантирует приглашение).

**Источники (проверено: 09.11.2026):** [MDN — Reason: CORS request not HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS/Errors/CORSRequestNotHttp) (локальные файлы — непрозрачный источник в Firefox и Chrome, совет поднять локальный сервер); [MDN — Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/en-US/docs/Web/Media/Guides/Autoplay) (условия автоматического воспроизведения); [MDN — Document: visibilitychange event](https://developer.mozilla.org/en-US/docs/Web/API/Document/visibilitychange_event); [itch.io — Uploading HTML5 games](https://itch.io/docs/creators/html5) (раздел Common Pitfalls: регистр имён файлов на сервере и в Windows и macOS). Пороги в таблице (1% кадров, 3 игрока, 5 минут, 200 объектов), учебная игра и вывод — наш ориентир и наш прогон в Node.js 24.

**Читайте также:**
- [Как найти просадку FPS в браузерной 2D-игре: бюджет кадра, Chrome DevTools Performance, долгие задачи и сборка мусора](/blog/prosadki-fps-v-brauzernoj-igre-chrome-devtools-performance)
- [Ориентация экрана и полноэкранный режим в браузерной игре: Fullscreen API и Screen Orientation](/blog/orientaciya-ekrana-i-polnoekrannyj-rezhim-v-brauzernoj-igre)
- [Сохранения в браузерной игре: localStorage или IndexedDB, версии формата и защита от потери прогресса](/blog/sohraneniya-v-brauzernoj-igre-localstorage-indexeddb)
