# v4f > A declarative, efficient, and flexible JavaScript validation library for Humans . Latest version **0.1.2** (published 2019-02-08) · MIT license · 0 weekly downloads ## Install ```sh npm install v4f pnpm add v4f yarn add v4f bun add v4f ``` ## Health **Score 30/100 (F)** — status: abandoned. Positive: has types; esm support; no vulnerabilities; high quality score. Warnings: low downloads; pre 1.0. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 0.1.2 | | Published | 2019-02-08 | | First published | 2019-01-13 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 0 | | Unpacked size | 59.8 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Author | Nassih soufiane | | Maintainers | xns7 | ## Links - npm: https://www.npmjs.com/package/v4f - Repository: https://github.com/web-pyjs/v4f - Homepage: https://v4f.js.org/ - npm.io page: https://npm.io/package/v4f ## Recent versions - 0.1.2 (latest) — 2019-02-08 - 0.1.1 — 2019-02-06 - 0.1.0 — 2019-02-06 - 0.0.9 — 2019-01-30 - 0.0.1 — 2019-01-13 ## README

undefined undefined undefined

[Documentation](https://v4f.js.org/docs/introduction/get-started) | [Exemples](https://v4f.js.org/docs/introduction/examples) | [API Reference](https://v4f.js.org/docs/api-reference/api) | [Need help ?](https://v4f.js.org/help) # Description : ### V4F A javascript library for validation that encourages rapid development and clean code, unlike other validation libraries v4f is designed from the ground up to be adaptable for any context, and it takes care of all your validation in different environments (client, server, native). You can use **V4f** together with ([react.js](https://reactjs.org/), [angular.js](https://angular.io/), [vue.js](https://vuejs.org/), [jquery](https://jquery.com/)) or with any web framework. ### Why ! why new validation library where they exist several good ones around, sure you are completely right. but the problem with those libraries is that almost all of the theme focus in data validation and they forget the key reason why we do validation for, is that we desire to guide our users by showing them what they missing or what they doing wrong with some pieces of information, but sadly you end up with generic messages errors or writing code on the top of this libraries every time you use them. **V4F** comes to solve this problem by focusing on those two features validations and failures messages, **V4F** comes with easy and powerful syntax that feels more human that everyone can understand with more than 40+ built-in rules. ## Out of the box **Schema** : v4f use the concept of the schema types to indicate your rules that will be checked later were we need it, this notion is powerful it lets you create complex rules ones and use it multiple types. **Nested Schema** : with v4f you can use a schema that already created inside other schemas to create complex validation. **Related Field** : validate fields that related or depends on each other easily with a simple syntax. **One-field** : Validate only one field from schema very useful in situations like instead field validation feedback. # Getting started ### Syntax overview ```javascript import { Schema, Field } from "v4f"; const User = Schema({ username: Field() .string() .alphaNum() .required(), email: Field() .string() .email() .required(), password: Field() .string() .min(6) .max(20) .not.equals(["#username"]) .not.equals(["#email"]) .required(), cPassword: Field() .string() .equals(["#password"]) .required() }); const result = User.validate(data); ``` The above schema defines the following constraints: - username : - Must be string - Must be alpha numeric - Required - email : - Must be string - Must be valid email - Required - password : - Must be string - At least 6 characters long but no more than 20 - Must not be equals to **username** and **email** - Required - cPassword : - Must be string - Must equals to **password** - Required ## Instalation To install the stable version: ```sh $ npm install v4f ``` This assumes you are using [npm](https://www.npmjs.com/) as your package manager. or ```sh $ yarn add v4f ``` If you you use [yarn](https://yarnpkg.com/) as package your package manager. ## Usage #### Commonjs ```javascript var v4f = required("v4f"); const User = v4f.Schema({// Your schema here}); ``` #### ES6 ```javascript import {Schema, Field} from "v4f"; const User = Schema({// Your schema here}); ``` Read the [Usage Guide](https://v4f.js.org/docs/guides/intro) on our website for detailed instructions on how to use the library. ## Contributing In general, we follow the "fork-and-pull" Git workflow. 1. Fork on GitHub 2. Make changes to your own fork 3. Submit a Pull request so that we can review your changes ### Test ```sh $ yarn test ``` ### Linter ```sh $ yarn lint ``` ## Maintainers - [reyx7](https://github.com/reyx7) - **Nassih Soufiane** (author) ### License (MIT) ``` MIT License Copyright (c) 2019 soufiane nassih soufiane.nass7@gmail.com Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", 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. ``` --- _Source: https://npm.io/package/v4f · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._