npm · #1070 most downloaded on npm

graphql

17.0.2201M downloads/mographql/graphql-js ↗New releases in your daily digest, changelog included.

A Query Language and Runtime which can target any service.

Last release 1 months ago
28 Aug 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 44 of 45 stable releases
216 versions withdrawn
withdrawn after publishing
12 years old
300 releases · first in 2015

Release timeline

300 releases since 2015

2015201720192021

Releases

17.0.23 Jul 2026
v17.0.2 (2026-07-03) Bug Fix 🐞 #4832 fix: detect default-value changes on input object fields ( @spokodev ) Polish 💅 #4829 fix(mapSchemaConfig): fix c
v17.0.2 (2026-07-03)

Bug Fix 🐞

#4832 fix: detect default-value changes on input object fields (@spokodev)

Polish 💅

#4829 fix(mapSchemaConfig): fix context for schema argument mapper (@yaacovCR)

Committers: 2

null(@spokodev)

Yaacov Rydzinski (@yaacovCR)
Open source →
Additional notes
v17.0.2 Latest

Latest

Compare

Choose a tag to compare

Open source →
17.0.1

One column per quarter.

v17.0.1 (2026-06-16) Bug Fix 🐞 #4824 fix(diagnostics): emit asyncStart after promise settlement to match native tracePromise ( @logaretm ) Internal 🏠

v17.0.1 (2026-06-16)

Bug Fix 🐞

#4824 fix(diagnostics): emit asyncStart after promise settlement to match native tracePromise (@logaretm)

Internal 🏠

2 PRs were merged

#4823 chore(npm): remove obsolete ESM-only package build (@yaacovCR)
#4825 chore(release): protect latest release channels (@yaacovCR)

Committers: 2

Abdelrahman Awad(@logaretm)
Yaacov Rydzinski (@yaacovCR)

Open source →

Additional notes

v17.0.1

Compare

Choose a tag to compare

Open source →

17.0.015 Jun 2026

v17.0.0 (2026-06-15) New Feature 🚀 #4819 feat: graduate directives on directives ( @yaacovCR ) Bug Fix 🐞 #4799 fix: raise request error on invalid fra

v17.0.0 (2026-06-15)

New Feature 🚀

#4819 feat: graduate directives on directives (@yaacovCR)

Bug Fix 🐞

#4799 fix: raise request error on invalid fragment variables (@yaacovCR)
#4800 fix: apply directives when SDL contains type definitions and extensions with directives (@yaacovCR)
#4564 OneOf Inhabitability (@jbellenger)
#4814 fix(KnownDirectivesRule): locations for input field arguments in extensions (@yaacovCR)
#4726 feat(validation): reject directive definition cycles (@yaacovCR)
#4815 Revert "feat(validation): reject directive definition cycles (#4726)" (@yaacovCR)

Docs 📝

11 PRs were merged

#4790 docs: minor diagnostics doc comment improvements (@yaacovCR)
#4791 fix: docs: polish diagnostics comments further (@yaacovCR)
#4793 docs: further improve general execution and tracing docs (@yaacovCR)
#4802 docs: correct extension field comments - v17 (@yaacovCR)
#4805 docs: publish fixed extensions comments (@yaacovCR)
#4807 docs: add prettier for jsdoc examples (@yaacovCR)
#4435 Subscriptions docs suggestions (@Urigo)
#4811 docs: fix a few indentations inside string literals (@yaacovCR)
#4813 internal: docs update (@yaacovCR)
#4820 docs: document @experimental_disableErrorPropagation (@yaacovCR)
#4817 docs: post 17.rc-0 update (@yaacovCR)

Polish 💅

2 PRs were merged

#4809 internal: use prettier for non-generated website files (@yaacovCR)
#4812 polish: fix stream test cases (@yaacovCR)

Internal 🏠

6 PRs were merged

#4795 chore: move website publishing from 16.x.x to 17.x.x (@yaacovCR)
#4796 internal: fix broken npm/deno deployments (@yaacovCR)
#4797 ci: update GitHub Actions versions (@yaacovCR)
#4806 internal: update frontmatter (@yaacovCR)
#4808 intenral: fix ci badge (@yaacovCR)
#4810 internal: add prettier:examples to lint-staged (@yaacovCR)

Committers: 3

James Bellenger(@jbellenger)
Uri Goldshtein(@Urigo)
Yaacov Rydzinski (@yaacovCR)

Open source →

Additional notes

v17.0.0

Compare

Choose a tag to compare

Open source →

17.0.0-rc.02 Jun 2026pre-release

v17.0.0-rc.0 (2026-06-02) New Feature 🚀 #4670 feat(v17): Implement tracing channels ( @logaretm ) Bug Fix 🐞 #4761 fix: DeferStreamDirectiveOnRootField

v17.0.0-rc.0 (2026-06-02)

New Feature 🚀

#4670 feat(v17): Implement tracing channels (@logaretm)

Bug Fix 🐞

#4761 fix: DeferStreamDirectiveOnRootField forbids fragments on abstract types (@robrichard)
#4762 fix: DeferStreamDirectiveOnValidOperations fragment tracking (@robrichard)
#4784 fix: do not copy over stack from error cause (@Malien)

Docs 📝

#4781 docs: improve deprecation information regarding originalError and cause (@yaacovCR)

Committers: 4

Abdelrahman Awad(@logaretm)
Rob Richard(@robrichard)
Yaacov Rydzinski (@yaacovCR)
Yaroslav Petryk(@Malien)

Open source →

Additional notes

v17.0.0-rc.0 Pre-release

Pre-release

Compare

Choose a tag to compare

Open source →

17.0.0-beta.21 Jun 2026pre-release

v17.0.0-beta.2 (2026-06-02) Breaking Change 💥 #4751 build: strip private discriminator from package types ( @yaacovCR ) #4752 fix: discriminate betwee

v17.0.0-beta.2 (2026-06-02)

Breaking Change 💥

#4751 build: strip private discriminator from package types (@yaacovCR)
#4752 fix: discriminate between GraphQLNonNull and GraphQLList (@yaacovCR)
#4770 refactor: extract ExecutionArgs types to separate file (@yaacovCR)

New Feature 🚀

#4485 Adopt Error.cause in favor of originalError (@Malien)

Bug Fix 🐞

#4739 chore(tests): add test for directive extensions without flag enabled (#4738) (@yaacovCR)
#4743 api: export VariableValues (@yaacovCR)
#4744 api: export ValidationOptions (@yaacovCR)
#4745 api: export SchemaChange (@yaacovCR)
#4746 api: export defer and stream validation rules (@yaacovCR)
#4747 api: export legacy incremental execution functions and helpers (@yaacovCR)
#4753 fix(build): development declaration stubs (@yaacovCR)
#4773 fix: FragmentVariableValueSource.value can be non-constant (@yaacovCR)
#4775 fix: remove unnecessary native promise coercion (@yaacovCR)

Docs 📝

3 PRs were merged

#4742 docs: add v17 API docs lint coverage (@yaacovCR)
#4756 docs: hide private internals schema.__validationErrors and inputValue._memoizedCoercedDefaultValue (@yaacovCR)
#4758 docs: fix inline examples, deprecation descriptions, type category (@yaacovCR)

