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> 

/just-detect-adblock/

    Package Sidebar

    Install

    npm i just-detect-adblock

    Weekly Downloads

    4,985

    Version

    1.1.0

    License

    ISC

    Unpacked Size

    10.4 kB

    Total Files

    5

    Last publish

    Collaborators

    • wmcmurray