October2016
版本发布时间: 2016-11-01 06:08:37
graphql/graphql-spec最新发布版本:October2021(2021-10-27 08:01:28)
http://facebook.github.io/graphql/October2016/
GraphQL is a working draft specification, initially released as a technical preview. In September 2016 the technical preview verbiage was removed [ba1bbe5] in recognition of GraphQL being used in production by companies large and small.
The October 2016 edition of the GraphQL specification is the first since this announcement and represents the latest draft of the specification. It is also the first in a planned 6-month release cycle.
Many thanks to everyone who contributed to this release.
All commits since last release
New/Breaking:
These are syntactic rules or semantic behavior which are different from the previous version. GraphQL service libraries should ensure these incorporated.
- [#229] New Validation Rule: Unique directives per location.
- [#83] New Literal Value:
null
. - [#221] Arguments enforce Non-Null types with field errors, and Variables and
Arguments distinguish between
null
and not-provided when applying default values. - [#191] JSON object serialization should order keys in a predictable way.
Clarifying:
These are clarifications and improvements to the specification which in many cases make ambiguous sections more explicit. GraphQL service libraries should check to ensure their behavior matches the specifiction.
- [c9b6827] Better explanation of interpreting escape sequences in strings.
- [f42dab5] Explain when build-in scalars can be omitted from a schema.
- [79caa41] Use
U+1234
instead of0x1234
to refer to unicode code points. - [#221] Adds full algorithm definitions for Execution.
- [#219] Ensure
|
is included as a possible Punctuator. - [#213] Clarify how to coerce
null
for List types. - [#177] Fix issue with value completion for objects with sub-selections.
- [0599414] Object and Interfaces must declare at least one field.
- [7c36326] Removed reference to experimental subscriptions feature.
Note: Many grammar and consistency commits were provided by the community, but only changes notable for their clarification of ambiguity were listed.