Chrome hat Manifest V2 leise beendet. Eines Tages akzeptierte der Web Store keine MV2-Einreichungen mehr. Wenn Sie Browser-Erweiterungen als Teil Ihres Indie-Produkt-Stacks erstellen, ist diese Frist bereits abgelaufen.Manifest V3ist nicht mehr optional. Es ist das einzige Spiel in der Stadt.

Die Frage ist nicht, ob MV3 übernommen werden soll. Die Frage ist, wie Sie Ihre Architektur überdenken können, damit Sie aufhören, gegen die Plattform zu kämpfen, und mit ihr arbeiten können. Diese Verschiebung ist größer, als die meisten Tutorials zugeben.

Warum sich MV3 wie eine andere Laufzeit anfühlt

Stellen Sie sich MV2-Hintergrundskripte wie einen Server vor, der niemals schläft. Ihre Variablen lebten dort dauerhaft. Ihre Timer tickten zuverlässig. Der Staat war immer warm und bereit.

MV3 ersetzt das durch aServicemitarbeiter. Servicemitarbeiter sind darauf ausgelegt, vergänglich zu sein. Chrome kann sie beenden, wenn der Speicherdruck zunimmt, und sie dann für das nächste Ereignis aktivieren. Es gibt keine Garantie dafür, dass Ihr Worker zwischen zwei Tab-Aktivierungen am Leben ist.

Das ist kein Fehler. Es ist das Design. Chrome ging diesen Kompromiss ein, um die Angriffsfläche für bösartige Erweiterungen zu verringern. Ob Sie mit diesem Kompromiss einverstanden sind, spielt keine Rolle. Ihre Architektur muss dem Rechnung tragen.

Die tiefere Implikation: Alles, was Sie in einer Variablen in Ihrem Hintergrundskript gespeichert haben, ist jetzt tödlich. Sie benötigen eine externe Persistenzschicht.chrome.storagewird zu Ihrer Single Source of Truth und nicht zu einer praktischen API.

Das Speicherproblem ist größer als Sie denken

chrome.storage.local ist standardmäßig auf 10 MB begrenzt. Für einfache Erweiterungen, die Präferenzen speichern, ist das ausreichend. Bei Erweiterungen, die API-Antworten zwischenspeichern, Benutzerverhalten verfolgen oder Dokumentinhalte speichern, verdampfen 10 MB schnell.

Die Lösung, die die meisten Entwickler übersehen, istIndexedDB. Es befindet sich im Browser, verarbeitet Gigabytes an Daten und unterstützt Transaktionen. Der Zugriff erfolgt über Servicemitarbeiter, Popup-Seiten und Inhaltsskripts. Allerdings wies der Service Worker-Zugriff auf IndexedDB in älteren Chrome-Versionen Zuverlässigkeitsfehler auf. Zielen Sie auf Chrome 102 oder höher, wenn Sie diesen Weg gehen.

Hier ist ein minimales IndexedDB-Setup, das in MV3 Service Workers zuverlässig funktioniert:

// storage.js, funktioniert in SW-, Popup- und Inhaltsskripten
const DB_NAME = 'MyExtensionDB';
const DB_VERSION = 1;

Exportfunktion openDatabase() {
  neues Versprechen zurückgeben((auflösen, ablehnen) => {
    const req = indexedDB.open(DB_NAME, DB_VERSION);

    req.onupgradeneeded = (event) => {
      const db = event.target.result;
      if (!db.objectStoreNames.contains('cache')) {
        const store = db.createObjectStore('cache', { keyPath: 'key' });
        store.createIndex('timestamp', 'timestamp', { unique: false });
      }
    };

    req.onsuccess = (event) => discover(event.target.result);
    req.onerror = (event) => Reject(event.target.error);
  });
}

Asynchrone Funktion exportieren saveRecord(key, data) {
  const db = Warten auf openDatabase();
  neues Versprechen zurückgeben((auflösen, ablehnen) => {
    const tx = db.transaction('cache', 'readwrite');
    tx.objectStore('cache').put({ key, data, timestamp: Date.now() });
    tx.oncomplete = auflösen;
    tx.onerror = ablehnen;
  });
}

