Skip to content

docs: clarify HTTPException docs#748

Merged
yusukebe merged 5 commits into
honojs:mainfrom
ambergristle:amend-httpexception-docs
Oct 2, 2025
Merged

docs: clarify HTTPException docs#748
yusukebe merged 5 commits into
honojs:mainfrom
ambergristle:amend-httpexception-docs

Conversation

@ambergristle

Copy link
Copy Markdown
Contributor

Motivations

Questions have come in on the Discord server from users who interpreted the docs to mean that HTTPException must be used. There are also some implementation details and "gotchas" that the docs didn't cover.

What's Changed

  • clarify that HTTPException is thrown by Hono ecosystem code, but that devs can throw it themselves
  • specify why HTTPException might be used instead of other errors
  • add context about response types and header behavior
  • add call-out about custom response status
  • add info about onError and notFound behavior in sub-routes

@yusukebe yusukebe left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@yusukebe

yusukebe commented Oct 2, 2025

Copy link
Copy Markdown
Member

@ambergristle

Nice! I think this is perfect. Let's merge. Thanks!

@yusukebe
yusukebe merged commit 43fee22 into honojs:main Oct 2, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants