graphql-spec
graphql-spec copied to clipboard
graphql
GraphQL is a query language and execution engine tied to any backend service.
Consider the following _currently valid_ schema and query: ```graphql type Query { sum(numbers:[Int!]!): Int } query Q ($number: Int = 3) { sum(numbers: [1, $number, 3]) } ``` With the...
It would be nice if you could somehow make resolving conditional whether i request subfieds at all: ExampleData: ``` vehicleData = [ { licenseplate: "AB-CD123", customerNo: "1234" }, ... ]...
References (soft aliases?) are an alternative syntax for fragment metafields such as `__fulfilled` The goal is to create an easily manageable way of requesting different types of fragment spread signals....
This is small addition to the JSON serialization section with the goal to clarify how JSON values should be decoded into GraphQL values for variable values. I believe we have...
I'm a bit confused about MapSourceToResponseEvent in the execution specification for subscriptions. It explains how to map a `sourceStream` to a `responseStream`. Instead of specifying the behavior in case `sourceStream`...
The Validation section for Directive types is a little out of step with the validation sections for the other types. In particular, while the grammar definition of Directive requires one...
For legibility and consistency reasons, it's helpful if the order of unordered collections is maintained. For example, an enum describes a set (unordered) of possible values, but it would be...
The spec uses the terms "set", "list" and "map" in many places. This PR defines these terms and their conformance requirements. This is a change extracted from #1063 as discussed...
This PR adds names for each of the "pieces of information" that make up an execution request, and then shows how these values are passed into the `ExecuteRequest()` algorithm. This...
We spell it both "implementors" and "implementers" which makes searching for the term annoying. Apparently implementers is the modern spelling with a 4:1 ratio over implementors ([Oxford Dictionary](https://trends.google.com/trends/explore?q=implementor,implementer&hl=en), [Google Trends](https://trends.google.com/trends/explore?q=implementor,implementer&hl=en)),...