Mit diesem Muster erhalten Sie eine kostenlose Wiederherstellung nach einem Absturz. Wenn Chrome Ihren Service Worker mitten in der Sitzung beendet, bleiben die Daten bestehen. Wenn die SW neu startet, liest sie aus IndexedDB und wird sauber fortgesetzt.

Timer sind nicht mehr das, was sie einmal waren

Solo-Entwickler erstellen häufig Erweiterungen, die nach einem Zeitplan ausgeführt werden müssen. Denken Sie an Kostenverfolgungstools, Erinnerungstools oder Synchronisierungsprogramme. In MV2 hast du einen geworfensetIntervalin Ihrem Hintergrundskript und habe es vergessen.

In MV3 bricht dieser Ansatz. Chrome beendet möglicherweise Ihren Service Worker, bevor das nächste Intervall ausgelöst wird. Es entstehen Lücken. Sie erhalten verpasste Updates. Es kommt zu frustrierten Benutzern, die Fehlerberichte einreichen.

Der Ersatz istchrome.alarms. Alarme bleiben bei Neustarts von Service Worker bestehen. Chrome aktiviert Ihre SW gezielt, um jedes Alarmereignis zu verarbeiten. Die Beschränkung beträgt einen Mindestzeitraum von einer Minute. Sie können nicht alle fünf Sekunden einen Alarm auslösen.

Für Aktualisierungen, die weniger als eine Minute dauern, ist ein Split-Ansatz das richtige Muster. Ihre Popup-Seite läuft eigenständigsetIntervalsolange es geöffnet ist, da Popup-Seiten einen stabilen Lebenszyklus haben, solange sie sichtbar sind. Der Alarm behandelt die Persistenz, wenn das Popup geschlossen wird. Dies deckt sowohl den Fall der Echtzeitanzeige als auch den Fall der Hintergrundpersistenz ohne Hacks ab.

Sicherheitsanforderungen, die Sie überraschen werden

MV3 hat das verschärftInhaltssicherheitsrichtliniedeutlich. Zwei Muster, die in MV2 funktionierten, unterbrechen Ihre Erweiterungsüberprüfung oder verursachen Laufzeitfehler.

Keine Remote-Skriptausführung

Wenn Ihre Erweiterung ein Skript von einem CDN abgerufen und dynamisch ausgeführt hat, ist dies nicht mehr der Fall. Das gesamte JavaScript muss zum Zeitpunkt der Übermittlung mit Ihrer Erweiterung gebündelt sein. Dies betrifft Erweiterungen, die Diagrammbibliotheken, Analyseskripts oder Dienstprogrammcode von externen URLs geladen haben.

Die Lösung ist unkompliziert: Bündeln Sie alles lokal mit einem Build-Tool wieesbuildoder Rollup. Sie erhalten ein kleineres, schnelleres und überprüfbares Paket. Sie verlieren die Möglichkeit, JS-Updates ohne eine neue Store-Übermittlung zu pushen. Planen Sie Ihren Veröffentlichungsrhythmus entsprechend.

innerHTML ist eine Haftung

MV3 verbietet nichtinnerHTMLgeradezu. Wenn es jedoch mit vom Benutzer bereitgestellten oder über die API abgerufenen Inhalten verwendet wird, entsteht ein XSS-Vektor, den Prüfer kennzeichnen. Das strengere CSP macht die Ausnutzung schwieriger, aber der richtige Schritt besteht darin, innerHTML nicht mehr vollständig für dynamische Inhalte zu verwenden.

Wechseln Sie zu DOM-Erstellungsmethoden. Verwendendocument.createElementUndTextinhaltfür alle Daten, die Sie nicht vollständig kontrollieren. Dadurch lässt sich Ihre Erweiterung auch einfacher prüfen, was die Überprüfung im Web Store beschleunigt.

Was MV3 Solo-Entwickler tatsächlich kostet

