{"id":32474752,"url":"https://github.com/wmcmurray/just-detect-adblock","last_synced_at":"2026-01-18T09:37:21.000Z","repository":{"id":40414617,"uuid":"86164871","full_name":"wmcmurray/just-detect-adblock","owner":"wmcmurray","description":"It's FuckAdBlock with a minimalist API.","archived":false,"fork":false,"pushed_at":"2020-10-29T05:00:24.000Z","size":33,"stargazers_count":85,"open_issues_count":11,"forks_count":14,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-08-20T14:15:31.237Z","etag":null,"topics":["adblock","adblocker","adblocking","braveshields","fuckadblock"],"latest_commit_sha":null,"homepage":"https://wmcmurray.github.io/just-detect-adblock/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wmcmurray.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-25T14:53:05.000Z","updated_at":"2024-12-21T09:56:56.000Z","dependencies_parsed_at":"2022-08-09T19:40:57.200Z","dependency_job_id":null,"html_url":"https://github.com/wmcmurray/just-detect-adblock","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/wmcmurray/just-detect-adblock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wmcmurray%2Fjust-detect-adblock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wmcmurray%2Fjust-detect-adblock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wmcmurray%2Fjust-detect-adblock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wmcmurray%2Fjust-detect-adblock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wmcmurray","download_url":"https://codeload.github.com/wmcmurray/just-detect-adblock/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wmcmurray%2Fjust-detect-adblock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28534172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adblock","adblocker","adblocking","braveshields","fuckadblock"],"created_at":"2025-10-26T20:01:31.744Z","updated_at":"2026-01-18T09:37:20.988Z","avatar_url":"https://github.com/wmcmurray.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# just-detect-adblock :no_entry_sign: :detective:\n\n[![npm](https://img.shields.io/npm/v/just-detect-adblock)](https://www.npmjs.com/package/just-detect-adblock)\n[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/wmcmurray/just-detect-adblock.svg?logo=lgtm\u0026logoWidth=18\u0026label=JS%20code%20quality)](https://lgtm.com/projects/g/wmcmurray/just-detect-adblock/context:javascript)\n\n[![live demo](https://img.shields.io/badge/-live%20demo%20!-springgreen?style=for-the-badge)](https://wmcmurray.github.io/just-detect-adblock/)\n\nThis package was originally ~~inspired~~ copied from [BlockAdBlock](https://github.com/sitexw/BlockAdBlock) \u0026 [FuckAdBlock](https://github.com/sitexw/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 !\n\n\n## Features\n\n- **Browser extensions** detection (like **AdBlock, Adblock Plus, uBlock, etc.**)\n- **Brave browser** shields detection\n- **Opera browser** adblocker detection\n\n\u003cbr\u003e\n\n\n## How to use\n\n```\nnpm install just-detect-adblock --save\n```\n\n| Methods                       | Return                          | Description                                                        |\n| :---------------------------- | :------------------------------ | :------------------------------------------------------------------|\n| `detectAnyAdblocker()`        | *Promise(detected=true/false)*  | perform all available checks below until at least one is positive  |\n| `detectDomAdblocker()`        | *Promise(detected=true/false)*  | detect if a browser extension is hiding ads from the DOM           |\n| `detectBraveShields()`        | *Promise(detected=true/false)*  | detect if Brave browser shields seems to be activated              |\n| `detectOperaAdblocker()`      | *Promise(detected=true/false)*  | detect if Opera browser adblocker seems to be activated            |\n| **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)** |\n\n\u003cbr\u003e\n\n## Exemples\n\n### Webpack\n```javascript\nimport { detectAnyAdblocker } from 'just-detect-adblock'\n\ndetectAnyAdblocker().then((detected) =\u003e {\n  if(detected){\n    // an adblocker is detected\n  }\n});\n```\n\n### Browser\n```html\n\u003cscript type=\"text/javascript\" src=\"/dist/bundle.umd.js\"\u003e\u003c/script\u003e\n\n\u003cscript type=\"text/javascript\"\u003e\n  justDetectAdblock.detectAnyAdblocker().then(function(detected) {\n    if(detected){\n      // an adblocker is detected\n    }\n  });\n\u003c/script\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwmcmurray%2Fjust-detect-adblock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwmcmurray%2Fjust-detect-adblock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwmcmurray%2Fjust-detect-adblock/lists"}