canirequire › Dual (CommonJS + ESM) › @tanstack/react-query
Is @tanstack/react-query ESM-only? Can you require() it?
Hooks for managing, caching and syncing asynchronous and remote data in React
Last verified Sep 9, 2026 against @tanstack/react-query@5.102.8. Markdown · JSON
Dual (CommonJS + ESM) Dual package — require() works on every Node.js version we test; import works too
@tanstack/react-query publishes both a CommonJS entry and a native ESM entry (ESM added in 4.3.0). require("@tanstack/react-query") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import "@tanstack/react-query" works alongside it.
What to do
- Nothing to change. require("@tanstack/react-query") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import * as reactQuery from "@tanstack/react-query" works alongside it; use named imports for what the ESM entry exports.
- TypeScript: types are bundled; install nothing extra.
Does @tanstack/react-query@5.102.8 actually load? Runtime test results
Installed and executed on Sep 9, 2026 with require("@tanstack/react-query") from a CommonJS file and import "@tanstack/react-query" from an ES module.
| Runtime | require("@tanstack/react-query") | import "@tanstack/react-query" |
|---|---|---|
| Node.js 18 | ✓ works | ✓ works |
| Node.js 20 | ✓ works | ✓ works |
| Node.js 22 | ✓ works | ✓ works |
| Node.js 24 | ✓ works | ✓ works |
| Node.js 26 | ✓ works | ✓ works |
| Bun 1.4.0 | ✓ works | ✓ works |
How to import @tanstack/react-query
ES modules (import)
import * as reactQuery from "@tanstack/react-query";Namespace import shown because the ESM entry may have no default export; use named imports for what it exports.
CommonJS (require)
const reactQuery = require("@tanstack/react-query");Module format by version
Derived from the type, main and exports fields of every stable release on npm, corrected where a runtime test of that version contradicted them (435 versions; the newest 60 shown).
| Versions | Format | First published |
|---|---|---|
| 5.90.7 – 5.102.8 | Dual (CommonJS + ESM) | Nov 5, 2025 |
Frequently asked
Is @tanstack/react-query ESM-only?
@tanstack/react-query@5.102.8 ships CommonJS and ESM builds. @tanstack/react-query publishes both a CommonJS entry and a native ESM entry (ESM added in 4.3.0). require("@tanstack/react-query") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. import "@tanstack/react-query" works alongside it.
Can I require @tanstack/react-query?
Yes. @tanstack/react-query ships a CommonJS entry alongside the native ESM entry. require("@tanstack/react-query") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun.
Does @tanstack/react-query work in Bun?
Yes. import "@tanstack/react-query" loaded successfully in Bun 1.4.0 on Sep 9, 2026.
Does @tanstack/react-query ship TypeScript types?
Yes. @tanstack/react-query bundles its own type declarations; no @types package is needed.
Links
Other dual (commonjs + esm) packages
- minimatch 10.2.6Dual
- brace-expansion 5.0.9Dual
- lru-cache 11.5.2Dual
- tslib 2.8.1Dual
- glob 13.0.6Dual
- eslint-visitor-keys 5.0.1Dual
- yallist 5.0.0Dual
- balanced-match 4.0.4Dual
Similar popularity
- @babel/plugin-transform-react-jsx-source 7.29.7CommonJS
- @radix-ui/react-visually-hidden 1.2.11Dual
- istanbul-lib-source-maps 5.0.6CommonJS
- webpack-sources 3.5.1CommonJS
- is-data-view 1.0.2CommonJS
- @protobufjs/aspromise 1.1.2CommonJS
- @csstools/css-calc 3.3.0ESM-only
- @napi-rs/wasm-runtime 1.2.3Dual