Почему WebGPU недоступен в браузере — три причины и что делать

Симптом узнаваемый. У тебя всё работает, ты радуешься. Отправляешь ссылку другу — «у меня белый экран». В консоли у него либо Cannot read properties of undefined (reading 'requestAdapter'), либо адаптер приходит пустым.
Главная ловушка тут вот в чём: WebGPU включается не «свежестью браузера», а совпадением трёх вещей — протокола, связки браузера с операционной системой и конкретной видеокарты. Свежий браузер может не помочь.
Сначала пойми, что именно сломалось
Две разные поломки выглядят почти одинаково. Различи их первой же строкой в консоли:
console.log("API:", !!navigator.gpu);
const adapter = navigator.gpu && (await navigator.gpu.requestAdapter());
console.log("адаптер:", adapter);
API: false— браузер вообще не знает про WebGPU. Это причины 1 и 2.API: true, но адаптерnull— API есть, а видеокарту браузер не дал. Это причина 3.
Именно поэтому проверка в одну строку — самая частая ошибка. Код вида if (navigator.gpu) пропускает вперёд тех, у кого дальше всё равно null, и падение случится на строчку ниже.
Причина 1. Сайт открыт не по HTTPS
Самая частая и самая обидная. WebGPU доступен только в защищённом контексте. Открыл страницу как file:// или по обычному http:// с IP-адреса в локальной сети — свойства navigator.gpu просто не существует.
Как проверить: в консоли console.log(window.isSecureContext). Пришло false — вот и ответ.
Как починить: локально работай через http://localhost (он считается защищённым по умолчанию), в бою — только по HTTPS. Тестируешь с телефона по локальному IP — подними туннель с сертификатом, иначе будешь чинить несуществующую проблему.
Причина 2. Связка браузера и системы
Здесь и живёт большинство «но у меня же последняя версия». Поддержка WebGPU зависит не только от браузера, но и от операционной системы под ним:
- Chrome и Edge — с версии 113, на Windows, macOS и ChromeOS. На Linux — только с 144-й, и то на видеокартах Intel Gen12 и новее.
- Chrome на Android — с версии 121.
- Safari — с 26-й, включая iPhone и iPad.
- Firefox — с 141-й, но только на Windows. На macOS и Linux по умолчанию выключен, на Android не поддерживается вовсе.
То есть Firefox на макé — свежайший, обновлённый, любимый — WebGPU тебе не даст. И это не ошибка пользователя.
Как проверить: попроси человека открыть ссылку в Chrome. Заработало — значит, дело в связке, а не в твоём коде.
Как починить: починить у пользователя нельзя, можно только предусмотреть. Тем, кто заходит из Firefox не на Windows, честно покажи запасной режим — а не пустой экран.
Причина 3. Браузер не выдал адаптер
Здесь navigator.gpu есть, а requestAdapter() возвращает null. Метод по спецификации не бросает исключение — он просто отвечает «подходящей видеокарты нет», и решение принимает сам браузер.
Типичные ситуации: очень старая видеокарта или драйвер, машина в виртуалке без графического ускорения, GPU в чёрном списке браузера, режим экономии энергии, удалённый рабочий стол.
Как проверить: в Chrome открой chrome://gpu — там видно, какие возможности выключены и почему.
Как починить: попробовать режим совместимости — он даёт урезанный набор возможностей WebGPU, зато заводится на более старых графических интерфейсах:
let adapter = await navigator.gpu.requestAdapter();
if (!adapter) {
adapter = await navigator.gpu.requestAdapter({ featureLevel: "compatibility" });
}
Не помогло — значит, у этого пользователя видеокарты для веба нет, и точка.
Что писать в коде, чтобы это не всплывало
Правило одно: WebGPU — ускорение, а не фундамент. Запасной путь — счёт на процессоре через WebAssembly:
const adapter = navigator.gpu && (await navigator.gpu.requestAdapter());
const device = adapter ? "webgpu" : "wasm";
Так устроены все живые библиотеки для ИИ в браузере: на видеокарте быстро, без неё медленнее, но работает. Пользователь без WebGPU получает рабочую страницу, а не сообщение «ваш браузер не поддерживается».
И ещё одно, из вредных мелочей: не кэшируй результат проверки навсегда. Человек может переключить ноутбук на встроенную графику, обновить браузер или открыть страницу с другой машины.
У меня Chrome последней версии, почему всё равно не работает?
Скорее всего, ты на Linux. Там Chrome включил WebGPU только с 144-й версии и только на видеокартах Intel Gen12 и новее — на остальных его нет независимо от номера версии.
А флаги в настройках браузера помогут?
Тебе — да, пользователю — нет. Включать dom.webgpu.enabled в Firefox или экспериментальные флаги в Chrome можно для проверки гипотезы, но строить на этом продукт нельзя: никто из посетителей флаги переключать не будет.
Как понять, что дело именно в WebGPU, а не в моём коде?
Открой консоль и выполни те две строки из начала статьи на своей странице. Если navigator.gpu есть и адаптер приходит объектом — проблема не в WebGPU, ищи дальше в загрузке модели, в путях к файлам или в кэше.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





