Skip to content

Commit 5cd2861

Browse files
committed
Be more explicit about the data that makes up a GraphQL request
1 parent 33c7fff commit 5cd2861

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

spec/Section 6 -- Execution.md

+6-4
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,13 @@ A GraphQL service generates a response from a request via execution.
1515
being executed. Conceptually, an initial value represents the "universe" of
1616
data available via a GraphQL Service. It is common for a GraphQL Service to
1717
always use the same initial value for every request.
18+
- {extensions} (optional): A map reserved for implementers to extend the
19+
protocol however they see fit.
1820

19-
The request may also contain an `extensions` entry. This entry, if set, must
20-
have a map as its value. This entry is reserved for implementors to extend the
21-
protocol however they see fit, and hence there are no additional restrictions on
22-
its contents.
21+
Note: Since {extensions} is reserved for implementers, the only requirement is
22+
that, if present, it is a map. There are no additional restrictions on its
23+
contents. It is recommended that implementers use prefixes in {extensions} keys
24+
to avoid conflicts with other implementers.
2325

2426
Given this information, the result of {ExecuteRequest(schema, document,
2527
operationName, variableValues, initialValue)} produces the response, to be

0 commit comments

Comments
 (0)