V5 迁移指南

// v4
fastify.get('/route', {
  schema: {
    querystring: {
      name: { type: 'string' }
    }
  }
}, (req, reply) => {
  reply.send({ hello: req.query.name });
});
 

// v5
fastify.get('/route', {
  schema: {
    querystring: {
      type: 'object',
      properties: {
        name: { type: 'string' }
      },
      required: ['name']
    }
  }
}, (req, reply) => {
  reply.send({ hello: req.query.name });
});
 

// v4
const logger = require('pino')();
const fastify = require('fastify')({
  logger
});
 

// v5
const loggerInstance = require('pino')();
const fastify = require('fastify')({
  loggerInstance
});
 

const fastify = require('fastify')({
  useSemicolonDelimiter: true
});
 

// v4
fastify.get('/route/:name', (req, reply) => {
  console.log(req.params.hasOwnProperty('name')); // true
  return { hello: req.params.name };
});
 

// v5
fastify.get('/route/:name', (req, reply) => {
  console.log(Object.hasOwn(req.params, 'name')); // true
  return { hello: req.params.name };
});
 

--- a/index.ts
+++ b/index.ts
@@ -11,7 +11,8 @@ import {
 import { FromSchema, FromSchemaDefaultOptions, FromSchemaOptions, JSONSchema } from 'json-schema-to-ts'

 export interface JsonSchemaToTsProvider<
   Options extends FromSchemaOptions = FromSchemaDefaultOptions
 > extends FastifyTypeProvider {
-  output: this['input'] extends JSONSchema ? FromSchema<this['input'], Options> : unknown;
+  validator: this['schema'] extends JSONSchema ? FromSchema<this['schema'], Options> : unknown;
+  serializer: this['schema'] extends JSONSchema ? FromSchema<this['schema'], Options> : unknown;
 }
 

// v4
fastify.listen(8000)
 

// v5
fastify.listen({ port: 8000 })
 

// v4
fastify.get('/route', (req, reply) => {
  reply.trailer('ETag', function (reply, payload) {
    return 'custom-etag'
  })
  reply.send('')
});
 

// v5
fastify.get('/route', (req, reply) => {
  reply.trailer('ETag', async function (reply, payload) {
    return 'custom-etag'
  })
  reply.send('')
});
 

// v4
reply.redirect(301, '/new-route')
 

// v5
reply.redirect('/new-route', 301)
 

// v4
fastify.get('/route', (req, reply) => {
  reply.sent = true;
  reply.raw.end('hello');
});
 

// v5
fastify.get('/route', (req, reply) => {
  reply.hijack();
  reply.raw.end('hello');
});
 

// v4
fastify.get('/route', {
 
}, (req, reply) => {
  reply.send({ hello: 'world' });
});
 
fastify.head('/route', (req, reply) => {
  // ...
});
 

// v5
fastify.get('/route', {
  exposeHeadRoutes: false
}, (req, reply) => {
  reply.send({ hello: 'world' });
});
 
fastify.head('/route', (req, reply) => {
  // ...
});
 

// v5
fastify.head('/route', (req, reply) => {
  // ...
});
 
fastify.get('/route', {
 
}, (req, reply) => {
  reply.send({ hello: 'world' });
});
 

// v4
fastify.get('/route', (req, reply) => {
  console.log(req.connection.remoteAddress);
  return { hello: 'world' };
});
 

// v5
fastify.get('/route', (req, reply) => {
  console.log(req.socket.remoteAddress);
  return { hello: 'world' };
});
 

// v4
fastify.get('/route', (req, reply) => {
  console.log(reply.getResponseTime());
  return { hello: 'world' };
});
 

// v5
fastify.get('/route', (req, reply) => {
  console.log(reply.elapsedTime);
  return { hello: 'world' };
});
 

// v4
fastify.get('/example/:file(^\\d+).png', function (request, reply) { })
 
console.log(fastify.hasRoute({
  method: 'GET',
  url: '/example/12345.png'
})); // true
 

// v5
 
fastify.get('/example/:file(^\\d+).png', function (request, reply) { })
 
console.log(fastify.hasRoute({
  method: 'GET',
  url: '/example/:file(^\\d+).png'
})); // true
 

const fastify = Fastify()
 
// 在默认的 HTTP 方法之上新增一个 HTTP 方法：
fastify.addHttpMethod('REBIND')
 
// 添加一个新的接受请求体的 HTTP 方法：
fastify.addHttpMethod('REBIND', { hasBody: true })
 
// 读取支持的 HTTP 方法列表：
fastify.supportedMethods // 返回字符串数组
 

// v4
fastify.decorateRequest('myObject', { hello: 'world' });
 

// v5
fastify.decorateRequest('myObject');
fastify.addHook('onRequest', async (req, reply) => {
  req.myObject = { hello: 'world' };
});
 

// v5
fastify.decorateRequest('myObject', () => ({ hello: 'world' }));
 

// v5
fastify.decorateRequest('myObject', {
  getter () {
    return { hello: 'world' }
  }
});
 

// v4
fastify.register(async function (instance, opts, done) {
  done();
});
 

// v5
fastify.register(async function (instance, opts) {
  return;
});
 

// v5
fastify.register(function (instance, opts, done) {
  done();
});
 

'use strict'
 
const diagnostics = require('node:diagnostics_channel')
const sget = require('simple-get').concat
const Fastify = require('fastify')
 
diagnostics.subscribe('tracing:fastify.request.handler:start', (msg) => {
  console.log(msg.route.url) // '/:id'
  console.log(msg.route.method) // 'GET'
})
 
diagnostics.subscribe('tracing:fastify.request.handler:end', (msg) => {
  // msg 与由 'tracing:fastify.request.handler:start' 通道发出的消息相同
  console.log(msg)
})
 
diagnostics.subscribe('tracing:fastify.request.handler:error', (msg) => {
  // 在发生错误时
})
 
const fastify = Fastify()
fastify.route({
  method: 'GET',
  url: '/:id',
  handler: function (req, reply) {
    return { hello: 'world' }
  }
})
 
fastify.listen({ port: 0 }, function () {
  sget({
    method: 'GET',
    url: fastify.listeningOrigin + '/7'
  }, (err, response, body) => {
    t.error(err)
    t.equal(response.statusCode, 200)
    t.same(JSON.parse(body), { hello: 'world' })
  })
})