AI 요약
일본 개발자가 새로운 HTTP 메서드 ‘QUERY’를 Hono + Bun 환경에서 구현한 사례를 공유했다. QUERY는 RFC 10008로 제안된 표준으로, ‘바디를 가질 수 있는 안전한 GET’으로 GET의 캐시 가능성과 POST의 바디 전송 기능을 결합했다. 복잡한 검색 조건을 URL 쿼리스트링 대신 바디로 전달하면서도 리소스를 변경하지 않고 캐시가 가능하다. Hono의 app.on() 메서드로 QUERY 메서드를 등록하고, OPTIONS 응답에 Allow 헤더와 Accept-Query 헤더를 포함해 클라이언트가 지원 여부를 확인할 수 있도록 했다.
핵심 포인트
- QUERY 메서드는 GET(안전·캐시 가능)과 POST(바디 전송)의 장점을 결합
- GET은 바디에 의미를 부여할 수 없지만, QUERY는 바디로 복잡한 검색 조건 전달 가능
- Hono의 app.on(‘QUERY’, path, handler)로 비표준 메서드 등록 가능
- OPTIONS 응답에 Allow: QUERY, OPTIONS 및 Accept-Query: application/json 헤더 포함
향후 전망
- 복잡한 검색 API에서 URL 길이 제한과 구조적 한계를 해결할 대안으로 주목
- 아직 Proposed Standard 단계로, 실제 브라우저·프록시·CDN 지원 확대가 관건
출처:Qiita (@maaaashi)