3.2.0 • Published 5 years ago
cephas v3.2.0
Cephas
Cephas is a little tool for validating simple objects against a schema.
Usage:
const cephas = require("cephas");
const validate = cephas({
name: {
required: true,
message: "Please provide your name",
},
email: {
required: true,
match: /([\w\.\-_]+)?\w+@[\w-_]+(\.\w+){1,}/gim, // you can match on regex
message: "Please provide your email address",
},
age: {
required: true,
message: "Please provide your age",
},
customMatchFunctionDefaultMsg: {
required: true,
match: function (prop) {
// You can match with a function
if (prop === "happy") {
return true;
} else {
return false; // If you return false the default err msg will be used
}
},
message: "Please cheer up a bit!",
},
customMatchFunctionCustomMsg: {
required: true,
match: function (prop) {
if (prop === "happy") {
return true;
} else {
return "Please cheer up a bit!!!"; // Or you can return a custom msg
}
},
message:
"This message will be ignored because the function returns a string",
},
});
// In this case errors will equal false as all props pass validation
const errors = validate({
name: "milyord",
email: "milyord@example.com",
age: "19",
});
If errors exist:
// In this case errors will be an object as props fail validation
const errors = validate({
name: "",
email: "",
age: "",
});
console.log(erros);
/* Will log the following:
{
name: 'Please provide your name',
email: 'Please provide your email address',
age: 'Please provide your age'
}
*/
Pretty self explanatory stuff.
Cheers!