scripting
Inserts JavaScript and CSS into websites. This API offers two approaches to inserting content:
scripting.executeScript(),scripting.insertCSS(), andscripting.removeCSS()that provide for one-off injections.scripting.registerContentScripts()that registers content scripts dynamically, which can then be retrieved withscripting.getRegisteredContentScripts()and unregistered withscripting.unregisterContentScripts()).
Note:Chrome restricts this API to Manifest V3. Firefox and Safari support this API in Manifest V2 and V3.
This API requires the"scripting"permission andhost permission for the target in the tab into which JavaScript or CSS is injected.
Alternatively, you can get permission temporarily in the active tab and only in response to an explicit user action, by asking for the"activeTab" permission. However, the"scripting" permission is still required.
Types
scripting.ContentScriptFilterSpecifies the IDs of scripts to retrieve with
scripting.getRegisteredContentScripts()or to unregister withscripting.unregisterContentScripts().scripting.ExecutionWorldSpecifies the execution environment of a script injected with
scripting.executeScript()or registered withscripting.registerContentScripts().scripting.InjectionTargetDetails of an injection target.
scripting.RegisteredContentScriptDetails of a content script to be registered or that is registered.
Functions
scripting.executeScript()Injects JavaScript code into a page.
scripting.getRegisteredContentScripts()Gets a list of registered content scripts.
scripting.insertCSS()Injects CSS into a page.
scripting.registerContentScripts()Registers a content script for future page loads.
scripting.removeCSS()Removes CSS which was previously injected into a page by a
scripting.insertCSS()call.scripting.updateContentScripts()Updates one or more content scripts already registered.
scripting.unregisterContentScripts()Unregisters one or more content scripts.
Browser compatibility
Note:This API is based on Chromium'schrome.scripting API.