chrome-extension-execute-on-website v1.0.3

chrome-extension-execute-on-website

Long name, I know, but it is self-explaining.

Or is it?..

What is it?

Well, it turns out that Chrome extensions does not have access to the JavaScript on the a webpage, even if the extension is a content script, meaning that you can't access variables and stuff on the page itself.

I know, it's disapointing. Anyway, there is a solution, and it's basically to inject a script tag to the page and do whatever you want in this script. What's the problem you ask? it's ugly as f, that's the problem.

Well, luckily, I've got the solution!

This tiny library allows you to easily execute JavaScript code from your Chrome extension in a webpage.

Usage

How does it work, you ask? as simple as that:

exec(() => {
    console.log('This is the window of the current webpage:', window);
});

Nice, huh? I know!

Anyway, so that's more or less it. Best 500 bytes (unminified) your Chrome extension is getting.

Installation

jsdelivr (Recommended)

I just love jsdelivr.

1. Download the script from the following URL, and put it somewhere in your extension's folder:

https://cdn.jsdelivr.net/npm/chrome-extension-execute-on-website/execute-on-website.min.js

2. Go to your manifest file, make sure you have contentSettings permission, like that:

  "permissions": [
    "contentSettings"
  ]

Under content_scripts add js array and insert the path to the library file as an item.

No worries, here's an example:

Assuming your script is in a folder called js:

"content_scripts": [
    {
      "js": [
        "js/execute-on-website.min.js",
        "./inject.js"
      ]
    }
  ]

As simple as that.

npm

Navigate to your extension's folder, and run the following command: (After making sure you have Node installed)

npm i chrome-extension-execute-on-website

Good, now go to your manifest.json, make sure you have contentSettings permission, like that:

  "permissions": [
    "contentSettings"
  ]

Under content_scripts add js array and put the following path as an item:

node_modules/chrome-extension-execute-on-website/execute-on-website.js

Should do the job. An example for the confused ones:

"content_scripts": [
    {
      "js": [
        "node_modules/chrome-extension-execute-on-website/execute-on-website.js",
        "./inject.js"
      ]
    }
  ]

Sample Manifest

Just to make sure you understand, here's an example of a full manifest with the library included:

{
  "name": "My Extension",
  "version": "0.0.4",
  "manifest_version": 2,
  "description": "",
  "homepage_url": "http://eliran.net",
  "icons": {
    "16": "icons/Lightning16.png",
    "19": "icons/Lightning19.png",
    "48": "icons/Lightning48.png",
    "128": "icons/Lightning128.png"
  },
  "permissions": [
    "contentSettings"
  ],
  "content_scripts": [
    {
      "matches": [
        "*://*/*"
      ],
      "js": [
        "js/execute-on-website.min.js",
        "./inject.js"
      ]
    }
  ]
}