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
- The upstream purpose is clear and narrow, it parses the HTTP
X-Forwarded-Forheader, and the most recent recorded upstream push (2026-06-01) suggests the repository is still actively touched, even though the last tagged version update is much older. - Apparent
updatescadence is low, with version tags at 0.1.1 (2017-09-11), 0.1.2 (2017-09-15), then a gap until 0.2.0 (2021-05-31).
AI summary generated Today
Recent updates
v0.2.0
5/31/2021Release 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
9/15/2017Release 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
9/11/2017Version 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
9/10/2017This 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.