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() zur Registrierung von Skripten.

Diese API ist der "content_scripts" manifest.json Schlüssel sehr ähnlich, außer dass mit "content_scripts" die Menge der Inhaltsskripte und zugehörigen Muster zur Installationszeit festgelegt ist. Mit der contentScripts API kann eine Erweiterung Skripte zur Laufzeit registrieren und abmelden.

Um die API zu verwenden, rufen Sie contentScripts.register() auf und übergeben Sie 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 repräsentiert die Skripte, die im register() Aufruf registriert wurden. Es definiert eine unregister() Methode, die Sie verwenden können, um die Inhaltsskripte abzumelden. Inhaltsskripte werden auch automatisch abgemeldet, wenn die Seite, die sie erstellt hat, zerstört wird. Wenn sie zum Beispiel von der Hintergrundseite registriert wurden, werden sie automatisch abgemeldet, wenn die Hintergrundseite zerstört wird, und wenn sie von einer Seitenleiste oder einem Popup registriert wurden, werden sie automatisch abgemeldet, 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 Funktion contentScripts.register() zurückgegeben. Es repräsentiert die Inhaltsskripte, die durch diesen Aufruf registriert wurden, und kann verwendet werden, um das Inhaltsskript abzumelden.

Funktionen

contentScripts.register()

Registriert die angegebenen Inhaltsskripte.

Browser-Kompatibilität

BCD tables only load in the browser

Beispielerweiterungen