RefineStage enum Core

Controls when a VMap.refineField, VObject.refineField or VObject.refineFieldRaw callback runs in the container pipeline.

  • RefineStage.post (default): runs after every declared field has been validated and transformed. Callback sees parsed values. Gated by dependsOn — skipped when any declared dependency (including the refine's own path) failed per-field validation.
  • RefineStage.pre: runs before any per-field iteration. Callback sees the input as it arrived (no preprocess / transforms applied). Always runs once the type check passed; dependsOn is not accepted (no field has been validated yet, so there is nothing to gate on).

Use RefineStage.pre for rules that depend on the raw input — original casing, whitespace, pre-coercion shape. The classic case is a field declared as V.string().toLowerCase().email() paired with a check that must see the user's original casing.

See also:

  • VMap, which accepts a stage on its field-level refine.
  • VObject, which also exposes a raw-map refine for the same purpose.
Inheritance
Available extensions

Values

post → const RefineStage

Runs after per-field validation/transforms. Callback sees parsed values; dependsOn gates execution.

pre → const RefineStage

Runs before any per-field iteration. Callback sees raw input; dependsOn is not accepted.

Properties

hashCode → int
The hash code for this object.
no setterinherited
index → int
A numeric identifier for the enumerated value.
no setterinherited
name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Constants

values → const List<RefineStage>
A constant List of the values in this enum, in order of their declaration.