# Is q ESM-only? Can you require() it?

> q@1.5.1 is a CommonJS package. CommonJS — require() works on every Node.js version we test.

A library for promises (CommonJS/Promises/A,B,D)

Last verified Sep 9, 2026 against q@1.5.1.

q ships CommonJS only. require("q") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=0.6.0. import "q" also works because Node.js and Bun can import CommonJS from ES modules, but only the default export is guaranteed; named imports depend on Node's static analysis of the module.

**Deprecated:** You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other. (For a CapTP with native promises, see @endo/eventual-send and @endo/captp)

## What to do

1. require("q") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=0.6.0.
2. From ES modules use the default import: import q from "q"; then destructure. Named imports only work when Node.js can statically detect the exports.
3. TypeScript: npm install -D @types/q
4. This package is deprecated: You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other. (For a CapTP with native promises, see @endo/eventual-send and @endo/captp)

## Facts

- Latest: 1.5.1 (Oct 19, 2017)
- Module format: CommonJS
- Last CommonJS version: 1.5.1
- TypeScript types: @types/q
- Node engines: >=0.6.0
- Weekly downloads: 11.9M
- License: MIT

## Runtime test results for q@1.5.1

Installed and executed on Sep 9, 2026 with require("q") from a CommonJS file and import "q" from an ES module.

| Runtime | require("q") | import "q" |
|---|---|---|
| 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 q

ES modules:

```js
import q from "q";
```

CommonJS:

```js
const q = require("q");
```

## Module format by version

Derived from the type, main and exports fields of every stable release on npm (75 versions; the newest 60 shown).

| Versions | Format | First published |
|---|---|---|
| 0.2.1 – 2.0.3 | CommonJS | Jan 5, 2011 |

## Frequently asked

**Is q ESM-only?**

q@1.5.1 is a CommonJS package. q ships CommonJS only. require("q") works on every Node.js version we test (18, 20, 22, 24 and 26) and in Bun. The package declares Node.js >=0.6.0. import "q" also works because Node.js and Bun can import CommonJS from ES modules, but only the default export is guaranteed; named imports depend on Node's static analysis of the module.

**Can I import q with ES module syntax?**

Yes. import q from "q" works in Node.js and Bun because they support importing CommonJS modules. Named imports work only when Node.js can statically detect the exports.

**Does q work in Bun?**

Yes. import "q" loaded successfully in Bun 1.4.0 on Sep 9, 2026.

**Does q ship TypeScript types?**

Not bundled. Install the community types with "npm install -D @types/q".

## Links

- [q on npm](https://www.npmjs.com/package/q)
- [Source repository](https://github.com/kriskowal/q)
- [HTML version](https://canirequire.com/package/q/)
- [JSON version](https://canirequire.com/package/q.json)

---

For scripts and AI agents: any package is at https://canirequire.com/package/<name>/index.md (Markdown) or https://canirequire.com/package/<name>.json (JSON); the site index is https://canirequire.com/llms.txt. Fetch the URL directly; no search needed.