NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #1571 most downloaded on npm
The one-liner node.js proxy middleware for connect, express, next.js and more
Last release 3 months ago
04 Jul 2026
Ships unpredictably
gaps range from 8 days to 12 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
12 years old
108 releases · first in 2015
feat(types): export OnProxyEvent type by @Netail in #1263
Full Changelog: v4.1.1...v4.2.0
One column per quarter.
fix(fixRequestBody): harden form-data stringification by @chimurai in #1260
Full Changelog: v4.1.0...v4.1.1
docs(MIGRATION.md): restore MIGRATION.md by @chimurai in #1226
Full Changelog: v4.0.0...v4.1.0
test(ws): on error event with unreachable websocket target by @chimurai in #1243
Full Changelog: v4.1.0-beta.1...v4.1.0-beta.2
docs(MIGRATION.md): restore MIGRATION.md by @chimurai in #1226
Full Changelog: v4.0.0...v4.1.0-beta.1
ESM-only package [BREAKING CHANGE] 💣 http-proxy-middleware now ships as native ES modules only. CommonJS require() usage is no longer supported, so im…
Switched proxy from http-proxy to httpxy ✨ (https://github.com/chimurai/http-proxy-middleware/pull/1160)
This replaces a long-standing core dependency and brings in many upstream fixes and behavior improvements documented by the httpxy project: https://github.com/unjs/httpxy/issues/2
ESM-only package [BREAKING CHANGE] 💣
http-proxy-middleware now ships as native ES modules only. CommonJS require() usage is no longer supported, so imports should use ESM syntax.
Updated Node.js support policy [BREAKING CHANGE] 💣 Dropped Node.js 14, 16, 18, and 20. New minimum supported runtime is Node.js 22.15.0
Removed legacyCreateProxyMiddleware() [BREAKING CHANGE] 💣
The legacy compatibility wrapper has been removed as part of API cleanup. Use createProxyMiddleware() directly.
Added IPv6 literal support ✨
target and forward now support literal IPv6 URLs, for example: http://[::1]:3000.
Experimental Hono support 🧪
Added createHonoProxyMiddleware() for Hono apps, including dedicated subpath support via http-proxy-middleware/hono.
Many thanks to everyone who helped make this release possible. 🙏
node: protocol imports by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1127http-proxy w/ httpxy by @SukkaW in https://github.com/chimurai/http-proxy-middleware/pull/1160Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.5...v4.0.0
target and forward options (ie. "http://[::1]:8000")chore(package.json): remove patch-package by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1217
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.5...v4.0.0-beta.6
ci(github-actions): upgrade streetsidesoftware/cspell-action to v8 by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1211
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.4...v4.0.0-beta.5
chore(eslint): @typescript-eslint/consistent-type-imports by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1195
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.3...v4.0.0-beta.4
chore(package.json): bump dependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1189
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.2...v4.0.0-beta.3
chore: remove legacyCreateProxyMiddleware() [BREAKING CHANGE] by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1175
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v4.0.0-beta.0...v4.0.0-beta.2
chore(deps): fix punycode node deprecation warning by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1109
node: protocol imports by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1127http-proxy w/ httpxy by @SukkaW in https://github.com/chimurai/http-proxy-middleware/pull/1160Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.5...v4.0.0-beta.0
fix(fixRequestBody): harden form-data stringification by @chimurai in #1259
Full Changelog: v3.0.6...v3.0.7
chore(deps): fix punycode node deprecation warning by @chimurai in #1109
node: protocol imports by @chimurai in #1127Full Changelog: v3.0.5...v3.0.6
fix(fixRequestBody): check readableLength by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1096
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.4...v3.0.5
chore(package): bump dev dependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1045
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.3...v3.0.4
fix(pathFilter): handle errors by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1043
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.2...v3.0.3
chore(vscode): fix eslint setting by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1030
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.1...v3.0.2
docs(responseInterceptor): fix header manipulation example by @mcgwiz in https://github.com/chimurai/http-proxy-middleware/pull/967
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.0...v3.0.1
docs(examples): move example dependencies from root by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/994
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.1-beta.0...v3.0.1-beta.1
docs(responseInterceptor): fix header manipulation example by @mcgwiz in https://github.com/chimurai/http-proxy-middleware/pull/967
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.0...v3.0.1-beta.0
Read the v3 in Discussions or MIGRATION.md to see what the breaking changes are and how you can migrate them.
Read the v3 in Discussions or MIGRATION.md to see what the breaking changes are and how you can migrate them.
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.4...v3.0.0
This release contains some breaking changes.
Please read the V3 discussion https://github.com/chimurai/http-proxy-middleware/discussions/768 or follow the MIGRATION_V3.md guide.
test(mockttp): fix deprecated functions by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/772
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v3.0.0-beta.0...v3.0.0-beta.1
refactor: logging [BREAKING CHANGE]
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.4...v3.0.0-beta.0
fix: harden proxy-table matching to prevent routing bypass by @G-Rath in #1268
fix: harden proxy-table matching to prevent routing bypass by @G-Rath in #1268
v2.0.10-beta.0 Pre-release
Pre-release
Compare
fix(fixRequestBody): check readableLength by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1097
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.8...v2.0.9
fix(fixRequestBody): prevent multiple .write() calls by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/1090
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.7...v2.0.8
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.7-beta.0...v2.0.7-beta.1
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.7-beta.0...v2.0.7-beta.1
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7-beta.0
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.6...v2.0.7-beta.0
fix(proxyReqWs): catch socket errors by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/763
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.5...v2.0.6
fix(error handler): add default handler to econnreset by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/759
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.4...v2.0.5
chore(package): bump dev dependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/714
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.3...v2.0.4
feat(package): optional @types/express peer dependency by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/707
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.2...v2.0.3
chore(package): bump devDependencies by @chimurai in https://github.com/chimurai/http-proxy-middleware/pull/651
Full Changelog: https://github.com/chimurai/http-proxy-middleware/compare/v2.0.1...v2.0.2
https://github.com/chimurai/http-proxy-middleware/compare/v2.0.0...v2.0.1
https://github.com/chimurai/http-proxy-middleware/compare/v2.0.0...v2.0.1
chore(package): drop node 10 [BREAKING CHANGE]
https://github.com/chimurai/http-proxy-middleware/compare/v1.3.1...v2.0.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.3.0...v1.3.1
https://github.com/chimurai/http-proxy-middleware/compare/v1.2.1...v1.3.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.2.0...v1.2.1
https://github.com/chimurai/http-proxy-middleware/compare/v1.2.0...v1.2.1
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.2...v1.2.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.2...v1.2.0
Nothing published for this version
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.1...v1.1.2
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.1...v1.1.2
Nothing published for this version
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.1.0...v1.1.1
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.6...v1.1.0
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.6...v1.1.0
Removing lodash reduced the bundle size by more than 50% (source: bundlephobia.com):
Before lodash removal: 133.2 kB MINIFIED 45.6 kB MINIFIED + GZIPPED
After lodash removal: 65.6 kB MINIFIED 22.4 kB MINIFIED + GZIPPED
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.5...v1.0.6
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.5...v1.0.6
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.4...v1.0.5
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.4...v1.0.5
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.3...v1.0.4
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.3...v1.0.4
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.2...v1.0.3
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.2...v1.0.3
smaller npm package size:
before:
npm notice package size: 30.3 kB npm notice unpacked size: 208.4 kB
after:
npm notice package size: 17.1 kB npm notice unpacked size: 61.0 kB
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.1...v1.0.2
https://github.com/chimurai/http-proxy-middleware/compare/v1.0.0...v1.0.1
feat(createProxyMiddleware): explicit import http-proxy-middleware (BREAKING CHANGE)
https://github.com/chimurai/http-proxy-middleware/compare/v0.21.0...v1.0.0
require/import of http-proxy-middleware is now explicit
functionality did not change in this release.
https://humanwhocodes.com/blog/2019/01/stop-using-default-exports-javascript-module
v0.x.x with implicit require
const proxy = require('http-proxy-middleware');
v1.0.0 with explicit require
const { createProxyMiddleware } = require('http-proxy-middleware');
import { Filter, Options, RequestHandler } from 'http-proxy-middleware';
Moving to less confusing semver versioning (https://github.com/chimurai/http-proxy-middleware/issues/358)
Nothing published for this version
https://github.com/chimurai/http-proxy-middleware/compare/v0.20.0...v0.21.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →