Skip to content

Commit

Permalink
replace server with service
Browse files Browse the repository at this point in the history
  • Loading branch information
robrichard committed Jan 15, 2023
1 parent 79da712 commit 8df13da
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 11 deletions.
14 changes: 7 additions & 7 deletions spec/Section 3 -- Type System.md
Original file line number Diff line number Diff line change
Expand Up @@ -2163,8 +2163,8 @@ fragment someFragment on User {
omitted.
- `label: String` - May be used by GraphQL clients to identify the data from
responses and associate it with the corresponding defer directive. If
provided, the GraphQL Server must add it to the corresponding payload. `label`
must be unique label across all `@defer` and `@stream` directives in a
provided, the GraphQL service must add it to the corresponding payload.
`label` must be unique label across all `@defer` and `@stream` directives in a
document. `label` must not be provided as a variable.

### @stream
Expand Down Expand Up @@ -2200,19 +2200,19 @@ query myQuery($shouldStream: Boolean) {
when omitted.
- `label: String` - May be used by GraphQL clients to identify the data from
responses and associate it with the corresponding stream directive. If
provided, the GraphQL Server must add it to the corresponding payload. `label`
must be unique label across all `@defer` and `@stream` directives in a
provided, the GraphQL service must add it to the corresponding payload.
`label` must be unique label across all `@defer` and `@stream` directives in a
document. `label` must not be provided as a variable.
- `initialCount: Int` - The number of list items the server should return as
- `initialCount: Int` - The number of list items the service should return as
part of the initial response. If omitted, defaults to `0`. A field error will
be raised if the value of this argument is less than `0`.

Note: The ability to defer and/or stream parts of a response can have a
potentially significant impact on application performance. Developers generally
need clear, predictable control over their application's performance. It is
highly recommended that GraphQL servers honor the `@defer` and `@stream`
highly recommended that GraphQL services honor the `@defer` and `@stream`
directives on each execution. However, the specification allows advanced use
cases where the server can determine that it is more performant to not defer
cases where the service can determine that it is more performant to not defer
and/or stream. Therefore, GraphQL clients _must_ be able to process a response
that ignores the `@defer` and/or `@stream` directives. This also applies to the
`initialCount` argument on the `@stream` directive. Clients _must_ be able to
Expand Down
8 changes: 4 additions & 4 deletions spec/Section 7 -- Response.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,10 +39,10 @@ all but the last response in the stream. The value of this entry is `false` for
the last response of the stream. This entry must not be present for GraphQL
operations that return a single response map.

The GraphQL server may determine there are no more values in the response stream
after a previous value with `hasNext` equal to `true` has been emitted. In this
case the last value in the response stream should be a map without `data` and
`incremental` entries, and a `hasNext` entry with a value of `false`.
The GraphQL service may determine there are no more values in the response
stream after a previous value with `hasNext` equal to `true` has been emitted.
In this case the last value in the response stream should be a map without
`data` and `incremental` entries, and a `hasNext` entry with a value of `false`.

The response map may also contain an entry with key `extensions`. This entry, if
set, must have a map as its value. This entry is reserved for implementors to
Expand Down

0 comments on commit 8df13da

Please sign in to comment.