Bug Fixes

• Fixed #1281: GraphQL errors and data are now accessible from 4xx/5xx HTTP responses
• Fixed #1461: ClientError is properly returned for non-2xx responses with malformed bodies
• Fixed #1462: ClientError is properly returned for non-2xx responses with unsupported content types

Changes

• Non-2xx HTTP responses now parse the response body first to extract GraphQL errors/data when available
• Non-2xx responses with valid GraphQL bodies return ClientError with errors and data accessible
• Non-2xx responses with invalid bodies still return ClientError (not generic Error) for backwards compatibility
• This release reverts PRs #1457 and #1459 which introduced regressions, then reapplies a minimal fix for #1281

Breaking Changes

None - this release maintains backwards compatibility while adding support for accessing GraphQL errors from 4xx/5xx responses.

Bug Fixes

• Non-JSON Error Response Handling: Fixed regression in 7.3.2 where servers returning HTTP 4xx/5xx status codes with non-JSON response bodies (HTML, plain text) would throw an unhelpful error: "Invalid execution result: result is not object or array" (#1459, closes #1458)
  • Added safe JSON parsing fallback for responses without proper Content-Type headers
  • Returns descriptive error messages with response body preview for non-JSON responses
  • Handles common production scenarios: load balancer errors (502/503 HTML pages), CDN errors, WAF/firewall responses, misconfigured servers
  • Maintains backward compatibility for servers that omit Content-Type but return valid JSON
  • Added comprehensive test coverage for HTML, plain text, and missing Content-Type scenarios

What Changed

Version 7.3.2 introduced a bug where the ELSE branch in parseResultFromResponse would pass raw strings (HTML, plain text) to a parser expecting objects/arrays. This only surfaced when:

1. Server returns 4xx/5xx status code
2. Content-Type header is missing or non-JSON (e.g., text/html, text/plain)
3. Response body is not valid JSON

This is now fixed with graceful error handling and clear error messages.

Bug Fixes

• HTTP Error Handling: Fixed regression from v6 to v7 where HTTP 4xx/5xx responses would not include GraphQL errors from response body in ClientError (#1457, closes #1281)

  • Response body is now parsed before checking HTTP status
  • Users can access GraphQL errors via error.response.errors even with non-2xx status codes
  • Common use case: authentication errors (422), server errors (500)

• graphql-codegen Compatibility: Added support for TypedDocumentString from @graphql-codegen when using documentMode: 'string' (#1456, closes #1453)

  • Handles boxed String objects created by TypedDocumentString class
  • Normalizes document input to prevent crashes when passing to GraphQL operations

Bug Fixes

• Fixed broken example links on npmjs.com (#1332)
  • Updated package.json repository metadata to point to correct location: graffle-js/graffle
  • Updated homepage URL to include /tree/graphql-request path
  • Updated bugs URL to point to correct issues page
  • All example links on npm now correctly resolve to files in the graphql-request branch

Links

• npm package
• Full Changelog

What's Changed

Features

• CommonJS Support: Added CommonJS module format () alongside ESM for better compatibility with Jest and other testing environments that aren't fully ESM-ready
• Improved Type Defaults: Default type parameters to any for easier migration and reduced type friction

Pull Requests

• feat(graphql-request): default types any and support common js #1396

Contributors

Thanks to @Moumouls (Antoine Cormouls) for the contribution! 🚀

---

Installation:

npm install graphql-request@7.3.0

Package: https://www.npmjs.com/package/graphql-request/v/7.3.0

Features:

• Support GraphQL@15 https://github.com/graffle-js/graffle/commit/849c9ab448d074fe1763f7bed30d627a569a390c

Fixes:

• b732f4595b2619cc0f0c23e69e8316f37e29713b Remove reference to type-fest which is not a dependency.

Fixes

• 37445c8e156bca8b256b8d01b3421ad7f6e43a6c Support CJS and remove Graffle code. To use Graffle by now, you should be using pnpm add graffle@next.

Fixes

• 829028d make dprint optional dep (#920)
• 3ba32a3 client sends accept header

Improvements

• 30b39bf improve: update all deps to latest (#936)
• 92ea1b2 docs: mention additional requirement for TS
• 39dfb37 refactor: no mock server
• db4db92 docs: TS moduleResolution requirements

Graffle

Features

• c91bbc3 anyware hook retries (#904)
• 6eebe6f extension system (#871)
• 543ffdf static exec and req funcs (#851)
• eecf7b9 incremental typed client (#848)

Chores

• f1fd315 add publint (#865)

Fixes

• dc299d9 no node fs module in runtime

Improvements

• 11805c8 improve: remove needless deep imports into graphql

Chores

• ecf5032 update dependency tsx to v4.9.4 (#843)
• 12cb8cf update dependency zod to v3.23.8 (#836)

BREAKING CHANGES

• 2a121c6 remove inlined graphql websocket code
• 99a192e add spec compliant default Accept header (#618)
• 0e53aed replace GraphQLClientRequestHeaders with built-in HeadersInit type (#616)
• c3a309f remove support for CommonJS (#607)
• 6efcc0d remove cross-fetch polyfill
• Valid URL must be passed (no more path-only strings like /foo) (#745)

Features

• f906d22 export request init extended type (#812)
• cc2dc55 response middleware extra info (#788)
• 2a121c6 (breaking) remove inlined graphql websocket code
• 0f1b7b5 exclude operation name via a field in RequestConfig (#645)
• 99a192e (breaking) add spec compliant default Accept header (#618)
• 0e53aed (breaking) replace GraphQLClientRequestHeaders with built-in HeadersInit type (#616)
• c3a309f (breaking) remove support for CommonJS (#607)
• 6efcc0d (breaking) remove cross-fetch polyfill
• e065677 export GraphQLClientRequestHeader (#558)

Fixes

• 553006b await response middleware (#810)
• 54da7bd alias encoding (#809)
• 190bdd2 remove vitest import
• 5f13401 no select root types if not in schema
• ee66c10 result types have no args
• fe124de args on interfaces and unions (#781)
• 893ad01 no infer runtime unions
• 310f10c order independent input object defs
• a71c9f8 order independent input object defs
• 118d1d7 no infer runtime objects
• 1238a1c thunk list objects
• 8a9e207 exact types on query and mutation (#755)
• aeb6087 generated code imports
• 7d828d7 allow null data
• 0d1e1a6 imports
• 2ad3e80 schema module exports path
• b7c26f8 schema import in generated types (#732)
• 4af7cb4 append search params (#673)
• a169969 no GET on mutations (#663)
• 8f926b8 do not require index sig on vars (#659)
• 0eb8a1d export GraphQLResponse type as part of the public API (#636)
• dbd7c7f do not overwrite user-provided Content-Type header (#614)
• d6298a3 refactor code so linter no longer produces warnings (#605)
• 3b7b31f ensure code formatting is correct (#604)
• a9fcb44 add support for TypedDocumentNode to be passed to WS methods (#585)
• c124ec8 Add ClientError to ResponseMiddleware param (#534)

Improvements

• b1f18c1 refactor: simplify encode tests
• f333c1e refactor: single pass encode (#807)
• dbffec8 refactor: modularize selection-set (#806)
• 5b13f30 refactor: organize dirs by layer (#805)
• bd5dddf docs: begin new documentation
• 05308fa improve: Node 18 tsconfig and ES2023 lib (#794)
• 6f07a0e refactor: client modules (#791)
• a554328 tests: refactor to one default schema (#790)
• 893a5e0 refactor: import order
• b9888e2 refactor: client dir
• 1287eda refactor: schema module (#770)
• c77de38 improve: upgrade to eslint 9 (#764)
• 5fe1cea refactor: legacy becomes raw
• 9dc4d81 refactor: tidy signature
• 52f4ab8 improve: upgrade deps to latest
• cc86c34 refactor: use dprint instead of prettier (#677)
• 080346e tests: case for overriding a built in header
• e040ec9 tests: do not retest headers init
• 4d4ac4c refactor: move existing api to legacy dir (#670)
• 4cadba3 refactor: modualarize api (#653)
• e5c8e7f improve: Optimised imports from graphql to decrease bundle size (#543)

Graffle (alpha)

Features

• be48f1e rename cli to graffle
• fb715d9 generated namespace and client ctor (#815)
• e2d1888 select (#816)
• 4ac0cd1 use a global namespace (#808)
• 2a39e81 rawOrThrow
• 80e050c returnMode successData (#804)
• 7b06232 mode to return all errors (#796)
• ae9ab07 treat schema file location as source dir
• b45dc60 use graphql return mode & named schema
• 547dfe5 can specify error type pattern in cli
• 2a77493 isError helper function
• a35be0a select type utilities (#785)
• 45412c2 root type field methods (#779)
• 73adae5 document method (#774)
• 98cb065 select helper
• 420a389 add raw method
• 5de618b root field methods
• 9191249 batch method
• cebd26d support non-null interface
• b85b50b union non-null field (#771)
• 33a0278 optional custom scalars (#768)
• fdca0a7 index sans dollar namespace (#767)
• 5658370 custom scalar runtime codecs (#746)
• 0e150e4 format generated code with dprint
• 34c9e25 string support for custom scalars (#742)
• f9ad67a support input object in selection set (#736)
• 4318cac disable environment input, rename flag (#731)
• 48e4d64 introduce a CLI for generating the client (#730)
• 9640d0a introduce an experimental typescript client (#672)