Гайды

Почему 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →