webextensions examples

Webextensions-Aussagen

https://github.com/mdn/webextensions-examples

Gepflegt von Mozillas Add-Ons-Team.

Webextensionen sind eine Möglichkeit, Browser -Erweiterungen zu schreiben: Das heißt, in einem Webbrowser installierten Programme, die das Verhalten des Browser- oder Webseiten ändern, die vom Browser geladen werden. Webextensionen basieren auf einer Reihe von Cross-Browser-APIs, sodass Webextensionen für Google Chrome, Opera oder Edge in den meisten Fällen auch in Firefox ausgeführt werden.

Das Repository "Webextensions-Beispiele" ist eine Sammlung einfacher, vollständiger und installierbarer Webextensionen. Die Beispiele zeigen, wie die Webextensions -APIs verwendet werden, und Sie können sie als Ausgangspunkt für Ihre Webextensionen verwenden.

Einen Index aller Beispiele finden Sie auf der Seite "Beispielerweiterungen" auf MDN.

Die Beispiele werden im Rahmen der Mozilla Public Lizenz 2.0 zur Verfügung gestellt.

So verwenden Sie "Webextensions-Beispiele"

Um das Repository zu verwenden, klonen Sie es zuerst.

Jedes Beispiel befindet sich in einem Ordner oberster Ebene und enthält eine kurze Readme, in der erklärt wird, was es tut. Um zu sehen, wie ein Beispiel funktioniert, installieren Sie es in Firefox, indem Sie den Installationsanweisungen folgen.

Um sich in der internen Struktur einer Webextension zu befinden, schauen Sie sich die Anatomie einer WebExtension -Seite auf MDN an.

Um diese Beispiele in Firefox zu verwenden, verwenden Sie die jüngste Freisetzung von Firefox. Die meisten Beispiele arbeiten jedoch mit früheren Veröffentlichungen.

Einige Beispiele basieren auf APIs, die nur in Vorabversionversionen von Firefox verfügbar sind. Wenn dies der Fall ist, deklariert das Beispiel die minimale Version, die es im Attribut strict_min_version der browser_specific_settings key in der Manifest.json -Datei der Erweiterung benötigt.

Installieren eines Beispiels

Einige Beispiele funktionieren nur auf bestimmten Domänen oder Seiten. Einzelheiten zu Beschränkungen finden Sie in der Readme -Datei jedes Beispiels. Keines der Beispiele funktioniert standardmäßig in privaten Browser -Fenstern. Weitere Informationen finden Sie in Erweiterungen im privaten Browsen.

So führen Sie eine Beispielerweiterung aus:

1. Öffnen Sie Firefox und laden Sie die about:debugging -Seite. Klicken Sie auf Temporäres Add-On und wählen Sie die Datei manifest.json im Ordner einer Beispielerweiterung aus. Hier ist ein Video, das zeigt, wie das geht.
2. Installieren Sie das Web-EXT-Tool. Öffnen Sie in der Befehlszeile den Ordner der Beispielerweiterung und geben Sie web-ext run ein. Dadurch wird Firefox gestartet und die Erweiterung automatisch installiert. Dieses Tool bietet einige zusätzliche Entwicklungsfunktionen wie automatisches Nachladen.

Unterstützung für andere Browser

Diese Beispiele werden in Firefox getestet. Sie können in anderen Browsern arbeiten, wenn der Browser die verwendeten APIs unterstützt. Beachten Sie, dass diese Beispiele alle den browser -Namespace verwenden und verspricht, mit asynchronen Funktionen zu arbeiten. Dies bedeutet, dass die Beispiele in Chrom nicht funktionieren, wenn Sie die von Mozilla bereitgestellte Polyfill verwenden. Weitere Informationen finden Sie im Überblick über WebTextension -APIs.

Erfahren Sie mehr

Weitere Informationen zum Entwickeln von Webextensionen finden Sie in der Dokumentation von Webextensions zu MDN, um sich zu erstellen.

Probleme?

Wenn Sie auf ein Problem stoßen:

• Stellen Sie eine Abfrage im Add-Ons-Diskursforum ab
• E-Mail an die Mailingliste von Dev-Addons
• Wenden Sie sich an das Add-On-Team im Add-Ono-Raum auf Matrix

Wenn Sie das Problem nicht beheben können, stellen Sie einen Fehler ein.

Beitragen

Wir begrüßen Beiträge, unabhängig davon, ob es sich um neue Beispiele, neue Funktionen, Fehlerbehebungen oder Übersetzungen von lokalisierbaren Zeichenfolgen handelt. Weitere Einzelheiten finden Sie in der Datei mit der bosting.md -Datei.