Package Exports

rich-param

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (rich-param) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

rich-param

An object with name and value which accepts pluggable methods as formatters or validators.

Install

npm install rich-param

Usage

Basic

import Param from 'rich-param'

// new Param(name, value, options)
const param = new Param('firstName', 'Jessica', { uppercase: true })

console.log(param.name) // firstName
console.log(param.value()) // JESSICA

Setting and getting value

console.log(param.value('pRIsCila')) // PRISCILA

Setting and getting options

See List of default options

console.log(param.option('uppercase')) // true
console.log(param.option('uppercase', false)) // false

console.log(param.value('prisciLa')) // prisciLa

Formatting the value

param.option('format', (value, param) => `${param.name}: ${value}`)

console.log(param.value('PRISCILA')) // firstName: PRISCILA

Validating the value

param.option('validate', (value, param) => ({
  valid: value === 'Jessica',
  message: 'Jessica is the only valid name'
}))

param.value('Jessica')
console.log(param.validate()) // true

param.value('Priscila')
console.log(param.validate()) // false

// or get the error object
param.validate((err) => {
  console.log(err)
  /* {
    valid: false,
    name: 'validate',
    param: 'firstName',
    value: 'Priscila',
    message: 'Jessica is the only valid name'
  } */
})

Validating using the built-in validators

See List of default options

param.option('required', true)
param.value('')

console.log(param.validate()) // false

// or get the error object
param.validate((err) => {
  console.log(err)
  /* {
    valid: false,
    name: 'required',
    required: true,
    param: 'firstName',
    value: '',
    message: 'firstName is required'
  } */
})

Creating a custom formatter

param.formatter('shout', (shout, value, param) => {
  if (shout && value) {
    value = value.toUpperCase() + '!'
  }
  return value
})

console.log(param.value('Jessica')) // Jessica

param.option('shout', true)

console.log(param.value('Jessica')) // JESSICA!

Creating a custom validator

param.validator('mustBeAShout', (mustBeAShout, value, param) => ({
  valid: !mustBeAShout || !value && value.toUpperCase() === value && value.indexOf('!') !== -1,
  message: 'THE VALUE MUST BE A SHOUT!'
}))

param.option('shout', false)

console.log(param.value('Jessica')) // Jessica
console.log(param.validate()) // true

param.option('mustBeAShout', true)

console.log(param.validate()) // false

param.option('shout', true)

console.log(param.value('Jessica')) // JESSICA!
console.log(param.validate()) // true

Reference

List of default options

Option	Type	Default value	Description
default	Mixed		Default param value
normalize	Boolean	`false`	Formats `Hey, jÉssiCa!` to `hey jessica`
lowercase	Boolean	`false`	Formats `HeLLo!` to `hello!`
uppercase	Boolean	`false`	Formats `HeLLo!` to `HELLO!`
trim	Boolean	`true`	Formats `HeLLo !` to `HeLLo !`
required	Boolean	`false`	Invalidates empty values
min	Number		Invalidates values lower than it
max	Number		Invalidates values greater than it
minlength	Number		Invalidates values with length lower than it
maxlength	Number		Invalidates values with length greater than it
enum	Array		Invalidates values which isn't in it
match	RegExp		Invalidates values which doesn't pass the RegExp
multiple	Boolean	`false`	Make the value an array
separator	String	`,`	String to be found in the value to split into an array (if multiple = true)
format	Function	`(value, param) => value`	Function to be called with `param.value()`
validate	Function	`(value, param) => ({ valid: true })`	Function to be called with `param.validate()`

rich-param

Package Exports

Readme

rich-param

Install

Usage

Basic

Setting and getting value

Setting and getting options

Formatting the value

Validating the value

Validating using the built-in validators

Creating a custom formatter

Creating a custom validator

Reference

List of default options

License