facebook_adblock

An open-source Ad Blocker for Facebook™

• Support the FB5 layout (Thanks to Christos Botsikas)
• Blocks both suggested posts and sidebar ads
• Does not slow down your computer
• Does not track/read your Facebook activity, or other websites
• You can inspect everything about this extension here, https://github.com/facebook-adblock/facebook_adblock/blob/mainline/src/main.js

This extension is 100% free and open source.

Installation

Chrome

https://chrome.google.com/webstore/detail/ad-blocker-for-facebook/kinpgphmiekapnpbmobneleaiemkefag

Firefox

https://addons.mozilla.org/en-US/firefox/addon/fb_ad_block/ (Thanks to Chih-Hsuan Yen)

Enjoy!

We are not affiliated, associated, authorized, endorsed by, or in any way officially connected with Facebook.

Facebook is a registered trademark of the Facebook, Inc.

Building

1. Run npm run release
2. The compiled extension should be in dist/
3. Load the unsigned extension into your browser

Debugging

All processed DOM elements are flagged with data-blocked attribute. Possible values are:

• allowedList: allowed list
• blockedList: blocked due to blocked list check
• sponsored: blocked due to sponsored label

You can use dev tools console with CSS selectors like *[data-blocked] or *[data-blocked=sponsored].

For example add inline style properties to all existing hidden sponsored posts:

document.querySelectorAll("*[data-blocked=sponsored]").forEach((x) => {
  x.style.display="inherit";
  x.style.border="red 10px solid";
});

You can also inject css which applies to both existing and new processed elements:

document.head.insertAdjacentHTML("beforeend",
`<style>
  *[data-blocked] {
    display:inherit !important;
    border: red 10px solid;
  }
  *[data-blocked=allowedList] {
    border-color: green;
  }
  *[data-adblocked] {
    display:inherit !important;
    border: pink 10px solid;
  }
  *[data-adblock-monitored] {
    border: blue 10px solid;
  }
  *[data-adblock-observed] {
    border: aqua 10px solid;
  }
</style>`);

Publishing

1. Tag a commit with a string with this format v*.*.*
   • git tag -a v2.0.0
2. Push a tag to Github
3. Github action should publish the extension to both Firefox and Chrome
   • Firefox should be released in a couple of minutes
   • Chrome can take as long as a few months if it needs a review