Skip to content

Latest commit

 

History

History

browser_extension_with_icon

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
template
true

Extension executing code when its button is clicked

Level :

What does it do ? ✨

This extension will execute some code when you click its icon in the addon/extension bar of your browser.

In this exact case our script will change its icon depending on whether it is considered active or not.

Software dependencies 🌈 📂

You'll need a web browser to load your extension in.

Ideally one of the following : Firefox, Brave, Chrom(e/ium), Edge

How to run ? 🚀

To load an extension in dev mode you'll need to follow steps depending on your browser

Firefox : Paste "about:debugging" in your address bar and hit enter, click "This Firefox" (in newer versions of Firefox), click "Load Temporary Add-on", then select any file in your extension's directory.


Brave : Go to brave://extensions/ and enable Developer mode at the top right.

You will then have the option load unpacked.

Click load unpacked (i.e. "development") and select the extension directory.


Chrom(e/ium) :

  1. Open the Extension Management page by navigating to chrome://extensions.
    • Alternatively, open this page by clicking on the Extensions menu button and selecting Manage Extensions at the bottom of the menu.
    • Alternatively, open this page by clicking on the Chrome menu, hovering over More Tools then selecting Extensions
  2. Enable Developer Mode by clicking the toggle switch next to Developer mode.
  3. Click the Load unpacked button and select the extension directory.

Edge Sideload an extension

How to modify ? 🔩 🔨

The key file is the manifest.json

  • The "background" part list the scrpits to start your extension.
  • The role of the manifest is to describe to the browser what the extension will do, which file are going to be used, in which way, and what are the special permissions required by your extension (like storing data, making requests, looking at the cookies etc ...)

Additional resources 📄 📗

MDN: Your first web extension

MDN: About manifest.json

MDN: How to use an icon in the extension bar

MDN: How to change the icon of your extension through code