Skip to content

tompec/disposable-email-domains

 
 

Repository files navigation

Disposable Email Domains

A list of disposable email domains like mailinator.com. You can use it to detect or block disposable accounts in your signup process. Exact domain matches are found in index.json and wildcard domains (ex: *.33mail.com) are in wildcard.json.

Examples

Node.JS

var domains = require('disposable-email-domains');
var wildcards = require('disposable-email-domains/wildcard.json');

// ... your code here

Installation

$ npm install disposable-domains

Contributing

  1. Install dependencies:

    npm install
    
  2. Add your disposable domains to contributions/index.txt (one domain per line, without any additional formatting)

  3. Run the domain manager script:

    npm run process
    

    That script will:

    • Add your domains to index.json
    • Validate domains using the FQDN (Fully Qualified Domain Name) standard
    • Move domains to wildcard.json if they have 2 or more subdomains
    • Sort and deduplicate all entries
    • Run the tests to ensure everything is working correctly

License

WWWWWW||WWWWWW
 W W W||W W W
      ||
    ( OO )__________
     /  |           \
    /o o|    MIT     \
    \___/||_||__||_|| *
         || ||  || ||
        _||_|| _||_||
       (__|__|(__|__|

THE SOFTWARE IS PROVIDED "AS IS" AND "AS AND WHEN AVAILABLE", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Packages

No packages published

Languages

  • JavaScript 100.0%