GraphQL: Non-nullable array/list

Non-null means exactly what it sounds like -- not null. An empty array is not null -- it's still returning a value.

Here is a summary table:

declaration accepts: | null | []   | [null] | [{foo: 'BAR'}]
------------------------------------------------------------------------
[Vote!]!             | no   | yes  | no     | yes
[Vote]!              | no   | yes  | yes    | yes
[Vote!]              | yes  | yes  | no     | yes
[Vote]               | yes  | yes  | yes    | yes

[Vote!]! means that the field (in this case votes) cannot return null and that it must resolve to an array and that none of the individuals items inside that array can be null. So [] and [{}] and [{foo: 'BAR'}] would all be valid (assuming foo is non-null). However, the following would throw: [{foo: 'BAR'}, null]

[Vote]! means that the field cannot return null, but any individual item in the returned list can be null.

[Vote!] means that the entire field can be null, but if it does return a value, it needs to an array and each item in that array cannot be null.

[Vote] means that the entire field can be null, but if it does return a value, it needs to an array. However, any member of the array may also be null.

If you need to verify whether an array is empty, you have to do so within your resolver logic. If you want GraphQL to still throw when an array is empty, just have your resolver return a rejected Promise.

For more information your can read the list and non-null section of the GraphQL introduction or take a look at the spec.