From 35a370416be591543cc852ccabd7b35c3e98c1e1 Mon Sep 17 00:00:00 2001 From: productdevbook Date: Sun, 15 Mar 2026 10:25:29 +0300 Subject: [PATCH 1/7] docs: fix incorrect code examples in guides - html() does not take event as first argument (response.md) - onError() takes (error, event) not (event, error) (error.md) - Remove undefined variable `body` in onResponse example (middleware.md) - Fix stray closing parenthesis in web handler example (handler.md) - Fix invalid for loop syntax: add missing `i++` (response.md + JSDoc) - Replace deprecated event.path with event.url.pathname (h3.md) Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/1.guide/1.basics/3.middleware.md | 2 +- docs/1.guide/1.basics/4.handler.md | 2 +- docs/1.guide/1.basics/5.response.md | 2 +- docs/1.guide/1.basics/6.error.md | 2 +- docs/1.guide/900.api/1.h3.md | 2 +- docs/2.utils/2.response.md | 2 +- src/utils/response.ts | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/1.guide/1.basics/3.middleware.md b/docs/1.guide/1.basics/3.middleware.md index 696e1d6fd..c09061457 100644 --- a/docs/1.guide/1.basics/3.middleware.md +++ b/docs/1.guide/1.basics/3.middleware.md @@ -89,7 +89,7 @@ app.use( app.use( onResponse((response, event) => { - console.log(`[${event.req.method}] ${event.url.pathname} ~>`, body); + console.log(`[${event.req.method}] ${event.url.pathname} ~>`, response.status); }), ); diff --git a/docs/1.guide/1.basics/4.handler.md b/docs/1.guide/1.basics/4.handler.md index 49c8a6cd5..e928bf64f 100644 --- a/docs/1.guide/1.basics/4.handler.md +++ b/docs/1.guide/1.basics/4.handler.md @@ -133,7 +133,7 @@ import { H3, fromWebHandler } from "h3"; export const app = new H3(); -const webHandler = (request) => new Response("👋 Hello!")); +const webHandler = (request) => new Response("👋 Hello!"); // Using fromWebHandler utiliy app.all("/web", fromWebHandler(webHandler)); diff --git a/docs/1.guide/1.basics/5.response.md b/docs/1.guide/1.basics/5.response.md index 283aff3c8..0f7870bc8 100644 --- a/docs/1.guide/1.basics/5.response.md +++ b/docs/1.guide/1.basics/5.response.md @@ -91,7 +91,7 @@ You can also use `html` utility as shortcut. ```js import { html } from "h3"; -app.get("/", (event) => html(event, "

hello world

")); +app.get("/", () => html("

hello world

")); ``` ### `Response` diff --git a/docs/1.guide/1.basics/6.error.md b/docs/1.guide/1.basics/6.error.md index 33ec67c9a..40ded1cb7 100644 --- a/docs/1.guide/1.basics/6.error.md +++ b/docs/1.guide/1.basics/6.error.md @@ -98,7 +98,7 @@ import { onError } from "h3"; // Handling errors using middleware app.use( - onError(event, (event, error) => { + onError((error, event) => { console.error(error); }), ); diff --git a/docs/1.guide/900.api/1.h3.md b/docs/1.guide/900.api/1.h3.md index b72362a9f..7f72c1bb6 100644 --- a/docs/1.guide/900.api/1.h3.md +++ b/docs/1.guide/900.api/1.h3.md @@ -133,7 +133,7 @@ const app = new H3({ console.log("Request:", event.req.url); }, onResponse: (response, event) => { - console.log("Response:", event.path, response.status); + console.log("Response:", event.url.pathname, response.status); }, onError: (error, event) => { console.error(error); diff --git a/docs/2.utils/2.response.md b/docs/2.utils/2.response.md index 6817796b5..c54f76d2d 100644 --- a/docs/2.utils/2.response.md +++ b/docs/2.utils/2.response.md @@ -87,7 +87,7 @@ return iterable(async function* work() { // Open document body yield "\n

