Skip to main content

Troubleshooting

Service not loaded​

ServicesStore.get(service) (and constructor(), session(), scope(), clone(), which call it internally) throws ServiceNotLoadedError when the service constructor or name was never passed to ServicesStore.register(...) or picked up by ServicesStore.load(folder). Register services before resolving them, and make sure load(folder) points at the correct directory.

Circular clone properties​

Cloning a service with properties that contain a circular reference throws a plain Error ("Circular clone properties are not cacheable.") from the internal property-serialization step used to cache scoped/cloned instances. Pass plain, serializable data as clone/scope properties.

executeCommand fails with module not loaded​

QService#executeCommand(...) requires @quik/cli to be registered in bootstrap; otherwise it throws ModuleNotLoadedError (from @quik/bootstrap, not a @quik/services error).

Common Errors​

  • quik.errors.services.service-not-loaded: thrown by ServiceNotLoadedError when a service was resolved before being registered/loaded.
  • quik.errors.services.general-error: thrown by QServiceError, a generic error type available for services to signal an unrecoverable failure.