IHOR.DEVБАЗА_ЗНАНЬ
МЕНЮ

~/blog / Розширення / reliable-background-jobs-with-chrome-alarms.md

// посібник · 3 хв читання

Надійні фонові завдання з chrome.alarms

Плануйте відновлювані MV3-завдання через alarms, відтворюйте розклад, допускайте сон і затримки та зберігайте прогрес замість таймерів.

Коротка відповідь

Використовуйте будильники Chrome, щоб повернутися до роботи після завершення воркера; setInterval не є постійним планувальником. Будильник дає можливість пробудження, а не точний строк чи збережену чергу. Зберігайте намір і прогрес завдання окремо, реєструйте слухача синхронно та робіть обробку безпечною для повторення.

Сон пристрою може затримувати доставку. Пропущений повторний будильник спрацьовує щонайбільше один раз після пробудження, а не повторює всі пропущені інтервали. Перевіряйте та відтворюйте важливі розклади за потреби, явно враховуючи поведінку зберігання мінімальної підтримуваної версії.

Практичні кроки реалізації

  1. Визначте, чи це нагадування, локальне обслуговування або зовнішній ефект. Нагадування можна пропустити; прийняте завантаження потребує узгодження. Не застосовуйте одне правило повторення до обох.
  2. Зберігайте бажаний стан розкладу. Після вимкнення користувачем очистіть будильник і запишіть вибір, щоб запуск воркера не повернув його.
  3. Перевіряйте будильник за назвою замість створення при кожному запуску, що скидає запланований час. Реєструйте слухачі до читання збереженого стану.
  4. Обмежте обробники. Очищення історії працює з визначеними локальними записами; мережеве завдання потребує часу очікування, межі повторів і ID проти випадкових дубльованих ефектів.
  5. Перевірте сон, перезапуск браузера, оновлення та відмову запису. persistAcrossSessions додано у Chrome 150; старіші версії мають іншу поведінку. Використовуйте опцію лише з відповідною межею сумісності, а приклади для старіших браузерів мають відтворювати відсутній будильник.

Бюджет історії LocaleStress — вимога зберігання, а не доказ реалізації через будильники. Очищення при записі звіту може бути достатнім; фоновий розклад потрібен лише продукту з часовим обслуговуванням.

Приклад реалізації

За дозволів alarms і storage воркер підтримує один необов’язковий годинний будильник. Обробник лише записує спостереження; замініть його обмеженим, безпечним для повторення завданням та обробляйте відмови.

const NAME = "local-maintenance";
async function reconcileSchedule() {
  const { maintenanceEnabled = false } = await chrome.storage.local.get("maintenanceEnabled");
  if (!maintenanceEnabled) { await chrome.alarms.clear(NAME); return; }
  if (!await chrome.alarms.get(NAME)) {
    await chrome.alarms.create(NAME, { periodInMinutes: 60 });
  }
}

chrome.alarms.onAlarm.addListener((alarm) => {
  if (alarm.name !== NAME) return;
  chrome.storage.local.set({ lastMaintenanceWake: Date.now() }).catch(console.error);
});
chrome.storage.onChanged.addListener((changes, area) => {
  if (area === "local" && "maintenanceEnabled" in changes) {
    void reconcileSchedule().catch(console.error);
  }
});
void reconcileSchedule().catch(console.error);

Паралельні ввімкнення й вимкнення потребують послідовного узгодження у повній реалізації. Позначка часу доводить спостережене пробудження, а не завершене обслуговування. Розділяйте ці діагностичні стани.

Компроміси та альтернативи

Подієве обслуговування усуває розклад, якщо запис чи відкриття вже дає природний тригер. Будильники підходять для періодичного повернення, а не точного часу. Для завдань, що мають виконуватися із закритим браузером, використовуйте серверний планувальник.

Поширені помилки

  • Вважати, що будильник пробуджує пристрій зі сну.
  • Створювати його при кожному запуску й відкладати строк.
  • Вважати спрацьовування завершенням зовнішнього завдання.
  • Додавати штучну активність замість збереженого прогресу.

Контрольний список випуску

  • Бажаний розклад і вимкнений стан збережені.
  • Відсутні будильники відтворюються без скидання чинних.
  • Повторення й переривання завдання безпечні.
  • Сон і перезапуск перевірені за підтримуваної версії.
  • Доказ завершення відрізняється від доказу пробудження.

Поширені запитання

Чи запланувати точну секунду?

Ні. Браузер може затримувати будильники; проєктуйте для виконання із затримкою та документованих мінімальних періодів.

Чи потрібен alarm кожному запису?

Зазвичай ні. Одна обмежена черга чи будильник обслуговування простіші для перегляду й не збільшують розклад без потреби.

Що зробити спочатку?

Визначте, чи наявна подія може виконати роботу. Якщо потрібен будильник, збережіть намір і перевірте пізню доставку перед додаванням повторів.

Первинні джерела

Пов’язані посібники та приклади

Ігор Харчишин

Незалежний full-stack інженер продуктів, який пише посібники з реалізації розширень браузера та сучасних вебпродуктів на основі першоджерел.

Потрібно реалізувати це у вашому продукті?

Інструменти браузера з чіткою метою, обґрунтованими дозволами та підтримуваною архітектурою Manifest V3.