@nestjs/graphql
Version:
GraphQL for NestJS: code-first and schema-first APIs, resolvers as providers, subscriptions, federation and generated SDL, on Apollo or Mercurius.
46 lines (45 loc) • 1.95 kB
JavaScript
import { FIELD_MIDDLEWARE_METADATA } from '../graphql.constants.js';
/**
* Applies field middleware to a field (`@Field()`) or a field resolver
* (`@ResolveField()`). It can be placed above or below either decorator, and
* composes well with `applyDecorators()`.
*
* Middleware runs in this order:
* 1. global middleware (`buildSchemaOptions.fieldMiddleware`),
* 2. middleware passed through the `middleware` option of `@Field()` or `@ResolveField()`,
* 3. middleware applied with `@UseFieldMiddleware()`, in the order given.
*
* When the decorator is stacked, the middleware of the lowest one runs first
* (as with `@UseGuards()`). A subclass that decorates an inherited member
* extends the inherited list. For field resolvers, field middleware runs before
* the enhancers enabled through `fieldResolverEnhancers` (guards, interceptors, filters).
*
* @param middleware one or more field middleware functions
*
* @see [Field middleware](https://docs.nestjs.com/graphql/field-middleware)
*
* @publicApi
*/
export function UseFieldMiddleware(...middleware) {
return (target, propertyKey) => {
const existing = Reflect.getMetadata(FIELD_MIDDLEWARE_METADATA, target, propertyKey) ?? [];
Reflect.defineMetadata(FIELD_MIDDLEWARE_METADATA, [...existing, ...middleware], target, propertyKey);
};
}
/**
* Returns the middleware applied with `@UseFieldMiddleware()` to the given member.
*/
export function getUseFieldMiddleware(target, propertyKey) {
if (!target) {
return [];
}
return (Reflect.getMetadata(FIELD_MIDDLEWARE_METADATA, target, propertyKey) ?? []);
}
/**
* Returns `true` if `@UseFieldMiddleware()` was applied to the given member
* on this very prototype, rather than inherited from a parent class.
*/
export function hasOwnUseFieldMiddleware(target, propertyKey) {
return (!!target &&
Reflect.hasOwnMetadata(FIELD_MIDDLEWARE_METADATA, target, propertyKey));
}