# nodejs-form-validator

> A nodeJS package to validate forms and other user inputs

Latest version **1.1.0** (published 2018-05-02) · ISC license · 0 weekly downloads

## Install

```sh
npm install nodejs-form-validator
pnpm add nodejs-form-validator
yarn add nodejs-form-validator
bun add nodejs-form-validator
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2018-05-02 |
| First published | 2018-04-26 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 6.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Gabriele Venturi |
| Maintainers | wendig0 |
| Keywords | nodejs, validator, form, user, input |

## Links

- npm: https://www.npmjs.com/package/nodejs-form-validator
- Repository: https://github.com/gventuri/nodejs-form-validator
- Homepage: https://github.com/gventuri/nodejs-form-validator#readme
- Issues: https://github.com/gventuri/nodejs-form-validator/issues
- npm.io page: https://npm.io/package/nodejs-form-validator

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.1.0 (latest) — 2018-05-02
- 1.0.6 — 2018-05-02
- 1.0.5 — 2018-04-27
- 1.0.4 — 2018-04-27
- 1.0.3 — 2018-04-27
- 1.0.2 — 2018-04-27
- 1.0.1 — 2018-04-26
- 1.0.0 — 2018-04-26

## README

# NodeJS Form Validator
A form validator build for node js.

With NodeJS Form validator, you can compare your form input or the user input with a schema that you have previously built.

## Installation
In order to install NodeJS Form Validator, you need to run:

```
  npm install nodejs-form-validator
```

Once you have installed, you need to import the package inside your project. You can do it with:

```javascript
  //Using Node.js `require()`
  const Validate = require('nodejs-form-validator');

  //Using ES6 imports
  import Validate from 'nodejs-form-validator';
```

Easy, isn't it?

## Overview
NodeJS Form Validator can be very helpful to help you to validate user input based on your fixed schema. It can be used both front-end and back-end to validate, for example, forms.

Before you use NodeJS Form Validator, you need to create 'validation schemas', which are simple js objects very easy to configure.
Something like this:

```javascript
  //USER MODEL
  const userSchema = {
    firstName: {
      minLength: {
        value: 2,
        error: "The first name must be at least 5 chars long"
      },
      maxLength: {
        value: 5,
        error: "The first name must be maximum 20 chars long"
      }
    },
    lastName: {
      minLength: {
        value: 5,
        error: "The last name must be at least 5 chars long"
      },
      maxLength: {
        value: 20,
        error: "The last name must be maximum 20 chars long"
      }
    },
    age: {
      isNumber: "The age must be a valid number"
    },
    dateOfBirth: {
      isDate: "The date of birth must be a valid date"
    },
    email: {
      required: "E-mail is required",
      isEmail: "E-mail not valid"
    }
  }
```

As you can see, you can use it to validate several things. You can check if the input has a minimum (or a maximum) number of chars, if it's a valid email, if it's a valid number, if it's a valid date and finally if it's required.
Also, you can configure the error message, in case the condition doesn't come true.

Now let's try to validate our user input. We have an object like this:

```javascript
  const userInput = {
    name: "John",
    surname: "Doe",
    email: "john@example.com"
  }
```

Now, in order to validate, we need to run the following code:

```javascript
  const errors = Validate(userSchema, userInput);
```

If there are errors, they'll be stored in the 'errors' var.

Another useful thing that NodeJS Form Validator does is to check that the only input provided by the user are the ones in the schema, so if for example we try to validate an object like the following, we'll get an error:

```javascript
  const wrongUserInput = {
    name: "John",
    surname: "Doe",
    email: "john@example.com",
    address: "Jonh's address"
  }
```

We'll get the following json error:

```javascript
  {
    field: "address",
    error: "Missing field in the model"
  }
```

This happens because the user has provided an information that is not expected in the schema.

Finally, you can extend the support to the children of the object, by adding `__children` as key inside the object, as you can see in the example:

```javascript
  const userInput = {
    name: "John",
    surname: "Doe",
    email: "john@example.com",
    options: {
      __children: {
        language: {},
        timeZone: {}
      }
    }
  }
```

With this code, you can verify also the children of `options`, which are `language` and `timeZone`. You can nest as many times as you wish by using the same syntax.

---
_Source: https://npm.io/package/nodejs-form-validator · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._