abp-filter-parser

For a faster more precise version of this library, see its C++ gyp rewrite.

JavaScript Adblock Plus filter parser for lists like EasyList

Parses filter rules as per:

• https://adblockplus.org/en/filters
• https://adblockplus.org/en/filter-cheatsheet

Usage

Babel / ES6:

import * as ABPFilterParser from 'abp-filter-parser.js';

Node:

let ABPFilterParser = require('abp-filter-parser');

Primary API:

let ABPFilterParser = require('abp-filter-parser');
var fs = require('fs');

let easyListTxt = fs.readFileSync('./test/data/easylist.txt', 'utf-8');
let parsedFilterData = {};
let urlToCheck = 'http://static.tumblr.com/dhqhfum/WgAn39721/cfh_header_banner_v2.jpg';

// This is the site who's URLs are being checked, not the domain of the URL being checked.
let currentPageDomain = 'slashdot.org';

ABPFilterParser.parse(easyListTxt, parsedFilterData);
// ABPFilterParser.parse(someOtherListOfFilters, parsedFilterData);

if (ABPFilterParser.matches(parsedFilterData, urlToCheck, {
      domain: currentPageDomain,
      elementTypeMaskMap: ABPFilterParser.elementTypes.SCRIPT,
    })) {
  console.log('You should block this URL!');
} else {
  console.log('You should NOT block this URL!');
}

Secondary APIs

You probably won't need these directly, they are used by the primary API above.

• parseDomains
• parseOptions
• parseHTMLFilter
• parseFilter
• matchesFilter