Method loadOrFail

packages/core/src/entity/Reference.ts:173–187

* Ensures the underlying entity is loaded first (without reloading it if it already is loaded). * Returns the entity or throws an error just like `em.findOneOrFail()` (and respects the same config options).

(
    options: LoadReferenceOrFailOptions<TT, P, F, E> = {},
  )

   * Returns the entity or throws an error just like `em.findOneOrFail()` (and respects the same config options).
   */
  async loadOrFail<TT extends T, P extends string = never, F extends string = never, E extends string = never>(
    options: LoadReferenceOrFailOptions<TT, P, F, E> = {},
  ): Promise<Loaded<TT, P, F, E>> {
    const ret = await this.load(options);

    if (!ret) {
      const wrapped = helper(this.entity);
      options.failHandler ??= wrapped.__em!.config.get('findOneOrFailHandler');
      const entityName = this.entity.constructor.name;
      const where = wrapped.getPrimaryKey() as any;
      throw options.failHandler(entityName, where);
    }

    return ret;
  }

  private set<TT extends T>(entity: TT | Ref<TT>): void {
    this.entity = Reference.unwrapReference(entity as T & object);