⚙️

Advanced NoBlocky Configuration

Explore advanced configuration options, test individual detection methods, and benchmark performance across different strategies.

🔧 Custom Configuration

Global Options

Timeout (ms): 5000

1s 15s

Maximum time to wait for all detection methods to complete.

Enable debug mode

Enables detailed console logging of detection process.

Enable consent-aware detection

Enables GDPR consent checking. External ad requests are skipped if user hasn't given advertising consent. Defaults to checking OneTrust C0004 category.

Use custom consent check

Provide a custom function to check consent status instead of the default OneTrust check. Only used when consent-aware is enabled.

Use redirect on detection

Automatically redirects the user to a specified URL when an ad blocker is detected.

Use onDetect callback

Triggers a custom function when an ad blocker is detected.

Use onNotDetect callback

Triggers a custom function when NO ad blocker is detected.

Detection Methods

Blocked Element Detector

Checks if existing DOM elements with ad-like selectors are hidden or have zero dimensions.

Ad Selectors (comma-separated)

Important: the ad selectors that should exist in your page.

Check parent elements (Safari optimization)

Safari's content blockers sometimes hide parent elements instead of the ad itself.

Fetch Ads Detector

Attempts to fetch real ad scripts from ad networks. If requests fail or are blocked, an ad blocker is intercepting network traffic.

Fetch URLs (comma-separated)

Known ad network URLs to test. These should be real ad scripts that blockers typically intercept.

Fail Ratio: 0.7

0.1 (10%) 1.0 (100%)

Percentage of URLs that must fail to confirm blocking.

Fetch Timeout (ms): 4000

1s 10s

How long to wait for each URL before considering it failed.

📝 Configuration Examples

Your Current Configuration

const result = await detectAdblock({
  timeout: 5000,
  debug: false,
  blockedElement: {
    adSelectors: ['.ad-container', '#sidebar-ad'],
    checkParent: true
  },
  fetchAds: {
    fetchUrls: [
      'https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js',
      'https://doubleclick.net/ads.js'
    ],
    failRatio: 0.7,
    timeout: 4000
  },
});

With Callbacks & Strategy Analysis

const result = await detectAdblock({
  timeout: 5000,
  debug: true,
  onDetect: (result) => {
    console.log('Adblock detected!', {
      confidence: result.confidence,
      strategies: result.strategyResults.map(s => s.strategy),
      detectorCount: result.strategyResults.reduce(
        (acc, s) => acc + s.detectorResults.length, 0
      )
    });
  },
  onNotDetect: (result) => {
    console.log('No adblock detected', result.strategyResults);
  }
});