Seien wir ehrlich, was die Kompromisse angeht. Die MV3-Migration ist nicht kostenlos. Folgendes zahlen Sie:

Mehr asynchroner Code:Jeder gelesene Zustand gelangt in den Speicher. Sie schreiben mehr Warteanrufe. Mehr Fehlerbehandlung. Mehr kognitiver Aufwand.
Längere Überprüfungszyklen:Strengeres CSP bedeutet mehr Kontrolle durch Prüfer. Planen Sie zusätzliche Zeit für Ihre erste MV3-Einreichung ein.
Alarm granularity limits:Ein Minimum von einer Minute macht bestimmte Produktideen völlig zunichte. Hintergrund-Preisprüfer, Echtzeit-Tracker und Heartbeat-Funktionen müssen alle neu gestaltet werden.
Bündeldisziplin:Keine Remote-Skripte bedeuten, dass Ihre Build-Pipeline wichtig ist. Sie benötigen einen geeigneten Bundler, falls Sie dies noch nicht getan haben.
IndexedDB-Komplexität:Die Promise-basierte API ist ausführlich. Wickeln Sie es frühzeitig ein oder verwenden Sie eine dünne Bibliothek wie zeine gut dokumentierte Speicherabstraktionfür Referenzmuster.

Darüber hinaus ändert der erzwungene Async-Everywhere-Ansatz die Art und Weise, wie Sie testen. Unit-Tests, die auf synchronen Statuslesevorgängen beruhten, müssen neu geschrieben werden. Berücksichtigen Sie dies bei Ihrer Migrationsschätzung.

Was MV3 Ihnen im Gegenzug gibt

Die Einschränkungen haben echte Vorteile. Das Async-First-Modell bedeutet, dass Ihre Erweiterung Browser-Neustarts und -Abstürze standardmäßig ordnungsgemäß verarbeitet. Benutzer verlieren ihren Status nicht, wenn Chrome aktualisiert wird. Ihre Erweiterung verhält sich sitzungsübergreifend vorhersehbar.

Die Sicherheitsverschärfung trägt auch zum Vertrauen bei. Nach Jahren voller Malware-Geschichten sind Benutzer zunehmend misstrauisch gegenüber Erweiterungen. Eine auf MV3 basierende Erweiterung mit einem sauberen, überprüfbaren Bundle ist skeptischen Benutzern einfacher zu erklären. Wenn Sie Ihre Erweiterung öffentlich bewerben, ist dieses Vertrauenssignal wichtig. Akostenloses Social-Media-Audit-Toolkann Ihnen bei der Beurteilung helfen, ob das Marketing Ihrer Erweiterung auf allen Plattformen die richtigen Glaubwürdigkeitssignale setzt.

Darüber hinaus führt die erzwungene Bündelungsdisziplin oft zu kleineren, schnelleren Erweiterungen. Lazy Loading wird durch bewusstes Code-Splitting ersetzt. Als Nebeneffekt der Einschränkungen verbessert sich die Leistung.

Praktische Schritte für Ihren nächsten Erweiterungsaufbau

Wenn Sie heute mit einer neuen Erweiterung beginnen oder eine Migration planen, finden Sie hier eine konkrete Checkliste:

Prüfen Sie jeden Zustand, den Ihre Erweiterung benötigt. Entscheiden Sie, was in chrome.storage.local, was in IndexedDB und was bei Bedarf abgeleitet werden kann.
Ersetzen Sie alle setInterval-Hintergrundaufrufe durch chrome.alarms. Entwerfen Sie alle Funktionen neu, die Hintergrundaktualisierungen in weniger als einer Minute erfordern.
Bündeln Sie alle Abhängigkeiten lokal. Richten Sie esbuild oder Rollup ein, bevor Sie Ihre erste Zeile Erweiterungscode schreiben.
Ersetzen Sie die Verwendung von innerHTML durch DOM-Methoden in jeder Datei, die externe Daten verarbeitet.
Schreiben Sie einmal eine openDB-Hilfsfunktion und importieren Sie sie überall. Schreiben Sie das IndexedDB-Setup nicht in jedem Modul neu.
Testen Sie die Beendigung des Service Workers explizit. Verwenden Sie Chrome DevTools, um Ihre SW manuell zu stoppen und zu überprüfen, ob Ihre Erweiterung ordnungsgemäß wiederhergestellt wird.