Polish 💅

#4774 test: restore GraphQLError no-stack coverage (@yaacovCR)

Internal 🏠

3 PRs were merged

#4771 internal: drop node 20 integration tests (@yaacovCR)
#4772 internal: add deno 2.8.x to CI (@yaacovCR)
#4777 fix: preserve generated version documentation (@yaacovCR)

Committers: 2

Yaacov Rydzinski (@yaacovCR)
Yaroslav Petryk(@Malien)

Open source →

Additional notes

v17.0.0-beta.2 Pre-release

Pre-release

Compare

Choose a tag to compare

Open source →

17.0.0-beta.110 May 2026pre-release

v17.0.0-beta.1 (2026-05-10) Breaking Change 💥 #4729 subscribe: replace perEventExecutor with mapSourceToResponseEvent ( @yaacovCR ) #4730 chore(engine

v17.0.0-beta.1 (2026-05-10)

Breaking Change 💥

#4729 subscribe: replace perEventExecutor with mapSourceToResponseEvent (@yaacovCR)
#4730 chore(engines): drop Node 20 support (@yaacovCR)
#4731 refactor(execution): extract buildResolveInfo helper (@yaacovCR)

New Feature 🚀

#4733 feat: support node v26 (@yaacovCR)

Bug Fix 🐞

#4725 chore: forward-port directives on directive definitions (#4521) (@yaacovCR)
#4727 chore: forward-port configuration of the ofType introspection depth (#4317) (@yaacovCR)

Polish 💅

#4728 polish: group FRAGMENT_VARIABLE_DEFINITION with executable defs (@yaacovCR)

Internal 🏠

3 PRs were merged

#4460 internal: use node experimental-strip-types instead of ts-node (@yaacovCR)
#4732 internal: use node test instead of mocha + c8 (@yaacovCR)
#4734 internal: add comment re: rewriteRelativeImportExtensions (@yaacovCR)

Committers: 1

Yaacov Rydzinski (@yaacovCR)

Open source →

Additional notes

v17.0.0-beta.1 Pre-release

Pre-release

Compare

Choose a tag to compare

Open source →

17.0.0-beta.07 May 2026pre-release

Abishek Kumar Giri( @abishekgiri )

v17.0.0-beta.0 (2026-05-07)

Breaking Change 💥

#4634 Use Object.create(null) over {} to avoid prototype issues (@benjie)
#4700 Demote createSourceEventStream to helper taking ValidatedExecutionArgs (@yaacovCR)
#4703 rename executeQueryOrMutationOrSubscriptionEvent to executeRootSelectionSet (@yaacovCR)
#4708 fix(variables): treat undefined as absent with respect to variables (@yaacovCR)
#4710 fix: ignore undefined-valued unknown fields in input objects (@yaacovCR)

New Feature 🚀

#4658 feat(execution): expose asyncWorkFinished execution hook (@yaacovCR)
#4674 feat(execution): expose partial result on abort errors (@yaacovCR)
#4701 export validateExecutionArgs helper (@yaacovCR)
#4702 feat: add ValidatedSubscriptionArgs and validateSubscriptionArgs (@yaacovCR)

Bug Fix 🐞

#4637 refactor(queue): replace stopped promise with onStop handlers (@yaacovCR)
#4641 refactor(incremental): close stream iterator only on abnormal stop (@yaacovCR)
#4642 fix(incremental): await async incremental cleanup (@yaacovCR)
#4644 fix(withConcurrentAbruptClose): do not close unnecessarily (@yaacovCR)
#4645 fix(cancellablePromise): handle rejection when cancelling already-aborted promise (@yaacovCR)
#4643 fix(execute): handle list promise rejections (@yaacovCR)
#4646 fix(execute): handle defaultTypeResolver promise rejections (@yaacovCR)
#4648 refactor(executor): separate finish/abort orchestration (@yaacovCR)
#4655 fix(execution): finish executors before publishing responses (@yaacovCR)
#4661 fix: bubbling sync errors need not become async (@yaacovCR)
#4663 fix(executor): let aborted async paths reach finish (@yaacovCR)
#4657 refactor(execution): track pending work (@yaacovCR)
#4664 fix(perf): hoist error creation (@yaacovCR)
#4665 execution: reduce parent executor retention in incremental callbacks (@yaacovCR)
#4671 fix(valueFromAST): forward port #4652 (@yaacovCR)
#4672 fix(execution): convert all promise-like results to promises (@yaacovCR)
#4518 Fix TypeInfo.getInputType() for custom scalar list literals. (@yuchenshi)
#4692 fix incremental label null validation (@jbellenger)
#4711 fix(coerceInputLiteral): null variable input object fields should override defaults (@yaacovCR)
#4712 fix: name fragment variables as such in execution errors (@yaacovCR)
#4714 fix: enhance runtime invalid default value error messages (@yaacovCR)
#4715 unify OneOf non-null and count error messages (@yaacovCR)
#4716 fix(OneOf): fail coercion when two fields are provided "pre-coercion-only" (@yaacovCR)
#4717 fix(valueFromAST): reject unknown input object fields (@yaacovCR)
#4718 fix(OneOf): count only known fields for one-of validation (@yaacovCR)
#4719 fix(OneOf): fail coercion for OneOf is the single field is invalidly provided by a default (@yaacovCR)

Polish 💅

19 PRs were merged

#4635 polish: remove a few superfluous awaits (@yaacovCR)
#4636 allow forwarding of cancellation reasons within computations/queues (@yaacovCR)
#4638 test(queue): cover async onStop cleanup (@yaacovCR)
#4639 refactor(computation): rename cancel to abort (@yaacovCR)
#4640 refactor(workqueue): propagate async computation abort cleanup (@yaacovCR)
#4647 refactor(executor): rename finished state to aborted (@yaacovCR)
#4649 refactor(cancellablePromise): extract withCancellation (@yaacovCR)
#4650 refactor(executor): replace internal abort signal with lightweight version (@yaacovCR)
#4656 refactor(execution): introduce shared execution context (@yaacovCR)
#4653 fix: avoid prototype-colliding names in execution values (@abishekgiri)
#4673 refactor(execution): separate response construction from finish checks (@yaacovCR)
#4675 polish(execution): remove obsolete abort async checks (@yaacovCR)
#4686 refactor(benchmark): extract shared mean stats helper (@yaacovCR)
#4687 polish(benchmark): handle theoretical stats errors (@yaacovCR)
#4693 polish: add expectToThrow test helper (@yaacovCR)
#4694 polish: add expectPromise.toReject helper (@yaacovCR)
#4695 polish: clean up stream tests (@yaacovCR)
#4696 polish: introduce spy test helper (@yaacovCR)
#4704 refactor: add executionMode/serially argument to executeRootSelectionSet (@yaacovCR)

Internal 🏠

17 PRs were merged

