Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Web-hacking proxy API for node
JavaScript HTML CSS


Description: Web-debugging proxy API for node.


Installation: npm install hoxy


var hoxy = require('hoxy');

var proxy = new hoxy.Proxy();

  phase: 'response',
  mimeType: 'text/html',
  as: '$'
}, function(req, resp){


// now proxy your client through localhost:8080 

Release notes:

  • 1.2.4 Improved cheerio markup serialization. Thanks Seth Holladay.
  • 1.2.3 Test command now npm test instead of mocha. Proxy close() method now passes args through to server close. Thanks Seth Holladay.
  • 1.2.2 Fixed errors and test failures occurring on io.js.
  • 1.2.1 Make listen() accept same args as native server.listen() instead of just port. Thanks Seth Holladay.
  • 1.2.0 Send content-length whenever reasonably possible. (minor version bump since minor alteration to existing behavior)
  • 1.1.5 Default protocol to 'http:' if not found because I'm a genius.
  • 1.1.4 Default protocol to 'http' if not found.
  • 1.1.3 Don't munge content-length headers unless necessary.
  • 1.1.2 Burned a version number because I suck at npm.
  • 1.1.1 Added SSL support for requests (protocol: https).
  • 1.1.0 Added CLI functionality to scaffold new proxy projects.
  • 1.0.5 Fixed static conditional get fail, flexible contentType matching, ability to set fullUrl.
  • 1.0.4 npm distribution no longer contains test directory.
  • 1.0.3 Fixed issue #21 causing breakage on windows, due to use of unix domain sockets.
  • 1.0.2 Added tee() method to requests and responses, and accompanying tests.
  • 1.0.1 Fixed bug with URL pattern matching, added filtering tests.
  • 1.0.0 Initial release of Hoxy 1.0 rewrite.

Note: 1.x vs 0.x

If you're looking for the old command line version of hoxy, it's branched as v0.2.x in this repository and still available on npm. Continued updates to that branch are unlikely.

1.x is an overhaul of the project. 1.x is a programming API, whereas 0.x was a command line utility. 1.x fully passes a decently large test suite.

Something went wrong with that request. Please try again.