Content-Disposition 파서

GeekFormat 정보

Content-Disposition 파서

Content-Disposition 헤더를 분석합니다.Disposition 유형, 파일명, 파일명* 및 국제화 파일명과 RFC 5987 인코딩을 지원합니다.

파싱 요약

Disposition 유형

attachment

실제 파일명

report Q2.csv

파일명

report.csv

filename*

UTF-8''report%20Q2.csv

빌더

attachment; filename="report.csv"; filename*=UTF-8''report%20Q2.csv

JSON 미리보기

{
  "type": "attachment",
  "parameters": {
    "filename": "report.csv",
    "filename*": "UTF-8''report%20Q2.csv"
  },
  "effectiveFilename": "report Q2.csv",
  "warnings": []
}

다운로드 헤더를 온라인에서 이해하고, 파일명 깨짐을 먼저 확인하세요.

사용 사례

파일 다운로드 후 이름이 깨지거나 브라우저가 예상대로 미리보기를 하지 않을 때 Content-Disposition의 구체적인 표기법 확인
Excel, PDF 등 첨부 파일 다운로드 API 디버깅 시 생성기로 표준 Content-Disposition 헤더 구성
브라우저 인라인 미리보기와 첨부 파일 다운로드 동작 차이 확인 시 attachment와 inline 유형 비교
게이트웨이 또는 CDN이 다운로드 응답 헤더를 투명 전송할 때 filename*의 UTF-8 인코딩 정확성 확인

이용 방법

Content-Disposition 응답 헤더 내용을 파싱 영역에 붙여넣거나 생성기로 각 필드 설정
파싱 모드에서 disposition 유형, effectiveFilename, filename 및 filename* 값 확인
생성 모드에서 attachment 또는 inline 선택, filename 및 UTF-8 파일명 입력
생성된 Content-Disposition 내용을 API 디버깅 또는 서버 설정 비교에 복사

주요 기능

다운로드 동작 명확히 분석: 미리보기, 다운로드, 파일명 인코딩 분리 확인
중국어 파일명 문제 해결: filename과 filename* 호환성 문제 해결에 특히 적합
API 통합 테스트 필수: 파일 내보내기, 첨부 파일 다운로드, 미리보기 링크 및 게이트웨이 투명 전송 시나리오에 적합
파싱 결과 명확: 필드별 상세 분석으로 개발자에게 복사하거나 서버 설정과 직접 비교 가능

자주 묻는 질문

왜 다운로드 파일명이 깨지나요?

가장 흔한 원인은 filename 인코딩이 불완전하거나 filename만 작성하고 filename*를 처리하지 않았기 때문입니다. 응답 헤더를 분리해 보면 일반적으로 빠르게 문제점을 파악할 수 있습니다.

attachment와 inline의 차이점은 무엇인가요?

attachment는 일반적으로 첨부 파일 다운로드를 나타내며, inline은 브라우저 인라인 미리보기에 더 적합합니다. 파싱 후 파일 처리 방식을 직관적으로 확인하여 다운로드와 미리보기 동작을 문제 해결할 수 있습니다.

이 도구가 API 통합 테스트와 파일 다운로드 문제 해결에 적합한가요?

네. 특히 Excel, PDF, 압축 파일 등 다운로드 API에 적합하여 파일명, 인코딩 및 응답 헤더 설정이 올바른지 빠르게 검증할 수 있습니다.

중국어 파일명과 RFC 5987 인코딩을 검사할 수 있나요?

네. 이 도구는 filename과 filename*의 차이를 식별하는 데 중점을 두어 중국어 파일명, 공백, 특수 문자 등 호환성 문제 해결에 적합합니다.

Content-Disposition 파서