#4676 chore(deps): upgrade to ts v6 (@yaacovCR)
#4677 internal: refactor benchmark runner structure (@yaacovCR)
#4678 internal: run benchmarks through worker files (@yaacovCR)
#4679 internal: read benchmark names through dedicated worker (@yaacovCR)
#4680 internal: separate benchmark timing and memory sampling (@yaacovCR)
#4681 fix(benchmark): use node flags only for memory sampling (@yaacovCR)
#4682 internal: use mitata for benchmark timing (@yaacovCR)
#4683 refactor(benchmark): integrate run + sampling files (@yaacovCR)
#4684 benchmark: perform timing tests in rounds to reduce variance (@yaacovCR)
#4685 benchmark: stop timing after stable pairwise comparisons (@yaacovCR)
#4688 benchmark: cache revision archives (@yaacovCR)
#4689 benchmark: report paired benchmark comparisons (@yaacovCR)
#4690 benchmark: add async object field benchmark (@yaacovCR)
#4697 internal: add runtime option to benchmark (@yaacovCR)
#4713 benchmark: add benchmark for schema validation (@yaacovCR)
#4722 internal: npm release:prepare should set publishTag (@yaacovCR)
#4723 fix(changelog): ignore open associated PRs (@yaacovCR)

Committers: 5

Abishek Kumar Giri(@abishekgiri)
Benjie(@benjie)
James Bellenger(@jbellenger)
Yaacov Rydzinski (@yaacovCR)
Yuchen Shi(@yuchenshi)

Open source →

Additional notes

v17.0.0-beta.0 Pre-release

Pre-release

Compare

Choose a tag to compare

Open source →

17.0.0-alpha.1411 Mar 2026pre-release

First released published to jsr.io.

v17.0.0-alpha.14 (2026-03-11)

First released published to jsr.io.

Internal 🏠

#4623 internal: satisfy stricter deno type/package checks (@yaacovCR)

Committers: 1

Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.1310 Mar 2026pre-release

## v17.0.0-alpha.13 (2026-03-10) #### Bug Fix 🐞 * #4619 polish: enable useUnknownInCatchVariables (@yaacovCR) #### Polish 💅 * #4621 polish: fix deno T

v17.0.0-alpha.13 (2026-03-10)

Bug Fix 🐞

#4619 polish: enable useUnknownInCatchVariables (@yaacovCR)

Polish 💅

#4621 polish: fix deno TS errors (@yaacovCR)

Internal 🏠

<details> <summary> 2 PRs were merged </summary>

#4618 fix package.json per build instructions (@yaacovCR)
#4620 internal: add type checking for deno dist (@yaacovCR) </details>

Committers: 1

Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.1210 Mar 2026pre-release

## v17.0.0-alpha.12 (2026-03-10) #### Internal 🏠 2 PRs were merged * #4615 internal: streamline release process (@yaacovCR (https://github.com/yaacovC

v17.0.0-alpha.12 (2026-03-10)

Internal 🏠

<details> <summary> 2 PRs were merged </summary>

#4615 internal: streamline release process ([@yaacovCR (https://github.com/yaacovCR))
#4616 internal: add JSR publish flow with deno prod/dev builds (@yaacovCR) </details>

Committers: 1

Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.112 Mar 2026pre-release

First release with trusted publishing and provenance, see: https://docs.npmjs.com/trusted-publishers for additional information.

v17.0.0-alpha.11 (2026-03-01)

First release with trusted publishing and provenance, see: https://docs.npmjs.com/trusted-publishers for additional information.

Internal 🏠

<details> <summary> 8 PRs were merged </summary>

#4599 add changesets to 17.x.x alpha (@yaacovCR)
#4600 pin node 25 to 25.6 (@yaacovCR)
#4601 internal: switch from changesets to simpler release automation (@yaacovCR)
#4603 internal: remove version/preversion scripts (@yaacovCR)
#4604 fix(changelog): adjust end-ref to not skip last PR (@yaacovCR)
#4605 lock down supported scenarios for gen-changelog (@yaacovCR)
#4606 internal: improve release workflow (@yaacovCR)
#4607 internal(release): checkout repo in extra steps (@yaacovCR) </details>

Committers: 1

Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.1024 Feb 2026pre-releaseBreaking

…rather than info.abortSignal, a BREAKING CHANGE from the previous alpha. The newest incremental delivery implementation has only new features compared…

v17.0.0-alpha.10 (2026-02-24)

Breaking Change 💥

NOTE: This release introduced new/refined implementations of incremental delivery and execution cancellation. The prior implementations were reverted and the new implementations were re-implemented from scratch, see PRs below. Importantly, the newest cancellation implementation exposes the AbortSignal to resolvers via info.getAbortSignal() rather than info.abortSignal, a BREAKING CHANGE from the previous alpha. The newest incremental delivery implementation has only new features compared to the prior alpha (primarily sensitivity to back-pressure).

#4447 chore: drop unsupported node versions (@yaacovCR)
#4464 use enableDevMode() or development condition instead of NODE_ENV (@yaacovCR)
#4537 Reference implementation of defer and stream spec (@yaacovCR)
#4536 Allow cancellation via abortSignal (@yaacovCR)
#4535 temporarily revert cancellation (@yaacovCR)
#4534 temporarily revert incremental delivery (@yaacovCR)
#4560 fix incremental types (@yaacovCR)
#3385 fix type for first argument to isTypeOf (@ryym)

New Feature 🚀

#4448 enable conditional exports (@yaacovCR)
#4468 predicates: replace instanceof with symbol based brand check (@yaacovCR)
#3044 Schema Coordinates (@leebyron)
#4546 introduce legacy incremental executor (@yaacovCR)
#4550 add bigint support (@yaacovCR)
#4561 let GraphQLArgs inherit all parse/validate/execute options (@yaacovCR)
#4562 add graphql "harness" abstraction along with async parse/validate support (@yaacovCR)
#4565 frontport #4482: Implement changes for executable descriptions (@yaacovCR)

Bug Fix 🐞

#4441 Ensure that 'schema' keyword kept when schema has description (@benjie)
#4462 avoid re-visiting deferred fragment spreads (@yaacovCR)
#4358 incremental: add new deferred fragments to the wrapped graphql result (@yaacovCR)
#4469 perf: do not use undefined for empty error array (@yaacovCR)
#4424 buildClientSchema: build enum type value maps lazily (@yaacovCR)
#4481 Fix incorrect FormattedCompletedResult fields and add a FormattedPendingResult (@jerelmiller)
#4495 chore: use latest npm lockfile metadata (@yaacovCR)
#4494 fix(mapAsyncIterable): always close source when mapped iterable is thrown (@yaacovCR)
#4496 refactor(execution): extract withCleanup from mapAsyncIterable (@yaacovCR)
#4497 fix(withCleanup): remove extra tick (@yaacovCR)
#4510 fix(Queue): calling stop should not drop pushed values (@yaacovCR)
#4520 incremental: improve perf of OverlappingFieldsCanBeMerged (@yaacovCR)
#4526 reduce ticks stemming from withCleanup (@yaacovCR)
#4531 refactor: move errorPropagation to ValidatedExecutionArgs (@yaacovCR)
#4533 add abrupt return handling for sync iterables (@yaacovCR)
#4544 fix inner stream with async iterables (@yaacovCR)
#4547 remove unnecessary Executor property (@yaacovCR)
#4548 fix: memoize collectSubfields and getStreamUsage across Executors (@yaacovCR)
#4554 use single phase of resolver abortSignal cancellation (@yaacovCR)
#4559 restore FormattedExperimentalIncrementalExecutionResults (@yaacovCR)
#4563 polish: improve GraphQL schema element config typing (@yaacovCR)
#4567 frontport: incorrect validation errors when variable descriptions are used (#4517) (@yaacovCR)
#4568 fix: treat dot as punctuator for schema coordinate parsing (@yaacovCR)
#4569 export all schema coordinate types (@yaacovCR)
#4572 add "as const" to schema change type "enum" (@yaacovCR)
#4583 validation: align MaxIntrospectionDepthRule with v16 backport (@yaacovCR)
#4596 chore(eslint): simplify ignore-pattern (@yaacovCR)

