{"id":13448508,"url":"https://github.com/ghostery/adblocker","last_synced_at":"2026-02-13T15:24:56.564Z","repository":{"id":36963587,"uuid":"114102066","full_name":"ghostery/adblocker","owner":"ghostery","description":"Efficient embeddable adblocker library","archived":false,"fork":false,"pushed_at":"2025-05-12T07:28:17.000Z","size":114171,"stargazers_count":887,"open_issues_count":26,"forks_count":110,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-05-12T07:41:48.876Z","etag":null,"topics":["adblock","adblocker","content-blocking","easylist","javascript","privacy","puppeteer"],"latest_commit_sha":null,"homepage":"https://www.ghostery.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ghostery.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-12-13T09:39:29.000Z","updated_at":"2025-05-12T07:28:20.000Z","dependencies_parsed_at":"2023-10-30T11:43:12.824Z","dependency_job_id":"d2a047ca-ab5c-4da7-a23f-7ee58e406cfe","html_url":"https://github.com/ghostery/adblocker","commit_stats":{"total_commits":3562,"total_committers":41,"mean_commits":86.8780487804878,"dds":0.6858506457046603,"last_synced_commit":"f4758588f7b6cef6e7a691acae55efda65e9dec3"},"previous_names":["cliqz-oss/adblocker"],"tags_count":215,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fadblocker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fadblocker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fadblocker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghostery%2Fadblocker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghostery","download_url":"https://codeload.github.com/ghostery/adblocker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253700350,"owners_count":21949689,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","content-blocking","easylist","javascript","privacy","puppeteer"],"created_at":"2024-07-31T05:01:47.567Z","updated_at":"2026-01-12T09:30:17.704Z","avatar_url":"https://github.com/ghostery.png","language":"TypeScript","readme":"\u003ch1 align=\"center\"\u003eAdblocker\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003e\n    Efficient\n    · Minimal\n    · JavaScript\n    · TypeScript\n    · uBlock Origin- and Easylist-compatible\n  \u003c/em\u003e\n  \u003cbr /\u003e\n  \u003cem\u003e\n    \u003ca href=\"https://github.com/ghostery/adblocker/tree/master/packages/adblocker\"\u003eNode.js\u003c/a\u003e\n    · \u003ca href=\"https://github.com/ghostery/adblocker/tree/master/packages/adblocker-puppeteer\"\u003ePuppeteer\u003c/a\u003e\n    · \u003ca href=\"https://github.com/ghostery/adblocker/tree/master/packages/adblocker-electron\"\u003eElectron\u003c/a\u003e\n    · \u003ca href=\"https://github.com/ghostery/adblocker/tree/master/packages/adblocker-webextension\"\u003eWebExtension\u003c/a\u003e\n  \u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ghostery/adblocker/actions?query=workflow%3ATests\"\u003e\n    \u003cimg alt=\"Github Actions Build Status\" src=\"https://img.shields.io/github/actions/workflow/status/ghostery/adblocker/tests.yml?label=tests\u0026style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/ghostery/adblocker/actions?query=workflow%3Assets\"\u003e\n    \u003cimg alt=\"Github Actions Assets Status\" src=\"https://img.shields.io/github/actions/workflow/status/ghostery/adblocker/assets.yml?label=assets\u0026style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://twitter.com/acdlite/status/974390255393505280\"\u003e\n    \u003cimg alt=\"Blazing Fast\" src=\"https://img.shields.io/badge/speed-blazing%20%F0%9F%94%A5-brightgreen.svg?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@ghostery/adblocker\"\u003e\n    \u003cimg alt=\"npm version\" src=\"https://img.shields.io/npm/v/@ghostery/adblocker.svg?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@ghostery/adblocker\"\u003e\n    \u003cimg alt=\"weekly downloads from npm\" src=\"https://img.shields.io/npm/dw/@ghostery/adblocker.svg?style=flat-square\"\u003e\u003c/a\u003e\n  \u003cbr/\u003e\n  \u003ca href=\"#badge\"\u003e\n    \u003cimg alt=\"code style: prettier\" src=\"https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://twitter.com/ghostery\"\u003e\n    \u003cimg alt=\"Follow Ghostery on Twitter\" src=\"https://img.shields.io/twitter/follow/ghostery.svg?label=follow+ghostery\u0026style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/ghostery/adblocker\"\u003e\n    \u003cimg alt=\"Dependabot\" src=\"https://img.shields.io/badge/dependabot-enabled-brightgreen?logo=dependabot\u0026style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/ghostery/adblocker/blob/master/LICENSE\"\u003e\n    \u003cimg alt=\"License Badge\" src=\"https://img.shields.io/github/license/ghostery/adblocker?style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nThe Ghostery adblocker is a JavaScript library for *blocking ads, trackers, and annoyances* with a strong focus on [efficiency](https://whotracks.me/blog/adblockers_performance_study.html). It was designed with compatibility in mind and integrates seamlessly with the following environments:\n\n* [Block ads in **Puppeteer**](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-puppeteer/README.md),\n* [Block ads in **Electron**](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-electron/README.md),\n* [Block ads in **Chrome** and **Firefox**](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-webextension/README.md),\n* Or as a [standalone JavaScript library](https://github.com/ghostery/adblocker/tree/master/packages/adblocker/README.md).\n\n## Getting Started\n\nThe Ghostery adblocker is the easiest and most efficient way to block ads and trackers in your project. Only a few lines of code are required to integrate smoothly with [Puppeteer](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-puppeteer-example), [Electron](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-electron-example), a  Chrome- and Firefox-compatible [browser extension](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-webextension-example), or any environment supporting [JavaScript](https://github.com/ghostery/adblocker/tree/master/packages/adblocker) (e.g. Node.js or React Native).\n\nHere is how to do it in two steps for a Chrome- and Firefox-compatible WebExtension:\n1. Install: `npm install --save @ghostery/adblocker-webextension`\n2. Add the following in your background script:\n```js\nimport { WebExtensionBlocker } from '@ghostery/adblocker-webextension';\n\nWebExtensionBlocker.fromPrebuiltAdsAndTracking().then((blocker) =\u003e {\n  blocker.enableBlockingInBrowser(browser);\n});\n```\n\nCongratulations, you are now blocking all ads and trackers! :tada:\n\n## Compatibility\n\nThe library supports 99% of all filters from the Easylist and uBlock Origin projects. Check [the compatibility matrix](https://github.com/ghostery/adblocker/wiki/Compatibility-Matrix) on the wiki for more details.\n\n## Contributing\n\nThis project makes use of [lerna](https://github.com/lerna/lerna) and [yarn workspaces](https://yarnpkg.com/lang/en/docs/workspaces/) under the hood. Quickly get started with:\n\n1. Fork and clone the repository,\n2. Enable corepack: `corepack enable`,\n3. Install dependencies: `yarn install --immutable`,\n4. Build: `yarn build`,\n5. Test: `yarn test`,\n\nFor any question, feel free to [open an issue](https://github.com/ghostery/adblocker/issues/new) or a pull request to get some help!\n\n## Who is using it?\n\nThis library is the building block technology used to power the adblockers from [Ghostery](https://www.ghostery.com/) and [Cliqz](https://cliqz.com/) on both *desktop* and *mobile* platforms. It is already running in production for millions of users and has been battle-tested to satisfy the following use-cases:\n\n  * Mobile-friendly adblocker in react-native, WebExtension, or custom JavaScript context: [Ghostery for iOS](https://github.com/ghostery/user-agent-ios).\n  * Ads and trackers blocker in [Electron](https://github.com/wexond/desktop) applications, [Puppeteer](https://github.com/Kikobeats/browserless) headless browsers, Cliqz browser, [ghostery](https://github.com/ghostery/ghostery-extension/) and [standalone](https://github.com/remusao/blockrz)).\n  * Batch requests processing in Node.js, HTML fuzzy keywork matcher, and more.\n\nThe innovative algorithms and architecture designed and implemented in this project have been shown to be among the [most efficient](https://whotracks.me/blog/adblockers_performance_study.html) ways to implement ad-blockers and have been used in other projects to implement highly performant adblockers such as [Brave](https://github.com/brave/adblock-rust).\n\n## Swag\n\nShow the world you're using `ghostery/adblocker` → [![powered by Ghostery](https://img.shields.io/badge/ghostery-powered-blue?logo=ghostery\u0026style=flat-square)](https://github.com/ghostery/adblocker)\n\n```md\n[![powered by Ghostery](https://img.shields.io/badge/ghostery-powered-blue?logo=ghostery)](https://github.com/ghostery/adblocker)\n```\n\nOr HTML:\n```html\n\u003ca href=\"https://github.com/ghostery/adblocker/\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\n    \u003cimg alt=\"powered by Ghostery\" src=\"https://img.shields.io/badge/ghostery-powered-blue?logo=ghostery\"\u003e\n\u003c/a\u003e\n```\n\n## License\n\n[Mozilla Public License 2.0](./LICENSE)\n","funding_links":[],"categories":["TypeScript","privacy"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghostery%2Fadblocker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghostery%2Fadblocker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghostery%2Fadblocker/lists"}