Derweb.dev-LernressourcenBehandeln Sie den Lebenszyklus von Servicemitarbeitern ausführlich. Wenn Sie diese Dokumentation lesen, bevor Sie Ihre Hintergrundlogik entwerfen, ersparen Sie sich Stunden späteres Debuggen.

Tools, die zu einem MV3-Workflow passen

Solo-Entwickler, die Erweiterungen bauen, tragen oft alle Rollen. Sie schreiben den Code, entwerfen die Benutzeroberfläche und kümmern sich um das Marketing. Es ist wichtig, dass Ihre Toolchain schlank bleibt.

Um Ihre Erweiterung während des Betatests zu teilen, akostenloser QR-Code-Generatorermöglicht Ihnen das Erstellen scanbarer Links für Ihren Chrome Web Store-Eintrag ohne zusätzliche Einrichtung. Nützlich für persönliche Vorführungen oder Konferenzstände.

Wenn Ihre Erweiterung Screenshots aufnimmt oder Bilder verarbeitet, anKI-Hintergrundentfernerhilft Ihnen, schnell saubere Werberessourcen für den Web-Store-Eintrag zu erstellen.

Führen Sie vor dem Start die Zielseite Ihrer Erweiterung über a auskostenloser Website-Graderum SEO- und Leistungsprobleme zu erkennen, die die organische Entdeckung beeinträchtigen könnten.

Wenn Ihre Erweiterung Mediendateien auf irgendeine Weise verarbeitet, ist es wichtig zu verstehen, wie Formate funktionieren. Akostenloser Video-zu-MP3-Konverterist ein guter Bezugspunkt, um darüber nachzudenken, wie sich browserbasierte Dateiverarbeitungspipelines verhalten.

Auch die Zugänglichkeit der Benutzeroberfläche Ihrer Erweiterung ist wichtig. DerA11Y-Projektverfügt über praktische Checklisten, um Popup-Seiten und Inhaltsskripte für jedermann nutzbar zu machen. Dies ist ein Bereich, der von MV3 nicht direkt angesprochen wird, Web Store-Rezensenten stellen jedoch Probleme mit der Barrierefreiheit fest.

Das Fazit für Indie-Erweiterungsentwickler

Manifest V3ist eine schwierigere Plattform als MV2. Die Asynchronisierungsanforderungen, Speicherbeschränkungen und Timerbeschränkungen sorgen für echte Reibung. Die Einschränkungen zwingen Sie jedoch auch zu widerstandsfähigerem und besser überprüfbarem Code.

Die Entwickler, die am meisten Schwierigkeiten haben werden, sind diejenigen, die versuchen, MV2-Muster direkt zu portieren. Die Entwickler, die erfolgreich sein werden, sind diejenigen, die die neuen Einschränkungen als Design-Inputs akzeptieren und ihre Architektur von Anfang an überdenken.

Lohnt sich der Kompromiss? Für die meisten Indie-Erweiterungsprojekte ja. Der Webshop ist immer noch ein praktikabler Vertriebskanal. Die Nutzerbasis ist enorm. Die Monetarisierungsmöglichkeiten sind real. Sie müssen jetzt einfach anders bauen.

Beginnen Sie mit Ihrem Staatsmodell. Wenn Sie das richtig machen, passt der Rest Ihrer MV3-Erweiterung zusammen. Wenn Sie etwas falsch machen, werden Sie wochenlang damit verbringen, Randfälle bei der Beendigung von Service Workern zu debuggen, die sich wie zufällige Fehler anfühlen.

Dieser Beitrag enthält Affiliate-Links. Wenn Sie über diese Links einen Kauf tätigen, erhalten wir möglicherweise eine Provision, ohne dass Ihnen zusätzliche Kosten entstehen.