Skip to content

Commit 586cbed

Browse files
benjieleebyron
andauthored
Add 'extensions' to request (#976)
* Add 'extensions' to request * Be more explicit about the data that makes up a GraphQL request * Reword * Reword again * Reword once more * Update Section 6 -- Execution.md editorial formatting --------- Co-authored-by: Lee Byron <[email protected]>
1 parent 4390617 commit 586cbed

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

Diff for: spec/Section 6 -- Execution.md

+9
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,20 @@ 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 implementation-specific additional
19+
information.
1820

1921
Given this information, the result of {ExecuteRequest(schema, document,
2022
operationName, variableValues, initialValue)} produces the response, to be
2123
formatted according to the Response section below.
2224

25+
Implementations should not add additional properties to a _request_, which may
26+
conflict with future editions of the GraphQL specification. Instead,
27+
{extensions} provides a reserved location for implementation-specific additional
28+
information. If present, {extensions} must be a map, but there are no additional
29+
restrictions on its contents. To avoid conflicts, keys should use unique
30+
prefixes.
31+
2332
Note: GraphQL requests do not require any specific serialization format or
2433
transport mechanism. Message serialization and transport mechanisms should be
2534
chosen by the implementing service.

0 commit comments

Comments
 (0)