Trigger.io

Trigger.io Forge Documentation

Important

This documentation is deprecated, and only kept here to support users of browser extension APIs. If you are using Trigger.io for iOS or Android, see https://trigger.io/docs/.

activations: Inject files into pages

Platforms: Browser

The activations module allows styles and scripts to be injected into webpages with specified URLs.

Config

The activations module must be enabled in config.json as follows:

{
    "modules": {
        "activations": [
            {
                "patterns": ["http://mail.google.com"],
                "scripts": ["gmail.js"],
                "styles": ["gmail.css"],
                "run_at": "start",
                "all_frames": false
            }
        ]
    }
}

This field specifies when and how your foreground files will be embedded into pages. It is an array of objects with three required keys:

  • patterns is an array of Match Patterns which control on which URLs your app will activate
  • scripts is an array of Javascript files which will be embedded
  • styles is an array of CSS files which will be embedded

As well as an optional keys:

  • run_at optionally defines when your included scripts will be added to the page, must be one of the following:
  • "start" scripts will be run immediately, potentially before the DOM is ready
  • "ready" scripts will run as soon as the DOM is ready
  • "end" (default) scripts will run at some point after the DOM is ready, with no guarantees as to whether or not window.onload will have fired yet or not.
  • all_frames optionally defines whether activations will be run in all frames or just the top level document, by default it is false.

Important

Safari only supports a single object in the activations array.