Коротко
Полноэкранный режим включается вызовом requestFullscreen() только из обработчика нажатия, а альбомную ориентацию фиксирует screen.orientation.lock('landscape') — но по данным MDN на 09.11.2026 блокировка работает в Chrome и Firefox для Android и не работает в Safari. На iPhone полноэкранного режима для элементов страницы нет совсем, поэтому игре нужен запасной путь: подсказка «поверните телефон» и пауза до поворота. Ниже — таблица поддержки, цепочка вызовов с запасными путями и сторож паузы, проверенные в Node.js 24.
Содержание
- Два разных API: экран и поворот
- Поддержка браузерами на 09.11.2026
- Полноэкранный режим: только по нажатию
- Ориентация: узнать можно везде, зафиксировать — не везде
- iPhone: игра без полноэкранного режима
- Пауза при выходе из полноэкранного режима и повороте
- Код на JavaScript
- Практический сценарий: аркада в альбомной ориентации
- Когда вам это не подойдёт
Два разных API: экран и поворот
Fullscreen API и Screen Orientation API решают разные задачи и поддерживаются по-разному. Первый растягивает один элемент страницы — обычно контейнер с canvas — на весь экран и прячет интерфейс браузера. Второй сообщает, как повёрнут экран, а в части браузеров ещё и фиксирует поворот.
| Задача | Вызов | Событие |
|---|---|---|
| Войти в полноэкранный режим | element.requestFullscreen() | fullscreenchange на document |
| Выйти из него | document.exitFullscreen() | fullscreenchange |
| Узнать, кто на весь экран | document.fullscreenElement | — |
| Узнать ориентацию | screen.orientation.type | change на screen.orientation |
| Зафиксировать ориентацию | screen.orientation.lock('landscape') | — |
| Снять фиксацию | screen.orientation.unlock() | — |
Обычно их вызывают вместе: сначала полноэкранный режим, потом блокировка поворота. Многие браузеры разрешают блокировку только в полноэкранном режиме — MDN так и пишет: блокировка обычно включена на мобильных устройствах и когда документ показан на весь экран.
Поддержка браузерами на 09.11.2026
Чтение ориентации работает везде, полноэкранный режим — почти везде, кроме iPhone, а блокировка поворота — в основном на Android. Данные — из таблиц совместимости MDN и caniuse, проверено 09.11.2026:
| Браузер | requestFullscreen() | orientation.type и change | orientation.lock() |
|---|---|---|---|
| Chrome на компьютере | да, с версии 71 | да, с 38 | метод есть, но всегда отклоняется с NotSupportedError |
| Chrome на Android | да, с 71 | да, с 38 | да, с 38 |
| Firefox на Android | да, с 64 | да, с 43 | да, с 144; раньше метод был, но завершался ошибкой |
| Firefox на компьютере | да, с 64 | да, с 43 | с 144 — только на планшетах с Windows (по заметкам к выпуску) |
| Safari на macOS | да, с 16.4; раньше — с префиксом webkit | да, с 16.4 | нет |
| Safari на iPad | частично, с 16.4: кнопка поверх игры, которую нельзя скрыть, и выход свайпом вниз | да, с 16.4 | нет |
| Safari на iPhone | нет для элементов страницы: caniuse отмечает «только iPad» во всех версиях до 27.2 | да, с 16.4 | нет |
| Android WebView (игра внутри приложения) | да | да | нет |
Ещё две цифры для масштаба. MDN помечает Fullscreen API и lock() как «Limited availability» — не Baseline, а Screen Orientation API в целом — как Baseline с марта 2023 года. По caniuse полная поддержка Fullscreen API есть у 83,99% пользователей и частичная — ещё у 13,54%.
Таблицы меняются с каждым выпуском браузера: строку про Android WebView в данных MDN исправили 14.10.2026. Перед выпуском игры перепроверьте их на страницах из списка источников.
Полноэкранный режим: только по нажатию
Войти в полноэкранный режим можно только в ответ на действие игрока — нажатие кнопки, касание или клавишу. MDN называет это требованием кратковременной активации: активацию дают pointerdown, touchend или keydown (кроме Esc), и через некоторое время она истекает. Вызов при загрузке страницы или по таймеру отклоняется, и обещание завершается ошибкой TypeError.
Отсюда три правила:
- Отдельная кнопка «Играть». Вызывайте
requestFullscreen()первым действием в её обработчике, до загрузки уровня и прочих ожиданий. - Растягивайте контейнер, а не
canvas. Тогда поверх игры остаются ваши кнопки паузы и звука из HTML. - Слушайте
fullscreenchange. Игрок выходит клавишейEscили жестом, и игра узнаёт об этом только из события:document.fullscreenElementстановитсяnull.
Если игра встроена в чужую страницу через iframe, у фрейма должен быть атрибут allow="fullscreen" (или allowfullscreen), иначе вызов отклоняется по политике разрешений. Сайты-каталоги вроде itch.io обычно дают свою кнопку полноэкранного режима или открывают игру на весь экран сами.
Параметр navigationUI: 'hide' просит браузер скрыть свои панели, но решение остаётся за браузером: значение по умолчанию — 'auto'.
Ориентация: узнать можно везде, зафиксировать — не везде
Текущий поворот показывает screen.orientation.type: одно из значений portrait-primary, portrait-secondary, landscape-primary, landscape-secondary. О повороте сообщает событие change. Это работает во всех основных браузерах, включая Safari с версии 16.4.
Блокировка screen.orientation.lock('landscape') возвращает обещание, и обрабатывать нужно оба исхода. По MDN обещание отклоняется с:
NotSupportedError— браузер не умеет фиксировать эту ориентацию (так всегда в Chrome на компьютере);SecurityError— вкладка скрыта или фрейму не дано разрешениеallow-orientation-lock;AbortError— во время ожидания пришёл второй вызовlock()илиunlock().
В Safari метода lock нет вовсе, поэтому перед вызовом проверяйте typeof screen.orientation.lock === 'function'. Ошибка блокировки — не повод прерывать игру: это сигнал включить запасной путь.
iPhone: игра без полноэкранного режима
На iPhone игра всегда идёт на странице с интерфейсом Safari вокруг, поэтому её раскладка должна выдерживать оба положения. Порядок действий:
- Подсказка вместо блокировки. Если игре нужна альбомная ориентация, а телефон в портретной, поверх игры показывается экран «поверните телефон», а игра стоит на паузе.
- Пересчёт размера по событию. После поворота меняется размер области просмотра: заново считайте размер холста и масштаб, как в статье про пиксель-арт без размытия.
- Безопасные зоны. В альбомной ориентации вырез экрана оказывается сбоку; отступы для HUD и размер зон касания разобраны в статье про интерфейс поверх игры.
На iPad полноэкранный режим есть, но с оговорками из таблицы: кнопка выхода поверх игры и выход свайпом вниз. Если в игре есть жест «провести вниз», на iPad он может выкинуть игрока из полноэкранного режима — назначьте этому действию другой жест или кнопку.
Пауза при выходе из полноэкранного режима и повороте
Игра встаёт на паузу сама, а продолжается только по нажатию игрока. Причин паузы две: выход из полноэкранного режима и поворот в неподходящую ориентацию.
Почему не продолжать автоматически: игрок, который вышел из полноэкранного режима, мог переключиться на сообщение или звонок. Если игра продолжится сама, он вернётся к уже проигранному уровню. Нажатие «Продолжить» в обработчике заодно даёт право снова вызвать requestFullscreen().
Сторож в коде ниже запоминает причину паузы. При повороте обратно в альбомную ориентацию он лишь разрешает продолжить (can-resume), а нажатие в портретной ориентации игру не запускает (still-portrait).
Код на JavaScript
Код содержит вход в игру с запасными путями и сторож паузы. Окружения браузеров здесь смоделированы объектами по таблице выше, поэтому код запускается в Node.js 24 (как модуль .mjs), а вывод совпадает с комментарием после кода. В браузере env.el — контейнер игры, env.screen — глобальный screen, а методы сторожа вызываются из обработчиков fullscreenchange и change.
// Полноэкранный режим с запасными путями: стандартный метод, префикс webkit, отказ
function requestFs(el) {
if (el.requestFullscreen) return el.requestFullscreen({ navigationUI: 'hide' });
if (el.webkitRequestFullscreen) { el.webkitRequestFullscreen(); return Promise.resolve(); } // старые Safari на iPad: без обещания
return Promise.reject(new Error('fullscreen-unavailable'));
}
// Блокировка ориентации: есть не везде, а где есть — часто только в полноэкранном режиме
async function lockLandscape(screenLike) {
const o = screenLike.orientation;
if (!o || typeof o.lock !== 'function') return 'no-lock-api';
try { await o.lock('landscape'); return 'locked'; }
catch (e) { return 'lock-failed:' + e.name; }
}
// Вызывается только из обработчика нажатия кнопки «Играть»
async function enterGame(env) {
let fs = 'fullscreen';
try { await requestFs(env.el); } catch (e) { fs = 'no-fullscreen'; }
const lock = fs === 'fullscreen' ? await lockLandscape(env.screen) : 'skip-lock';
const portrait = env.screen.orientation
? env.screen.orientation.type.startsWith('portrait')
: env.height > env.width;
const hint = lock !== 'locked' && portrait ? 'rotate-hint' : 'play';
return [fs, lock, hint].join(' | ');
}
// Поддельные окружения для проверки в Node.js
const err = (name) => Object.assign(new Error(name), { name });
const ok = () => Promise.resolve();
const no = (name) => () => Promise.reject(err(name));
const orient = (type, lock) => ({ type, lock });
const envs = {
'Chrome, Android': { el: { requestFullscreen: ok }, screen: { orientation: orient('portrait-primary', ok) }, width: 390, height: 844 },
'Chrome, компьютер': { el: { requestFullscreen: ok }, screen: { orientation: orient('landscape-primary', no('NotSupportedError')) }, width: 1280, height: 720 },
'Safari, iPad': { el: { requestFullscreen: ok }, screen: { orientation: { type: 'portrait-primary' } }, width: 820, height: 1180 },
'Safari, iPhone': { el: {}, screen: { orientation: { type: 'portrait-primary' } }, width: 390, height: 844 },
'вызов без нажатия': { el: { requestFullscreen: no('TypeError') }, screen: { orientation: orient('landscape-primary', ok) }, width: 844, height: 390 },
};
for (const [name, env] of Object.entries(envs)) console.log(name.padEnd(18), '→', await enterGame(env));
// Пауза и возврат: игра сама не продолжается, нужен жест игрока
function createGuard(wantLandscape = true) {
const s = { paused: false, reason: null, fullscreen: true, landscape: true, log: [] };
const check = () => {
const bad = !s.fullscreen ? 'exit-fullscreen' : (wantLandscape && !s.landscape ? 'portrait' : null);
if (bad && !s.paused) { s.paused = true; s.reason = bad; s.log.push('pause:' + bad); }
if (!bad && s.paused && s.reason === 'portrait') s.log.push('can-resume');
};
return {
s,
onFullscreenChange(isFs) { s.fullscreen = isFs; check(); },
onOrientationChange(type) { s.landscape = type.startsWith('landscape'); check(); },
tapResume() {
if (!s.paused) return;
if (wantLandscape && !s.landscape) { s.log.push('still-portrait'); return; }
s.paused = false; s.reason = null; s.log.push('resume');
},
};
}
const g = createGuard();
g.onOrientationChange('portrait-primary');
g.tapResume();
g.onOrientationChange('landscape-secondary');
g.tapResume();
g.onFullscreenChange(false);
g.tapResume();
console.log(g.s.log.join(' → '));
Ожидаемый вывод программы:
Chrome, Android → fullscreen | locked | play
Chrome, компьютер → fullscreen | lock-failed:NotSupportedError | play
Safari, iPad → fullscreen | no-lock-api | rotate-hint
Safari, iPhone → no-fullscreen | skip-lock | rotate-hint
вызов без нажатия → no-fullscreen | skip-lock | play
pause:portrait → still-portrait → can-resume → resume → pause:exit-fullscreen → resume
Полезная деталь: в Chrome на компьютере блокировка всегда отклоняется, но экран и так альбомный, и подсказка не нужна. В последней строке без нажатия полноэкранный режим отклонён, а игра всё равно идёт, потому что окно уже альбомное.
Практический сценарий: аркада в альбомной ориентации
Возьмём аркаду с опорным размером 1280×720, которая играется только в альбомной ориентации, и 5 устройств для проверки. Порядок работы:
- Кнопка «Играть». Первое действие обработчика —
enterGame, только потом загрузка уровня. - Подсказка поворота. Экран «поверните телефон» — в HTML поверх
canvas; показывается при результатеrotate-hintи при паузе с причинойportrait. - Обработчики.
documentслушаетfullscreenchange,screen.orientation—change; оба передают состояние сторожу. - Кнопка «Продолжить». Вызывает
tapResume, а еслиdocument.fullscreenElementпуст и браузер поддерживает режим — ещё иrequestFullscreen(). - Проверка на устройствах. Ожидаемые результаты:
| Устройство | При нажатии «Играть» | Что проверить руками |
|---|---|---|
| Телефон на Android, Chrome | полный экран, поворот зафиксирован | Назад выводит из режима — игра на паузе |
| Ноутбук, Chrome или Firefox | полный экран | Esc — пауза, «Продолжить» возвращает полный экран |
| iPad, Safari | полный экран, подсказка в портретной ориентации | свайп вниз — пауза |
| iPhone, Safari | подсказка «поверните телефон» | после поворота игра ждёт нажатия |
| Игра во фрейме на чужом сайте | без полного экрана, если нет allow="fullscreen" | игра всё равно запускается |
Когда вам это не подойдёт
Связка полноэкранного режима и блокировки поворота полезна для мобильных аркад, но не для всех игр:
- Игра в портретной ориентации или для любого положения. Головоломке на сетке или кликеру проще выдерживать оба положения, чем требовать поворот.
- Только компьютер. На ноутбуке поворот не меняется, а полноэкранный режим — дело вкуса: часть игроков предпочитает окно рядом с другими вкладками. Дайте кнопку, но не включайте режим без спроса.
- Игра внутри чужого приложения. В Android WebView блокировка не поддерживается, а полноэкранный режим зависит от настроек приложения-контейнера.
- Нужна гарантия альбомной ориентации на iPhone. Из браузера её не получить; это задача нативной обёртки, а не веб-страницы.
Мы разрабатываем J2DRU — браузерный 2D игровой движок, рассчитанный на управление с клавиатуры, мыши, геймпада и касанием, с целевыми браузерами Chrome на компьютере и Android и Safari на macOS, iPhone и iPad. Движок в разработке и публично пока не открыт, заявку можно оставить на странице раннего доступа (подача заявки не гарантирует приглашение).
Источники (проверено: 09.11.2026): MDN — Element: requestFullscreen() (требование кратковременной активации, TypeError, navigationUI, политика fullscreen для фреймов, «Limited availability»); MDN — Transient activation (какие события дают активацию, срок истекает); MDN — ScreenOrientation: lock() (блокировка обычно на мобильных и в полноэкранном режиме, ошибки NotSupportedError, SecurityError, AbortError); MDN — Screen Orientation API (Baseline с марта 2023); данные совместимости MDN browser-compat-data для ScreenOrientation, Element.requestFullscreen, Document.exitFullscreen (версии браузеров в таблице; правка про Android WebView — 14.10.2026); MDN — Firefox 144 release notes for developers (lock() и unlock() для Android и планшетов с Windows, выпуск 14.10.2025); caniuse — Fullscreen API (iOS Safari — частичная поддержка «только iPad» до 27.2, 83,99% + 13,54%) и caniuse — Screen Orientation. Окружения браузеров в коде — наша модель по этим таблицам, вывод — наш прогон в Node.js 24.
Читайте также: