required

Search…
required
The required validator is the only validator that ensures a value is present. All other validators in Strickland will return isValid: true if the value supplied is empty. This approach allows all other validators to be applied to optional values. And as we'll explore shortly, validators can be composed to combine required with other validators.
The values that required recognizes as empty and invalid are:
1.null
2.undefined
3.'' (empty string)
4.false
For all other values, including 0 (despite being is falsy), required will indicate the result is valid.
The false boolean value being invalid is commonly used to validate that checkboxes must be checked. For example, when a user must accept terms before submitting a form, the checked state of the checkbox can be validated with required.
Named Props
required: A boolean indicating whether or not the value is required (default: true)
Parameters
The required validator supports three parameter signatures:
1.required(requiredValue) where the value is used as the required named prop
2.required(propsObject) where the props object contains a required named prop
3.required(propsFunction) where the props function returns a props object with a required named prop
Usage
1
import validate, {required} from 'strickland';
2
​
3
const nameRequired = required({
4
    message: 'Name is required'
5
});
6
​
7
const result = validate(nameRequired, '');
8
​
9
/*
10
    result = {
11
        required: true,
12
        message: 'Name is required',
13
        isValid: false,
14
        value: ''
15
    }
16
 */
Copied!
The required validator respects a named prop of required that indicates whether or not the value is required. This is useful for dynamic validation scenarios where your application needs to support conditionally required fields; you can apply the required validator and dynamically supply the required named prop. If the required named prop is false, the validator will always return isValid: true.
1
// Required by default
2
const a = required();
3
​
4
// As a value parameter
5
const requiredField = required(true);
6
const optionalField = required(false);
7
​
8
// As a named prop
9
const nameRequired = required({
10
    required: true,
11
    message: '"Name" is required'
12
});
13
​
14
// As a function that resolves to have the named prop
15
const requiredValidator = required((context) => ({
16
    required: context.required,
17
    message: context.required ?
18
        '"Name" is required' :
19
        '"Name" is optional'
20
}));
Copied!
Built-In Validators
compare
Last modified 1yr ago
Copy link
Contents
Named Props
Parameters
Usage