feat: add getValidatedRouterParams util

README.md

@@ -215,6 +215,8 @@ H3 has a concept of composable utilities that accept `event` (from `eventHandler
 - `getQuery(event)`
 - `getValidatedQuery(event, validate)`
 - `getRouterParams(event)`
+- `getValidatedRouterParams(event, validate)`
+- `getRouterParam(event, name)`
 - `getMethod(event, default?)`
 - `isMethod(event, expected, allowHead?)`
 - `assertMethod(event, expected, allowHead?)`

src/types.ts

@@ -51,10 +51,9 @@ export interface H3EventContext extends Record<string, any> {
 export type EventHandlerResponse<T = any> = T | Promise<T>;
 
 export interface EventHandlerRequest {
-  // TODO: Default to unknown in next major version
-  body?: any;
-
+  body?: any; // TODO: Default to unknown in next major version
   query?: QueryObject;
+  routerParams?: Record<string, string>;
 }
 
 export type InferEventInput<

src/utils/request.ts

@@ -34,6 +34,16 @@ export function getRouterParams(
   return event.context.params || {};
 }
 
+export function getValidatedRouterParams<
+  T,
+  Event extends H3Event = H3Event,
+  _T = InferEventInput<"routerParams", Event, T>,
+>(event: Event, validate: ValidateFunction<_T>): Promise<_T> {
+  const routerParams = getRouterParams(event);
+
+  return validateData(routerParams, validate);
+}
+
 export function getRouterParam(
   event: H3Event,
   name: string,