NoBlocky
Advanced adblock detection library for modern web applications. Reliable, lightweight, and framework-agnostic with multiple detection methods and enterprise-grade features.
🚀 Quick Start
Installation
npm install noblockyBasic Usage
import { detectAdblock } from 'noblocky';
const result = await detectAdblock();
if (result.isBlocked) {
console.log('Adblock detected!');
console.log('Confidence:', result.confidence);
console.log('Strategy results:', result.strategyResults);
} else {
console.log('No adblock detected');
}✨ Key Features
Enterprise Ready
Production-grade features for serious applications.
- • Multi-strategy detection
- • Confidence scoring
- • Result caching & analytics
- • Robust error handling
- • Debug logging & monitoring
Lightweight & Fast
Minimal bundle size with maximum performance.
- • < 15KB minified
- • Zero dependencies
- • Tree-shakeable
- • Async/await ready
- • Modern ES modules
Browser Compatible
Works across all modern browsers and environments.
- • Chrome, Firefox, Safari
- • Edge & mobile browsers
- • Node.js environments
- • Web Workers support
- • Progressive enhancement
🏗️ Detection Architecture
Strategy-Based Detection System
NoBlocky uses intelligent strategies that combine multiple detection methods for maximum accuracy and performance
🔍 Detection Methods
🎯 Bait Element Detector
Creates decoy ad elements that blockers typically remove
� Fetch Ads Detector
Tests network requests to known ad-serving domains
📜 Script Injection Detector
Dynamically injects and monitors ad-related scripts
⚡ Intelligent Strategies
🍎 Safari Strategy
Optimized for Safari's content blocking extensions
🦁 Firefox/Brave Strategy
Tailored for Firefox and Brave browser blockers
⚙️ Generic Strategy
Comprehensive fallback for all other browsers
💼 Use Cases
Publishers & Media
Understand ad blocking impact, optimize ad placements, and implement alternative monetization strategies.
E-commerce
Detect affiliate link blocking, track marketing campaign effectiveness, and protect revenue streams.
Analytics & Marketing
Measure ad blocker usage, segment users, and adjust marketing strategies based on blocking behavior.
Ready to Get Started?
Explore our comprehensive examples and integrate NoBlocky into your application today.
📊 Why AdBlock Detection Matters
Global adblock usage rate
Desktop users with adblockers
Annual ad revenue lost globally
Mobile adblock adoption
Source: Various industry reports and studies on adblock usage trends