Docs 📝

<details> <summary> 3 PRs were merged </summary>

#4487 Remove subscription section from README (@NeoPhi)
#4577 Revert website on next to 16.x.x version (@yaacovCR)
#4590 align README with new dev mode (@yaacovCR) </details>

Polish 💅

<details> <summary> 35 PRs were merged </summary>

#4454 integrationTests: pin bun/deno versions (@yaacovCR)
#4459 upgrade dependencies (@yaacovCR)
#4472 docs: update dual-build information within README (@yaacovCR)
#4500 polish(withCleanup): condense one line (@yaacovCR)
#4499 refactor(mapAsyncIterable): use withCleanup to simplify (@yaacovCR)
#4498 refactor: extract Queue from IncrementalPublisher and IncrementalGraph (@yaacovCR)
#4501 polish(Queue): further simplify algorithm (@yaacovCR)
#4502 polish(IncrementalPublisher): introduce ensureId helper (@yaacovCR)
#4503 polish(IncrementalPublisher): simplify early return handling (@yaacovCR)
#4527 refactor(execution): add separate entrypoints file (@yaacovCR)
#4528 refactor(execute): minor refactor (@yaacovCR)
#4529 refactor: streamline variable name (@yaacovCR)
#4532 withConcurrentAbruptClose should await handlers (@yaacovCR)
#4538 rename execute.ts to Executor.ts file (@yaacovCR)
#4539 rename entrypoints.ts to execute.ts (@yaacovCR)
#4540 move subscription helpers from Executor to execute (@yaacovCR)
#4541 convert ExecutionContext interface and functions to Executor (@yaacovCR)
#4542 polish: clean up abort listener without checking hasNext (@yaacovCR)
#4543 extract getStreamUsage (@yaacovCR)
#4545 extract IncrementalExecutor from Executor (@yaacovCR)
#4549 streamline scalar coercion (@yaacovCR)
#4570 add tests for validateInputValue / validateInputLiteral (@yaacovCR)
#4571 add additional mapSchemaConfig tests (@yaacovCR)
#4573 valueFromAST: use nullish to simplify (@yaacovCR)
#4580 test(validation): add empty-selection case from 16.x.x backport (@yaacovCR)
#4581 test(validation): add OneOf variable tests from 16.x.x to next (@yaacovCR)
#4584 remove legacy comment (@yaacovCR)
#4585 align schema coordinates comments (@yaacovCR)
#4587 validation: add description-handling comment (@yaacovCR)
#4586 polish: align schema coordinate whitespace (@yaacovCR)
#4588 polish: reorder tests to match 16.x.x (@yaacovCR)
#4589 prune cspell file (@yaacovCR)
#4592 upgrade deps (@yaacovCR)
#4593 lint: add brackets to path (@yaacovCR)
#4595 test(execution): add additional tests from original PR #4458 (@yaacovCR) </details>

Internal 🏠

<details> <summary> 14 PRs were merged </summary>

#4446 add integration tests for dev/prod (@yaacovCR)
#4455 pin bun and deno versions within integration script (@yaacovCR)
#4457 internal: use swc with ts-node (@yaacovCR)
#4456 avoid spawn with shell: true and arguments (@yaacovCR)
#4465 increase memory allowance for benchmarks (@yaacovCR)
#4467 internal: revert formatting change (@yaacovCR)
#4471 chore: update module/moduleResolution settings (@yaacovCR)
#4566 frontport: update contributing (#4524) (@yaacovCR)
#4574 prune prettierignore (@yaacovCR)
#4575 remove old generated next folder from .gitignore (@yaacovCR)
#4576 frontport: chore: always ignore scripts (#4514) (@yaacovCR)
#4578 website: fix build (@yaacovCR)
#4579 Include website within main CI for lintiing (@yaacovCR)
#4591 add latest version of node to test matrix (@yaacovCR) </details>

Committers: 6

Benjie(@benjie)
Daniel Rinehart(@NeoPhi)
Jerel Miller(@jerelmiller)
Lee Byron(@leebyron)
Ryutaro Yamada(@ryym)
Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.911 Jun 2025pre-release

## v17.0.0-alpha.9 (2025-06-11) #### Breaking Change 💥 * #4342 Validate against @stream on different instances of the same field (@robrichard) * #3974

v17.0.0-alpha.9 (2025-06-11)

Breaking Change 💥

#4342 Validate against @stream on different instances of the same field (@robrichard)
#3974 Forbid @skip and @include directives in subscription root selection (@benjie)
#3986 Reject deprecated fields when interface field is not deprecated (@benjie)
#4354 Make includeDeprecated non-null (@martinbonnin)
#4425 feat: pass abortSignal to resolvers via GraphQLResolveInfo (@glasser)

New Feature 🚀

#4348 Add support for @experimental_disableErrorPropagation (@martinbonnin)

Bug Fix 🐞

#4389 fix(replaceVariables): preserve sources for fragment variable values (@yaacovCR)

Polish 💅

#4407 Minor validation tweaks from review (@benjie)

Internal 🏠

<details> <summary> 5 PRs were merged </summary>

#4355 Remove website from linting (@JoviDeCroock)
#4413 internal: refresh port of v16 work to next (@yaacovCR)
#4420 internal: frontport additional amazing docs work (@yaacovCR)
#4421 fix(benchmark): fix incorrect merge of original commit from v16 (@yaacovCR) </details>

Committers: 6

Benjie(@benjie)
David Glasser(@glasser)
Jovi De Croock(@JoviDeCroock)
Martin Bonnin(@martinbonnin)
Rob Richard(@robrichard)
Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.86 Feb 2025pre-release

## v17.0.0-alpha.8 (2025-01-14) #### Breaking Change 💥 * #3814 RFC: Default value validation & coercion (@yaacovCR) * #4288 introduce GraphQLField, Gr

v17.0.0-alpha.8 (2025-01-14)

Breaking Change 💥

#3814 RFC: Default value validation & coercion (@yaacovCR)
#4288 introduce GraphQLField, GraphQLInputField, GraphQLArgument, and GraphQLEnumValue (@yaacovCR)
#4296 ease upgrade path for programmatic default values (@yaacovCR)
#4322 Make @stream initialCount NonNull (@robrichard)

New Feature 🚀

#4261 feat: pass abortSignal to resolvers (@yaacovCR)
#4267 cancel execution despite hanging async resolvers (@yaacovCR)
#4263 stop resolvers after execution ends (@yaacovCR)
#4275 Add safe schema change for descriptions changing (@JoviDeCroock)
#4277 Detect directive argument changes (@JoviDeCroock)
#4274 add cancellation support to async iterable iteration (@yaacovCR)
#3601 Add KnownOperationTypes rule (@yaacovCR)

