This object contains details of a script to be registered or that is registered.

Type

Values of this type are objects. They contain these properties:

• allFrames

  • : boolean. If specified true, the script is inject into all frames, even if the frame is not the top-most frame in the tab. Each frame is checked independently for URL requirements; it does not inject into child frames if the URL requirements are not met. Defaults to false, meaning that only the top frame is matched.

  css

  • : array of string. The list of CSS files to be injected into matching pages. These are injected in the order they appear in this array.

  cssOrigin

  • : string. The style origin for the injection, either "user", to add the CSS as a user stylesheet, or "author", to add it as an author stylesheet. Defaults to "author". This property is case insensitive in Firefox and Safari.

  excludeMatches

  • : array of string. Array of pages that this content script is excluded from but would otherwise be injected into.

  id

  • : string. The ID of the content script, specified in the API call.

  js

  • : array of string. Array of path to JavaScript files in the extension package to inject into matching pages. Scripts are injected in the order they appear in this array.

  matches

  • : array of string. Array of the pages this content script is injected into. Must be specified for .

  matchOriginAsFallback

  • : boolean. Whether code is injected into about:, data:, and blob: pages when their origin matches the pattern in matches, even if the document origin is opaque (due to the use of CSP or iframe sandbox). Match patterns in matches must specify a wildcard path glob. Defaults to false.

  persistAcrossSessions

  • : boolean. Specifies if this content script persists across browser restarts and updates and extension restarts. Defaults to true.When an extension updates, content scripts are cleared. To restore scripts, add code to the extension’s event handler that responds to the "update" reason.

  runAt

  • : . Specifies when JavaScript files are injected into the web page. The default value is document_idle. In Firefox, runAt also affects the point where the CSS is inserted. In Chrome, runAt does not affect the CSS insertion point.

  world

  • : . The execution environment for a script to execute in. The default value is ISOLATED.

Browser compatibility

This API is based on Chromium’s chrome.scripting API.