Skip to content

Commit 7e54331

Browse files
committed
update with links and other edits
1 parent 895353c commit 7e54331

File tree

1 file changed

+16
-6
lines changed

1 file changed

+16
-6
lines changed

website/docs/tutorials/whats-new-in-graphql-js-v17.md

+16-6
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,35 @@
1-
# What's New in graphql-js v17?
1+
# What's New in `graphql-js` v17?
22

3-
## Specification Changes
3+
## Changes by Way of the Specification
44

55
### New Experimental Features
66

77
#### Experimental Support for Incremental Delivery
88

9+
- [Spec PR](https://github.com/graphql/graphql-spec/pull/1110) / [RFC](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md)
910
- enabled only when using `experimentalExecuteIncrementally()`, use of a schema or operation with `@defer`/`@stream` directives within `execute()` will now throw.
1011
- enable early execution with the new `enableEarlyExecution` configuration option for `experimentalExecuteIncrementally()`.
1112

1213
#### Experimental Support for Fragment Arguments
1314

15+
- [Spec PR](https://github.com/graphql/graphql-spec/pull/1081) / [RFC](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md)
1416
- enable with the new `experimentalFragmentArguments` configuration option for `parse()`.
1517
- new experimental `Kind.FRAGMENT_ARGUMENT` for visiting
1618
- new experimental `TypeInfo` methods and options for handling fragment arguments.
1719
- coerce AST via new function `coerceInputLiteral()` with experimental fragment variables argument (as opposed to deprecated `valueFromAST()` function).
1820

19-
### Clarifications
21+
### Specification Clarifications
2022

21-
- Fix ambiguity around when schema definition may be omitted (#3839)
22-
- No reusing root types (#3453)
23+
#### Fix ambiguity around when schema definition may be omitted
24+
25+
- [Spec PR](https://github.com/graphql/graphql-spec/pull/987)
26+
- Schema definition will include only the proper root types.
27+
28+
### Implementation Fixes
29+
30+
#### Enforcing uniqueness of root types
31+
32+
- `graphql-js` now properly enforces that the schema's root types must be unique.
2333

2434
## New API features
2535

@@ -48,5 +58,5 @@
4858
- Remove deprecated positional arguments for the `GraphQLError` constructor.
4959
- Remove deprecated distinct Enum types: `KindEnum`, `TokenKindEnum`, and `DirectiveLocationEnum`.
5060
- Remove deprecated `getVisitFn()` helper function, use `getEnterLeaveForKind()` instead.
51-
- Remove deprecated `formatError()` and `printError()` helper sfunctions, use `error.toString()` and `error.toJSON()` methods instead.
61+
- Remove deprecated `formatError()` and `printError()` helper functions, use `error.toString()` and `error.toJSON()` methods instead.
5262
- Remove deprecated positional arguments for `createSourceEventStream()`.

0 commit comments

Comments
 (0)