Method load

packages/core/src/entity/Reference.ts:139–167

* Ensures the underlying entity is loaded first (without reloading it if it already is loaded). Returns the entity. * If the entity is not found in the database (e.g. it was deleted in the meantime, or currently active filters disallow loading of it) * the method returns `null`. Use `loadOrFai

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

   * the method returns `null`. Use `loadOrFail()` if you want an error to be thrown in such a case.
   */
  async load<TT extends T, P extends string = never, F extends string = never, E extends string = never>(
    options: LoadReferenceOptions<TT, P, F, E> = {},
  ): Promise<Loaded<TT, P, F, E> | null> {
    const wrapped = helper(this.entity as TT & object);

    if (!wrapped.__em) {
      return this.entity as Loaded<TT, P, F, E>;
    }

    options = { ...options, filters: QueryHelper.mergePropertyFilters(this.property?.filters, options.filters)! };

    if (this.isInitialized() && !options.refresh && options.populate) {
      await wrapped.__em.populate(this.entity, options.populate as any, options as any);
    }

    if (!this.isInitialized() || options.refresh) {
      if (
        options.dataloader ??
        [DataloaderType.ALL, DataloaderType.REFERENCE].includes(wrapped.__em.config.getDataloaderType())
      ) {
        const dataLoader = await wrapped.__em.getDataLoader('ref');
        return dataLoader.load([this, options]);
      }

      return wrapped.init(options);
    }

    return this.entity as Loaded<TT, P, F, E>;
  }

  /**
   * Ensures the underlying entity is loaded first (without reloading it if it already is loaded).