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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
contentScripts
RegisteredContentScript
RegisteredContentScript.unregister
register
register.cookieStoreId
register.matchOriginAsFallback
register.world

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Beispielerweiterungen