Как добавить пуш-уведомления на сайт — и почему на iPhone они молчат

Веб-пуши — те самые карточки, которые всплывают, даже когда сайт закрыт. Штука бесплатная и делается за вечер.
И сразу главная ловушка, на которой спотыкаются все: на iPhone веб-пуш не работает у сайта, открытого во вкладке Safari. Вообще. Он оживает только после того, как человек добавил твой сайт на домашний экран. Причём это не про Safari — все браузеры на iOS работают на движке WebKit, так что Chrome на айфоне ведёт себя точно так же.
Держи это в голове — и пошли собирать.
Что понадобится
Три части, которые должны сойтись:
- манифест — чтобы сайт можно было установить на домашний экран;
- service worker — фоновый скрипт, который поймает уведомление, когда вкладка закрыта;
- VAPID-ключи — пара ключей, которой твой сервер доказывает пуш-сервису, что это правда ты.
Сервер нужен любой, хоть на бесплатном хостинге: пуш нельзя отправить из браузера, только со своей стороны.
1. Добавь манифест
Создай manifest.json в корне сайта:
{
"name": "Мой проект",
"short_name": "Проект",
"start_url": "/",
"display": "standalone",
"icons": [
{ "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
]
}
И подключи его в <head>:
<link rel="manifest" href="/manifest.json">
Без манифеста iPhone не даст установить сайт на домашний экран — а значит, пушей там не будет.
2. Напиши service worker
Файл sw.js в корне (важно: именно в корне — иначе он не увидит весь сайт):
self.addEventListener('push', (event) => {
const data = event.data ? event.data.json() : {};
event.waitUntil(
self.registration.showNotification(data.title || 'Привет', {
body: data.body || '',
icon: '/icon-192.png',
})
);
});
self.addEventListener('notificationclick', (event) => {
event.notification.close();
event.waitUntil(clients.openWindow('/'));
});
Первый обработчик показывает карточку, второй — открывает сайт по клику. Без второго уведомление просто исчезнет, и пользователь не поймёт, куда идти.
3. Сгенерируй VAPID-ключи
Одна команда в терминале:
npx web-push generate-vapid-keys --json
Получишь пару: publicKey и privateKey. Публичный поедет в браузер, приватный остаётся на сервере — положи оба в .env (см. переменные окружения) и никогда не коммить приватный в репозиторий. Почему это важно — в как безопасно хранить ключи.
4. Спроси разрешение и подпишись
Этот код выполняется на странице — обязательно по клику пользователя, а не при загрузке:
async function subscribe() {
const reg = await navigator.serviceWorker.register('/sw.js');
const permission = await Notification.requestPermission();
if (permission !== 'granted') return;
const sub = await reg.pushManager.subscribe({
userVisibleOnly: true,
applicationServerKey: 'ТВОЙ_ПУБЛИЧНЫЙ_VAPID_КЛЮЧ',
});
await fetch('/api/save-subscription', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(sub),
});
}
Два момента, которые чинят половину проблем:
- Вешай это на кнопку «Включить уведомления». Браузеры глушат запрос разрешения, если он выскакивает сам при открытии страницы. А пользователь, нажавший «Запретить», уже не увидит запрос повторно — второго шанса не будет.
userVisibleOnly: trueобязателен. Молчаливые пуши в вебе запрещены: на каждый пуш обязана появиться видимая карточка.
5. Сохрани подписку на сервере
С фронта прилетит объект такого вида:
{
"endpoint": "https://fcm.googleapis.com/fcm/send/dK9...",
"keys": { "p256dh": "BL7ELU24...", "auth": "juarI8x..." }
}
Это адрес конкретного браузера конкретного человека плюс ключи шифрования. Сложи целиком в базу — по одной записи на устройство. Один человек с телефона и ноутбука даст две подписки, и это нормально.
Обращайся с endpoint как с секретом: кто его знает, тот может слать уведомления твоему пользователю.
6. Отправь пуш с сервера
Ставим библиотеку: npm i web-push. Дальше — десяток строк:
const webpush = require('web-push');
webpush.setVapidDetails(
'mailto:[email protected]',
process.env.VAPID_PUBLIC_KEY,
process.env.VAPID_PRIVATE_KEY
);
await webpush.sendNotification(
subscription,
JSON.stringify({ title: 'Готово', body: 'Твой отчёт собран' })
);
Библиотека сама зашифрует текст ключами из подписки и постучится в пуш-сервис браузера.
Один момент из практики: подписки протухают — человек снёс приложение, почистил данные. Тогда sendNotification вернёт ошибку 404 или 410. Лови её и удаляй запись из базы, иначе список мёртвых подписок будет расти вечно.
Что получится
Нажимаешь кнопку на сайте, разрешаешь уведомления, закрываешь вкладку. С сервера дёргаешь отправку — и карточка всплывает поверх системы, как у обычного приложения. На ноутбуке — в углу экрана, на Android — в шторке.
Как отладить, если не работает
Открой в браузере DevTools → вкладку Application → раздел Service Workers. Там сразу видно главное: зарегистрирован ли твой sw.js, активен ли он, не висит ли старая версия.
Три приёма, которые экономят вечер:
- Кнопка Push прямо в DevTools. Отправляет тестовое уведомление в твой service worker без всякого сервера. Если по ней карточка появляется, а с сервера нет — проблема в отправке, а не в коде обработчика.
- Галочка Update on reload. Service worker кешируется агрессивно, и ты часто правишь файл, а браузер крутит старую копию. С этой галочкой он обновляется на каждой перезагрузке.
- Проверь разрешение вручную. В консоли набери
Notification.permission. Ответdeniedозначает, что пользователь однажды нажал «Запретить», и никакой код это не переиграет — снимать запрет придётся в настройках сайта вручную.
Отдельно про iOS: три условия
Чтобы пуши заработали на iPhone, должно совпасть всё:
- iOS 16.4 или новее;
- у сайта есть манифест;
- пользователь открыл «Поделиться» → «На экран Домой» и запустил сайт с иконки.
Пока сайт живёт во вкладке — pushManager там просто недоступен, и никакой код это не обойдёт. Поэтому на iPhone добавь честную подсказку: «Чтобы получать уведомления, добавь сайт на домашний экран». В свежих версиях iOS сайты с домашнего экрана по умолчанию открываются как отдельное приложение, так что дальше всё идёт как на Android.
Ещё полезное: Safari 18.4 принёс Declarative Web Push — упрощённый вариант, которому не нужен service worker. Но для совместимости со всем остальным мир пока живёт на схеме выше.
Почему пуши приходят на ноутбуке, но не на телефоне?
Девять из десяти случаев — iOS и незакрытый пункт 3: сайт не добавлен на домашний экран. Проверь на Android — если там приходит, дело именно в этом.
Нужен ли HTTPS?
Да. Service worker работает только на HTTPS. Исключение одно — localhost для разработки.
Чем пуши отличаются от писем?
Пуш мгновенный и короткий, письмо — длинное и остаётся в почте. Для «твой отчёт готов» лучше пуш, для чеков и важных документов — письмо с сервера.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





