fastify 5.12.0 → 5.12.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pi/self-learning-memory/README.md +8 -0
- package/.pi/self-learning-memory/core/CORE.md +33 -0
- package/.pi/self-learning-memory/core/index.json +735 -0
- package/.pi/self-learning-memory/daily/2026-07-06.md +22 -0
- package/.pi/self-learning-memory/daily/2026-07-29.md +50 -0
- package/.pi/self-learning-memory/daily/2026-08-04.md +41 -0
- package/.pi/self-learning-memory/daily/2026-08-18.md +40 -0
- package/.pi/self-learning-memory/long-term-memory.md +89 -0
- package/AGENTS.md +290 -0
- package/docs/Reference/Server.md +8 -3
- package/fastify.d.ts +1 -1
- package/fastify.js +2 -2
- package/lib/request.js +3 -2
- package/lib/route.js +2 -1
- package/lib/validation.js +10 -1
- package/package.json +1 -1
- package/test/close.test.js +34 -0
- package/test/fix-root-primitive-coercion.test.js +35 -0
- package/test/internals/reply.test.js +1 -1
- package/test/route-prefix.test.js +32 -0
- package/test/trust-proxy.test.js +27 -21
- package/test/types/fastify.tst.ts +2 -0
package/test/close.test.js
CHANGED
|
@@ -665,6 +665,40 @@ test('preClose async', async t => {
|
|
|
665
665
|
await fastify.close()
|
|
666
666
|
})
|
|
667
667
|
|
|
668
|
+
test('preClose runs exactly once with a child plugin', async t => {
|
|
669
|
+
t.plan(1)
|
|
670
|
+
const fastify = Fastify()
|
|
671
|
+
let count = 0
|
|
672
|
+
|
|
673
|
+
fastify.register(async (child) => {
|
|
674
|
+
child.get('/x', async () => 'ok')
|
|
675
|
+
})
|
|
676
|
+
fastify.addHook('preClose', async () => { count++ })
|
|
677
|
+
|
|
678
|
+
await fastify.ready()
|
|
679
|
+
await fastify.close()
|
|
680
|
+
|
|
681
|
+
t.assert.strictEqual(count, 1)
|
|
682
|
+
})
|
|
683
|
+
|
|
684
|
+
test('preClose runs exactly once with nested child plugins', async t => {
|
|
685
|
+
t.plan(1)
|
|
686
|
+
const fastify = Fastify()
|
|
687
|
+
let count = 0
|
|
688
|
+
|
|
689
|
+
fastify.register(async (child) => {
|
|
690
|
+
child.register(async (grandchild) => {
|
|
691
|
+
grandchild.get('/y', async () => 'ok')
|
|
692
|
+
})
|
|
693
|
+
})
|
|
694
|
+
fastify.addHook('preClose', async () => { count++ })
|
|
695
|
+
|
|
696
|
+
await fastify.ready()
|
|
697
|
+
await fastify.close()
|
|
698
|
+
|
|
699
|
+
t.assert.strictEqual(count, 1)
|
|
700
|
+
})
|
|
701
|
+
|
|
668
702
|
test('preClose execution order', (t, done) => {
|
|
669
703
|
t.plan(4)
|
|
670
704
|
const fastify = Fastify()
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
'use strict'
|
|
2
|
+
|
|
3
|
+
const { test } = require('node:test')
|
|
4
|
+
const Fastify = require('..')
|
|
5
|
+
|
|
6
|
+
test('root primitive values coerced by Ajv are assigned to the request', async (t) => {
|
|
7
|
+
const fastify = Fastify()
|
|
8
|
+
|
|
9
|
+
fastify.post('/', {
|
|
10
|
+
schema: {
|
|
11
|
+
body: {
|
|
12
|
+
type: 'integer',
|
|
13
|
+
minimum: 1,
|
|
14
|
+
maximum: 10
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
}, (request, reply) => {
|
|
18
|
+
reply.send({ body: request.body, type: typeof request.body })
|
|
19
|
+
})
|
|
20
|
+
|
|
21
|
+
const response = await fastify.inject({
|
|
22
|
+
method: 'POST',
|
|
23
|
+
url: '/',
|
|
24
|
+
payload: '"10"',
|
|
25
|
+
headers: { 'content-type': 'application/json' }
|
|
26
|
+
})
|
|
27
|
+
|
|
28
|
+
t.assert.strictEqual(response.statusCode, 200)
|
|
29
|
+
t.assert.deepStrictEqual(JSON.parse(response.payload), {
|
|
30
|
+
body: 10,
|
|
31
|
+
type: 'number'
|
|
32
|
+
})
|
|
33
|
+
|
|
34
|
+
await fastify.close()
|
|
35
|
+
})
|
|
@@ -49,7 +49,7 @@ test('Once called, Reply should return an object with methods', t => {
|
|
|
49
49
|
t.assert.strictEqual(typeof reply[kReplyErrorHandlerCalled], 'boolean')
|
|
50
50
|
t.assert.strictEqual(typeof reply.send, 'function')
|
|
51
51
|
t.assert.strictEqual(typeof reply.code, 'function')
|
|
52
|
-
t.assert.strictEqual(typeof reply.mediaType, '
|
|
52
|
+
t.assert.strictEqual(typeof reply.mediaType, 'undefined')
|
|
53
53
|
t.assert.strictEqual(typeof reply.status, 'function')
|
|
54
54
|
t.assert.strictEqual(typeof reply.header, 'function')
|
|
55
55
|
t.assert.strictEqual(typeof reply.serialize, 'function')
|
|
@@ -563,6 +563,38 @@ test('matches both /prefix and /prefix/ with a / route - prefixTrailingSlash: "
|
|
|
563
563
|
completion.patience.then(testDone)
|
|
564
564
|
})
|
|
565
565
|
|
|
566
|
+
test('reports the canonical route url for hidden prefix trailing slash route', async t => {
|
|
567
|
+
t.plan(4)
|
|
568
|
+
|
|
569
|
+
const fastify = Fastify({
|
|
570
|
+
ignoreTrailingSlash: false,
|
|
571
|
+
exposeHeadRoutes: false
|
|
572
|
+
})
|
|
573
|
+
|
|
574
|
+
const onRouteUrls = []
|
|
575
|
+
|
|
576
|
+
fastify.addHook('onRoute', routeOptions => {
|
|
577
|
+
onRouteUrls.push(routeOptions.url)
|
|
578
|
+
})
|
|
579
|
+
|
|
580
|
+
fastify.register(async instance => {
|
|
581
|
+
instance.get('/', async request => {
|
|
582
|
+
return request.routeOptions.url
|
|
583
|
+
})
|
|
584
|
+
|
|
585
|
+
instance.get('/bar/', async request => {
|
|
586
|
+
return request.routeOptions.url
|
|
587
|
+
})
|
|
588
|
+
}, { prefix: '/prefix' })
|
|
589
|
+
|
|
590
|
+
t.assert.strictEqual((await fastify.inject('/prefix')).payload, '/prefix')
|
|
591
|
+
t.assert.strictEqual((await fastify.inject('/prefix/')).payload, '/prefix')
|
|
592
|
+
t.assert.strictEqual((await fastify.inject('/prefix/bar/')).payload, '/prefix/bar/')
|
|
593
|
+
t.assert.deepStrictEqual(onRouteUrls, ['/prefix', '/prefix/bar/'])
|
|
594
|
+
|
|
595
|
+
await fastify.close()
|
|
596
|
+
})
|
|
597
|
+
|
|
566
598
|
test('matches both /prefix and /prefix/ with a / route - prefixTrailingSlash: "both", ignoreDuplicateSlashes: false', (t, testDone) => {
|
|
567
599
|
t.plan(4)
|
|
568
600
|
const fastify = Fastify({
|
package/test/trust-proxy.test.js
CHANGED
|
@@ -106,20 +106,33 @@ test('trust proxy function', async t => {
|
|
|
106
106
|
await fetchForwardedRequest(fastifyServer, '1.1.1.1', '/trustproxyfunc', undefined, 'fastify.test:1234')
|
|
107
107
|
})
|
|
108
108
|
|
|
109
|
-
test('trust proxy number', async t => {
|
|
110
|
-
t.plan(
|
|
109
|
+
test('trust proxy number ignores forwarded headers', async t => {
|
|
110
|
+
t.plan(5)
|
|
111
111
|
const app = fastify({
|
|
112
112
|
trustProxy: 1
|
|
113
113
|
})
|
|
114
114
|
t.after(() => app.close())
|
|
115
115
|
|
|
116
116
|
app.get('/trustproxynumber', function (req, reply) {
|
|
117
|
-
|
|
117
|
+
t.assert.strictEqual(req.ip, '203.0.113.7', 'ip falls back to socket remote address')
|
|
118
|
+
t.assert.deepStrictEqual(req.ips, ['203.0.113.7'], 'ips falls back to socket remote address')
|
|
119
|
+
t.assert.strictEqual(req.host, 'app.example.com', 'host ignores x-forwarded-host')
|
|
120
|
+
t.assert.strictEqual(req.hostname, 'app.example.com', 'hostname ignores x-forwarded-host')
|
|
121
|
+
t.assert.strictEqual(req.protocol, 'http', 'protocol ignores x-forwarded-proto')
|
|
118
122
|
reply.code(200).send({ ip: req.ip, host: req.host })
|
|
119
123
|
})
|
|
120
124
|
|
|
121
|
-
|
|
122
|
-
|
|
125
|
+
await app.inject({
|
|
126
|
+
method: 'GET',
|
|
127
|
+
url: '/trustproxynumber',
|
|
128
|
+
remoteAddress: '203.0.113.7',
|
|
129
|
+
headers: {
|
|
130
|
+
host: 'app.example.com',
|
|
131
|
+
'x-forwarded-for': '9.9.9.9, 8.8.8.8',
|
|
132
|
+
'x-forwarded-host': 'evil.com',
|
|
133
|
+
'x-forwarded-proto': 'https'
|
|
134
|
+
}
|
|
135
|
+
})
|
|
123
136
|
})
|
|
124
137
|
|
|
125
138
|
test('trust proxy IP addresses', async t => {
|
|
@@ -241,18 +254,15 @@ test('trust proxy reads forwarded headers from trusted connections', async t =>
|
|
|
241
254
|
})
|
|
242
255
|
})
|
|
243
256
|
|
|
244
|
-
test('trust proxy with number and undefined socket remoteAddress', t => {
|
|
257
|
+
test('trust proxy with number and undefined socket remoteAddress ignores forwarded headers', t => {
|
|
245
258
|
t.plan(3)
|
|
246
259
|
|
|
247
|
-
// Test case for issue #6606: trustProxy: 1 with undefined/null socket.remoteAddress
|
|
248
|
-
// This simulates IISNode on Windows where socket.remoteAddress may be undefined
|
|
249
260
|
const headers = {
|
|
261
|
+
host: 'real.test',
|
|
250
262
|
'x-forwarded-for': '2.2.2.2, 1.1.1.1',
|
|
251
263
|
'x-forwarded-host': 'fastify.test',
|
|
252
264
|
'x-forwarded-proto': 'https'
|
|
253
265
|
}
|
|
254
|
-
// socket must exist but remoteAddress can be undefined
|
|
255
|
-
// This is what happens in IISNode with enableXFF="true"
|
|
256
266
|
const req = {
|
|
257
267
|
method: 'GET',
|
|
258
268
|
url: '/',
|
|
@@ -262,20 +272,16 @@ test('trust proxy with number and undefined socket remoteAddress', t => {
|
|
|
262
272
|
|
|
263
273
|
const TpRequest = buildRequest(Request, 1)
|
|
264
274
|
const request = new TpRequest('id', 'params', req, 'query', 'log')
|
|
265
|
-
|
|
266
|
-
t.assert.
|
|
267
|
-
|
|
268
|
-
// the hop count check should skip it and we get 1.1.1.1 (the first trusted address from X-Forwarded-For)
|
|
269
|
-
t.assert.strictEqual(request.ip, '1.1.1.1', 'gets ip from x-forwarded-for')
|
|
270
|
-
// The host should also work correctly
|
|
271
|
-
t.assert.strictEqual(request.host, 'fastify.test', 'gets host from x-forwarded-host')
|
|
275
|
+
t.assert.strictEqual(request.ip, undefined, 'ip falls back to undefined socket remote address')
|
|
276
|
+
t.assert.strictEqual(request.host, 'real.test', 'host ignores x-forwarded-host')
|
|
277
|
+
t.assert.strictEqual(request.protocol, 'http', 'protocol ignores x-forwarded-proto')
|
|
272
278
|
})
|
|
273
279
|
|
|
274
|
-
test('trust proxy with number and null socket remoteAddress', t => {
|
|
280
|
+
test('trust proxy with number and null socket remoteAddress ignores forwarded headers', t => {
|
|
275
281
|
t.plan(2)
|
|
276
282
|
|
|
277
|
-
// Test case for trustProxy: 1 with null socket.remoteAddress
|
|
278
283
|
const headers = {
|
|
284
|
+
host: 'real.test',
|
|
279
285
|
'x-forwarded-for': '2.2.2.2, 1.1.1.1',
|
|
280
286
|
'x-forwarded-host': 'fastify.test'
|
|
281
287
|
}
|
|
@@ -288,8 +294,8 @@ test('trust proxy with number and null socket remoteAddress', t => {
|
|
|
288
294
|
|
|
289
295
|
const TpRequest = buildRequest(Request, 1)
|
|
290
296
|
const request = new TpRequest('id', 'params', req, 'query', 'log')
|
|
291
|
-
t.assert.
|
|
292
|
-
t.assert.strictEqual(request.
|
|
297
|
+
t.assert.strictEqual(request.ip, null, 'ip falls back to null socket remote address')
|
|
298
|
+
t.assert.strictEqual(request.host, 'real.test', 'host ignores x-forwarded-host')
|
|
293
299
|
})
|
|
294
300
|
|
|
295
301
|
test('trust proxy does not trust x-forwarded-host/proto when socket is null', t => {
|
|
@@ -198,6 +198,8 @@ expect(fastify({
|
|
|
198
198
|
}
|
|
199
199
|
})).type.toBeAssignableTo<FastifyInstance>()
|
|
200
200
|
expect(fastify({ trustProxy: true })).type.toBeAssignableTo<FastifyInstance>()
|
|
201
|
+
// @ts-expect-error No overload matches this call.
|
|
202
|
+
fastify({ trustProxy: 1 })
|
|
201
203
|
expect(fastify({ querystringParser: () => ({ foo: 'bar' }) })).type.toBeAssignableTo<FastifyInstance>()
|
|
202
204
|
expect(fastify({ querystringParser: () => ({ foo: { bar: 'fuzz' } }) })).type.toBeAssignableTo<FastifyInstance>()
|
|
203
205
|
expect(fastify({ querystringParser: () => ({ foo: ['bar', 'fuzz'] }) })).type.toBeAssignableTo<FastifyInstance>()
|