Skip to main content

Troubleshooting

Module not initialized​

Make sure @quik/entity is registered in your bootstrap module and appears after its dependencies (@quik/core).

Entity not registered​

EntityStore.get(name)/create(...)/init(...) throw EntityNotLoadedError until the entity class is registered with EntityStore.register(EntityClass). This includes tests that construct entities directly without going through module setup.

Validation fails unexpectedly​

entity.validate() throws ValidationError (containing per-field results in error.fields) unless it is called as validate(true), in which case it returns the results instead of throwing. Fields flagged readonly or with no validators are skipped; fields flagged optional skip validation entirely when the value is null/undefined.

Common Errors​

  • quik.errors.entity.validation: validate() found one or more failing field validators; inspect error.fields for details.
  • quik.errors.entity.entity-not-loaded: the requested entity name/constructor was not registered via EntityStore.register(...).
  • quik.errors.entity.at-least-one-field-required: an operation required at least one field to be present on the entity but none were given.
  • quik.entity.validators.*: per-field validator messages (string/number/date/array/set rules) interpolated with the failing field name and constraint values — see the package's en.json for the full catalog.