Bug Fix 🐞

#4299 Make deprecated.reason non-nullable (@martinbonnin)
#4313 type fix for ExperimentalIncrementalExecutionResults (@yaacovCR)

Polish 💅

<details> <summary> 13 PRs were merged </summary>

#4260 adjust prefix for toError (@yaacovCR)
#4265 use object for GraphQLWrappedResult instead of tuple (@yaacovCR)
#4254 Remove typescript enums in favor of plain JS/TS solution (@JoviDeCroock)
#4273 polish: refactor execution plan functions to match spec (@yaacovCR)
#4282 rename PromiseCanceller to AbortSignalListener (@yaacovCR)
#4294 polish: fix lexer state comment (@yaacovCR)
#4270 refactor: treeshakable kind enum (@jasonkuhrt)
#4297 introduces mapSchemaConfig utility function (@yaacovCR)
#4306 polish: fix switched comments in GraphQLScalarTypeConfig (@hayes)
#4308 move subscription @defer check out of collectFields (@yaacovCR)
#4309 use operation.selectionSet as argument to collectFields() instead of operation (@yaacovCR)
#4307 update validateInputValue to use renamed method (@yaacovCR)
#4320 polish: skip recollecting a named fragment's selections even when deferred (@yaacovCR) </details>

Internal 🏠

<details> <summary> 2 PRs were merged </summary>

#4304 internal: update CONTRIBUTING guide (@yaacovCR)
#4301 frontport v16 work to main (@yaacovCR) </details>

Committers: 6

Jason Kuhrt(@jasonkuhrt)
Jovi De Croock(@JoviDeCroock)
Martin Bonnin(@martinbonnin)
Michael Hayes(@hayes)
Rob Richard(@robrichard)
Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.7.canary.pr.4319.e7cfada212d5cdd7dc09890bef82ac9da32026eb13 Jan 2025pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4319, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4319.abe5e8e0bb4a916f37d6d1b7fdcf128155a24a4621 Jan 2025pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4319, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4319.55799077dbb6c5ab0c33471482a66b91f048a51614 Jan 2025pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4319, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4319.09f8d400782ed385ec6f8fb9d151e221414af61314 Jan 2025pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4319, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4297.42bcd01f7c733e255ff9eab84ec8d7500dfd208a26 Nov 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4297, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4297.1ef860e11444e48f590000a92cfbe80a73ae715626 Nov 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4297, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4297.096937aa86603f461be857eae48d8b2061b39e2626 Nov 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4297, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4297.06006bf6f8de51bb2fa9e99caedfed1c1323603726 Nov 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4297, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.7.canary.pr.4288.b96419eebb37a65c76964ccd0994ab9d3b4e821513 Nov 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4288, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.714 Aug 2024pre-release

## v17.0.0-alpha.7 (2024-08-14) #### Bug Fix 🐞 * #4100 Require non-empty directive locations (@jbellenger) * #4125 Rename inputObjectOneOf to oneOf in

v17.0.0-alpha.7 (2024-08-14)

Bug Fix 🐞

#4100 Require non-empty directive locations (@jbellenger)
#4125 Rename inputObjectOneOf to oneOf in getIntrospectionQuery() (@benjie)
#4144 return async iterables in the non incremental delivery case (@yaacovCR)
#4140 fix(incremental): do not initiate non-pending execution groups (@yaacovCR)
#4160 fix(incremental): fix paths for subsequent async stream items (@yaacovCR)

Polish 💅

<details> <summary> 5 PRs were merged </summary>

#4108 polish(incremental): refactor getNewPending functionality (@yaacovCR)
#4112 refactor(incremental): simplify incremental graph by allowing mutations (@yaacovCR)
#4141 polish(incremental): small fixes (@yaacovCR)
#4147 incremental: optimize build field plan (@yaacovCR)
#4148 polish(incremental): rename terms to match spec (@yaacovCR) </details>

Internal 🏠

<details> <summary> 2 PRs were merged </summary>

#4130 chore: Tag GraphQL JS reviewers team for reviews on PRs (@saihaj)
#4162 chore(actions): upgrade to latest versions (@yaacovCR) </details>

Committers: 4

Benjie(@benjie)
James Bellenger(@jbellenger)
Saihajpreet Singh(@saihaj)
Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.613 Aug 2024pre-release

Nothing published for this version

17.0.0-alpha.5.canary.pr.4153.d5c18bebb93273daf40fce67daa1babc430a2ce213 Aug 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4153, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.5.canary.pr.4153.4ff43175428332c954563050819fcb612e19ca4113 Aug 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4153, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.521 Jun 2024pre-release

## v17.0.0-alpha.5 (2024-06-21) #### New Feature 🚀 * #4018 Enable passing values configuration to GraphQLEnumType as a thunk (@benjie) * #4078 Add @on

v17.0.0-alpha.5 (2024-06-21)

New Feature 🚀

#4018 Enable passing values configuration to GraphQLEnumType as a thunk (@benjie)
#4078 Add @oneOf support to introspection query (@maciesielka)

Committers: 2

Benjie(@benjie)
Mike Ciesielka(@maciesielka)

Open source →

17.0.0-alpha.421 Jun 2024pre-release

## v17.0.0-alpha.4 (2024-06-21) #### Breaking Change 💥 * #4097 incremental: disable early execution by default (@yaacovCR) #### New Feature 🚀 * #4002

v17.0.0-alpha.4 (2024-06-21)

Breaking Change 💥

#4097 incremental: disable early execution by default (@yaacovCR)

New Feature 🚀

#4002 allow nested defers at the same level (@yaacovCR)
#4118 Introduce "recommended" validation rules (@benjie)

Bug Fix 🐞

#3984 fix: suppress records for deferred fragments that are completely empty (@yaacovCR)
#3987 fix(incremental): fix logic around selecting id/subPath (@yaacovCR)
#3969 Add support for @oneOf directives in printSchema (@hayes)
#3993 fix(incremental): skip all empty subsequent results (@yaacovCR)
#4044 Fix stream directive validation error message (@Cito)

Docs 📝

#4105 Update release instructions in CONTRIBUTING.md (@benjie)

Polish 💅

<details> <summary> 15 PRs were merged </summary>

#3970 tests: remove empty strings in string literals (@IvanGoncharov)
#3994 simplify CollectFields for @defer and @stream (@yaacovCR)
#4045 rename executeImpl to executeOperation (@yaacovCR)
#4026 incremental: introduce GraphQLWrappedResult to avoid filtering (@yaacovCR)
#4050 perf: allow skipping of field plan generation (@yaacovCR)
#4051 perf: introduce completePromisedListItemValue (@yaacovCR)
#4052 refactor: introduce completeIterableValue (@yaacovCR)
#4076 incremental: avoid double loop with stream from sync iterables (@yaacovCR)
#4046 perf: use undefined for empty (@yaacovCR)
#3997 Add test for consolidating grouped field sets properly into deferred fragments (@yaacovCR)
#4099 refactor: extract execution types to separate file (@yaacovCR)
#4101 incremental(stream): revert test logic (@yaacovCR)
#4094 incremental: introduce IncrementalGraph class to manage tree of subsequent results (@yaacovCR)
#4098 incremental: handle Stream as stream rather than linked list (@yaacovCR)
#4106 polish(IncrementalPublisher): remove unnecessary check and method call (@yaacovCR) </details>

