Advanced
Session utils
Clear the session data for the current request.
Get the session for the current request.
Encrypt and sign the session data for the current request.
Decrypt and verify the session data for the current request.
Update the session data for the current request.
Create a session manager for the current request.
Remove a cookie by name.
Get a cookie value by name.
Parse the request to get HTTP Cookie header string and returning an object of all cookie name-value pairs.
Set a cookie value by name.
Get a unique fingerprint for the incoming request.
Define WebSocket hooks.
Define WebSocket event handler.
Make sure the status code is a valid HTTP status code.
Make sure the status message is safe to use in a response.
Allowed characters: horizontal tabs, spaces or visible ascii characters: https://www.rfc-editor.org/rfc/rfc7230#section-3.1.2
Returns a new event handler that removes the base url of the event before calling the original handler.
Example:
Check request caching headers (If-Modified-Since) and add caching headers (Last-Modified, Cache-Control) Note: public cache control will be added by default
Make a fetch request with the event's context and headers.
Get the request headers object without headers known to cause issues when proxying.
Make a proxy request to a target URL and send the response back to the client.
Proxy the incoming request to a target URL.
Append CORS headers to the response.
Append CORS preflight headers to the response.
Handle CORS for the incoming request.
If the incoming request is a CORS preflight request, it will append the CORS preflight headers and send a 204 response.
If return value is true, the request is handled and no further action is needed.
Example:
Check if the incoming request is a CORS request.
Check if the incoming request is a CORS preflight request.
Initialize an EventStream instance for creating server sent events
Example:
Cookie utils
Fingerprint utils
WebSocket utils
Sanitize
Base
const api = createApp()
.get("/", () => "Hello API!");
const app = createApp();
.use("/api/**", withBase("/api", api.handler));
Cache
Proxy
CORS
const app = createApp();
const router = createRouter();
router.use("/", async (event) => {
const corsRes = handleCors(event, {
origin: "*",
preflight: {
statusCode: 204,
},
methods: "*",
});
if (corsRes) {
return corsRes;
}
// Your code here
});
);
Server Sent Events (SSE)
import { createEventStream, sendEventStream } from "h3";
app.use("/sse", (event) => {
const eventStream = createEventStream(event);
// Send a message every second
const interval = setInterval(async () => {
await eventStream.push("Hello world");
}, 1000);
// cleanup the interval and close the stream when the connection is terminated
eventStream.onClosed(async () => {
console.log("closing SSE...");
clearInterval(interval);
await eventStream.close();
});
return eventStream.send();
});