← 목차

12. 압축

compression()을 켜면 요청에 accept-encoding: gzip, deflate를 붙이고 응답이 gzip 또는 deflate로 인코딩됐으면 투명하게 해제한다.

const response = await ZLinkHttpClient.create('https://api.internal')
  .compression()
  .get('/large-report')
  .submit<Report>();

래퍼 통제 해제

undici request는 응답을 자동 해제하지 않는다. 그래서 래퍼가 node:zlib로 해제를 통제한다. 이유는 의미론을 zlink 계약에 맞추기 위해서다:

• gzip + deflate 모두 처리한다(deflate는 zlib-wrap/raw 둘 다 감지).
• 해제 후 content-encoding 헤더를 제거한다.
• decoded 크기를 maxResponseBodySize로 강제한다.
• download(sink) streaming chunk는 해제하지 않는다(받은 그대로 전달).

본문이 손상됐으면 payloadDecodeFailed, decoded 크기가 한도를 넘으면 requestFailed로 보고된다.

다음: 에러 처리 →