Internal 🏠

<details> <summary> 5 PRs were merged </summary>

#3992 Use node v20 for CI (@robrichard)
#4013 docs: reviewer and merge process (@saihaj)
#4030 fix(benchmark): select npm.cmd on windows (@yaacovCR)
#4029 benchmark: update v8 flag (@yaacovCR)
#4121 port[v17]: Fix publish scripts (@benjie) </details>

Committers: 7

Benjie(@benjie)
Christoph Zwerschke(@Cito)
Ivan Goncharov(@IvanGoncharov)
Michael Hayes(@hayes)
Rob Richard(@robrichard)
Saihajpreet Singh(@saihaj)
Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.3.canary.pr.4097.291dd92c9059c6bcc88ff1fa21058a8ac519cf834 Jun 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4097, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4035.3404abc2382e32f6a3ab26f08a9ed54554678fa927 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4035, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4032.8bcdcea90e0a24432a78270866c27e0db6a2ae4d27 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4032, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4032.4fb41fe3e1f2b4b27437138d6d7d4763c1992e7a21 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4032, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4026.d2f30cc0780dd436b1a05aa23dfa28c83da7d03319 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4026, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4026.74aa85f56dea9ab9feb4445165eb0e2347ea674f19 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4026, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4026.5e657d31b3abdc38acd6bb21c50ed3a41aa3390517 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4026, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4026.5922420b3b235970ee230497190e28c8290c8f1612 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4026, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4026.405885d861f562a160f9e92d0be418d81931201628 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4026, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4026.1140ceffaf9629dd46a16d4fd28479240752f6eb28 Mar 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4026, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.4002.b3f6af2e83280d7830b2a01265e0977b7b68e2f41 Feb 2024pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/4002, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.3969.83688beb16ecba5a0495158c3c2b3684730579bf7 Oct 2023pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3969, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.3.canary.pr.3791.4a8f641106bee54f1e4a4de4bf59c49976541b0014 Oct 2023pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3791, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.36 Sept 2023pre-release

> This release contains a new response format for operations containing the experimental @defer & @stream directives. This new response format address

v17.0.0-alpha.3 (2023-09-06)

This release contains a new response format for operations containing the experimental @defer & @stream directives. This new response format addresses issues around data duplication, response amplification, and data consistency that affected the previous response format. See https://github.com/graphql/defer-stream-wg/discussions/69 for more information.

Breaking Change 💥

#3742 Remove defer/stream support from subscriptions (@robrichard)
#3722 original execute should throw if defer/stream directives are present (@yaacovCR)
#3855 Drop support for node14 (@IvanGoncharov)
#3875 GraphQLInputObjectType: remove check that duplicate TS types (@IvanGoncharov)
#3886 RFC: incremental delivery: without branching, with deduplication (@yaacovCR)
#3897 incremental delivery: add pending notifications (@yaacovCR)
#3960 incremental: utilize id and subPath rather than path and label (@yaacovCR)

New Feature 🚀

#3754 enhancement: remove extra ticks (@yaacovCR)
#3877 GraphQLInterface: add missing template parameters (@IvanGoncharov)
#3860 Make print() break long List and Object Values over multiple line (@dylanowen)
#3822 Expose printDirective function to enable schema sharding (@tomgasson)
#3513 Implement OneOf Input Objects via @oneOf directive (@erikkessler1)
#3929 incremental: subsequent result records should not store parent references (@yaacovCR)
#3948 Add support for fourfold nested lists in introspection (@gschulze)

Bug Fix 🐞

#3746 fix: allow async errors to bubble to AsyncIterable list items (@yaacovCR)
#3747 add filtering for asyncIterable lists (@yaacovCR)
#3748 Fix typo in the error message for max tokens (@Cito)
#3753 fix(incrementalDelivery): filtering should never affect the error source (@yaacovCR)
#3757 fix: re-initialize subsequentPayloads (@yaacovCR)
#3706 Fix crash in node when mixing sync/async resolvers (@chrskrchr)
#3763 resources/utils: fix git().revList (@IvanGoncharov)
#3760 fix(incrementalDelivery): fix null bubbling with async iterables (@yaacovCR)
#3776 extendSchema: preserve "description" and "extensions" (@igrlk)
#3837 fix: invalid originalError propagation in custom scalars (@stenreijers)
#3839 Fix ambiguity around when schema definition may be omitted (@benjie)
#3832 internal: fix inlineInvariant for cjs builds that require filenames with explicit extensions (@yaacovCR)
#3864 Narrow the return type of astFromValue (@dylanowen)
#3869 printSchema: correctly print empty description (@IvanGoncharov)
#3873 ASTReducer: correctly type scalar values (@IvanGoncharov)
#3899 asyncIterable: locate async iterator errors to the collection (@yaacovCR)
#3894 introduce new IncrementalPublisher class (@yaacovCR)
#3961 fix(types): path is required within incremental results (@yaacovCR)
#3937 Improve description for @oneOf directive (@spawnia)
#3965 instanceOf: workaround bundler issue with process.env (@IvanGoncharov)
#3958 OverlappingFieldsCanBeMergedRule: Fix performance degradation (@AaronMoat)

Docs 📝

<details> <summary> 4 PRs were merged </summary>

#3778 Remove outdated instructions on experimental tag (@robrichard)
#3947 Fix edit URL in documentation (@benjie)
#3951 Fix invalid sample code (@sakesun)
#3957 docs: add installation instructions for bun (@colinhacks) </details>

Polish 💅

<details> <summary> 31 PRs were merged </summary>

#3749 polish: add additional test (@yaacovCR)
#3728 incrementalDelivery: refactoring and streamlining (@yaacovCR)
#3752 refactor: introduce completeListItemValue (@yaacovCR)
#3762 Fix formatting in schema for test "resolve Interface type using __typename on source object" (@spawnia)
#3771 lint: enable ESLint's logical-assignment-operators rule (@IvanGoncharov)
#3781 Fix comments in defer/stream validation rules (@robrichard)
#3793 polish: do not repeat isPromise check (@yaacovCR)
#3801 polish: narrow mapSourceToResponse return type (@yaacovCR)
#3806 polish: remove misleading comment (@yaacovCR)
#3816 polish: clarify filtering test semantics (@yaacovCR)
#3821 Fix wording of comment in buildClientSchema (@Cito)
#3856 Use replaceAll instead of RegExp with global flag (@IvanGoncharov)
#3865 Add accidentally deleted test spec name back (@Cito)
#3857 Use ES2021 Array.at (@IvanGoncharov)
#3872 Enable @typescript-eslint/strict-boolean-expressions rule (@IvanGoncharov)
#3874 GraphQLObjectType: partial revert of #3143, due to perf regression (@IvanGoncharov)
#3876 GraphQL*Type: bind only single property instead of entire context (@IvanGoncharov)
#3878 execute: code refactors related to steam/defer (@yaacovCR)
#3881 simplify schema in defer tests (@robrichard)
#3880 Testing the right functions in testUtils (@Cito)
#3885 remove unnecessary duplicated fields from defer tests (@yaacovCR)
#3890 Fix misleading test section description (@Cito)
#3891 refactors from the without-branching branch (@yaacovCR)
#3896 executeFields: update grouped field set variable name (@yaacovCR)
#3902 introduce promiseWithResolvers helper (@robrichard)
#3903 execute: move publishing code into separate file (@yaacovCR)
#3939 Speedup sorting & building/extending schema (@IvanGoncharov)
#3930 incremental publisher should handle all response building (@yaacovCR)
#3904 add tests with regard to duplication (@yaacovCR)
#3962 skip unnecessary initialization of empty items array (@yaacovCR)
#3966 polish: improve addDeferredFragments readability (@yaacovCR) </details>

