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.