just-detect-adblock

1.1.0 • Public • Published

just-detect-adblock 🚫🕵

This package was originally inspired copied from BlockAdBlock & FuckAdBlock, then I added features that those don't have. I just didn't like how overly complicated their API was, so I made this, which contains only helper functions that can be called manually. The rest is up to you !

Features

  • can detect browser extensions (like Adblock Plus)
  • can detect Brave browser shields
  • can detect Opera browser adblocker

How to use

npm install just-detect-adblock --save
Methods Return Description
detectAnyAdblocker() Promise(detected=true/false) perform all available checks below until at least one is positive
detectDomAdblocker() Promise(detected=true/false) detect if a browser extension is hiding ads from the DOM
detectBraveShields() Promise(detected=true/false) detect if Brave browser shields seems to be activated
detectOperaAdblocker() Promise(detected=true/false) detect if Opera browser adblocker seems to be activated
DEPRECATED isDetected() true/false if an adblocker is detected (old behavior only, this method does not detect Brave or Opera adblockers, please use detectAnyAdblocker instead)

Exemples

Webpack

import { detectAnyAdblocker } from 'just-detect-adblock'
 
detectAnyAdblocker().then((detected) => {
  if(detected){
    // an adblocker is detected
  }
});

Browser

<script type="text/javascript" src="/dist/bundle.umd.js"></script>
 
<script type="text/javascript">
  justDetectAdblock.detectAnyAdblocker().then(function(detected) {
    if(detected){
      // an adblocker is detected
    }
  });
</script> 

Package Sidebar

Install

npm i just-detect-adblock

Weekly Downloads

6,188

Version

1.1.0

License

ISC

Unpacked Size

10.4 kB

Total Files

5

Last publish

Collaborators

  • wmcmurray