Jak szybciej dostarczać aktualizacje rozszerzeń Chrome do użytkowników

Jak naprawdę działają aktualizacje rozszerzeń Chrome

Chrome sprawdza aktualizacje rozszerzeń mniej więcej co 5 godzin. Gdy znajdzie nową wersję w Chrome Web Store, pobiera ją i instaluje cicho w tle. Użytkownik nie widzi żadnego komunikatu — chyba że zmieniłeś uprawnienia.

To "chyba że" jest źródłem większości problemów. Jeśli nowa wersja wymaga uprawnień lub dostępu do hostów, których nie było w poprzedniej wersji, Chrome:

1. Natychmiast wyłącza rozszerzenie
2. Wyświetla znacznik na ikonie puzzla w pasku narzędzi
3. Czeka, aż użytkownik ręcznie kliknie "Włącz ponownie" i zaakceptuje nowe uprawnienia

Dopóki użytkownik tego nie zrobi, utknął na starej wersji z wyłączonym rozszerzeniem. Dla krytycznego narzędzia biznesowego, takiego jak rozszerzenie do zarządzania reklamami, jest to nieakceptowalne.

1. Zawęź host_permissions do minimum

Pole host_permissions w manifest.json to przyczyna numer jeden problemów z aktualizacjami. Każdy nowy origin wywołuje proces ponownej zgody.

"host_permissions": [
  "<all_urls>"
]

"host_permissions": [
  "https://ads.allegro.pl/*",
  "https://api.example.com/*"
]

"host_permissions": [
  "https://*.allegro.pl/*",
  "https://api.example.com/*"
]

2. Content scripts i wzorce dopasowań

Content scripts mają własne pole matches, które określa, na jakich stronach się uruchamiają. Zmiana tych wzorców nie wywołuje ponownej zgody na uprawnienia — ale błędna konfiguracja wciąż opóźnia aktualizacje w inny sposób.

Wzorce, które powodują problemy

"content_scripts": [{
  "matches": ["<all_urls>"],
  "js": ["content.js"]
}]

Wzorce zrobione dobrze

"content_scripts": [{
  "matches": [
    "https://ads.allegro.pl/*",
    "https://allegro.pl/ads/*"
  ],
  "js": ["content.js"],
  "run_at": "document_idle"
}]

Używaj run_at z głową

Pole run_at nie wpływa bezpośrednio na szybkość aktualizacji, ale ma znaczenie dla doświadczenia użytkownika po aktualizacji:

• document_idle (domyślne) — najbezpieczniejsze, uruchamia się po załadowaniu strony
• document_end — uruchamia się po gotowości DOM, ale przed zasobami podrzędnymi
• document_start — uruchamia się przed wszystkim innym, może spowalniać stronę

Używaj document_idle, chyba że masz konkretny powód, by tego nie robić. Rozszerzenia spowalniające ładowanie stron dostają niższe oceny i więcej odinstalowań.

3. Pole permissions — zaplanuj powierzchnię API z góry

Tablica permissions (oddzielna od host_permissions) kontroluje dostęp do API Chrome, takich jak storage, tabs,alarms i notifications. Dodanie nowego uprawnienia tutaj również wywołuje ponowną zgodę.

{
  "permissions": ["storage", "alarms"],
  "optional_permissions": ["notifications", "downloads"],
  "optional_host_permissions": ["https://analytics.example.com/*"]
}

4. Powiadamiaj użytkowników w czasie rzeczywistym

Nawet jeśli zrobisz wszystko dobrze z uprawnieniami i wzorcami dopasowań, ~5-godzinny cykl aktualizacji Chrome oznacza, że użytkownicy mogą korzystać z nieaktualnego kodu przez godziny. Dla krytycznych poprawek to za wolno.

Rozwiązanie: sprawdzaj opublikowaną wersję z wnętrza rozszerzenia i informuj użytkownika o dostępnej aktualizacji.

Dlaczego nie GitHub Action?

Można pomyśleć, że CI/CD to właściwe miejsce do sprawdzania wersji. Mamy GitHub Action do wykrywania eskalacji uprawnień i świetnie sprawdza się w łapaniu problemów przed publikacją. Ale do powiadamiania użytkowników o dostępnych aktualizacjach CI/CD nie pomoże:

• GitHub Action działa w Twoim pipeline, nie w przeglądarce użytkownika
• Spala minuty CI przy każdym sprawdzeniu
• Nie może powiedzieć użytkownikowi "hej, kliknij Aktualizuj"

Potrzebujesz lekkiego API, które Twoje rozszerzenie może wywołać w runtime, aby porównać swoją wersję z wersją opublikowaną w Chrome Web Store.

Chrome Extension Version API

Zbudowaliśmy i udostępniliśmy jako open source chrome-extension-version-api — jednoendpointowy serwis .NET, który odpytuje Chrome Web Store o opublikowaną wersję dowolnego rozszerzenia. Działa jako kontener Docker z wbudowanym cache.

GET /check-published-extension-version/{extensionId}

// Odpowiedź (200 OK)
{
  "version": "1.23.4",
  "cached": false,
  "checkedAt": "2026-03-16T12:00:00Z"
}

docker run -p 8080:8080 ghcr.io/toumash/chrome-extension-version-api:latest

Implementacja po stronie rozszerzenia

W content scripcie — kodzie, który działa na stronie, z której użytkownik aktywnie korzysta — sprawdź opublikowaną wersję i wyświetl powiadomienie o aktualizacji bezpośrednio w interfejsie:

// content.js — działa na stronie, z której użytkownik korzysta
const EXTENSION_ID = chrome.runtime.id;
const VERSION_API = 'https://your-api.example.com';

async function checkForUpdate() {
  const localVersion = chrome.runtime.getManifest().version;
  const res = await fetch(
    `${VERSION_API}/check-published-extension-version/${EXTENSION_ID}`
  );
  const { version: storeVersion } = await res.json();

  if (storeVersion && storeVersion !== localVersion) {
    // Pokaż baner aktualizacji na stronie, z której użytkownik korzysta
    const banner = document.createElement('div');
    banner.textContent = `Dostępna aktualizacja (v${storeVersion}). Przeładuj stronę.`;
    banner.style.cssText =
      'position:fixed;bottom:16px;right:16px;padding:12px 20px;' +
      'background:#f97316;color:#fff;border-radius:8px;z-index:99999;' +
      'font-family:sans-serif;cursor:pointer;';
    banner.onclick = () => location.reload();
    document.body.appendChild(banner);
  }
}

// Sprawdź przy ładowaniu strony
checkForUpdate();

FAQ

Powiązane artykuły