must-type

1.0.1 • Public • Published

must-type.js

is a framework which is inspired from the require() in solidity, used for validating types and inputs on common js and even on es6 withiut the use of typescript, this good for aplication which has to require a type for aurguments of functions or input on forms

install

npm i must.js 

usage

commonjs

   const {must, string} = require("must-type");
   const isString = string(100) // false
   const must(isString) "this is not type of string") // return type error
   function sampleFunction(name,age){
   must(string(name) && name.length >= 6, 'name is not a typeof string or it\'s length is less than 6');
   must(age === type(0), `age must be type ${type}`);
   must(age >= 18, 'you are less than 18');
   must(age <= 50, 'only for 50 and younger');
   console.log({age : age, name : name})
}
sampleFunction(123, 1)
// only the first error are displayed because it will stop the execution
// TypeError name is not a typeof string or it's length is less than 6

sampleFunction("john doe", 13);
// TypeError you are less than 18
sampleFunction("john doe", 60);
// TypeError only for 50 and younger

sampleFunction("john doe", 22);
// {age : 22, name : "john doe"}

es6

import {must, int, t} from "must-type"
const isNumber = int("jhone doe")  // false 
must(isNumber === t.int, 'this is not a string); // this is not a string

function sampleFunction(name,age){
   must(string(name) && name.length >= 6, 'name is not a typeof string or it\'s length is less than 6');
   must(age === type(0), `age must be type ${type}`);
   must(age >= 18, 'you are less than 18');
   must(age <= 50, 'only for 50 and younger');
   console.log({age : age, name : name})
}
sampleFunction(123, 1)
// only the first error are displayed because it will stop the execution
// TypeError name is not a typeof string or it's length is less than 6

sampleFunction("john doe", 13);
// TypeError you are less than 18
sampleFunction("john doe", 60);
// TypeError only for 50 and younger

sampleFunction("john doe", 22);
// {age : 22, name : "john doe"}

what is the use cases for must.js

  1. validate types on function aurguments
   const {must, object}
   function myFunction(aurgumentA, aurgumentB){
      must(object(aurgumentA), `this aurgument must be an object`);
      // it requires aurgumentA to be an object if it is indeed 
      // an object it will continue the execution else return TypeError
      console.log(aurgumentA, aurgumentB);
   }
  1. for the use of conditionals
const {type, t} require("must-type")
const identifier = {name : "john doe", age : 37}
if(type(identifier.age) == t.num ){
   console.log(identifier);
}
  1. in api requests
   const express = require("express");
   const app = express();
   const {must} = require("must-type");
   app.get("/:id", (req,res) => {
      must(req.params.id.length > 5, 'id must be higher than 5 characters');
      // if req.params.id.length < 5 then there will be an error
      res.send("no error occured");
   })
   app.listen(5000, () => console.log(server is running on port 5000))

to learn must.js please visit the documentation for more information

Readme

Keywords

Package Sidebar

Install

npm i must-type

Weekly Downloads

6

Version

1.0.1

License

MIT

Unpacked Size

12.5 kB

Total Files

5

Last publish

Collaborators

  • loweandaya7566