added tests for defer directive

Author: morrys

src/execution/__tests__/directives-test.js

@@ -845,6 +845,34 @@ describe('Introspection', () => {
                 },
               ],
             },
+            {
+              name: 'defer',
+              locations: ['FRAGMENT_SPREAD'],
+              args: [
+                {
+                  defaultValue: null,
+                  name: 'if',
+                  type: {
+                    kind: 'SCALAR',
+                    name: 'Boolean',
+                    ofType: null,
+                  },
+                },
+                {
+                  defaultValue: null,
+                  name: 'label',
+                  type: {
+                    kind: 'NON_NULL',
+                    name: null,
+                    ofType: {
+                      kind: 'SCALAR',
+                      name: 'String',
+                      ofType: null,
+                    },
+                  },
+                },
+              ],
+            },
             {
               name: 'deprecated',
               locations: ['FIELD_DEFINITION', 'ENUM_VALUE'],

src/type/__tests__/introspection-test.js

@@ -14,6 +14,7 @@ import { validateSchema } from '../../type/validate';
 import {
   assertDirective,
   GraphQLSkipDirective,
+  GraphQLDeferDirective,
   GraphQLIncludeDirective,
   GraphQLDeprecatedDirective,
 } from '../../type/directives';
@@ -211,9 +212,10 @@ describe('Schema Builder', () => {
   it('Maintains @skip & @include', () => {
     const schema = buildSchema('type Query');
 
-    expect(schema.getDirectives()).to.have.lengthOf(3);
+    expect(schema.getDirectives()).to.have.lengthOf(4);
     expect(schema.getDirective('skip')).to.equal(GraphQLSkipDirective);
     expect(schema.getDirective('include')).to.equal(GraphQLIncludeDirective);
+    expect(schema.getDirective('defer')).to.equal(GraphQLDeferDirective);
     expect(schema.getDirective('deprecated')).to.equal(
       GraphQLDeprecatedDirective,
     );
@@ -224,27 +226,30 @@ describe('Schema Builder', () => {
       directive @skip on FIELD
       directive @include on FIELD
       directive @deprecated on FIELD_DEFINITION
+      directive @defer on FRAGMENT_SPREAD
     `);
 
-    expect(schema.getDirectives()).to.have.lengthOf(3);
+    expect(schema.getDirectives()).to.have.lengthOf(4);
     expect(schema.getDirective('skip')).to.not.equal(GraphQLSkipDirective);
     expect(schema.getDirective('include')).to.not.equal(
       GraphQLIncludeDirective,
     );
     expect(schema.getDirective('deprecated')).to.not.equal(
       GraphQLDeprecatedDirective,
     );
+    expect(schema.getDirective('defer')).to.not.equal(GraphQLDeferDirective);
   });
 
   it('Adding directives maintains @skip & @include', () => {
     const schema = buildSchema(`
       directive @foo(arg: Int) on FIELD
     `);
 
-    expect(schema.getDirectives()).to.have.lengthOf(4);
+    expect(schema.getDirectives()).to.have.lengthOf(5);
     expect(schema.getDirective('skip')).to.not.equal(undefined);
     expect(schema.getDirective('include')).to.not.equal(undefined);
     expect(schema.getDirective('deprecated')).to.not.equal(undefined);
+    expect(schema.getDirective('defer')).to.not.equal(undefined);
   });
 
   it('Type modifiers', () => {

src/utilities/__tests__/buildASTSchema-test.js

@@ -7,6 +7,7 @@ import { GraphQLSchema } from '../../type/schema';
 import {
   GraphQLSkipDirective,
   GraphQLIncludeDirective,
+  GraphQLDeferDirective,
   GraphQLDeprecatedDirective,
 } from '../../type/directives';
 
@@ -790,7 +791,11 @@ describe('findBreakingChanges', () => {
     const oldSchema = new GraphQLSchema({});
 
     const newSchema = new GraphQLSchema({
-      directives: [GraphQLSkipDirective, GraphQLIncludeDirective],
+      directives: [
+        GraphQLSkipDirective,
+        GraphQLIncludeDirective,
+        GraphQLDeferDirective,
+      ],
     });
 
     expect(findBreakingChanges(oldSchema, newSchema)).to.deep.equal([

src/utilities/__tests__/findBreakingChanges-test.js

@@ -590,6 +590,15 @@ describe('Type System Printer', () => {
         if: Boolean!
       ) on FIELD | FRAGMENT_SPREAD | INLINE_FRAGMENT
 
+      """Directs the executor to defer fragment when the \`if\` argument is true."""
+      directive @defer(
+        """Deferred when true."""
+        if: Boolean
+
+        """label"""
+        label: String!
+      ) on FRAGMENT_SPREAD
+
       """Marks an element of a GraphQL schema as no longer supported."""
       directive @deprecated(
         """
@@ -803,6 +812,15 @@ describe('Type System Printer', () => {
         if: Boolean!
       ) on FIELD | FRAGMENT_SPREAD | INLINE_FRAGMENT
 
+      # Directs the executor to defer fragment when the \`if\` argument is true.
+      directive @defer(
+        # Deferred when true.
+        if: Boolean
+
+        # label
+        label: String!
+      ) on FRAGMENT_SPREAD
+
       # Marks an element of a GraphQL schema as no longer supported.
       directive @deprecated(
         # Explains why this element was deprecated, usually also including a suggestion for how to access supported similar data. Formatted using the Markdown syntax, as specified by [CommonMark](https://commonmark.org/).

src/utilities/__tests__/schemaPrinter-test.js

@@ -61,6 +61,7 @@ describe('Validate: Known directives', () => {
         human @skip(if: false) {
           name
         }
+        ...DeferFrag @defer(if: true)
       }
     `);
   });
@@ -116,6 +117,8 @@ describe('Validate: Known directives', () => {
         ...Frag @include(if: true)
         skippedField @skip(if: true)
         ...SkippedFrag @skip(if: true)
+        ...DeferVarFrag @defer(if: $var)
+        ...DeferFrag @defer(if: true)
       }
 
       mutation Bar @onMutation {
@@ -135,7 +138,7 @@ describe('Validate: Known directives', () => {
   it('with misplaced directives', () => {
     expectErrors(`
       query Foo($var: Boolean) @include(if: true) {
-        name @onQuery @include(if: $var)
+        name @onQuery @include(if: $var) @defer(if: $var)
         ...Frag @onQuery
       }
 
@@ -151,6 +154,10 @@ describe('Validate: Known directives', () => {
         message: 'Directive "@onQuery" may not be used on FIELD.',
         locations: [{ line: 3, column: 14 }],
       },
+      {
+        message: 'Directive "@defer" may not be used on FIELD.',
+        locations: [{ line: 3, column: 42 }],
+      },
       {
         message: 'Directive "@onQuery" may not be used on FRAGMENT_SPREAD.',
         locations: [{ line: 4, column: 17 }],

src/validation/__tests__/KnownDirectives-test.js

@@ -227,6 +227,8 @@ describe('Validate: Provided required arguments', () => {
           human @skip(if: false) {
             name
           }
+          ...DeferFrag @defer(label: "DeferFrag_defer")
+          ...DeferIfFrag @defer(if: true, label: "DeferFrag_defer")
         }
       `);
     });
@@ -237,6 +239,7 @@ describe('Validate: Provided required arguments', () => {
           dog @include {
             name @skip
           }
+          ...DeferFrag @defer
         }
       `).to.deep.equal([
         {
@@ -249,6 +252,11 @@ describe('Validate: Provided required arguments', () => {
             'Directive "@skip" argument "if" of type "Boolean!" is required, but it was not provided.',
           locations: [{ line: 4, column: 18 }],
         },
+        {
+          message:
+            'Directive "@defer" argument "label" of type "String!" is required, but it was not provided.',
+          locations: [{ line: 6, column: 24 }],
+        },
       ]);
     });
   });

src/validation/__tests__/ProvidedRequiredArguments-test.js

@@ -11,6 +11,7 @@ import {
   GraphQLDirective,
   GraphQLIncludeDirective,
   GraphQLSkipDirective,
+  GraphQLDeferDirective,
 } from '../../type/directives';
 import {
   GraphQLInt,
@@ -362,6 +363,7 @@ export const testSchema = new GraphQLSchema({
   directives: [
     GraphQLIncludeDirective,
     GraphQLSkipDirective,
+    GraphQLDeferDirective,
     new GraphQLDirective({
       name: 'onQuery',
       locations: ['QUERY'],