Method loadCount

packages/core/src/entity/Collection.ts:141–174

* Gets the count of collection items from database instead of counting loaded items. * The value is cached (unless you use the `where` option), use `refresh: true` to force reload it. * When the dataloader is enabled (globally or per-query), multiple calls are batched into a single grouped que

(options: LoadCountOptions<T> | boolean = {})

   * When the dataloader is enabled (globally or per-query), multiple calls are batched into a single grouped query.
   */
  async loadCount(options: LoadCountOptions<T> | boolean = {}): Promise<number> {
    options = typeof options === 'boolean' ? { refresh: options } : options;
    const { refresh, where, dataloader, ...countOptions } = options;

    if (!refresh && !where && this.#count != null) {
      return this.#count;
    }

    const em = this.getEntityManager()!;

    if (
      !em.getPlatform().usesPivotTable() &&
      this.property.kind === ReferenceKind.MANY_TO_MANY &&
      this.property.owner
    ) {
      return (this.#count = this.length);
    }

    let count: number;

    if (dataloader ?? [DataloaderType.ALL, DataloaderType.COLLECTION].includes(em.config.getDataloaderType())) {
      const loader = await em.getDataLoader('count');
      count = await loader.load([this, { where, ...countOptions }]);
    } else {
      const cond = this.createLoadCountCondition(where ?? ({} as FilterQuery<T>));
      count = await em.count(this.property.targetMeta!.class, cond, countOptions as any);
    }

    if (!where) {
      this.#count = count;
    }

    return count;
  }

  /** Queries a subset of the collection items from the database with custom filtering, ordering, and pagination. */
  async matching<TT extends T, P extends string = never>(options: MatchingOptions<T, P>): Promise<Loaded<TT, P>[]> {