A JavaScript Node.js module that parses the HTTP `X-Forwarded-For` header from a Node.js `IncomingMessage` request object. It returns an array of IP addresses, including the socket address, in reverse order (index 0 is the socket address, the last index is typically the end-user).
Project status
- Maintenance status: Appears actively maintained recently, with an upstream push dated 2026-06-01 (close to today), but the latest published version update noted here is v0.2.0 (2021-05-31), so versioned updates are infrequent.
- Update cadence: After initial releases in 2017, there is a long gap until v0.2.0 in 2021, and no further versioned updates are shown in the provided history, despite the recent upstream commit activity.
AI summary generated
Recent updates
v0.2.0
Release v0.2.0 primarily updates how the library extracts the client IP for X-Forwarded-For parsing, moving from the deprecated req.connection to req.socket. The core behavior is implemented in index.js via a new getSocketAddr helper and validated with updated tests.
v0.1.2
Release v0.1.2 focuses on performance improvements to how the library parses the X-Forwarded-For header. It also adds a small benchmark harness and updates dev tooling/CI settings.
v0.1.1
Version 0.1.1 updates the X-Forwarded-For parsing to fix incorrect handling of leading and trailing optional whitespace (OWS), and it includes a small performance tweak by hoisting the token-splitting RegExp. The release notes only mention these behavioral and perf changes.
v0.1.0
This release, v0.1.0, is the initial public release of the project. There are no release notes beyond the statement that it is the first version, so no specific developer-impacting changes are documented.