// @flow strict import { GraphQLError } from '../../error/GraphQLError'; import { type ASTVisitor } from '../../language/visitor'; import { type ASTValidationContext } from '../ValidationContext'; export function unusedFragMessage(fragName: string): string { return `Fragment "${fragName}" is never used.`; } /** * No unused fragments * * A GraphQL document is only valid if all fragment definitions are spread * within operations, or spread within other fragments spread within operations. */ export function NoUnusedFragments(context: ASTValidationContext): ASTVisitor { const operationDefs = []; const fragmentDefs = []; return { OperationDefinition(node) { operationDefs.push(node); return false; }, FragmentDefinition(node) { fragmentDefs.push(node); return false; }, Document: { leave() { const fragmentNameUsed = Object.create(null); for (const operation of operationDefs) { for (const fragment of context.getRecursivelyReferencedFragments( operation, )) { fragmentNameUsed[fragment.name.value] = true; } } for (const fragmentDef of fragmentDefs) { const fragName = fragmentDef.name.value; if (fragmentNameUsed[fragName] !== true) { context.reportError( new GraphQLError(unusedFragMessage(fragName), fragmentDef), ); } } }, }, }; }