class staticbo.commonRules. LengthIsRule
Source: common-rules/
The rule ensures that the length of the property value has a given length.
new LengthIsRule(primaryProperty, length, message[, priority][, stopsProcessing])
Creates a new length-is rule object.
Parameters
| Name | Type | Optional | Description |
|---|---|---|---|
|
primaryProperty |
|
The property definition the rule relates to. |
|
|
length |
number |
|
The required length of the property value. |
|
message |
string |
|
Human-readable description of the rule failure. |
|
priority |
number |
Yes |
The priority of the rule. |
|
stopsProcessing |
boolean |
Yes |
Indicates the rule behavior in case of failure. |
- Extends
- bo.rules.ValidationRule
- Throws
-
Argument error: The primary property must be a PropertyInfo object.
-
Argument error: The length must be an integer value.
-
Argument error: The message must be a non-empty string.
Properties
read-onlylength
number
The required length of the property value.
read-onlyruleName
string
The name of the rule type. The default value usually the name of the constructor, without the Rule suffix.
- Inherited from
- bo.rules.RuleBase#ruleName
Methods
addAffectedProperty(property)
Adds an additional property that is influenced by the rule.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
property |
|
|
An affected property influenced by the rule. |
- Inherited from
- bo.rules.ValidationRule#addAffectedProperty
- Throws
-
Argument error: The affected property must be a PropertyInfo object.
addInputProperty(property)
Adds an additional property to the rule that will use its value.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
property |
|
|
An input property that value is used by the rule of. |
- Inherited from
- bo.rules.ValidationRule#addInputProperty
- Throws
-
Argument error: The input property must be a PropertyInfo object.
abstractexecute(inputs) → (bo.rules.ValidationResult or undefined)
Checks if the length of the property value equals to the defined length.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
inputs |
Array of any type |
|
An array of the values of the required properties. |
- Returns
-
(bo.rules.ValidationResult or undefined)Information about the failure.
protectedgetInputValues(getValue) → object
Returns the values of the properties that are used by the rule. This method is called by the rule manager internally to provide the values of the input properties for the execute() method.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
getValue |
|
|
A function that returns the value of a property. |
- Inherited from
- bo.rules.ValidationRule#getInputValues
- Throws
-
Argument error: The getValue argument must be a function..
- Returns
-
An object that properties hold the values of the input properties of.
initialize(primaryProperty, message[, priority][, stopsProcessing])
Sets the properties of the rule.
Parameters
| Name | Type | Optional | Description |
|---|---|---|---|
|
primaryProperty |
|
|
The property definition the rule relates to. |
|
message |
|
|
Human-readable description of the rule failure. |
|
priority |
|
Yes |
The priority of the rule. |
|
stopsProcessing |
|
Yes |
Indicates the rule behavior in case of failure. |
- Inherited from
- bo.rules.ValidationRule#initialize
- Throws
-
Argument error: The primary property must be a PropertyInfo object.
-
Argument error: The message must be a non-empty string.
result([message], severity) → bo.rules.ValidationResult
Returns the result of the rule executed.
Parameters
| Name | Type | Optional | Description |
|---|---|---|---|
|
message |
|
Yes |
Human-readable description of the rule failure. |
|
severity |
|
|
The severity of the failed rule. |
- Inherited from
- bo.rules.ValidationRule#result
- Returns
-
The result of the validation rule.