A fully-typed class for filtering a list of domain names in various ways
npm i domainfilter
or
yarn add domainfilter
I've automatically generated basic documentation using TypeDoc. Some basic usage examples are below.
https://crock.github.io/DomainFilter/
I have included a Node script in the bundle that will download a JSON list of adult terms for the IFilterConfig.adult option or you can pass in your own list of terms like so...
const df = new DomainFilter({ adult: false }, {
adultTerms: ["badword", "anotherbadword"]
})To run the Node script, you can do the following in your project directory...
node node_modules/domainfilter/scripts/downloadAdultTerms.jsimport DomainFilter, { KeywordPosition } from 'domainfilter';
const df = new DomainFilter({
keywords: [
{ value: "example", selected: true, position: KeywordPosition.anywhere },
{ value: "admin", selected: true, position: KeywordPosition.end },
{ value: "foobar", selected: false, position: KeywordPosition.anywhere },
]
});
const results = df.filter([
"admintuts.com",
"example.com",
"sysadmin.com",
"foobar.org"
]);
print(results); // Logs ["sysadmin.com", "example.com"]<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Dropfilter - Browser Usage Example</title>
</head>
<body>
<div id="results"></div>
<script src="/dist/DomainFilter.umd.js"></script>
<script>
const DomainFilter = window["DomainFilter"].default
const resultsEl = document.getElementById("results");
document.addEventListener("DOMContentLoaded", function() {
const df = new DomainFilter({
keywords: [
{
value: 'admin',
selected: true,
position: "start"
}
]
});
const results = df.filter([
'admintuts.com',
'google.com',
'sysadmin.com'
])
resultsEl.innerText = results.join("\n");
})
</script>
</body>
</html>A complete set of unit tests are implemented using Jest.
To run the tests, simply run npm run test in the root directory.
Let me know of any issues or feature requests by opening an issue on GitHub.
| Completed | Feature |
|---|---|
| ✅ | IFilterConfig.domainLength |
| ✅ | IFilterConfig.domainHacks |
| ✅ | IFilterConfig.hyphens |
| ✅ | IFilterConfig.numbers |
| ✅ | IFilterConfig.keywords |
| ✅ | IFilterConfig.extensions |
| ✅ | IFilterConfig.adult - Added in 1.0.4 |
| ❌ | IFilterConfig.idn |