contentScripts

Verwenden Sie diese API, um Inhaltsskripte zu registrieren. Das Registrieren eines Inhaltsskripts weist den Browser an, die angegebenen Inhaltsskripte in Seiten einzufügen, die den angegebenen URL-Mustern entsprechen.

Hinweis: Bei der Verwendung von Manifest V3 oder höher, verwenden Sie scripting.registerContentScripts(), um Skripte zu registrieren.

Diese API ist sehr ähnlich zum "content_scripts" manifest.json Schlüssel, mit dem Unterschied, dass die Menge der Inhaltsskripte und die zugehörigen Muster bei der Installation festgelegt sind. Mit der contentScripts API kann eine Erweiterung Skripte zur Laufzeit registrieren und wieder entfernen.

Um die API zu verwenden, rufen Sie contentScripts.register() auf und übergeben ein Objekt, das die zu registrierenden Skripte, die URL-Muster und andere Optionen definiert. Dies gibt ein Promise zurück, das mit einem contentScripts.RegisteredContentScript Objekt aufgelöst wird.

Das RegisteredContentScript Objekt stellt die Skripte dar, die im register()-Aufruf registriert wurden. Es definiert eine unregister() Methode, die Sie verwenden können, um die Inhaltsskripte zu deregistrieren. Inhaltsskripte werden auch automatisch deregistriert, wenn die Seite, die sie erstellt hat, zerstört wird. Zum Beispiel, wenn sie von der Hintergrundseite registriert wurden, werden sie automatisch deregistriert, wenn die Hintergrundseite zerstört wird, und wenn sie von einer Seitenleiste oder einem Popup registriert wurden, werden sie automatisch deregistriert, wenn die Seitenleiste oder das Popup geschlossen wird.

Es gibt keine contentScripts API-Berechtigung, aber eine Erweiterung muss die entsprechenden Host-Berechtigungen für alle Muster haben, die sie an register() übergibt.

Typen

contentScripts.RegisteredContentScript

Ein Objekt dieses Typs wird von der contentScripts.register() Funktion zurückgegeben. Es repräsentiert die Inhaltsskripte, die durch diesen Aufruf registriert wurden, und kann verwendet werden, um das Inhaltsskript zu deregistrieren.

Funktionen

contentScripts.register()

Registriert die angegebenen Inhaltsskripte.

Beispielerweiterungen

Browser-Kompatibilität