Executing...

    \n"; // Do work ... - for (let i = 0; i < 1000) { + for (let i = 0; i < 1000; i++) { await delay(1000); // Report progress yield `
  1. Completed job #`; diff --git a/src/utils/response.ts b/src/utils/response.ts index 5c5a0aa74..2e5f45c02 100644 --- a/src/utils/response.ts +++ b/src/utils/response.ts @@ -105,7 +105,7 @@ export function writeEarlyHints( * // Open document body * yield "\n

    Executing...

      \n"; * // Do work ... - * for (let i = 0; i < 1000) { + * for (let i = 0; i < 1000; i++) { * await delay(1000); * // Report progress * yield `
    1. Completed job #`; From ffd3397ef642f842f6a254b19ccf21f4576ca859 Mon Sep 17 00:00:00 2001 From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com> Date: Sun, 15 Mar 2026 07:26:17 +0000 Subject: [PATCH 2/7] chore: apply automated updates --- docs/1.guide/1.basics/4.handler.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/1.guide/1.basics/4.handler.md b/docs/1.guide/1.basics/4.handler.md index e928bf64f..bad287626 100644 --- a/docs/1.guide/1.basics/4.handler.md +++ b/docs/1.guide/1.basics/4.handler.md @@ -139,10 +139,10 @@ const webHandler = (request) => new Response("👋 Hello!"); app.all("/web", fromWebHandler(webHandler)); // Using simple wrapper -app.all("/web", event => webHandler(event.req)); +app.all("/web", (event) => webHandler(event.req)); // Using app.mount -app.mount("/web", webHandler) +app.mount("/web", webHandler); ``` ### From Node.js Handlers From 1a6916a6ee6f3de82885a52eddd607fbb6f8d7c5 Mon Sep 17 00:00:00 2001 From: productdevbook Date: Sun, 15 Mar 2026 10:29:01 +0300 Subject: [PATCH 3/7] chore: apply oxfmt formatting fixes Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/2.utils/2.response.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/2.utils/2.response.md b/docs/2.utils/2.response.md index c54f76d2d..68a7c187c 100644 --- a/docs/2.utils/2.response.md +++ b/docs/2.utils/2.response.md @@ -96,9 +96,9 @@ return iterable(async function* work() { } // Close out the report return `
    `; -}) +}); async function delay(ms) { - return new Promise(resolve => setTimeout(resolve, ms)); + return new Promise((resolve) => setTimeout(resolve, ms)); } ``` From 012fc0e759be47ee8918678acaddd9bacfdcadd0 Mon Sep 17 00:00:00 2001 From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com> Date: Sun, 15 Mar 2026 07:29:42 +0000 Subject: [PATCH 4/7] chore: apply automated updates --- docs/2.utils/2.response.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/2.utils/2.response.md b/docs/2.utils/2.response.md index 68a7c187c..c54f76d2d 100644 --- a/docs/2.utils/2.response.md +++ b/docs/2.utils/2.response.md @@ -96,9 +96,9 @@ return iterable(async function* work() { } // Close out the report return `
`; -}); +}) async function delay(ms) { - return new Promise((resolve) => setTimeout(resolve, ms)); + return new Promise(resolve => setTimeout(resolve, ms)); } ``` From 829f15e6417a05ea5235bfb5d595bd392420a24d Mon Sep 17 00:00:00 2001 From: productdevbook Date: Sun, 15 Mar 2026 10:35:20 +0300 Subject: [PATCH 5/7] chore: fix oxfmt formatting in response.md Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/2.utils/2.response.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/2.utils/2.response.md b/docs/2.utils/2.response.md index c54f76d2d..68a7c187c 100644 --- a/docs/2.utils/2.response.md +++ b/docs/2.utils/2.response.md @@ -96,9 +96,9 @@ return iterable(async function* work() { } // Close out the report return ``; -}) +}); async function delay(ms) { - return new Promise(resolve => setTimeout(resolve, ms)); + return new Promise((resolve) => setTimeout(resolve, ms)); } ``` From 284154be1e89afa531d94c004bb8b59eab1d8c22 Mon Sep 17 00:00:00 2001 From: "autofix-ci[bot]" <114827586+autofix-ci[bot]@users.noreply.github.com> Date: Sun, 15 Mar 2026 07:35:54 +0000 Subject: [PATCH 6/7] chore: apply automated updates --- docs/2.utils/2.response.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/2.utils/2.response.md b/docs/2.utils/2.response.md index 68a7c187c..c54f76d2d 100644 --- a/docs/2.utils/2.response.md +++ b/docs/2.utils/2.response.md @@ -96,9 +96,9 @@ return iterable(async function* work() { } // Close out the report return ``; -}); +}) async function delay(ms) { - return new Promise((resolve) => setTimeout(resolve, ms)); + return new Promise(resolve => setTimeout(resolve, ms)); } ``` From 4f5b1babc814b10eceab52cce8cff697d81653df Mon Sep 17 00:00:00 2001 From: productdevbook Date: Sun, 15 Mar 2026 10:54:32 +0300 Subject: [PATCH 7/7] fix: fix formatting in iterable() JSDoc source (automd regenerates docs) The docs file is auto-generated from JSDoc via automd. Fix the source JSDoc formatting (missing semicolon, arrow function parens) so the generated docs pass oxfmt checks. Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/2.utils/2.response.md | 4 ++-- src/utils/response.ts | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/2.utils/2.response.md b/docs/2.utils/2.response.md index c54f76d2d..68a7c187c 100644 --- a/docs/2.utils/2.response.md +++ b/docs/2.utils/2.response.md @@ -96,9 +96,9 @@ return iterable(async function* work() { } // Close out the report return ``; -}) +}); async function delay(ms) { - return new Promise(resolve => setTimeout(resolve, ms)); + return new Promise((resolve) => setTimeout(resolve, ms)); } ``` diff --git a/src/utils/response.ts b/src/utils/response.ts index 2e5f45c02..756d4d887 100644 --- a/src/utils/response.ts +++ b/src/utils/response.ts @@ -114,9 +114,9 @@ export function writeEarlyHints( * } * // Close out the report * return ``; - * }) + * }); * async function delay(ms) { - * return new Promise(resolve => setTimeout(resolve, ms)); + * return new Promise((resolve) => setTimeout(resolve, ms)); * } */ export function iterable(