canirequire

canirequire › ESM-only › socks-proxy-agent

Is socks-proxy-agent ESM-only? Can you require() it?

A SOCKS proxy `http.Agent` implementation for HTTP and HTTPS

Last verified Sep 9, 2026 against socks-proxy-agent@10.1.0. JSON

ESM-only ESM-only since 9.0.0 — last CommonJS version is 8.0.5

socks-proxy-agent dropped its CommonJS build in 9.0.0 (March 2026). The last version you can require() on every Node.js version, including 18 and older, is 8.0.5, published Dec 7, 2024.

On Node.js 20.19+, 22.12+ and every newer release, require("socks-proxy-agent") 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.

socks-proxy-agent@10.1.0 declares engines ">= 20", so Node.js 18 is outside its supported range regardless of module format.

Latest
10.1.0 (Jun 8, 2026)
Module format
ESM-only
Last CommonJS version
8.0.5
ESM-only since
9.0.0 (Mar 11, 2026)
TypeScript types
Bundled
Node engines
>= 20
Weekly downloads
50.9M
License
MIT

Does socks-proxy-agent@10.1.0 actually load? Runtime test results

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

Runtimerequire("socks-proxy-agent")import "socks-proxy-agent"
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 socks-proxy-agent

ES modules (import)

import socksProxyAgent from "socks-proxy-agent";

CommonJS (require)

// Node.js 20.19+ / 22.12+ / newer (package has no top-level await):
const socksProxyAgent = require("socks-proxy-agent");

// Any Node.js version:
const socksProxyAgent = await import("socks-proxy-agent");

// Or pin the last CommonJS release:
// npm install socks-proxy-agent@8.0.5

Module format by version

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

VersionsFormatFirst published
9.0.0 – 10.1.0ESM-onlyMar 11, 2026
0.0.1 – 8.0.5CommonJSJul 11, 2013

Frequently asked

Is socks-proxy-agent ESM-only?

socks-proxy-agent@10.1.0 is ESM-only. socks-proxy-agent dropped its CommonJS build in 9.0.0 (March 2026). The last version you can require() on every Node.js version, including 18 and older, is 8.0.5, published Dec 7, 2024.

Which version of socks-proxy-agent still supports CommonJS / require()?

8.0.5 is the last version of socks-proxy-agent with a CommonJS build. Install it with "npm install socks-proxy-agent@8.0.5". Every version from 9.0.0 on is ESM-only.

How do I use socks-proxy-agent from a CommonJS file?

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

Does socks-proxy-agent work in Bun?

Yes. import "socks-proxy-agent" loaded successfully in Bun 1.4 on Sep 9, 2026.

Does socks-proxy-agent ship TypeScript types?

Yes. socks-proxy-agent bundles its own type declarations; no @types package is needed.

Links

Other esm-only packages

Similar popularity