From de169850e17ba6a33326b9375c2da9357a6f7a60 Mon Sep 17 00:00:00 2001 From: Yaacov Rydzinski Date: Mon, 23 Sep 2024 13:57:50 +0300 Subject: [PATCH] update with links and other edits --- .../tutorials/whats-new-in-graphql-js-v17.md | 22 ++++++++++++++----- 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/website/docs/tutorials/whats-new-in-graphql-js-v17.md b/website/docs/tutorials/whats-new-in-graphql-js-v17.md index b90505bdb7..95350e34ab 100644 --- a/website/docs/tutorials/whats-new-in-graphql-js-v17.md +++ b/website/docs/tutorials/whats-new-in-graphql-js-v17.md @@ -1,25 +1,35 @@ -# What's New in graphql-js v17? +# What's New in `graphql-js` v17? -## Specification Changes +## Changes by Way of the Specification ### New Experimental Features #### Experimental Support for Incremental Delivery +- [Spec PR](https://github.com/graphql/graphql-spec/pull/1110) / [RFC](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) - enabled only when using `experimentalExecuteIncrementally()`, use of a schema or operation with `@defer`/`@stream` directives within `execute()` will now throw. - enable early execution with the new `enableEarlyExecution` configuration option for `experimentalExecuteIncrementally()`. #### Experimental Support for Fragment Arguments +- [Spec PR](https://github.com/graphql/graphql-spec/pull/1081) / [RFC](https://github.com/graphql/graphql-wg/blob/main/rfcs/DeferStream.md) - enable with the new `experimentalFragmentArguments` configuration option for `parse()`. - new experimental `Kind.FRAGMENT_ARGUMENT` for visiting - new experimental `TypeInfo` methods and options for handling fragment arguments. - coerce AST via new function `coerceInputLiteral()` with experimental fragment variables argument (as opposed to deprecated `valueFromAST()` function). -### Clarifications +### Specification Clarifications -- Fix ambiguity around when schema definition may be omitted (#3839) -- No reusing root types (#3453) +#### Fix ambiguity around when schema definition may be omitted + +- [Spec PR](https://github.com/graphql/graphql-spec/pull/987) +- Schema definition will include only the proper root types. + +### Implementation Fixes + +#### Enforcing uniqueness of root types + +- `graphql-js` now properly enforces that the schema's root types must be unique. ## New API features @@ -48,5 +58,5 @@ - Remove deprecated positional arguments for the `GraphQLError` constructor. - Remove deprecated distinct Enum types: `KindEnum`, `TokenKindEnum`, and `DirectiveLocationEnum`. - Remove deprecated `getVisitFn()` helper function, use `getEnterLeaveForKind()` instead. -- Remove deprecated `formatError()` and `printError()` helper sfunctions, use `error.toString()` and `error.toJSON()` methods instead. +- Remove deprecated `formatError()` and `printError()` helper functions, use `error.toString()` and `error.toJSON()` methods instead. - Remove deprecated positional arguments for `createSourceEventStream()`.