Skip to content

Commit

Permalink
update with links and other edits
Browse files Browse the repository at this point in the history
  • Loading branch information
yaacovCR committed Sep 23, 2024
1 parent 87fe01b commit de16985
Showing 1 changed file with 16 additions and 6 deletions.
22 changes: 16 additions & 6 deletions website/docs/tutorials/whats-new-in-graphql-js-v17.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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()`.

0 comments on commit de16985

Please sign in to comment.