Options which configure the behavior of the field
The initially provided options which configure the data field
The field name of this DataField instance. This is assigned by SchemaField#initialize.
A reference to the parent schema to which this DataField belongs. This is assigned by SchemaField#initialize.
Whether this field defines part of a Document/Embedded Document hierarchy.
Does this field type contain other fields in a recursive structure? Examples of recursive fields are SchemaField, ArrayField, or TypeDataField Examples of non-recursive fields are StringField, NumberField, or ObjectField
Apply any cleaning logic specific to this DataField type.
The appropriately coerced value.
The cleaned value.
Apply a function to this DataField which propagates through recursively to any contained data schema.
The function to apply
The current value of this field
The results object
Coerce source data to ensure that it conforms to the correct data type for the field. Data coercion operations should be simple and synchronous as these are applied whenever a DataModel is constructed. For one-off cleaning of user-provided input the sanitize method should be used.
The initial value
The cast value
Attempt to retrieve a valid initial value for the DataField.
The source data object for which an initial value is required
A valid initial value
Validate a candidate input for this field, ensuring it meets the field requirements. A validation failure can be provided as a raised Error (with a string message), by returning false, or by returning a DataModelValidationFailure instance. A validator which returns true denotes that the result is certainly valid and further validations are unnecessary.
The initial value
Returns a DataModelValidationFailure if a validation failure occurred.
Certain fields may declare joint data validation criteria. This method will only be called if the field is designated as recursive.
Candidate data for joint model validation
Options which modify joint model validation
Initialize the original source data into a mutable copy for the DataModel instance.
The source value of the field
The DataModel instance that this field belongs to
An initialized copy of the source data
Export the current value of the field into a serializable object.
The initialized value of the field
An exported representation of the field
Special validation rules which supersede regular field validation. This validator screens for certain values which are otherwise incompatible with this field like null or undefined.
The candidate value
A boolean to indicate with certainty whether the value is valid. Otherwise, return void.
Recursively traverse a schema and retrieve a field specification by a given path
The field path as an array of strings
Test whether a provided value is a valid choice from the allowed choice set
The provided value
Is the choice valid?
A dot-separated string representation of the field path within the parent schema.
A subclass of DataField which deals with number-typed data.
{number} min A minimum allowed value
{number} max A maximum allowed value
{number} step A permitted step size
{boolean} integer=false Must the number be an integer?
{number} positive=false Must the number be positive?
{number[]|object|function} [choices] An array of values or an object of values/labels which represent allowed choices for the field. A function may be provided which dynamically returns the array of choices.