Swift: Safari Web Extensions From 0 to 0.01
Zusammenfassung
Kurz
Der vollständige Bericht zeigt an einer iOS-Safari-Erweiterung zur Farbumkehr, wie Popup, Hintergrund- und Content-Skript sowie eine Swift-App über Nachrichten und gemeinsam gespeicherte Einstellungen zusammenarbeiten. Er erklärt zudem Einrichtung und Debugging mit Safari Web Inspector, behandelt aber nur das konkrete Beispiel und berichtet keine umfassende Prüfung weiterer Fälle.
Mittel
Der vollständige Bericht erklärt anhand einer iOS-Safari-Erweiterung zur Umkehrung von Webseitenfarben, wie Popup, Content-Skript, Hintergrundskript und native App Nachrichten austauschen. Er beschreibt die von Xcode angelegten Dateien, das Aktivieren der Erweiterung und das Prüfen von JavaScript mit Safari Web Inspector. Für reale Geräte müsse der Web Inspector eingeschaltet werden; im Simulator sei er laut Beitrag bereits verfügbar. Das Content-Skript werde über die URL-Regeln im Manifest geladen.
Der Aktivierungszustand liegt im Beispiel in gemeinsam genutzten UserDefaults einer App Group. Die App ändert ihn per SwiftUI-Schalter. Da JavaScript die native Nachrichten-API laut Artikel nur aus dem Hintergrundskript aufrufen kann, vermittelt dieses Anfragen des Content-Skripts an die App und gibt Antworten zurück. Der Popup-Schalter veranlasst das Hintergrundskript, sowohl den App-Zustand als auch das Content-Skript des aktiven Tabs zu aktualisieren. Änderungen aus der iOS-App erkennt die Webseite laut Autor beim Wiedererscheinen durch eine erneute Statusabfrage; für macOS nennt er eine separate Nachrichtenmöglichkeit. Der Beitrag enthält Codebeispiele und einen GitHub-Verweis, behandelt aber nur dieses konkrete Beispiel und berichtet keine systematische Prüfung weiterer Anwendungsfälle.
Ausführlich lesen
Der vollständige Bericht ist ein Tutorial von Itsuki zum Aufbau einer Safari-Web-Erweiterung mit einer begleitenden iOS-App. An einem Beispiel zur Umkehrung von Webseitenfarben erklärt der Autor, wie Popup, Content-Skript, Hintergrundskript und App Nachrichten austauschen können. Er betont, dass Safari-Web-Erweiterungen zwar auf den üblichen Webtechniken wie JavaScript, HTML und CSS beruhen, die Verbindung zu einer nativen App aber zusätzliche Kommunikationswege erfordert.
Zu Beginn beschreibt der Beitrag die Dateien, die Xcode beim Hinzufügen eines Safari-Web-Extension-Ziels anlegt: Das Hintergrundskript verarbeitet Ereignisse und vermittelt Nachrichten; das Content-Skript greift auf die Webseite zu; Popup-Dateien bilden die Oberfläche der Erweiterung; und die Manifest-Datei legt unter anderem Skripte, Berechtigungen und Einsatzbereiche fest. Der Autor erläutert außerdem, wie sich die Erweiterung starten und in Safari aktivieren lässt. Für die Fehlersuche empfiehlt er Safari Web Inspector auf einem verbundenen Mac. Auf echten iOS-Geräten müsse dieser in den Safari-Einstellungen eingeschaltet werden; im Simulator sei er laut Beitrag bereits verfügbar. Hintergrund- und Popup-Seiten erscheinen im Inspektor gesondert. Damit das Content-Skript auf einer untersuchten Seite geladen wird, müsse das Manifest die passende URL-Regel enthalten; für den vorgestellten Test wird sie auf alle URLs erweitert und die entsprechende Berechtigung erteilt.
Im Beispiel wird der Aktivierungszustand über eine gemeinsame App-Group-UserDefaults-Ablage zwischen App und Erweiterung gespeichert. Die App kann den Wert über einen SwiftUI-Schalter ändern. JavaScript kann die native App mit `browser.runtime.sendNativeMessage` ansprechen; laut Artikel steht diese API nur dem Hintergrundskript zur Verfügung. Deshalb fragt das Content-Skript den Hintergrund nach dem aktuellen Status, der die Anfrage an die App weiterleitet und deren Antwort zurückgibt. Für die native Nachrichtenfunktion nennt der Beitrag außerdem die Berechtigung `nativeMessaging` im Manifest.
Ein Klick auf den Schalter im Popup wird ebenfalls über das Hintergrundskript vermittelt. Dieses sendet eine Nachricht an die native App, um den gespeicherten Status umzuschalten, und informiert das Content-Skript des aktiven Tabs, damit es den Seitenfilter unmittelbar ändern kann. Wenn der Status in der iOS-App geändert wurde, soll das Content-Skript beim Zurückkehren der Webseite in den Vordergrund den Wert erneut abfragen. Der Autor begründet das damit, dass es für iOS keine entsprechende Swift-Nachrichten-API von der App zur Erweiterung gebe und die App beim Öffnen in den Hintergrund wechsle. Für macOS erwähnt er dagegen eine `SFSafariApplication`-Möglichkeit, die bei mehreren gleichzeitig geöffneten Fenstern relevant sein könne.
Der Bericht führt die wesentlichen Swift- und JavaScript-Beispiele sowie ein Manifest mit Manifest-Version 3 auf und verweist auf den vollständigen Beispielcode auf GitHub. Sein Umfang ist ein konkreter Einführungs- und Kommunikationsleitfaden anhand einer einzelnen iOS-Farbumkehr-Erweiterung. Eine systematische Prüfung anderer Anwendungsfälle oder ein Vergleich verschiedener Browser wird nicht berichtet; auch die Aussagen zu Safari-Verhalten und APIs werden im Text nicht unabhängig belegt.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Luna lieferte zwei Zusammenfassungen (kurz und mittel). Beide geben den Bericht sachlich korrekt wieder und enthalten keine erfundenen Angaben. Die mittlere Fassung ist die ausführlichere und wurde als Hauptfassung bewertet. Für die Einordnung wurden keine Fragen angegeben (weder Sammel- noch Teilfragen), daher ist die Liste leer.
Im Bericht, aber nicht in der Zusammenfassung
- Popup und Content-Skript können nicht direkt miteinander kommunizieren, der Weg führt immer über das Hintergrundskript
- console.log-Ausgaben erscheinen nicht in Xcode, deshalb wird das Debugging über den Safari Web Inspector beschrieben
- Die Anleitung zum Verbinden des Web Inspectors mit dem Mac hat konkrete Schritte, etwa Safari auf dem Mac vollständig beenden und den Simulator vorher starten
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.