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.

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 dercontentScripts API kann eine Erweiterung Skripte zur Laufzeit registrieren und wieder entfernen.

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

DasRegisteredContentScript Objekt stellt die Skripte dar, die imregister()-Aufruf registriert wurden. Es definiert eineunregister() 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 keinecontentScripts API-Berechtigung, aber eine Erweiterung muss die entsprechendenHost-Berechtigungen für alle Muster haben, die sie anregister() übergibt.

Typen

contentScripts.RegisteredContentScript

Ein Objekt dieses Typs wird von dercontentScripts.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

• content-script-register

Browser-Kompatibilität