Noodles Practicing Medicine

    TypeScript icon, indicating that this package has built-in type declarations

    0.1.1 • Public • Published


    NPM Version Package License NPM Downloads

    Based on this small library assists in adding to a NestJS project.

    This package also ensures that the ids are mapped to the dataloader in the correct sequence automatically and provides a helpful base class to simplify dataloader creation.

    Requires NestJS 7+


    $ yarn add @intelrug/nestjs-graphql-dataloader


    1. Register DataLoaderInterceptor

    First, register a NestJS interceptor in your applications root module(s) providers configuration. This can actually be placed in any of your modules and it will be available anywhere but I would recommend your root module(s). It only needs to be defined once.


      provide: APP_INTERCEPTOR,
      useClass: DataLoaderInterceptor,

    For example:

    import { DataLoaderInterceptor } from '@intelrug/nestjs-graphql-dataloader';
      providers: [
          provide: APP_INTERCEPTOR,
          useClass: DataLoaderInterceptor,
      imports: [
          path.resolve(__dirname, '../../config', '**/!(*.d).{ts,js}'),

    2. Build @Loaders for each @ObjectType

    Using the provided template method, OrderedNestDataLoader<KeyType, EntityType>, you can easily implement DataLoaders for your types. Here is an example:

    import { Injectable } from '@nestjs/common';
    import { OrderedNestDataLoader } from '@intelrug/nestjs-graphql-dataloader';
    import { Location } from '../core/location.entity';
    import { LocationService } from '../core/location.service';
    export class LocationLoader extends OrderedNestDataLoader<Location['id'], Location> {
      constructor(private readonly locationService: LocationService) {
      protected getOptions = () => ({
        query: (keys: Array<Location['id']>) => this.locationService.findByIds(keys),

    Note: In these examples the usage of Location['id'] is referring to the type of the property, which in this case is string. It would be perfectly acceptable to declare the generic type argument as string rather than Location['id'].

    Add these to your modules providers as usual. You will most likely want to include it in your modules exports so the loader can be imported by resolvers in other modules.

    getOptions takes a single options argument which has the following interface:

    interface IOrderedNestDataLoaderOptions<ID, Type> {
      propertyKey?: string | string[];
      query: (keys: readonly ID[]) => Promise<Type[]>;
      typeName?: string;

    Since the majority of the time a propertyKey is 'id' this is the default if not specified.

    The typeName for the above example is automatically assigned 'Location' which is derived from the class name, this is just used for logging errors.

    The query is the equivalent of a repository.findByIds(ids) operation. It should return the same number of elements as requested. The order does not matter as the base loader implementation takes care of this.

    3. Use the @Loader in @ResolveField

    To then use the resolver it just needs to be injected into the resolvers field resolver method. Here is an example:

    import DataLoader from 'dataloader';
    @ResolveField(() => [Location])
    public async locations(
      @Parent() company: Company,
      locationLoader: DataLoader<Location['id'], Location>,
    ) {
      return locationLoader.loadMany(company.locationIds);


    npm i @intelrug/nestjs-graphql-dataloader

    DownloadsWeekly Downloads






    Unpacked Size

    20.9 kB

    Total Files


    Last publish


    • intelrug