# is-valid-domain-extension

<p align="center">🍩</p>

<p align="center"><a href="https://nodei.co/npm/is-valid-domain-extension/"><img src="https://nodei.co/npm/is-valid-domain-extension.png"></a></p>
<p align="center">
  <img src="https://img.shields.io/badge/License-MIT-yellow.svg">
</p>

 * 🌐 NPM package that allows you to check if the URL has a legit and a valid domain extension!
 * Supports all of the domain extensions available over the world!
 * Supports all domain extensions even with punny codes such as: `.சிங்கப்பூர்`, `.онлайн`, `.كاثوليك`, `.新加坡`, `.ভারত`, `.భారత్` and so on (yes, they are legit domain extensions)
 * Package automatically checks for the latest list of domain extensions from [Internet Assigned Numbers Authority](https://www.iana.org/)
 * See examples below

# Install [NPM](https://www.npmjs.com/package/is-valid-domain-extension)

 `$ npm i is-valid-domain-extension`

# Usage

- Returns a Boolean indicating whether `string` is a legit and a valid domain extension
- It will return `false` if the `string` is empty or if it desn't start with `http://`, `https://` or `www.`

# Examples

## CommonJS
``` javascript
const isValidDomainExtension = require('is-valid-domain-extension');

(async () => {
    // --| Returns: true
    // --| Returns true as valid and legit the following examples
    if (await isValidDomainExtension('www.exampleurl.香港')) {
        console.log('This a legit and a valid domain extension! 🍩');
    }

    if (await isValidDomainExtension('http://exampleurl.みんな')); {
        console.log('This a legit and a valid domain extension! 🍩');
    }

    // --| Returns: false
    // --| The following examples return false as not they are not valid url's or domain extensions
    if (!await isValidDomainExtension('https://exampleurl.comdasdsadasdsadasdsa')) {
        console.log('This is not a valid domain extension! 😔');
    }

    if (!await isValidDomainExtension('http://exampleurl.comxxxxxx')) {
        console.log('This is not a valid domain extension! 😔');
    }
})();
```

## ESM
```javascript
import isValidDomainExtension from 'is-valid-domain-extension';

(async () => {
    // --| Returns: true
    // --| Returns true as valid and legit the following examples
    if (await isValidDomainExtension('www.exampleurl.香港')) {
        console.log('This is a legit and valid domain extension! 🍩');
    }

    if (await isValidDomainExtension('http://exampleurl.みんな')); {
        console.log('This is a legit and a valid domain extension! 🍩');
    }

    // --| Returns: false
    // --| The following examples return false as not they are not valid url's or domain extensions
    if (!await isValidDomainExtension('http://exampleurl.comxxxxxx')) {
        console.log('This is not a valid domain extension! 😔');
    }

    if (!await isValidDomainExtension('http://exampleurl.comxxxxxx')) {
        console.log('This is not a valid domain extension! 😔');
    }
})();
```
## TypeScript

```javascript
import isValidDomainExtension = require('is-valid-domain-extension');

(async () => {
    // --| Valid domain examples
    const validDomains: string[] = [
        'www.exampleurl.香港',
        'http://exampleurl.みんな',
        'http://exampleurl.العليان',
        'www.exampleurl.wolterskluwer'
    ];

    for (const url of validDomains) {
        const isValid: boolean = await isValidDomainExtension(url);

        if (isValid) {
            console.log(`✅ ${url} is a legit and valid domain extension! 🍩`);
        }
    }

    // --| Invalid domain examples
    const invalidDomains: string[] = [
        'https://exampleurl.comdasdsadasdsadasdsa',
        'http://exampleurl.comxxxxxx',
        'http://exampleurl'
    ];

    for (const url of invalidDomains) {
        const isValid: boolean = await isValidDomainExtension(url);

        if (!isValid) {
            console.log(`❌ ${url} is NOT a valid domain extension! 😔`);
        }
    }
})();
```
<p align="center">🍩</p>