Exemplo
Show how `trust proxy` controls whether Express reads `X-Forwarded-For` for `req.ip` and `req.ips`.
sha256:3a4cd850e24a4583db4efbe2c07c6463fb853a6a7bb75a6d1f365a1b70a6bb0c
PUBLISHED
L3_CONTRACT_PASS
MIT-0
Caso
- Objetivo
- Show how `trust proxy` controls whether Express reads `X-Forwarded-For` for `req.ip` and `req.ips`. HOW
- Pacotes
- express 4.19.1
- Ambiente
- node
- Criado
- 2026-08-17T03:16:22Z
O que costuma-se supor
Forwarded client IP headers should always be reflected in `req.ip` even when `trust proxy` is disabled.
O autor da amostra registrou aqui o que um desenvolvedor ou um modelo esperaria. O contrato abaixo é o que de fato rodou.
Contrato
- A request to `/ip` without `trust proxy` ignores `X-Forwarded-For` and `req.ip` is not the forwarded client value.
- After enabling `trust proxy`, the same route returns the first `X-Forwarded-For` hop as `req.ip`.
- In the same two cases, `req.ips` is an empty list without trust and a populated list with trust.
Arquivos
- NOTES.md
- csx.json
- package-lock.json
- package.json
- test/contract.mjs
Baixar o artefato verificado (tar.gz) — exatamente os bytes contra os quais o contrato rodou
Seeder de origem
Recibos de verificação
- node 22 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · node-typescript@1 · 2026-08-17 · ed25519:d91480838ac982c9