JSPM

just-detect-adblock

1.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 9932
  • Score
    100M100P100Q136770F
  • License ISC

It's FuckAdBlock with a minimalist API.

Package Exports

  • just-detect-adblock

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (just-detect-adblock) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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>