Internal 🏠

<details> <summary> 17 PRs were merged </summary>

#3751 GitHub Workflows security hardening (@sashashura)
#3759 fix(github-actions-bot): add additional permissions (@yaacovCR)
#3769 Fix typo in CONTRIBUTING.md (@igrlk)
#3770 Minor simplification in schema-test (@Cito)
#3772 eslintrc: reorder rules to match order in the official docs (@IvanGoncharov)
#3774 eslintrc: enable few rules with minimal code changes (@IvanGoncharov)
#3797 workflows: fix and cleanup permissions (@IvanGoncharov)
#3800 fix permissions for codeql-action (@yaacovCR)
#3823 Avoid an before consonant (@spawnia)
#3843 internal: fix website build error (@yaacovCR)
#3849 ESLint: use the --rulesdir option for internal rules. (@IvanGoncharov)
#3848 Add node@19 to integration tests + use it in CI (@IvanGoncharov)
#3850 ci: uncomment package-lock.json check for unmet dependencies (@IvanGoncharov)
#3852 ESLint: switch to '.eslintrc.cjs' as config file (@IvanGoncharov)
#3879 gen-changelog: Fix error introduced in #3872 (@IvanGoncharov)
#3882 eslint: replace unmaintained 'node' plugin with it's fork (@IvanGoncharov)
#3964 fix for development on Windows (@sakesun) </details>

Dependency 📦

<details> <summary> 4 PRs were merged </summary>

#3766 Update deps (@IvanGoncharov)
#3779 Update deps (@IvanGoncharov)
#3854 Update deps (@IvanGoncharov)
#3884 update deps (@IvanGoncharov) </details>

Committers: 17

Aaron Moat(@AaronMoat)
Alex(@sashashura)
Benedikt Franke(@spawnia)
Benjie(@benjie)
Chris Karcher(@chrskrchr)
Christoph Zwerschke(@Cito)
Colin McDonnell(@colinhacks)
Dylan Owen(@dylanowen)
Erik Kessler(@erikkessler1)
Gunnar Schulze(@gschulze)
Igor Luchenkov(@igrlk)
Ivan Goncharov(@IvanGoncharov)
Rob Richard(@robrichard)
Sakesun(@sakesun)
Sten Reijers(@stenreijers)
Tom Gasson(@tomgasson)
Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.2.canary.pr.3957.454033bcee41c456acce935e49e3e420b75115e41 Sept 2023pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3957, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.2.canary.pr.3937.8e773a04d8041ffc00a1550e8c6688e01ba1183229 Aug 2023pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3937, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.2.canary.pr.3911.a281faf70fee4ba1522af45cf15f41a899c723c428 Aug 2023pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3911, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.2.canary.pr.3791.e6d3ec58026d75b71b7b84c3da5f376ec7eeca947 Feb 2023pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3791, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.2.canary.pr.3791.264f22163eb937ff87a420be9f7d45965f2cbf071 Dec 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3791, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.2.canary.pr.3791.22288c73e61ad3ca68687546f2058561e41fcc9319 Feb 2023pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3791, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.2.canary.pr.3754.1564174b0dc26e0adf7ff2833716d06606b06a2027 Dec 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3754, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.222 Sept 2022pre-release

## v17.0.0-alpha.2 (2022-09-22) #### Breaking Change 💥 * #3622 fix: update remaining GraphQLNonNull codepoints to GraphQLNonNull (@yaacovCR) * #3621 c

v17.0.0-alpha.2 (2022-09-22)

Breaking Change 💥

#3622 fix: update remaining GraphQLNonNull<GraphQLType> codepoints to GraphQLNonNull<GraphQLNullableType> (@yaacovCR)
#3621 change incorrect subscribe return type to a GraphQLError (@yaacovCR)
#3620 align return types from execution and subscription (@yaacovCR)
#3635 createSourceEventStream: remove deprecated positional argument overload (@yaacovCR)
#3642 Remove 'devAssert' checks that duplicate TS types (@IvanGoncharov)
#3643 Remove 'assertValidExecutionArguments' function (@IvanGoncharov)
#3733 incrementalDelivery: remove singleResult wrapper (@yaacovCR)

New Feature 🚀

#3597 Fix typing for isNonNullType (@yaacovCR)
#3605 Add new 'GraphQLSchema.getField' method (@IvanGoncharov)
#3634 createSourceEventStream: introduce named arguments and deprecate positional arguments (@yaacovCR)
#2757 Support returning async iterables from resolver functions (@IvanGoncharov)
#3418 [RFC] Client Controlled Nullability experiment implementation w/o execution (@twof)
#3684 parser: limit maximum number of tokens (@IvanGoncharov)
#3659 Reference implementation of defer and stream spec (@robrichard)
#3361 deploy full ESM with "type": "module" in "latest-esm" npm tag (@PabloSzx)

Bug Fix 🐞

#3618 extendSchema: Do not modify standard directives (@IvanGoncharov)
#3639 refactor: subscribe: introduce buildPerEventExecutionContext (@yaacovCR)
#3670 Fix: make public API compatible with 'exactOptionalPropertyTypes' (@IvanGoncharov)
#3678 Parser: allow 'options' to explicitly accept undefined (@IvanGoncharov)
#3720 Filter subsequent payloads when parent field is null (@robrichard)
#3729 incrementalDelivery: fix iterable streaming with errors (@yaacovCR)

Docs 📝

#3731 update incremental docs (@yaacovCR)

Polish 💅

<details> <summary> 16 PRs were merged </summary>

#3598 Refactor GraphQL*Type TS types to be more DRY (@yaacovCR)
#3627 Reuse GraphQLWrappingType in 'GraphQLType' definition (@IvanGoncharov)
#3630 subscribe-test: extract subscribeWithBadFn function (@yaacovCR)
#3636 move subscribe code to execute file (@yaacovCR)
#3638 refactor: small refactors within execute (@yaacovCR)
#3641 ESLint: error on function accepting more than 5 parameters (@IvanGoncharov)
#3654 refactor: use exeContext strategically (@yaacovCR)
#3681 Fix coerceInputValue test name (@spawnia)
#3680 validate: remove warning about throwing literal (@IvanGoncharov)
#3683 polish: remove unnecessary Maybe (@yaacovCR)
#3688 Replace all instances of ObjMap<boolean> with ES6 Set (@IvanGoncharov)
#3689 Remove superficial .values() and .entries() calls (@IvanGoncharov)
#3690 Motivation: looked into this it as part of #3687 (@IvanGoncharov)
#3655 polish: add tests for expectPromise and expectEqualPromisesOrValues (@yaacovCR)
#3696 polish: mapAsyncIterator (@yaacovCR)
#3736 promiseForObject: convert to be async function (@IvanGoncharov) </details>

