정의
리소스의 헤더 정보만 조회하는 HTTP 메서드
다운로드 여부, 캐시 유효성 검사, 존재 확인 등에서 유용하게 사용됩니다.
특징
본문 없이 메타 정보만 반환
안정성 O: 서버 상태를 변경하지 않음
멱등성 O: 동일 요청 반복 시 결과 동일
본문 없음: 응답 본문 없이 헤더만 제공
캐시 검증: If-Modified-Since, ETag 검사에 활용
대역폭 절감: 본문 제외로 네트워크 부담 줄임
사용 예시
리소스의 메타 정보가 필요할 때 사용
파일 유효성 검사: 파일 크기, 형식 확인
리소스 존재 여부: 상태 코드로 존재 확인
캐시 확인: 클라이언트 캐시와 서버 데이터 비교
코드 예시
응답 본문 없이 헤더만 반환합니다.
fetch('/api/files/sample', {
method: 'HEAD'
})
.then(res => {
console.log('Content-Length:', res.headers.get('Content-Length'));
console.log('Content-Type:', res.headers.get('Content-Type'));
});