fastify 4.23.2 → 4.24.0

package/README.md

@@ -388,7 +388,7 @@ Past Sponsors:
 - [LetzDoIt](https://www.letzdoitapp.com/)
 
 This list includes all companies that support one or more of the team members
-in the maintainance of this project.
+in the maintenance of this project.
 
 ## License
 

package/docs/Guides/Ecosystem.md

@@ -181,6 +181,8 @@ section.
   to go!
   A plugin to implement [Lyra](https://github.com/nearform/lyra) search engine
   on Fastify
+- [`@joggr/fastify-prisma`](https://github.com/joggrdocs/fastify-prisma)
+  A plugin for accessing an instantiated PrismaClient on your server.
 - [`@mgcrea/fastify-graceful-exit`](https://github.com/mgcrea/fastify-graceful-exit)
   A plugin to close the server gracefully
 - [`@mgcrea/fastify-request-logger`](https://github.com/mgcrea/fastify-request-logger)
@@ -279,6 +281,8 @@ section.
 - [`fastify-cloudevents`](https://github.com/smartiniOnGitHub/fastify-cloudevents)
   Fastify plugin to generate and forward Fastify events in the Cloudevents
   format.
+- [`fastify-cloudflare-turnstile`](https://github.com/112RG/fastify-cloudflare-turnstile)
+  Fastify plugin for CloudFlare Turnstile.
 - [`fastify-cloudinary`](https://github.com/Vanilla-IceCream/fastify-cloudinary)
   The Cloudinary Fastify SDK allows you to quickly and easily integrate your
   application with Cloudinary. Effortlessly optimize and transform your cloud's
@@ -317,6 +321,8 @@ section.
 - [`fastify-esso`](https://github.com/patrickpissurno/fastify-esso) The easiest
   authentication plugin for Fastify, with built-in support for Single sign-on
   (and great documentation).
+- [`fastify-event-bus`](https://github.com/Shiva127/fastify-event-bus) Event bus
+  support for Fastify. Built upon [js-event-bus](https://github.com/bcerati/js-event-bus).
 - [`fastify-evervault`](https://github.com/Briscoooe/fastify-evervault/) Fastify
   plugin for instantiating and encapsulating the 
   [Evervault](https://evervault.com/) client.

package/docs/Reference/Hooks.md

@@ -445,6 +445,7 @@ fastify.addHook('onListen', async function () {
 
 > **Note**  
 > This hook will not run when the server is started using `fastify.inject()` or `fastify.ready()`
+
 ### onClose
 <a id="on-close"></a>
 

package/docs/Reference/Plugins.md

@@ -134,7 +134,7 @@ fastify.listen({ port: 3000 }, (err, address) => {
 <a id="async-await"></a>
 
 *async/await* is supported by `after`, `ready`, and `listen`, as well as
-`fastify` being a [Thenable](https://promisesaplus.com/).
+`fastify` being a Thenable.
 
 ```js
 await fastify.register(require('my-plugin'))

package/docs/Reference/Reply.md

@@ -85,7 +85,8 @@ object that exposes the following functions and properties:
   from Node core.
 - `.log` - The logger instance of the incoming request.
 - `.request` - The incoming request.
-- `.context` - Access the [Request's context](./Request.md) property.
+- `.context` - Deprecated, access the [Request's context](./Request.md) property.
+- `.routeOptions` - Access the [Request's routeOptions](./Request.md) property.
 
 ```js
 fastify.get('/', options, function (request, reply) {
@@ -605,8 +606,9 @@ low-level request and response. Moreover, hooks will not be invoked.
 *Modifying the `.sent` property directly is deprecated. Please use the
 aforementioned `.hijack()` method to achieve the same effect.*
 
-<a name="hijack"></a>
 ### .hijack()
+<a name="hijack"></a>
+
 Sometimes you might need to halt the execution of the normal request lifecycle
 and handle sending the response manually.
 
@@ -892,6 +894,5 @@ For more details, see:
 
 - https://github.com/fastify/fastify/issues/1864 for the discussion about this
   feature
-- https://promisesaplus.com/ for the definition of thenables
 - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/then
   for the signature

package/docs/Reference/Request.md

@@ -37,8 +37,9 @@ Request is a core Fastify object containing the following fields:
 - `connection` - Deprecated, use `socket` instead. The underlying connection of
   the incoming request.
 - `socket` - the underlying connection of the incoming request
-- `context` - A Fastify internal object. You should not use it directly or
-  modify it. It is useful to access one special key:	
+- `context` - Deprecated, use `request.routeOptions.config` instead.
+A Fastify internal object. You should not use
+it directly or modify it. It is useful to access one special key:	
   - `context.config` - The route [`config`](./Routes.md#routes-config) object.
 - `routeSchema` - Deprecated, use `request.routeOptions.schema` instead. The
   scheme definition set for the router that is handling the request

package/docs/Reference/Server.md

@@ -50,20 +50,21 @@ describes the properties available in that options object.
     - [after](#after)
     - [ready](#ready)
     - [listen](#listen)
+  - [`listenTextResolver`](#listentextresolver)
     - [addresses](#addresses)
     - [getDefaultRoute](#getdefaultroute)
     - [setDefaultRoute](#setdefaultroute)
     - [routing](#routing)
     - [route](#route)
-    - [hasRoute](#hasRoute)
+    - [hasRoute](#hasroute)
     - [close](#close)
-    - [decorate*](#decorate)
+    - [decorate\*](#decorate)
     - [register](#register)
     - [addHook](#addhook)
     - [prefix](#prefix)
     - [pluginName](#pluginname)
     - [hasPlugin](#hasplugin)
-    - [listeningOrigin](#listeningOrigin)
+  - [listeningOrigin](#listeningorigin)
     - [log](#log)
     - [version](#version)
     - [inject](#inject)
@@ -93,6 +94,7 @@ describes the properties available in that options object.
     - [defaultTextParser](#defaulttextparser)
     - [errorHandler](#errorhandler)
     - [childLoggerFactory](#childloggerfactory)
+    - [Symbol.asyncDispose](#symbolasyncdispose)
     - [initialConfig](#initialconfig)
 
 ### `http`
@@ -1866,6 +1868,32 @@ fastify.get('/', {
 Fastify instance. See the [`childLoggerFactory` config option](#setchildloggerfactory)
 for more info.
 
+#### Symbol.asyncDispose
+<a id="symbolAsyncDispose"></a>
+
+`fastify[Symbol.asyncDispose]` is a symbol that can be used to define an
+asynchronous function that will be called when the Fastify instance is closed.
+
+It's commonly used alongside the `using` TypeScript keyword to ensure that
+resources are cleaned up when the Fastify instance is closed.
+
+This combines perfectly inside short lived processes or unit tests, where you must
+close all Fastify resources after returning from inside the function.
+
+```ts
+test('Uses app and closes it afterwards', async () => {
+  await using app = fastify();
+  // do something with app.
+})
+```
+
+In the above example, Fastify is closed automatically after the test finishes.
+
+Read more about the
+[ECMAScript Explicit Resource Management](https://tc39.es/proposal-explicit-resource-management)
+and the [using keyword](https://devblogs.microsoft.com/typescript/announcing-typescript-5-2/)
+introduced in TypeScript 5.2.
+
 #### initialConfig
 <a id="initial-config"></a>
 

package/docs/Reference/Type-Providers.md

@@ -47,7 +47,7 @@ server.get('/route', {
             },
             required: ['foo', 'bar']
         }
-    } as const // don't forget to use const !
+    }
 
 }, (request, reply) => {
 
@@ -141,7 +141,7 @@ function pluginWithJsonSchema(fastify: FastifyInstance, _opts, done): void {
             y: { type: 'number' },
             z: { type: 'boolean' }
           },
-        } as const
+        }
       }
     }, (req) => {
       const { x, y, z } = req.body // type safe

package/docs/Reference/TypeScript.md

@@ -606,7 +606,7 @@ your plugin.
    ```
 5. Open `index.d.ts` and add the following code:
    ```typescript
-   import { FastifyPlugin } from 'fastify'
+   import { FastifyPluginCallback } from 'fastify'
 
    interface PluginOptions {
      //...
@@ -627,7 +627,7 @@ your plugin.
 
    // fastify-plugin automatically adds named export, so be sure to add also this type
    // the variable name is derived from `options.name` property if `module.exports.myPlugin` is missing
-   export const myPlugin: FastifyPlugin<PluginOptions>
+   export const myPlugin: FastifyPluginCallback<PluginOptions>
 
    // fastify-plugin automatically adds `.default` property to the exported plugin. See the note below
    export default myPlugin
@@ -1233,15 +1233,16 @@ a function signature with an underlying generic `Options` which is defaulted to
 FastifyPlugin parameter when calling this function so there is no need to
 specify the underlying generic. The options parameter is the intersection of the
 plugin's options and two additional optional properties: `prefix: string` and
-`logLevel`: [LogLevel][LogLevel].
+`logLevel`: [LogLevel][LogLevel]. `FastifyPlugin` is deprecated use
+`FastifyPluginCallback` and `FastifyPluginAsync` instead.
 
 Below is an example of the options inference in action:
 
 ```typescript
 const server = fastify()
 
-const plugin: FastifyPlugin<{
-  option1: string;
+const plugin: FastifyPluginCallback<{
+:  option1: string;
   option2: boolean;
 }> = function (instance, opts, done) { }
 
@@ -1296,9 +1297,22 @@ Union type of: `'info' | 'error' | 'debug' | 'fatal' | 'warn' | 'trace'`
 The context type definition is similar to the other highly dynamic pieces of the
 type system. Route context is available in the route handler method.
 
-##### fastify.FastifyContext
+##### fastify.FastifyRequestContext
 
-[src](https://github.com/fastify/fastify/blob/main/types/context.d.ts#L6)
+[src](https://github.com/fastify/fastify/blob/main/types/context.d.ts#L11)
+
+An interface with a single required property `config` that is set by default to
+`unknown`. Can be specified either using a generic or an overload.
+
+This type definition is potentially incomplete. If you are using it and can
+provide more details on how to improve the definition, we strongly encourage you
+to open an issue in the main
+[fastify/fastify](https://github.com/fastify/fastify) repository. Thank you in
+advanced!
+
+##### fastify.FastifyReplyContext
+
+[src](https://github.com/fastify/fastify/blob/main/types/context.d.ts#L11)
 
 An interface with a single required property `config` that is set by default to
 `unknown`. Can be specified either using a generic or an overload.

package/fastify.d.ts

@@ -10,7 +10,7 @@ import { ConstraintStrategy, HTTPVersion } from 'find-my-way'
 import { Chain as LightMyRequestChain, InjectOptions, Response as LightMyRequestResponse, CallbackFunc as LightMyRequestCallback } from 'light-my-request'
 
 import { FastifyBodyParser, FastifyContentTypeParser, AddContentTypeParser, hasContentTypeParser, getDefaultJsonParser, ProtoAction, ConstructorAction } from './types/content-type-parser'
-import { FastifyContext, FastifyContextConfig } from './types/context'
+import { FastifyRequestContext, FastifyContextConfig, FastifyReplyContext } from './types/context'
 import { FastifyErrorCodes } from './types/errors'
 import { DoneFuncWithErrOrRes, HookHandlerDoneFunction, RequestPayload, onCloseAsyncHookHandler, onCloseHookHandler, onErrorAsyncHookHandler, onErrorHookHandler, onReadyAsyncHookHandler, onReadyHookHandler, onListenAsyncHookHandler, onListenHookHandler, onRegisterHookHandler, onRequestAsyncHookHandler, onRequestHookHandler, onResponseAsyncHookHandler, onResponseHookHandler, onRouteHookHandler, onSendAsyncHookHandler, onSendHookHandler, onTimeoutAsyncHookHandler, onTimeoutHookHandler, preHandlerAsyncHookHandler, preHandlerHookHandler, preParsingAsyncHookHandler, preParsingHookHandler, preSerializationAsyncHookHandler, preSerializationHookHandler, preValidationAsyncHookHandler, preValidationHookHandler, onRequestAbortHookHandler, onRequestAbortAsyncHookHandler } from './types/hooks'
 import { FastifyListenOptions, FastifyInstance, PrintRoutesOptions } from './types/instance'
@@ -175,7 +175,7 @@ declare namespace fastify {
     FastifyPluginCallback, FastifyPluginAsync, FastifyPluginOptions, FastifyPlugin, // './types/plugin'
     FastifyListenOptions, FastifyInstance, PrintRoutesOptions, // './types/instance'
     FastifyLoggerOptions, FastifyBaseLogger, FastifyLoggerInstance, FastifyLogFn, LogLevel, // './types/logger'
-    FastifyContext, FastifyContextConfig, // './types/context'
+    FastifyRequestContext, FastifyContextConfig, FastifyReplyContext, // './types/context'
     RouteHandler, RouteHandlerMethod, RouteOptions, RouteShorthandMethod, RouteShorthandOptions, RouteShorthandOptionsWithHandler, RouteGenericInterface, // './types/route'
     FastifyRegister, FastifyRegisterOptions, RegisterOptions, // './types/register'
     FastifyBodyParser, FastifyContentTypeParser, AddContentTypeParser, hasContentTypeParser, getDefaultJsonParser, ProtoAction, ConstructorAction, // './types/content-type-parser'

package/fastify.js

@@ -1,6 +1,6 @@
 'use strict'
 
-const VERSION = '4.23.2'
+const VERSION = '4.24.0'
 
 const Avvio = require('avvio')
 const http = require('node:http')
@@ -506,6 +506,13 @@ function fastify (options) {
     // versions of Node.js. In that event, we don't care, so ignore the error.
   }
 
+  // Older nodejs versions may not have asyncDispose
+  if ('asyncDispose' in Symbol) {
+    fastify[Symbol.asyncDispose] = function dispose () {
+      return fastify.close()
+    }
+  }
+
   return fastify
 
   function throwIfAlreadyStarted (msg) {

package/lib/contentTypeParser.js

@@ -406,7 +406,7 @@ function ParserListItem (contentType) {
   // because it would become a match-all handler
   if (this.isEssence === false && parsed.type === '') {
     // handle semicolon or empty string
-    const tmp = contentType.split(';')[0]
+    const tmp = contentType.split(';', 1)[0]
     this.type = tmp === '' ? contentType : tmp
   } else {
     this.type = parsed.type

package/lib/reply.js

@@ -4,6 +4,7 @@ const eos = require('node:stream').finished
 
 const {
   kFourOhFourContext,
+  kPublicRouteContext,
   kReplyErrorHandlerCalled,
   kReplyHijacked,
   kReplyStartTime,
@@ -79,6 +80,7 @@ Object.defineProperties(Reply.prototype, {
   // Is temporary to avoid constant conflicts between `next` and `main`
   context: {
     get () {
+      warning.emit('FSTDEP019')
       return this.request[kRouteContext]
     }
   },
@@ -115,6 +117,11 @@ Object.defineProperties(Reply.prototype, {
     set (value) {
       this.code(value)
     }
+  },
+  [kPublicRouteContext]: {
+    get () {
+      return this.request[kPublicRouteContext]
+    }
   }
 })
 
@@ -244,7 +251,7 @@ Reply.prototype.header = function (key, value = '') {
     }
 
     if (Array.isArray(value)) {
-      this[kReplyHeaders][key].push(...value)
+      Array.prototype.push.apply(this[kReplyHeaders][key], value)
     } else {
       this[kReplyHeaders][key].push(value)
     }
@@ -458,7 +465,6 @@ Reply.prototype.getResponseTime = function () {
 // Make reply a thenable, so it could be used with async/await.
 // See
 // - https://github.com/fastify/fastify/issues/1864 for the discussions
-// - https://promisesaplus.com/ for the definition of thenable
 // - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/then for the signature
 Reply.prototype.then = function (fulfilled, rejected) {
   if (this.sent) {
@@ -591,6 +597,17 @@ function onSendEnd (reply, payload) {
     return
   }
 
+  if ((statusCode >= 100 && statusCode < 200) || statusCode === 204) {
+    // Responses without a content body must not send content-type
+    // or content-length headers.
+    // See https://www.rfc-editor.org/rfc/rfc9110.html#section-8.6.
+    reply.removeHeader('content-type')
+    reply.removeHeader('content-length')
+    safeWriteHead(reply, statusCode)
+    sendTrailer(undefined, res, reply)
+    return
+  }
+
   if (typeof payload.pipe === 'function') {
     sendStream(payload, res, reply)
     return
@@ -810,7 +827,7 @@ function onResponseCallback (err, request, reply) {
 }
 
 function buildReply (R) {
-  const props = [...R.props]
+  const props = R.props.slice()
 
   function _Reply (res, request, log) {
     this.raw = res

package/lib/reqIdGenFactory.js

@@ -12,6 +12,16 @@
  * @returns {GenerateRequestId}
  */
 function reqIdGenFactory (requestIdHeader, optGenReqId) {
+  const genReqId = optGenReqId || buildDefaultGenReqId()
+
+  if (requestIdHeader) {
+    return buildOptionalHeaderReqId(requestIdHeader, genReqId)
+  }
+
+  return genReqId
+}
+
+function buildDefaultGenReqId () {
   // 2,147,483,647 (2^31 − 1) stands for max SMI value (an internal optimization of V8).
   // With this upper bound, if you'll be generating 1k ids/sec, you're going to hit it in ~25 days.
   // This is very likely to happen in real-world applications, hence the limit is enforced.
@@ -20,20 +30,16 @@ function reqIdGenFactory (requestIdHeader, optGenReqId) {
   const maxInt = 2147483647
 
   let nextReqId = 0
-  function defaultGenReqId (_req) {
+  return function defaultGenReqId () {
     nextReqId = (nextReqId + 1) & maxInt
     return `req-${nextReqId.toString(36)}`
   }
+}
 
-  const genReqId = optGenReqId || defaultGenReqId
-
-  if (requestIdHeader) {
-    return function (req) {
-      return req.headers[requestIdHeader] || genReqId(req)
-    }
+function buildOptionalHeaderReqId (requestIdHeader, genReqId) {
+  return function (req) {
+    return req.headers[requestIdHeader] || genReqId(req)
   }
-
-  return genReqId
 }
 
 module.exports = {

package/lib/request.js

@@ -66,7 +66,7 @@ function buildRequest (R, trustProxy) {
 }
 
 function buildRegularRequest (R) {
-  const props = [...R.props]
+  const props = R.props.slice()
   function _Request (id, params, req, query, log, context) {
     this.id = id
     this[kRouteContext] = context

package/lib/route.js

@@ -28,7 +28,8 @@ const {
   FST_ERR_ROUTE_METHOD_NOT_SUPPORTED,
   FST_ERR_ROUTE_METHOD_INVALID,
   FST_ERR_ROUTE_BODY_VALIDATION_SCHEMA_NOT_SUPPORTED,
-  FST_ERR_ROUTE_BODY_LIMIT_OPTION_NOT_INT
+  FST_ERR_ROUTE_BODY_LIMIT_OPTION_NOT_INT,
+  FST_ERR_HOOK_INVALID_ASYNC_HANDLER
 } = require('./errors')
 
 const {
@@ -268,6 +269,20 @@ function buildRouting (options) {
               if (typeof func !== 'function') {
                 throw new FST_ERR_HOOK_INVALID_HANDLER(hook, Object.prototype.toString.call(func))
               }
+
+              if (hook === 'onSend' || hook === 'preSerialization' || hook === 'onError' || hook === 'preParsing') {
+                if (func.constructor.name === 'AsyncFunction' && func.length === 4) {
+                  throw new FST_ERR_HOOK_INVALID_ASYNC_HANDLER()
+                }
+              } else if (hook === 'onRequestAbort') {
+                if (func.constructor.name === 'AsyncFunction' && func.length !== 1) {
+                  throw new FST_ERR_HOOK_INVALID_ASYNC_HANDLER()
+                }
+              } else {
+                if (func.constructor.name === 'AsyncFunction' && func.length === 3) {
+                  throw new FST_ERR_HOOK_INVALID_ASYNC_HANDLER()
+                }
+              }
             }
           } else if (opts[hook] !== undefined && typeof opts[hook] !== 'function') {
             throw new FST_ERR_HOOK_INVALID_HANDLER(hook, Object.prototype.toString.call(opts[hook]))
@@ -307,8 +322,8 @@ function buildRouting (options) {
         constraints.version = opts.version
       }
 
-      const headHandler = router.find('HEAD', opts.url, constraints)
-      const hasHEADHandler = headHandler != null
+      const headHandler = router.findRoute('HEAD', opts.url, constraints)
+      const hasHEADHandler = headHandler !== null
 
       // remove the head route created by fastify
       if (hasHEADHandler && !context[kRouteByFastify] && headHandler.store[kRouteByFastify]) {

package/lib/schemas.js

@@ -158,7 +158,7 @@ function getSchemaSerializer (context, statusCode, contentType) {
   }
   if (responseSchemaDef[statusCode]) {
     if (responseSchemaDef[statusCode].constructor === Object && contentType) {
-      const mediaName = contentType.split(';')[0]
+      const mediaName = contentType.split(';', 1)[0]
       if (responseSchemaDef[statusCode][mediaName]) {
         return responseSchemaDef[statusCode][mediaName]
       }
@@ -170,7 +170,7 @@ function getSchemaSerializer (context, statusCode, contentType) {
   const fallbackStatusCode = (statusCode + '')[0] + 'xx'
   if (responseSchemaDef[fallbackStatusCode]) {
     if (responseSchemaDef[fallbackStatusCode].constructor === Object && contentType) {
-      const mediaName = contentType.split(';')[0]
+      const mediaName = contentType.split(';', 1)[0]
       if (responseSchemaDef[fallbackStatusCode][mediaName]) {
         return responseSchemaDef[fallbackStatusCode][mediaName]
       }
@@ -182,7 +182,7 @@ function getSchemaSerializer (context, statusCode, contentType) {
   }
   if (responseSchemaDef.default) {
     if (responseSchemaDef.default.constructor === Object && contentType) {
-      const mediaName = contentType.split(';')[0]
+      const mediaName = contentType.split(';', 1)[0]
       if (responseSchemaDef.default[mediaName]) {
         return responseSchemaDef.default[mediaName]
       }

package/lib/warnings.js

@@ -21,7 +21,7 @@ warning.create('FastifyDeprecation', 'FSTDEP010', 'Modifying the "reply.sent" pr
 
 warning.create('FastifyDeprecation', 'FSTDEP011', 'Variadic listen method is deprecated. Please use ".listen(optionsObject)" instead. The variadic signature will be removed in `fastify@5`.')
 
-warning.create('FastifyDeprecation', 'FSTDEP012', 'Request#context property access is deprecated. Please use "Request#routeConfig" or "Request#routeSchema" instead for accessing Route settings. The "Request#context" will be removed in `fastify@5`.')
+warning.create('FastifyDeprecation', 'FSTDEP012', 'request.context property access is deprecated. Please use "request.routeOptions.config" or "request.routeOptions.schema" instead for accessing Route settings. The "request.context" will be removed in `fastify@5`.')
 
 warning.create('FastifyDeprecation', 'FSTDEP013', 'Direct return of "trailers" function is deprecated. Please use "callback" or "async-await" for return value. The support of direct return will removed in `fastify@5`.')
 
@@ -35,6 +35,8 @@ warning.create('FastifyDeprecation', 'FSTDEP017', 'You are accessing the depreca
 
 warning.create('FastifyDeprecation', 'FSTDEP018', 'You are accessing the deprecated "request.routerMethod" property. Use "request.routeOptions.method" instead. Property "req.routerMethod" will be removed in `fastify@5`.')
 
+warning.create('FastifyDeprecation', 'FSTDEP019', 'reply.context property access is deprecated. Please use "reply.routeOptions.config" or "reply.routeOptions.schema" instead for accessing Route settings. The "reply.context" 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastify",
-  "version": "4.23.2",
+  "version": "4.24.0",
   "description": "Fast and low overhead web framework, for Node.js",
   "main": "fastify.js",
   "type": "commonjs",
@@ -195,7 +195,7 @@
     "avvio": "^8.2.1",
     "fast-content-type-parse": "^1.0.0",
     "fast-json-stringify": "^5.7.0",
-    "find-my-way": "^7.6.0",
+    "find-my-way": "^7.7.0",
     "light-my-request": "^5.9.1",
     "pino": "^8.12.0",
     "process-warning": "^2.2.0",

package/test/async-dispose.test.js

@@ -0,0 +1,21 @@
+'use strict'
+
+const t = require('tap')
+const Fastify = require('../fastify')
+
+// asyncDispose doesn't exist in node <= 16
+t.test('async dispose should close fastify', { skip: !('asyncDispose' in Symbol) }, async t => {
+  t.plan(2)
+
+  const fastify = Fastify()
+
+  await fastify.listen({ port: 0 })
+
+  t.equal(fastify.server.listening, true)
+
+  // the same as syntax sugar for
+  // await using app = fastify()
+  await fastify[Symbol.asyncDispose]()
+
+  t.equal(fastify.server.listening, false)
+})