feat: access handler name add properties to req route options

lib/request.js

@@ -172,6 +172,7 @@ Object.defineProperties(Request.prototype, {
   },
   routerPath: {
     get () {
+      warning.emit('FSTDEP017')
       return this[kRouteContext].config?.url
     }
   },
@@ -181,6 +182,7 @@ Object.defineProperties(Request.prototype, {
       const routeLimit = context._parserOptions.limit
       const serverLimit = context.server.initialConfig.bodyLimit
       const version = context.server.hasConstraintStrategy('version') ? this.raw.headers['accept-version'] : undefined
+      const { handler } = context
       const options = {
         method: context.config?.method,
         url: context.config?.url,
@@ -189,23 +191,37 @@ Object.defineProperties(Request.prototype, {
         logLevel: context.logLevel,
         exposeHeadRoute: context.exposeHeadRoute,
         prefixTrailingSlash: context.prefixTrailingSlash,
+        handler,
         version
       }
+
+      Object.defineProperties(options, {
+        config: {
+          get: () => context.config
+        },
+        schema: {
+          get: () => context.schema
+        }
+      })
+
       return Object.freeze(options)
     }
   },
   routerMethod: {
     get () {
+      warning.emit('FSTDEP018')
       return this[kRouteContext].config?.method
     }
   },
   routeConfig: {
     get () {
+      warning.emit('FSTDEP016')
       return this[kRouteContext][kPublicRouteContext]?.config
     }
   },
   routeSchema: {
     get () {
+      warning.emit('FSTDEP015')
       return this[kRouteContext][kPublicRouteContext].schema
     }
   },

lib/warnings.js

@@ -27,6 +27,14 @@ warning.create('FastifyDeprecation', 'FSTDEP013', 'Direct return of "trailers" f
 
 warning.create('FastifyDeprecation', 'FSTDEP014', 'You are trying to set/access the default route. This property is deprecated. Please, use setNotFoundHandler if you want to custom a 404 handler or the wildcard (*) to match all routes.')
 
+warning.create('FastifyDeprecation', 'FSTDEP015', 'You are accessing the deprecated "request.routeSchema" property. Use "request.routeOptions.schema" instead. Property "req.routeSchema" will be removed in `fastify@5`.')
+
+warning.create('FastifyDeprecation', 'FSTDEP016', 'You are accessing the deprecated "request.routeConfig" property. Use "request.routeOptions.config" instead. Property "req.routeConfig" will be removed in `fastify@5`.')
+
+warning.create('FastifyDeprecation', 'FSTDEP017', 'You are accessing the deprecated "request.routerPath" property. Use "request.routeOptions.config.url" instead. Property "req.routerPath" will be removed in `fastify@5`.')
+
+warning.create('FastifyDeprecation', 'FSTDEP018', 'You are accessing the deprecated "request.routerMethod" property. Use "request.routeOptions.config.method" instead. Property "req.routerMethod" will be removed in `fastify@5`.')
+
 warning.create('FastifyWarning', 'FSTWRN001', 'The %s schema for %s: %s is missing. This may indicate the schema is not well specified.', { unlimited: true })
 
 module.exports = warning

test/request.deprecated.test.js

@@ -0,0 +1,38 @@
+'use strict'
+
+// Tests for some deprecated `request.*` keys. This file should be
+// removed when the deprecation is complete.
+
+process.removeAllListeners('warning')
+
+const test = require('tap').test
+const Fastify = require('../')
+
+test('Should expose router options via getters on request and reply', t => {
+  t.plan(7)
+  const fastify = Fastify()
+  const expectedSchema = {
+    params: {
+      id: { type: 'integer' }
+    }
+  }
+
+  fastify.get('/test/:id', {
+    schema: expectedSchema
+  }, (req, reply) => {
+    t.equal(req.routeConfig.url, '/test/:id')
+    t.equal(req.routeConfig.method, 'GET')
+    t.same(req.routeSchema, expectedSchema)
+    t.equal(req.routerPath, '/test/:id')
+    t.equal(req.routerMethod, 'GET')
+    reply.send()
+  })
+
+  fastify.inject({
+    method: 'GET',
+    url: '/test/123456789'
+  }, (error, res) => {
+    t.error(error)
+    t.equal(res.statusCode, 200)
+  })
+})

test/router-options.test.js

@@ -92,7 +92,7 @@ test('Should honor maxParamLength option', t => {
 })
 
 test('Should expose router options via getters on request and reply', t => {
-  t.plan(10)
+  t.plan(9)
   const fastify = Fastify()
   const expectedSchema = {
     params: {
@@ -105,11 +105,10 @@ test('Should expose router options via getters on request and reply', t => {
   }, (req, reply) => {
     t.equal(reply.context.config.url, '/test/:id')
     t.equal(reply.context.config.method, 'GET')
-    t.equal(req.routeConfig.url, '/test/:id')
-    t.equal(req.routeConfig.method, 'GET')
-    t.same(req.routeSchema, expectedSchema)
-    t.equal(req.routerPath, '/test/:id')
-    t.equal(req.routerMethod, 'GET')
+    t.same(req.routeOptions.schema, expectedSchema)
+    t.equal(typeof req.routeOptions.handler, 'function')
+    t.equal(req.routeOptions.config.url, '/test/:id')
+    t.equal(req.routeOptions.config.method, 'GET')
     t.equal(req.is404, false)
     reply.send({ hello: 'world' })
   })