multiform-validator
v2.2.9
Published
Javascript library made to validate, several form fields, such as: email, images, phone, password, cpf etc.
Downloads
904
Maintainers
Readme
[!NOTE] I accept help to make the version of the other programming languages.
Multiform-validator
This npm package provides JavaScript functions to validate various forms fields.
Documentation: https://multiformvalidator.netlify.app
Feel free to find bugs and report them to me. Your feedback is highly appreciated. Hugs from Gabriel Logan!
CDNs
ESM:
jsDelivr:
https://cdn.jsdelivr.net/npm/[email protected]/+esm
<script type="module">
import multiform-validator from "https://cdn.jsdelivr.net/npm/[email protected]/+esm"
</script>
CJS:
jsDelivr:
https://cdn.jsdelivr.net/npm/[email protected]/dist/cjs/index.min.js
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/cjs/index.min.js"></script>
unpkg:
https://unpkg.com/[email protected]/dist/cjs/index.cjs
<script src="https://unpkg.com/[email protected]/dist/cjs/index.cjs"></script>
Example of use with CDN
using cjs:
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/cjs/index.min.js"></script>
<script>
const emailResult = isEmail("123456");
const cpfResult = cpfIsValid("123456");
console.log(emailResult); // returns false
console.log(cpfResult.isValid); // returns false
</script>
or
using esm:
<script type="module">
import multiformValidator from "https://cdn.jsdelivr.net/npm/[email protected]/+esm";
const emailResult = multiformValidator.isEmail("123456");
const cpfResult = multiformValidator.cpfIsValid("123456");
console.log(emailResult); // returns false
console.log(cpfResult.isValid); // returns false
</script>
Installation
npm install multiform-validator
or
yarn add multiform-validator
Data Validator
This package contains various modules for validating different types of data. Below are the available validation modules:
Available Validation Modules
- cnpjValidator: CNPJ validation.
- cpfValidator: CPF validation.
- getOnlyEmail: Extracts only the email or emails address from a string.
- identifyFlagCard: Identifies the flag of a credit card.
- isAscii: Checks if the string contains only ASCII characters.
- isBase64: Checks if the string is a valid Base64 encoding.
- isCEP: CEP validation (Brazilian postal code).
- isCreditCardValid: Credit card validation.
- isDate: Date format validation.
- isDecimal: Checks if the number is a decimal.
- isEmail: Email address validation format.
- isEmpty: Checks if the string is empty.
- isMACAddress: MAC address validation.
- isMD5: Checks if the string is a valid MD5 hash.
- isNumber: Checks if the value is a number.
- isPort: Port number validation.
- isPostalCode: Postal code validation.
- isTime: Time format validation.
- isValidAudio: Audio file validation.
- isValidImage: Image file validation.
- isValidPdf: Pdf file validation.
- isValidTxt: Txt file validation.
- isValidVideo: Video file validation.
- passwordStrengthTester: Password strength test.
- validateBRPhoneNumber: Brazilian phone number validation.
- validateEmail: Email address full validation.
- validateName: Name validation.
- validatePassword: Password validation.
- validatePassportNumber: Passport number validation.
- validatePhoneNumber: Phone number validation.
- validateSurname: Surname validation.
- validateTextarea: Textarea validation.
- validateUsername: Username validation.
- validateUSPhoneNumber: US phone number validation.
You can use it in React Native, Angular, any javascript framework or any javascript or typescript code.
Example using Reactjs:
For better information, read the documentation
const validator = require("multiform-validator");
// or
import validator from "multiform-validator";
or;
// Attention, FUNCTION_NAME is not a valid function name! It is just an example of how to import the functions.
const { FUNCTION_NAME } = require("multiform-validator");
// or
import { FUNCTION_NAME } from "multiform-validator";
const validator = require('multiform-validator');
// or
import validator from 'multiform-validator';
// then
validator.FUNCTION_NAME
// OBS: 'if the function is called validate, the return will be an object and not boolean'
// When return object boolean
validator.FUNCTION_NAME = true or false
// When return object
validator.FUNCTION_NAME = object = { isValid: true or false, errorMsg: 'stringError' }
validator.FUNCTION_NAME.isValid = true or false
validator.FUNCTION_NAME.errorMsg = 'ErrorMsg' // You can customize errors
/**
* There are other returns in some functions, with strings etc, stay tuned
*/
Documentation
https://multiformvalidator.netlify.app
const { validateEmail } = require("multiform-validator");
// or
import { validateEmail } from "multiform-validator";
// It has many more validations, you can read the documentation or
// do several tests to learn how to use the library in the best possible way.
// Two last parameters are optional
console.log(
validateEmail("[email protected]", { maxLength: 30, country: "br" }).isValid,
); // returns false
console.log(
validateEmail("[email protected]", { maxLength: 30, country: "br" }).isValid,
); // returns true
console.log(validateEmail("[email protected]", { maxLength: 30 }).isValid); // returns true
// All examples return default messages, below is an example setting your own messages
// If you want to use a default parameter, use null.
const validationResult = validateEmail("[email protected]", { maxLength: 30 });
if (validationResult.isValid) {
console.log("0 errors");
} else {
console.log(validationResult.errorMsg); // returns the error
}
// or
const validationResult = validateEmail("[email protected]", {
maxLength: 30,
errorMsg: [null, "This is an invalid email with my own errors"],
});
if (validationResult.isValid) {
console.log("0 errors");
} else {
console.log(validationResult.errorMsg); // Return 'This is an invalid email with my own errors'
}
Feel free to explore the various functions and experiment with different inputs to understand their behavior. If you encounter any issues or have suggestions, don't hesitate to reach out to me. Your feedback is valuable and helps improve the package. Happy coding!
If you want to help me, you can buy me a coffee (: