@dahoom/disposable-email
Version:
a lightweight, no dependencies, regularly updated disposable email npm package with types forked from https://github.com/disposable/disposable
70 lines (50 loc) • 2.92 kB
Markdown
# Disposable email domains
> a simple, no dependencies, regularly updated disposable email npm package with types forked from https://github.com/disposable/disposable
[](https://github.com/Dahoom152/disposable-email/actions/workflows/node.js.yml)
[](https://img.shields.io/npm/v/@dahoom/disposable-email)
[](https://npmtrends.com/@dahoom152/disposable-email)
[](https://packagephobia.com/result?p=@dahoom/disposable-email)
[](https://img.shields.io/bundlephobia/minzip/%40dahoom%2Fdisposable-email)
```
npm i @dahoom/disposable-email
```
I recommend using this serverside to avoid malicious workarounds
## Examples
regular usage:
```
import disposable from "@dahoom/disposable-email";
const email = 'me@example.com';
//returns true if the email is disposable, false if not
const temp = disposable.validate(email);
if(!temp){
return 'disposable emails are not allowed';
}
```
if you just want to import the function itself:
```
import { validate } from "@dahoom/disposable-email";
const email = 'me@example.com';
//returns true if the email is disposable, false if not
const temp = validate(email);
if(!temp){
return 'disposable emails are not allowed';
}
```
## Description
| Function | Description |
| -------------------------------------------- | --------------------------------------------------------------------- |
| `validate(domainOrEmail, callback)` | Validates if a domain or email is disposable. |
| Parameter | Description |
| ------------- | ----------------------- |
| `domainOrEmail`| The domain or email to validate.|
| `callback` | The optional callback function to execute after validation.|
| Returns | Description |
| -------- | -------------------------------------------------------------------- |
| `boolean`| Returns true if the domain or email is not disposable, false otherwise.|
## Credits
Types included from [@types/disposable-email](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/disposable-email/index.d.ts)
Forked from https://github.com/disposable/disposable
A collection of domains for disposable email services like [10MinuteMail](http://10minutemail.com) and [GuerrillaMail](https://www.guerrillamail.com). Also, some 🛠 to make your life easier.
- https://github.com/adamloving
- https://github.com/michenriksen
- https://github.com/ivolo