A fork of harryf's [node-soupselect] (http://github.com/harryf/node-soupselect), which is originally a port of Simon Willison's soupselect for use with node.js and node-htmlparser.
$ npm install cheerio-soupselect
From the root folder:
$ make test
cheerio-soupselect supports all of the most common jQuery selectors, including multiple attribute selectors and multiple selectors.
soupselect also supports a bunch of basic filters, listed below. Each filter is implement according to the jQuery specification.
- contains
- empty
- parent
- has
- header
- not
- eq
- gt
- lt
- even
- odd
- first
- last
cheerio-soupselect supports custom filters through the
exported filters
object. It's simple:
var soupselect = require("cheerio-soupselect"),
filters = soupselect.filters;
...
filters["custom-filter"] = function(ctx, val){
console.log("Hello filters!");
return [];
};
...
var ret = soupselect.select(dom, ":custom-filter('awesome arg')");
The ctx
parameter provides an array of htmlparser2
DOMs, which are themselves arrays. These element are
grouped by parent.
The val
parameter provides access to everything inside
the brackets of the filter, if anything.
A few notes about custom selectors:
-
Your custom function must return an array.
-
For the most part, you will not need to handle nesting filters/selectors. However, if you wish to modify the nested selector then, you may do so by modifiying
val
.