Яндекс Проверка Почты (Yandex Mail Checker)

Расширение для Chrome, которое показывает количество непрочитанных писем в Яндекс.Почте прямо на панели инструментов.

Возможности

Функция	Описание
🔔 Счетчик на иконке	Отображает количество непрочитанных писем на иконке расширения
📬 Уведомления	Системные уведомления Windows о новых письмах с отправителем и темой
⏱️ Настраиваемый интервал	Автопроверка каждые 1 / 5 / 15 / 30 минут (выбор в меню)
🔄 Ручная проверка	ПКМ по иконке → "Проверить сейчас"
🖱️ Быстрый переход	Клик по иконке — открывает Яндекс.Почту в новой вкладке
⚠️ Умная индикация ошибок	Различает "не залогинен", "нет сети", "ошибка сервера"
🔁 Автоповтор при ошибках	2 быстрых ретрая через 30 сек, затем штатный интервал
💾 Сохранение состояния	Помнит результат и настройки после перезапуска браузера

Установка

Вариант 1: Chrome Web Store

Скоро

Вариант 2: Ручная установка

git clone https://github.com/yourusername/yandex-mail-checker

cd yandex-mail-checker

Далее:

1. Откройте Chrome и перейдите на chrome://extensions/
2. Включите "Режим разработчика" (Developer mode)
3. Нажмите "Загрузить распакованное расширение" (Load unpacked)
4. Выберите папку с проектом

Использование

Основные действия

Действие	Результат
Левый клик по иконке	Открывает Яндекс.Почту в новой вкладке
Правый клик по иконке	Контекстное меню с настройками

Контекстное меню (правый клик по иконке)

Пункт	Описание
Проверить сейчас	Принудительная проверка почты
Интервал проверки	Подменю: 1 мин / 5 мин / 15 мин / 30 мин (текущий отмечен ✓)
🔔 Уведомления	Включить/выключить системные уведомления

Уведомления

При получении новых писем расширение показывает системное уведомление Windows:

• Одно письмо — отправитель и тема
• Несколько писем — список до 3 последних (отправитель + тема)
• Клик по уведомлению — открывает Яндекс.Почту

Уведомления можно отключить через контекстное меню.

Индикация на бейдже

Бейдж	Значение
Число (1–99+)	Количество непрочитанных писем
Пусто	Нет новых писем
?	Требуется авторизация в Яндекс.Почте
!	Ошибка подключения / ошибка сервера
↻	Идёт проверка

Подсказка (tooltip)

При наведении на иконку отображается: Яндекс.Почта (3 минуты назад) — время с последней проверки. При ошибках — описание проблемы.

Как это работает

Расширение использует lite-версию Яндекс.Почты, потому что она:

• Быстрее загружается (минимум JavaScript)
• Потребляет меньше трафика
• Легче парсится (чистый HTML)
• Не требует дополнительных API-ключей

Процесс работы:

1. Service worker запрашивает https://mail.yandex.ru/lite/inbox с заданным интервалом
2. Парсит HTML — извлекает количество непрочитанных, отправителей и темы
3. Сравнивает с предыдущим состоянием
4. Обновляет бейдж и отправляет уведомления о новых письмах
5. Сохраняет результат в chrome.storage.local

Обработка ошибок:

• Если пользователь не авторизован (редирект на passport.yandex.ru) — бейдж ?
• Если нет сети или таймаут — 2 быстрых ретрая через 30 сек, затем штатный интервал
• Если ошибка сервера (5xx) — аналогично, ретрай с паузой

Технические детали

Технологии

• Manifest V3 — современная архитектура расширений Chrome
• Service Worker — фоновые процессы без постоянной памяти
• Chrome Alarms API — периодические проверки
• Chrome Notifications API — системные уведомления
• Chrome Storage API — сохранение состояния и настроек
• Context Menus API — контекстное меню

Разрешения

Разрешение	Зачем
storage	Сохранение настроек и состояния
alarms	Периодическая проверка почты
contextMenus	Контекстное меню на иконке
notifications	Системные уведомления о новых письмах
https://mail.yandex.ru/*	Доступ к lite-версии почты

ВАЖНЫЙ ДИСКЛЕЙМЕР

Отношения с Яндексом

Данное расширение не является официальным продуктом Яндекса и не связано с компанией Яндекс. Это независимый open-source проект, созданный энтузиастами для удобства пользователей.

Соответствие правилам

Расширение разработано с уважением к правилам Яндекса и интернет-этикету:

✅ Не нарушает:

• Использует публичную lite-версию сайта
• Не обходит защиту, капчи или аутентификацию
• Не автоматизирует действия (только чтение)
• Не собирает личные данные пользователей
• Не передает информацию третьим лицам
• Имеет разумный интервал проверки (от 1 до 30 минут)

❌ Чего расширение НЕ делает:

• Не майнит криптовалюту
• Не показывает рекламу
• Не отслеживает пользователей
• Не изменяет содержимое страниц Яндекса
• Не выполняет действий от имени пользователя

Ограничение ответственности

Автор не несет ответственности за любые последствия использования данного расширения. Вы используете его на свой страх и риск. Расширение предоставляется "как есть" без каких-либо гарантий.

Если Яндекс против

Если представители Яндекса считают, что данное расширение нарушает их правила, просьба связаться с автором (через Issues на GitHub) для обсуждения возможности доработки или удаления репозитория.

Лицензия

Это свободное программное обеспечение: вы можете распространять и/или изменять его на условиях Стандартной общественной лицензии GNU (GPL) версии 3, как опубликовано Фондом свободного программного обеспечения.

Данная программа распространяется в надежде, что она будет полезной, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемых гарантий КОММЕРЧЕСКОЙ ЦЕННОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ. См. GNU General Public License для более подробной информации.

Полный текст лицензии доступен в файле LICENSE.

Контакты и поддержка

• GitHub Issues: Для сообщений об ошибках и предложений

Благодарности

• Сообществу open-source за вдохновение
• Яндекс за отличный почтовый сервис