docs(hono): Document shouldHandleError option (#17923)

## DESCRIBE YOUR PR
Documents: getsentry/sentry-javascript#21205

Adds "Hono Features" to the sidebar:

<img width="297" height="220" alt="image"
src="https://github.com/user-attachments/assets/7bf2b777-df43-4b97-8911-9c273d233b38"
/>


## IS YOUR CHANGE URGENT?  

Help us prioritize incoming PRs by letting us know when the change needs
to go live.
- [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE -->
- [ ] Other deadline: <!-- ENTER DATE HERE -->
- [ ] None: Not urgent, can wait up to 1 week+

## SLA

- Teamwork makes the dream work, so please add a reviewer to your PRs.
- Please give the docs team up to 1 week to review your PR unless you've
added an urgent due date to it.
Thanks in advance for your help!

## PRE-MERGE CHECKLIST

*Make sure you've checked the following before merging your changes:*

- [ ] Checked Vercel preview for correctness, including links
- [ ] PR was reviewed and approved by any necessary SMEs (subject matter
experts)
- [ ] PR was reviewed and approved by a member of the [Sentry docs
team](https://github.com/orgs/getsentry/teams/docs)

Author: s1gr1d

docs/platforms/javascript/guides/hono/features/error-handler.mdx

@@ -0,0 +1,102 @@
+---
+title: Error Handler
+description: "Learn how Sentry's Hono SDK captures errors and how to customize which errors are sent to Sentry."
+---
+
+The `sentry()` middleware automatically captures unhandled errors from Hono's `onError` handler.
+
+## Default Behavior
+
+The default logic checks whether the error carries a numeric `status` property (as Hono's `HTTPException` and similar error types do).
+
+The middleware captures:
+
+- **5xx errors** — anything with a numeric `status >= 500`
+- **Non-HTTP errors** — errors without a numeric `status` property, including standard `Error` instances, non-object throws, and `null`
+
+The middleware ignores:
+
+- **3xx–4xx errors** — anything with a numeric `status` in the range 300–499 (redirects, client errors)
+
+Use `shouldHandleError` when you need to capture errors outside this default range, for example to track 401 and 403 responses as security signals.
+
+## Using `shouldHandleError`
+
+Pass a `shouldHandleError` callback to the `sentry()` middleware. The callback receives the raw error as `unknown` and must return `true` to capture it or `false` to suppress it.
+
+```typescript {tabTitle:Cloudflare Workers} {filename:index.ts} {mdExpandTabs}
+import { Hono } from "hono";
+import { sentry } from "@sentry/hono/cloudflare";
+
+const app = new Hono();
+
+app.use(
+  sentry(app, {
+    dsn: "___PUBLIC_DSN___",
+    shouldHandleError(error) {
+      const status = (error as { status?: number })?.status;
+      // Capture 401/403 in addition to the default 5xx errors
+      return (
+        status === 401 ||
+        status === 403 ||
+        typeof status !== "number" ||
+        status >= 500
+      );
+    },
+  })
+);
+
+export default app;
+```
+
+```typescript {tabTitle:Node.js} {filename:app.ts}
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { sentry } from "@sentry/hono/node";
+
+const app = new Hono();
+
+app.use(
+  sentry(app, {
+    shouldHandleError(error) {
+      const status = (error as { status?: number })?.status;
+      // Capture 401/403 in addition to the default 5xx errors
+      return (
+        status === 401 ||
+        status === 403 ||
+        typeof status !== "number" ||
+        status >= 500
+      );
+    },
+  })
+);
+
+// Your routes here
+
+serve(app);
+```
+
+```typescript {tabTitle:Bun} {filename:index.ts}
+import { Hono } from "hono";
+import { sentry } from "@sentry/hono/bun";
+
+const app = new Hono();
+
+app.use(
+  sentry(app, {
+    dsn: "___PUBLIC_DSN___",
+    shouldHandleError(error) {
+      const status = (error as { status?: number })?.status;
+      // Capture 401/403 in addition to the default 5xx errors
+      return (
+        status === 401 ||
+        status === 403 ||
+        typeof status !== "number" ||
+        status >= 500
+      );
+    },
+  })
+);
+
+export default app;
+```

docs/platforms/javascript/guides/hono/features/index.mdx

@@ -0,0 +1,9 @@
+---
+title: Hono Features
+description: "Learn how Sentry's Hono SDK exposes features for first-class integration with Hono."
+excerpt: ""
+---
+
+The Sentry Hono SDK offers Hono-specific features for first-class integration with the framework.
+
+<PageGrid />

docs/platforms/javascript/guides/hono/index.mdx

@@ -357,6 +357,8 @@ export default app;
 
 By default, Sentry captures exceptions from Hono's `onError` handler, excluding errors with 3xx or 4xx status codes. No additional configuration is needed for this.
 
+To control which errors are captured, use the <PlatformLink to="/features/error-handler/">`shouldHandleError`</PlatformLink> option.
+
 ### Add Readable Stack Traces With Source Maps (Optional)
 
 <PlatformContent includePath="getting-started-sourcemaps-short-version" />
@@ -379,6 +381,7 @@ Now's a good time to customize your setup and look into more advanced topics:
 
 - Explore [practical guides](/guides/) on what to monitor, log, track, and investigate after setup
 - Learn how to <PlatformLink to="/usage">manually capture errors</PlatformLink>
+- Explore <PlatformLink to="/features">Hono-specific features</PlatformLink> like custom error filtering
 - Continue to <PlatformLink to="/configuration">customize your configuration</PlatformLink>
 - Get familiar with [Sentry's product features](/product) like tracing, insights, and alerts