feat: add utility for router params (#120)

README.md

@@ -121,6 +121,7 @@ Instead of adding helpers to `req` and `res`, h3 exposes them as composable util
 - `setCookie(res, name, value, opts?)`
 - `deleteCookie(res, name, opts?)`
 - `useQuery(req)`
+- `getRouterParams(event)`
 - `send(res, data, type?)`
 - `sendRedirect(res, location, code=302)`
 - `getRequestHeaders(event, headers)` (alias: `getHeaders`)

src/utils/request.ts

@@ -10,6 +10,14 @@ export function getQuery (event: CompatibilityEvent) {
 /** @deprecated Use `h3.getQuery` */
 export const useQuery = getQuery
 
+export function getRouterParams (event: CompatibilityEvent): CompatibilityEvent['context'] {
+  // Fallback object needs to be returned in case router is not used (#149)
+  return event.context.params || {}
+}
+
+/** @deprecated Use `h3.getRouterParams` */
+export const useRouterParams = getRouterParams
+
 export function getMethod (event: CompatibilityEvent, defaultMethod: HTTPMethod = 'GET'): HTTPMethod {
   return (event.req.method || defaultMethod).toUpperCase() as HTTPMethod
 }

test/utils.test.ts

@@ -1,6 +1,6 @@
 import supertest, { SuperTest, Test } from 'supertest'
 import { describe, it, expect, beforeEach } from 'vitest'
-import { createApp, App, sendRedirect, useBase, useQuery, useMethod, assertMethod } from '../src'
+import { createApp, createRouter, App, sendRedirect, useBase, useQuery, getRouterParams, useRouterParams, useMethod, assertMethod } from '../src'
 
 describe('', () => {
   let app: App
@@ -53,6 +53,56 @@ describe('', () => {
     })
   })
 
+  describe('getRouterParams', () => {
+    it('can return router params', async () => {
+      const router = createRouter().get('/api/test/:name', (request) => {
+        const params = getRouterParams(request)
+        expect(params).toMatchObject({ name: 'string' })
+        return '200'
+      })
+      app.use(router)
+      const result = await request.get('/api/test/string')
+
+      expect(result.text).toBe('200')
+    })
+
+    it('can return an empty object if router is not used', async () => {
+      app.use('/', (request) => {
+        const params = getRouterParams(request)
+        expect(params).toMatchObject({})
+        return '200'
+      })
+      const result = await request.get('/')
+
+      expect(result.text).toBe('200')
+    })
+  })
+
+  describe('useRouterParams', () => {
+    it('can return router params', async () => {
+      const router = createRouter().get('/api/test/:name', (request) => {
+        const query = useRouterParams(request)
+        expect(query).toMatchObject({ name: 'string' })
+        return '200'
+      })
+      app.use(router)
+      const result = await request.get('/api/test/string')
+
+      expect(result.text).toBe('200')
+    })
+
+    it('can return an empty object if router is not used', async () => {
+      app.use('/', (request) => {
+        const params = useRouterParams(request)
+        expect(params).toMatchObject({})
+        return '200'
+      })
+      const result = await request.get('/')
+
+      expect(result.text).toBe('200')
+    })
+  })
+
   describe('useMethod', () => {
     it('can get method', async () => {
       app.use('/', req => useMethod(req))