Internal 🏠

<details> <summary> 36 PRs were merged </summary>

#3596 benchmark: test performance cost of re-creating schema (@IvanGoncharov)
#3602 gen-changelog: fix crash due to 'git rev-list' returning empty string (@IvanGoncharov)
#3604 benchmark: various improvments to benchmark (@IvanGoncharov)
#3608 Remove 'utf-8' as argument of writeFileSync (@IvanGoncharov)
#3610 resources: add new localRepoPath utility function (@IvanGoncharov)
#3611 diff-npm-package: move report into shared 'reports' folder (@IvanGoncharov)
#3612 github actions: switch embedded JS to ESM (@IvanGoncharov)
#3613 GH actions: fix 'checkForCommonlyIgnoredFiles' (@IvanGoncharov)
#3614 Lint GitHub Actions (@IvanGoncharov)
#3615 Update GitHub actions dependencies (@IvanGoncharov)
#3623 diff-npm-package: create reports folder (@yaacovCR)
#3625 benchmark: replace failing on context switching with warning (@IvanGoncharov)
#3624 diff-npm-package: fix reports dir creation (@yaacovCR)
#3626 ci: Fix imports in 'actions/github-script' (@IvanGoncharov)
#3631 ci: speed up 'ci' workflow by removing unneeded internal dependencies (@IvanGoncharov)
#3628 benchmark: add Windows compatibility (@yaacovCR)
#3134 Async benchmarks (@robrichard)
#3668 Cleanup words/files ignores in cspell.yml (@IvanGoncharov)
#3669 tsconfig: Explicitly list all type checking options (@IvanGoncharov)
#3692 gen-changelog: Use fetch instead of http.request (@IvanGoncharov)
#3695 benchmark: use 'execOutput' from 'util.ts' (@IvanGoncharov)
#3697 resources: Move mkdirSync into writeGeneratedFile (@IvanGoncharov)
#3698 resources: merge execOutput and exec into single function (@IvanGoncharov)
#3699 ci: add dependency review workflow (@IvanGoncharov)
#3704 resources: replace execSync with spawnSync (@IvanGoncharov)
#3700 ci: Add CodeQL analysis (@IvanGoncharov)
#3564 Fully switch to ESM (scripts, tests, etc.) (@IvanGoncharov)
#3721 ci: Move 'integration-test.ts' into 'resources' (@IvanGoncharov)
#3723 resources: add utility function to create tmp dir (@IvanGoncharov)
#3724 resources/utils.ts: npm/git will inherit stdout by default (@IvanGoncharov)
#3725 changelog: use top-level await to simplify code (@IvanGoncharov)
#3735 resources: replace usage of deprecated ts function (@IvanGoncharov)
#3738 Remove unused Babel config files (@IvanGoncharov)
#3741 build-npm/deno: use TS to find all *.ts files (@IvanGoncharov)
#3744 fix github actions lint (@robrichard)
#3745 resources/util: spawn command fail on error (@IvanGoncharov) </details>

Dependency 📦

<details> <summary> 4 PRs were merged </summary>

#3607 Update deps (@IvanGoncharov)
#3667 Update deps (@IvanGoncharov)
#3693 Update deps (@IvanGoncharov)
#3737 Update deps (@IvanGoncharov) </details>

Committers: 6

Alex Reilly(@twof)
Benedikt Franke(@spawnia)
Ivan Goncharov(@IvanGoncharov)
Pablo Sáez(@PabloSzx)
Rob Richard(@robrichard)
Yaacov Rydzinski (@yaacovCR)

Open source →

17.0.0-alpha.1.canary.pr.3703.fce1b706e279820c9612ad3061b740b831f1767223 Aug 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3703, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3703.df016a7b352e356ad0049dd81e2cd14252cec5fe23 Aug 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3703, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3703.9360805de6310b453b76a53431f921b44a76c2f923 Aug 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3703, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3673.53c289997f206acd10388d6a574341c68cc1a30e12 Jul 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3673, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3659.cef660554446d49cec9a0958afb9690dd0b1919323 Jun 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3659, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3659.735abf5edacd99b712ddb40d89bd8b213640eb0716 Aug 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3659, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3659.5dba20aef36112d13569d5f296ef967383e60d0f25 Aug 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3659, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3658.null22 Jun 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3658, no gurantees provided so please use your own discretion.

Nothing published for this version

17.0.0-alpha.1.canary.pr.3651.57364d3f9da445b2bba520d3b886e07dc2af10e26 Jul 2022pre-releasewithdrawn: You are using canary version build from https://github.com/graphql/graphql-js/pull/3651, no gurantees provided so please use your own discretion.

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →

graphql

Release timeline

Releases

v17.0.2 (2026-07-03)

Bug Fix 🐞

Polish 💅

Committers: 2

Choose a tag to compare

v17.0.1 (2026-06-16)

Bug Fix 🐞

Internal 🏠

Committers: 2

Choose a tag to compare

v17.0.0 (2026-06-15)

New Feature 🚀

Bug Fix 🐞

Docs 📝

Polish 💅

Internal 🏠

Committers: 3

Choose a tag to compare

v17.0.0-rc.0 (2026-06-02)

New Feature 🚀

Bug Fix 🐞

Docs 📝

Committers: 4

Choose a tag to compare

v17.0.0-beta.2 (2026-06-02)

Breaking Change 💥

New Feature 🚀

Bug Fix 🐞

Docs 📝

Polish 💅

Internal 🏠

Committers: 2

Choose a tag to compare

v17.0.0-beta.1 (2026-05-10)

Breaking Change 💥

New Feature 🚀

Bug Fix 🐞

Polish 💅

Internal 🏠

Committers: 1

Choose a tag to compare

v17.0.0-beta.0 (2026-05-07)

Breaking Change 💥

New Feature 🚀

Bug Fix 🐞

Polish 💅

Internal 🏠

Committers: 5

Choose a tag to compare

v17.0.0-alpha.14 (2026-03-11)

Internal 🏠

Committers: 1

v17.0.0-alpha.13 (2026-03-10)

Bug Fix 🐞

Polish 💅

Internal 🏠

Committers: 1

v17.0.0-alpha.12 (2026-03-10)

Internal 🏠

Committers: 1

v17.0.0-alpha.11 (2026-03-01)

Internal 🏠

Committers: 1

v17.0.0-alpha.10 (2026-02-24)

Breaking Change 💥

New Feature 🚀

Bug Fix 🐞

Docs 📝

Polish 💅

Internal 🏠

Committers: 6

v17.0.0-alpha.9 (2025-06-11)

Breaking Change 💥

New Feature 🚀

Bug Fix 🐞

Polish 💅

Internal 🏠