canirequire

canirequire › ESM-only › restore-cursor

Is restore-cursor ESM-only? Can you require() it?

Gracefully restore the CLI cursor on exit

Last verified Sep 9, 2026 against restore-cursor@5.1.0. JSON

ESM-only ESM-only since 4.0.0 — last CommonJS version is 3.1.0

restore-cursor dropped its CommonJS build in 4.0.0 (August 2021). The last version you can require() on every Node.js version, including 18 and older, is 3.1.0, published Apr 26, 2019.

On Node.js 20.19+, 22.12+ and every newer release, require("restore-cursor") works anyway: Node can load synchronous ES modules through require(). Verified on Node 20, 22, 24, 26. Node.js 18 and older still fail with ERR_REQUIRE_ESM.

Latest
5.1.0 (Jul 26, 2024)
Module format
ESM-only
Last CommonJS version
3.1.0
ESM-only since
4.0.0 (Aug 23, 2021)
TypeScript types
Bundled
Node engines
>=18
Weekly downloads
107.5M
License
MIT

Does restore-cursor@5.1.0 actually load? Runtime test results

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

Runtimerequire("restore-cursor")import "restore-cursor"
Node.js 18✗ failsERR_REQUIRE_ESM✓ works
Node.js 20✓ works✓ works
Node.js 22✓ works✓ works
Node.js 24✓ works✓ works
Node.js 26✓ works✓ works
Bun 1.4✓ works✓ works

How to import restore-cursor

ES modules (import)

import restoreCursor from "restore-cursor";

CommonJS (require)

// Node.js 20.19+ / 22.12+ / newer (package has no top-level await):
const restoreCursor = require("restore-cursor");

// Any Node.js version:
const restoreCursor = await import("restore-cursor");

// Or pin the last CommonJS release:
// npm install restore-cursor@3.1.0

Module format by version

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

VersionsFormatFirst published
4.0.0 – 5.1.0ESM-onlyAug 23, 2021
1.0.0 – 3.1.0CommonJSAug 31, 2014

Frequently asked

Is restore-cursor ESM-only?

restore-cursor@5.1.0 is ESM-only. restore-cursor dropped its CommonJS build in 4.0.0 (August 2021). The last version you can require() on every Node.js version, including 18 and older, is 3.1.0, published Apr 26, 2019.

Which version of restore-cursor still supports CommonJS / require()?

3.1.0 is the last version of restore-cursor with a CommonJS build. Install it with "npm install restore-cursor@3.1.0". Every version from 4.0.0 on is ESM-only.

How do I use restore-cursor from a CommonJS file?

Use a dynamic import: const mod = await import("restore-cursor"). On Node.js 20.19+, 22.12+ and newer, a plain require("restore-cursor") also works for ESM packages that do not use top-level await. Alternatively pin restore-cursor@3.1.0.

Does restore-cursor work in Bun?

Yes. import "restore-cursor" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does restore-cursor ship TypeScript types?

Yes. restore-cursor bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity