AugmentedFastifyInstance
Api Code Documentation / Exports / types / AugmentedFastifyInstance
types.AugmentedFastifyInstance
Interface representing an extended fastify instance
#
HierarchyFastifyInstance
↳
AugmentedFastifyInstance
#
Table of contents#
Properties- addContentTypeParser
- all
- authenticate
- defaultTextParser
- delete
- get
- getDefaultJsonParser
- getDefaultRoute
- hasContentTypeParser
- head
- initialConfig
- log
- metrics
- options
- patch
- post
- prefix
- put
- register
- removeAllContentTypeParsers
- removeContentTypeParser
- server
- swaggerCSP
- version
#
Methods- addHook
- addSchema
- after
- close
- decorate
- decorateReply
- decorateRequest
- errorHandler
- getSchema
- getSchemas
- hasDecorator
- hasReplyDecorator
- hasRequestDecorator
- inject
- listen
- printPlugins
- printRoutes
- ready
- route
- routing
- setDefaultRoute
- setErrorHandler
- setNotFoundHandler
- setReplySerializer
- setSchemaController
- setSchemaErrorFormatter
- setSerializerCompiler
- setValidatorCompiler
#
Properties#
addContentTypeParser• addContentTypeParser: AddContentTypeParser
<Server
, IncomingMessage
>
Add a content type parser
#
Inherited fromFastifyInstance.addContentTypeParser
#
Defined innode_modules/fastify/types/instance.d.ts:422
#
all• all: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.all
#
Defined innode_modules/fastify/types/instance.d.ts:108
#
authenticate• authenticate: any
#
Defined in#
defaultTextParser• defaultTextParser: FastifyBodyParser
<string
, Server
, IncomingMessage
, RouteGenericInterface
>
Fastify default plain text parser
#
Inherited fromFastifyInstance.defaultTextParser
#
Defined innode_modules/fastify/types/instance.d.ts:439
#
delete• delete: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.delete
#
Defined innode_modules/fastify/types/instance.d.ts:105
#
get• get: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.get
#
Defined innode_modules/fastify/types/instance.d.ts:101
#
getDefaultJsonParser• getDefaultJsonParser: getDefaultJsonParser
Fastify default JSON parser
#
Inherited fromFastifyInstance.getDefaultJsonParser
#
Defined innode_modules/fastify/types/instance.d.ts:435
#
getDefaultRoute• getDefaultRoute: DefaultRoute
<IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.getDefaultRoute
#
Defined innode_modules/fastify/types/instance.d.ts:92
#
hasContentTypeParser• hasContentTypeParser: hasContentTypeParser
#
Inherited fromFastifyInstance.hasContentTypeParser
#
Defined innode_modules/fastify/types/instance.d.ts:423
#
head• head: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.head
#
Defined innode_modules/fastify/types/instance.d.ts:102
#
initialConfig• initialConfig: Readonly
<{ bodyLimit?
: number
; caseSensitive?
: boolean
; connectionTimeout?
: number
; disableRequestLogging?
: boolean
; forceCloseConnections?
: boolean
; http2?
: boolean
; http2SessionTimeout?
: number
; https?
: boolean
| Readonly
<{ allowHTTP1
: boolean
}> ; ignoreTrailingSlash?
: boolean
; keepAliveTimeout?
: number
; maxParamLength?
: number
; onConstructorPoisoning?
: ConstructorAction
; onProtoPoisoning?
: ProtoAction
; pluginTimeout?
: number
; requestIdHeader?
: string
; requestIdLogLabel?
: string
}>
Frozen read-only object registering the initial options passed down by the user to the fastify instance
#
Inherited fromFastifyInstance.initialConfig
#
Defined innode_modules/fastify/types/instance.d.ts:454
#
log• log: FastifyLoggerInstance
#
Inherited fromFastifyInstance.log
#
Defined innode_modules/fastify/types/instance.d.ts:37
#
metrics• metrics: FastifyMetrics
Metrics interface
#
Inherited fromFastifyInstance.metrics
#
Defined innode_modules/fastify-metrics/dist/index.d.ts:9
#
options• options: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.options
#
Defined innode_modules/fastify/types/instance.d.ts:106
#
patch• patch: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.patch
#
Defined innode_modules/fastify/types/instance.d.ts:107
#
post• post: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.post
#
Defined innode_modules/fastify/types/instance.d.ts:103
#
prefix• prefix: string
#
Inherited fromFastifyInstance.prefix
#
Defined innode_modules/fastify/types/instance.d.ts:35
#
put• put: RouteShorthandMethod
<Server
, IncomingMessage
, ServerResponse
>
#
Inherited fromFastifyInstance.put
#
Defined innode_modules/fastify/types/instance.d.ts:104
#
register• register: FastifyRegister
<FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
> & PromiseLike
<undefined
>>
#
Inherited fromFastifyInstance.register
#
Defined innode_modules/fastify/types/instance.d.ts:89
#
removeAllContentTypeParsers• removeAllContentTypeParsers: removeAllContentTypeParsers
Remove all content type parsers, including the default ones
#
Inherited fromFastifyInstance.removeAllContentTypeParsers
#
Defined innode_modules/fastify/types/instance.d.ts:431
#
removeContentTypeParser• removeContentTypeParser: removeContentTypeParser
Remove an existing content type parser
#
Inherited fromFastifyInstance.removeContentTypeParser
#
Defined innode_modules/fastify/types/instance.d.ts:427
#
server• server: Server
#
Inherited fromFastifyInstance.server
#
Defined innode_modules/fastify/types/instance.d.ts:34
#
swaggerCSP• swaggerCSP: any
#
Defined in#
version• version: string
#
Inherited fromFastifyInstance.version
#
Defined innode_modules/fastify/types/instance.d.ts:36
#
Methods#
addHookâ–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
onRequest
is the first hook to be executed in the request lifecycle. There was no previous hook, the next hook will be preParsing
.
Notice: in the onRequest
hook, request.body will always be null, because the body parsing happens before the preHandler
hook.
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onRequest" |
hook | onRequestHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:118
â–¸ addHook<RouteGeneric
, ContextConfig
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
#
ParametersName | Type |
---|---|
name | "onRequest" |
hook | onRequestAsyncHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyLoggerInstance > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:127
â–¸ addHook<RouteGeneric
, ContextConfig
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
preParsing
is the second hook to be executed in the request lifecycle. The previous hook was onRequest
, the next hook will be preValidation
.
Notice: in the preParsing
hook, request.body will always be null, because the body parsing happens before the preHandler
hook.
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
#
ParametersName | Type |
---|---|
name | "preParsing" |
hook | preParsingHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyLoggerInstance > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:139
â–¸ addHook<RouteGeneric
, ContextConfig
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
#
ParametersName | Type |
---|---|
name | "preParsing" |
hook | preParsingAsyncHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyLoggerInstance > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:147
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
preValidation
is the third hook to be executed in the request lifecycle. The previous hook was preParsing
, the next hook will be preHandler
.
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "preValidation" |
hook | preValidationHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:158
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "preValidation" |
hook | preValidationAsyncHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:167
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
preHandler
is the fourth hook to be executed in the request lifecycle. The previous hook was preValidation
, the next hook will be preSerialization
.
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "preHandler" |
hook | preHandlerHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:179
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "preHandler" |
hook | preHandlerAsyncHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:188
â–¸ addHook<PreSerializationPayload
, RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
preSerialization
is the fifth hook to be executed in the request lifecycle. The previous hook was preHandler
, the next hook will be onSend
.
Note: the hook is NOT called if the payload is a string, a Buffer, a stream or null.
#
Type parametersName | Type |
---|---|
PreSerializationPayload | unknown |
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "preSerialization" |
hook | preSerializationHookHandler <PreSerializationPayload , Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:201
â–¸ addHook<PreSerializationPayload
, RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Type parametersName | Type |
---|---|
PreSerializationPayload | unknown |
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "preSerialization" |
hook | preSerializationAsyncHookHandler <PreSerializationPayload , Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:211
â–¸ addHook<OnSendPayload
, RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
You can change the payload with the onSend
hook. It is the sixth hook to be executed in the request lifecycle. The previous hook was preSerialization
, the next hook will be onResponse
.
Note: If you change the payload, you may only change it to a string, a Buffer, a stream, or null.
#
Type parametersName | Type |
---|---|
OnSendPayload | unknown |
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onSend" |
hook | onSendHookHandler <OnSendPayload , Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:225
â–¸ addHook<OnSendPayload
, RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Type parametersName | Type |
---|---|
OnSendPayload | unknown |
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onSend" |
hook | onSendAsyncHookHandler <OnSendPayload , Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:235
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
onResponse
is the seventh and last hook in the request hook lifecycle. The previous hook was onSend
, there is no next hook.
The onResponse hook is executed when a response has been sent, so you will not be able to send more data to the client. It can however be useful for sending data to external services, for example to gather statistics.
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onResponse" |
hook | onResponseHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:249
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onResponse" |
hook | onResponseAsyncHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:258
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
onTimeout
is useful if you need to monitor the request timed out in your service. (if the connectionTimeout
property is set on the fastify instance)
The onTimeout hook is executed when a request is timed out and the http socket has been hanged up. Therefore you will not be able to send data to the client.
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onTimeout" |
hook | onTimeoutHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:271
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onTimeout" |
hook | onTimeoutAsyncHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:280
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
This hook is useful if you need to do some custom error logging or add some specific header in case of error. It is not intended for changing the error, and calling reply.send will throw an exception. This hook will be executed only after the customErrorHandler has been executed, and only if the customErrorHandler sends an error back to the user (Note that the default customErrorHandler always sends the error back to the user). Notice: unlike the other hooks, pass an error to the done function is not supported.
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onError" |
hook | onErrorHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyError , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:295
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onError" |
hook | onErrorAsyncHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyError , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:304
â–¸ addHook<RouteGeneric
, ContextConfig
, Logger
>(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
Triggered when a new route is registered. Listeners are passed a routeOptions object as the sole parameter. The interface is synchronous, and, as such, the listener does not get passed a callback
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
Logger | extends FastifyLoggerInstance = FastifyLoggerInstance |
#
ParametersName | Type |
---|---|
name | "onRoute" |
hook | onRouteHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , Logger > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, Logger
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:318
â–¸ addHook(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Triggered when a new plugin is registered and a new encapsulation context is created. The hook will be executed before the registered code. This hook can be useful if you are developing a plugin that needs to know when a plugin context is formed, and you want to operate in that specific context. Note: This hook will not be called if a plugin is wrapped inside fastify-plugin.
#
ParametersName | Type |
---|---|
name | "onRegister" |
hook | onRegisterHookHandler <Server , IncomingMessage , ServerResponse , FastifyLoggerInstance , FastifyPluginOptions > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:332
â–¸ addHook(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Triggered when fastify.listen() or fastify.ready() is invoked to start the server. It is useful when plugins need a "ready" event, for example to load data before the server start listening for requests.
#
ParametersName | Type |
---|---|
name | "onReady" |
hook | onReadyHookHandler <Server , IncomingMessage , ServerResponse , FastifyLoggerInstance > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:340
â–¸ addHook(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
ParametersName | Type |
---|---|
name | "onReady" |
hook | onReadyAsyncHookHandler |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:345
â–¸ addHook(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Triggered when fastify.close() is invoked to stop the server. It is useful when plugins need a "shutdown" event, for example to close an open connection to a database.
#
ParametersName | Type |
---|---|
name | "onClose" |
hook | onCloseHookHandler <Server , IncomingMessage , ServerResponse , FastifyLoggerInstance > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:353
â–¸ addHook(name
, hook
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
ParametersName | Type |
---|---|
name | "onClose" |
hook | onCloseAsyncHookHandler <Server , IncomingMessage , ServerResponse , FastifyLoggerInstance > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addHook
#
Defined innode_modules/fastify/types/instance.d.ts:358
#
addSchemaâ–¸ addSchema(schema
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
ParametersName | Type |
---|---|
schema | unknown |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.addSchema
#
Defined innode_modules/fastify/types/instance.d.ts:39
#
afterâ–¸ after(): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
> & PromiseLike
<undefined
>
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
> & PromiseLike
<undefined
>
#
Inherited fromFastifyInstance.after
#
Defined innode_modules/fastify/types/instance.d.ts:43
â–¸ after(afterListener
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
ParametersName | Type |
---|---|
afterListener | (err : Error ) => void |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.after
#
Defined innode_modules/fastify/types/instance.d.ts:44
#
closeâ–¸ close(): Promise
<undefined
>
#
ReturnsPromise
<undefined
>
#
Inherited fromFastifyInstance.close
#
Defined innode_modules/fastify/types/instance.d.ts:46
â–¸ close(closeListener
): undefined
#
ParametersName | Type |
---|---|
closeListener | () => void |
#
Returnsundefined
#
Inherited fromFastifyInstance.close
#
Defined innode_modules/fastify/types/instance.d.ts:47
#
decorateâ–¸ decorate<T
>(property
, value
, dependencies?
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Type parametersName |
---|
T |
#
ParametersName | Type |
---|---|
property | string | symbol |
value | T extends (...args : any []) => any ? (this : FastifyInstance <Server , IncomingMessage , ServerResponse , FastifyLoggerInstance >, ...args : Parameters <T >) => ReturnType <T > : T |
dependencies? | string [] |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.decorate
#
Defined innode_modules/fastify/types/instance.d.ts:50
#
decorateReplyâ–¸ decorateReply<T
>(property
, value
, dependencies?
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Type parametersName |
---|
T |
#
ParametersName | Type |
---|---|
property | string | symbol |
value | T extends (...args : any []) => any ? (this : FastifyReply <Server , IncomingMessage , ServerResponse , RouteGenericInterface , unknown >, ...args : Parameters <T >) => ReturnType <T > : T |
dependencies? | string [] |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.decorateReply
#
Defined innode_modules/fastify/types/instance.d.ts:64
#
decorateRequestâ–¸ decorateRequest<T
>(property
, value
, dependencies?
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Type parametersName |
---|
T |
#
ParametersName | Type |
---|---|
property | string | symbol |
value | T extends (...args : any []) => any ? (this : FastifyRequest <RouteGenericInterface , Server , IncomingMessage , unknown , FastifyLoggerInstance >, ...args : Parameters <T >) => ReturnType <T > : T |
dependencies? | string [] |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.decorateRequest
#
Defined innode_modules/fastify/types/instance.d.ts:57
#
errorHandlerâ–¸ errorHandler(error
, request
, reply
): void
Fastify default error handler
#
ParametersName | Type |
---|---|
error | FastifyError |
request | FastifyRequest <RouteGenericInterface , Server , IncomingMessage , unknown , FastifyLoggerInstance > |
reply | FastifyReply <Server , IncomingMessage , ServerResponse , RouteGenericInterface , unknown > |
#
Returnsvoid
#
Inherited fromFastifyInstance.errorHandler
#
Defined innode_modules/fastify/types/instance.d.ts:381
#
getSchemaâ–¸ getSchema(schemaId
): unknown
#
ParametersName | Type |
---|---|
schemaId | string |
#
Returnsunknown
#
Inherited fromFastifyInstance.getSchema
#
Defined innode_modules/fastify/types/instance.d.ts:40
#
getSchemasâ–¸ getSchemas(): Record
<string
, unknown
>
#
ReturnsRecord
<string
, unknown
>
#
Inherited fromFastifyInstance.getSchemas
#
Defined innode_modules/fastify/types/instance.d.ts:41
#
hasDecoratorâ–¸ hasDecorator(decorator
): boolean
#
ParametersName | Type |
---|---|
decorator | string | symbol |
#
Returnsboolean
#
Inherited fromFastifyInstance.hasDecorator
#
Defined innode_modules/fastify/types/instance.d.ts:71
#
hasReplyDecoratorâ–¸ hasReplyDecorator(decorator
): boolean
#
ParametersName | Type |
---|---|
decorator | string | symbol |
#
Returnsboolean
#
Inherited fromFastifyInstance.hasReplyDecorator
#
Defined innode_modules/fastify/types/instance.d.ts:73
#
hasRequestDecoratorâ–¸ hasRequestDecorator(decorator
): boolean
#
ParametersName | Type |
---|---|
decorator | string | symbol |
#
Returnsboolean
#
Inherited fromFastifyInstance.hasRequestDecorator
#
Defined innode_modules/fastify/types/instance.d.ts:72
#
injectâ–¸ inject(opts
, cb
): void
#
ParametersName | Type |
---|---|
opts | string | InjectOptions |
cb | CallbackFunc |
#
Returnsvoid
#
Inherited fromFastifyInstance.inject
#
Defined innode_modules/fastify/types/instance.d.ts:75
â–¸ inject(opts
): Promise
<Response
>
#
ParametersName | Type |
---|---|
opts | string | InjectOptions |
#
ReturnsPromise
<Response
>
#
Inherited fromFastifyInstance.inject
#
Defined innode_modules/fastify/types/instance.d.ts:76
â–¸ inject(): Chain
#
ReturnsChain
#
Inherited fromFastifyInstance.inject
#
Defined innode_modules/fastify/types/instance.d.ts:77
#
listenâ–¸ listen(port
, address
, backlog
, callback
): void
#
ParametersName | Type |
---|---|
port | string | number |
address | string |
backlog | number |
callback | (err : null | Error , address : string ) => void |
#
Returnsvoid
#
Inherited fromFastifyInstance.listen
#
Defined innode_modules/fastify/types/instance.d.ts:79
â–¸ listen(port
, address
, callback
): void
#
ParametersName | Type |
---|---|
port | string | number |
address | string |
callback | (err : null | Error , address : string ) => void |
#
Returnsvoid
#
Inherited fromFastifyInstance.listen
#
Defined innode_modules/fastify/types/instance.d.ts:80
â–¸ listen(port
, callback
): void
#
ParametersName | Type |
---|---|
port | string | number |
callback | (err : null | Error , address : string ) => void |
#
Returnsvoid
#
Inherited fromFastifyInstance.listen
#
Defined innode_modules/fastify/types/instance.d.ts:81
â–¸ listen(port
, address?
, backlog?
): Promise
<string
>
#
ParametersName | Type |
---|---|
port | string | number |
address? | string |
backlog? | number |
#
ReturnsPromise
<string
>
#
Inherited fromFastifyInstance.listen
#
Defined innode_modules/fastify/types/instance.d.ts:82
â–¸ listen(opts
, callback
): void
#
ParametersName | Type |
---|---|
opts | Object |
opts.backlog? | number |
opts.host? | string |
opts.port | number |
callback | (err : null | Error , address : string ) => void |
#
Returnsvoid
#
Inherited fromFastifyInstance.listen
#
Defined innode_modules/fastify/types/instance.d.ts:83
â–¸ listen(opts
): Promise
<string
>
#
ParametersName | Type |
---|---|
opts | Object |
opts.backlog? | number |
opts.host? | string |
opts.port | number |
#
ReturnsPromise
<string
>
#
Inherited fromFastifyInstance.listen
#
Defined innode_modules/fastify/types/instance.d.ts:84
#
printPluginsâ–¸ printPlugins(): string
Prints the representation of the plugin tree used by avvio, the plugin registration system
#
Returnsstring
#
Inherited fromFastifyInstance.printPlugins
#
Defined innode_modules/fastify/types/instance.d.ts:449
#
printRoutesâ–¸ printRoutes(opts?
): string
Prints the representation of the internal radix tree used by the router
#
ParametersName | Type |
---|---|
opts? | PrintRoutesOptions |
#
Returnsstring
#
Inherited fromFastifyInstance.printRoutes
#
Defined innode_modules/fastify/types/instance.d.ts:444
#
readyâ–¸ ready(): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
> & PromiseLike
<undefined
>
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
> & PromiseLike
<undefined
>
#
Inherited fromFastifyInstance.ready
#
Defined innode_modules/fastify/types/instance.d.ts:86
â–¸ ready(readyListener
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
ParametersName | Type |
---|---|
readyListener | (err : Error ) => void |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.ready
#
Defined innode_modules/fastify/types/instance.d.ts:87
#
routeâ–¸ route<RouteGeneric
, ContextConfig
, SchemaCompiler
>(opts
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | unknown |
SchemaCompiler | FastifySchema |
#
ParametersName | Type |
---|---|
opts | RouteOptions <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , SchemaCompiler , FastifyLoggerInstance > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.route
#
Defined innode_modules/fastify/types/instance.d.ts:95
#
routingâ–¸ routing(req
, res
): void
#
ParametersName | Type |
---|---|
req | IncomingMessage |
res | ServerResponse |
#
Returnsvoid
#
Inherited fromFastifyInstance.routing
#
Defined innode_modules/fastify/types/instance.d.ts:91
#
setDefaultRouteâ–¸ setDefaultRoute(defaultRoute
): void
#
ParametersName | Type |
---|---|
defaultRoute | DefaultRoute <IncomingMessage , ServerResponse > |
#
Returnsvoid
#
Inherited fromFastifyInstance.setDefaultRoute
#
Defined innode_modules/fastify/types/instance.d.ts:93
#
setErrorHandlerâ–¸ setErrorHandler<TError
, RouteGeneric
>(handler
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Set a function that will be called whenever an error happens
#
Type parametersName | Type |
---|---|
TError | extends Error = FastifyError |
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
#
ParametersName | Type |
---|---|
handler | (this : FastifyInstance <Server , IncomingMessage , ServerResponse , FastifyLoggerInstance >, error : TError , request : FastifyRequest <RouteGeneric , Server , IncomingMessage , unknown , FastifyLoggerInstance >, reply : FastifyReply <Server , IncomingMessage , ServerResponse , RouteGeneric , unknown >) => void | Promise <void | RouteGeneric ["Reply" ]> |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setErrorHandler
#
Defined innode_modules/fastify/types/instance.d.ts:386
#
setNotFoundHandlerâ–¸ setNotFoundHandler<RouteGeneric
>(handler
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Set the 404 handler
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
#
ParametersName | Type |
---|---|
handler | (request : FastifyRequest <RouteGeneric , Server , IncomingMessage , unknown , FastifyLoggerInstance >, reply : FastifyReply <Server , IncomingMessage , ServerResponse , RouteGeneric , unknown >) => void |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setNotFoundHandler
#
Defined innode_modules/fastify/types/instance.d.ts:366
â–¸ setNotFoundHandler<RouteGeneric
, ContextConfig
>(opts
, handler
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Type parametersName | Type |
---|---|
RouteGeneric | extends RouteGenericInterface = RouteGenericInterface |
ContextConfig | extends unknown = unknown |
#
ParametersName | Type |
---|---|
opts | Object |
opts.preHandler? | preHandlerHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyLoggerInstance > | preHandlerHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyLoggerInstance >[] |
opts.preValidation? | preValidationHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyLoggerInstance > | preValidationHookHandler <Server , IncomingMessage , ServerResponse , RouteGeneric , ContextConfig , FastifyLoggerInstance >[] |
handler | (request : FastifyRequest <RouteGeneric , Server , IncomingMessage , unknown , FastifyLoggerInstance >, reply : FastifyReply <Server , IncomingMessage , ServerResponse , RouteGeneric , unknown >) => void |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setNotFoundHandler
#
Defined innode_modules/fastify/types/instance.d.ts:370
#
setReplySerializerâ–¸ setReplySerializer(replySerializer
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Set the reply serializer for all routes.
#
ParametersName | Type |
---|---|
replySerializer | (payload : unknown , statusCode : number ) => string |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setReplySerializer
#
Defined innode_modules/fastify/types/instance.d.ts:413
#
setSchemaControllerâ–¸ setSchemaController(schemaControllerOpts
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Set the schema controller for all routes.
#
ParametersName | Type |
---|---|
schemaControllerOpts | FastifySchemaControllerOptions |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setSchemaController
#
Defined innode_modules/fastify/types/instance.d.ts:408
#
setSchemaErrorFormatterâ–¸ setSchemaErrorFormatter(errorFormatter
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
ParametersName | Type |
---|---|
errorFormatter | (errors : FastifySchemaValidationError [], dataVar : string ) => Error |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setSchemaErrorFormatter
#
Defined innode_modules/fastify/types/instance.d.ts:418
#
setSerializerCompilerâ–¸ setSerializerCompiler<T
>(schemaCompiler
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Set the schema serializer for all routes.
#
Type parametersName | Type |
---|---|
T | FastifySchema |
#
ParametersName | Type |
---|---|
schemaCompiler | FastifySerializerCompiler <T > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setSerializerCompiler
#
Defined innode_modules/fastify/types/instance.d.ts:403
#
setValidatorCompilerâ–¸ setValidatorCompiler<T
>(schemaCompiler
): FastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
Set the schema validator for all routes.
#
Type parametersName | Type |
---|---|
T | FastifySchema |
#
ParametersName | Type |
---|---|
schemaCompiler | FastifySchemaCompiler <T > |
#
ReturnsFastifyInstance
<Server
, IncomingMessage
, ServerResponse
, FastifyLoggerInstance
>
#
Inherited fromFastifyInstance.setValidatorCompiler
#
Defined innode_modules/fastify/types/instance.d.ts:398