node-fastify 5.8.3

package/test/nullable-validation.test.js

@@ -0,0 +1,187 @@
+'use strict'
+
+const { test } = require('node:test')
+const Fastify = require('..')
+
+test('nullable string', (t, done) => {
+  t.plan(3)
+  const fastify = Fastify()
+  fastify.route({
+    method: 'POST',
+    url: '/',
+    handler: (req, reply) => {
+      t.assert.strictEqual(req.body.hello, null)
+      reply.code(200).send(req.body)
+    },
+    schema: {
+      body: {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string',
+            format: 'email',
+            nullable: true
+          }
+        }
+      },
+      response: {
+        200: {
+          type: 'object',
+          properties: {
+            hello: {
+              type: 'string',
+              format: 'email',
+              nullable: true
+            }
+          }
+        }
+      }
+    }
+  })
+  fastify.inject({
+    method: 'POST',
+    url: '/',
+    body: {
+      hello: null
+    }
+  }, (err, res) => {
+    t.assert.ifError(err)
+    t.assert.strictEqual(res.json().hello, null)
+    done()
+  })
+})
+
+test('object or null body', async (t) => {
+  t.plan(4)
+
+  const fastify = Fastify()
+
+  fastify.route({
+    method: 'POST',
+    url: '/',
+    handler: (req, reply) => {
+      t.assert.strictEqual(req.body, undefined)
+      reply.code(200).send({ isUndefinedBody: req.body === undefined })
+    },
+    schema: {
+      body: {
+        type: ['object', 'null'],
+        properties: {
+          hello: {
+            type: 'string',
+            format: 'email'
+          }
+        }
+      },
+      response: {
+        200: {
+          type: 'object',
+          nullable: true,
+          properties: {
+            isUndefinedBody: {
+              type: 'boolean'
+            }
+          }
+        }
+      }
+    }
+  })
+
+  const fastifyServer = await fastify.listen({ port: 0 })
+  t.after(() => { fastify.close() })
+
+  const result = await fetch(fastifyServer, {
+    method: 'POST'
+  })
+
+  t.assert.ok(result.ok)
+  t.assert.strictEqual(result.status, 200)
+  t.assert.deepStrictEqual(await result.json(), { isUndefinedBody: true })
+})
+
+test('nullable body', async (t) => {
+  t.plan(4)
+
+  const fastify = Fastify()
+
+  fastify.route({
+    method: 'POST',
+    url: '/',
+    handler: (req, reply) => {
+      t.assert.strictEqual(req.body, undefined)
+      reply.code(200).send({ isUndefinedBody: req.body === undefined })
+    },
+    schema: {
+      body: {
+        type: 'object',
+        nullable: true,
+        properties: {
+          hello: {
+            type: 'string',
+            format: 'email'
+          }
+        }
+      },
+      response: {
+        200: {
+          type: 'object',
+          nullable: true,
+          properties: {
+            isUndefinedBody: {
+              type: 'boolean'
+            }
+          }
+        }
+      }
+    }
+  })
+
+  const fastifyServer = await fastify.listen({ port: 0 })
+  t.after(() => fastify.close())
+
+  const result = await fetch(fastifyServer, {
+    method: 'POST'
+  })
+
+  t.assert.ok(result.ok)
+  t.assert.strictEqual(result.status, 200)
+  t.assert.deepStrictEqual(await result.json(), { isUndefinedBody: true })
+})
+
+test('Nullable body with 204', async (t) => {
+  t.plan(4)
+
+  const fastify = Fastify()
+
+  fastify.route({
+    method: 'POST',
+    url: '/',
+    handler: (req, reply) => {
+      t.assert.strictEqual(req.body, undefined)
+      reply.code(204).send()
+    },
+    schema: {
+      body: {
+        type: 'object',
+        nullable: true,
+        properties: {
+          hello: {
+            type: 'string',
+            format: 'email'
+          }
+        }
+      }
+    }
+  })
+
+  const fastifyServer = await fastify.listen({ port: 0 })
+  t.after(() => fastify.close())
+
+  const result = await fetch(fastifyServer, {
+    method: 'POST'
+  })
+
+  t.assert.ok(result.ok)
+  t.assert.strictEqual(result.status, 204)
+  t.assert.strictEqual((await result.text()).length, 0)
+})

package/test/options.error-handler.test.js

@@ -0,0 +1,5 @@
+'use strict'
+
+const t = require('node:test')
+require('./helper').payloadMethod('options', t, true)
+require('./input-validation').payloadMethod('options', t)

package/test/options.test.js

@@ -0,0 +1,5 @@
+'use strict'
+
+const t = require('node:test')
+require('./helper').payloadMethod('options', t)
+require('./input-validation').payloadMethod('options', t)

package/test/output-validation.test.js

@@ -0,0 +1,140 @@
+'use strict'
+
+const { test } = require('node:test')
+const fastify = require('..')()
+
+const opts = {
+  schema: {
+    response: {
+      200: {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'string'
+          }
+        }
+      },
+      '2xx': {
+        type: 'object',
+        properties: {
+          hello: {
+            type: 'number'
+          }
+        }
+      }
+    }
+  }
+}
+
+test('shorthand - output string', t => {
+  t.plan(1)
+  try {
+    fastify.get('/string', opts, function (req, reply) {
+      reply.code(200).send({ hello: 'world' })
+    })
+    t.assert.ok(true)
+  } catch (e) {
+    t.assert.fail()
+  }
+})
+
+test('shorthand - output number', t => {
+  t.plan(1)
+  try {
+    fastify.get('/number', opts, function (req, reply) {
+      reply.code(201).send({ hello: 55 })
+    })
+    t.assert.ok(true)
+  } catch (e) {
+    t.assert.fail()
+  }
+})
+
+test('wrong object for schema - output', t => {
+  t.plan(1)
+  try {
+    fastify.get('/wrong-object-for-schema', opts, function (req, reply) {
+      // will send { }
+      reply.code(201).send({ hello: 'world' })
+    })
+    t.assert.ok(true)
+  } catch (e) {
+    t.assert.fail()
+  }
+})
+
+test('empty response', t => {
+  t.plan(1)
+  try {
+    // no checks
+    fastify.get('/empty', opts, function (req, reply) {
+      reply.code(204).send()
+    })
+    t.assert.ok(true)
+  } catch (e) {
+    t.assert.fail()
+  }
+})
+
+test('unlisted response code', t => {
+  t.plan(1)
+  try {
+    fastify.get('/400', opts, function (req, reply) {
+      reply.code(400).send({ hello: 'DOOM' })
+    })
+    t.assert.ok(true)
+  } catch (e) {
+    t.assert.fail()
+  }
+})
+
+test('start server and run tests', async (t) => {
+  const fastifyServer = await fastify.listen({ port: 0 })
+  t.after(() => fastify.close())
+
+  await test('shorthand - string get ok', async (t) => {
+    const result = await fetch(fastifyServer + '/string')
+    t.assert.ok(result.ok)
+    t.assert.strictEqual(result.status, 200)
+    const body = await result.text()
+    t.assert.strictEqual(result.headers.get('content-length'), '' + body.length)
+    t.assert.deepStrictEqual(JSON.parse(body), { hello: 'world' })
+  })
+
+  await test('shorthand - number get ok', async (t) => {
+    const result = await fetch(fastifyServer + '/number')
+    t.assert.ok(result.ok)
+    t.assert.strictEqual(result.status, 201)
+    const body = await result.text()
+    t.assert.strictEqual(result.headers.get('content-length'), '' + body.length)
+    t.assert.deepStrictEqual(JSON.parse(body), { hello: 55 })
+  })
+
+  await test('shorthand - wrong-object-for-schema', async (t) => {
+    const result = await fetch(fastifyServer + '/wrong-object-for-schema')
+    t.assert.ok(!result.ok)
+    t.assert.strictEqual(result.status, 500)
+    const body = await result.text()
+    t.assert.strictEqual(result.headers.get('content-length'), '' + body.length)
+    t.assert.deepStrictEqual(JSON.parse(body), {
+      statusCode: 500,
+      error: 'Internal Server Error',
+      message: 'The value "world" cannot be converted to a number.'
+    })
+  })
+
+  await test('shorthand - empty', async (t) => {
+    const result = await fetch(fastifyServer + '/empty')
+    t.assert.ok(result.ok)
+    t.assert.strictEqual(result.status, 204)
+  })
+
+  await test('shorthand - 400', async (t) => {
+    const result = await fetch(fastifyServer + '/400')
+    t.assert.ok(!result.ok)
+    t.assert.strictEqual(result.status, 400)
+    const body = await result.text()
+    t.assert.strictEqual(result.headers.get('content-length'), '' + body.length)
+    t.assert.deepStrictEqual(JSON.parse(body), { hello: 'DOOM' })
+  })
+})

package/test/patch.error-handler.test.js

@@ -0,0 +1,5 @@
+'use strict'
+
+const t = require('node:test')
+require('./helper').payloadMethod('patch', t, true)
+require('./input-validation').payloadMethod('patch', t)

package/test/patch.test.js

@@ -0,0 +1,5 @@
+'use strict'
+
+const t = require('node:test')
+require('./helper').payloadMethod('patch', t)
+require('./input-validation').payloadMethod('patch', t)

package/test/plugin.1.test.js

@@ -0,0 +1,230 @@
+'use strict'
+
+const t = require('node:test')
+const test = t.test
+const Fastify = require('../fastify')
+const fp = require('fastify-plugin')
+
+test('require a plugin', (t, testDone) => {
+  t.plan(1)
+  const fastify = Fastify()
+  fastify.register(require('./plugin.helper'))
+  fastify.ready(() => {
+    t.assert.ok(fastify.test)
+    testDone()
+  })
+})
+
+test('plugin metadata - ignore prefix', (t, testDone) => {
+  t.plan(2)
+  const fastify = Fastify()
+
+  plugin[Symbol.for('skip-override')] = true
+  fastify.register(plugin, { prefix: 'foo' })
+
+  fastify.inject({
+    method: 'GET',
+    url: '/'
+  }, function (err, res) {
+    t.assert.ifError(err)
+    t.assert.strictEqual(res.payload, 'hello')
+    testDone()
+  })
+
+  function plugin (instance, opts, done) {
+    instance.get('/', function (request, reply) {
+      reply.send('hello')
+    })
+    done()
+  }
+})
+
+test('plugin metadata - naming plugins', async t => {
+  t.plan(2)
+  const fastify = Fastify()
+
+  fastify.register(require('./plugin.name.display'))
+  fastify.register(function (fastify, opts, done) {
+    // one line
+    t.assert.strictEqual(fastify.pluginName, 'function (fastify, opts, done) { -- // one line')
+    done()
+  })
+  fastify.register(function fooBar (fastify, opts, done) {
+    t.assert.strictEqual(fastify.pluginName, 'fooBar')
+    done()
+  })
+
+  await fastify.ready()
+})
+
+test('fastify.register with fastify-plugin should not encapsulate his code', async t => {
+  t.plan(9)
+  const fastify = Fastify()
+
+  fastify.register((instance, opts, done) => {
+    instance.register(fp((i, o, n) => {
+      i.decorate('test', () => {})
+      t.assert.ok(i.test)
+      n()
+    }))
+
+    t.assert.ok(!instance.test)
+
+    // the decoration is added at the end
+    instance.after(() => {
+      t.assert.ok(instance.test)
+    })
+
+    instance.get('/', (req, reply) => {
+      t.assert.ok(instance.test)
+      reply.send({ hello: 'world' })
+    })
+
+    done()
+  })
+
+  fastify.ready(() => {
+    t.assert.ok(!fastify.test)
+  })
+
+  const fastifyServer = await fastify.listen({ port: 0 })
+  t.after(() => { fastify.close() })
+
+  const result = await fetch(fastifyServer)
+  t.assert.ok(result.ok)
+  t.assert.strictEqual(result.status, 200)
+  const body = await result.text()
+  t.assert.strictEqual(result.headers.get('content-length'), '' + body.length)
+  t.assert.deepStrictEqual(JSON.parse(body), { hello: 'world' })
+})
+
+test('fastify.register with fastify-plugin should provide access to external fastify instance if opts argument is a function', async t => {
+  t.plan(21)
+  const fastify = Fastify()
+
+  fastify.register((instance, opts, done) => {
+    instance.register(fp((i, o, n) => {
+      i.decorate('global', () => {})
+      t.assert.ok(i.global)
+      n()
+    }))
+
+    instance.register((i, o, n) => n(), p => {
+      t.assert.ok(!(p === instance || p === fastify))
+      t.assert.ok(Object.prototype.isPrototypeOf.call(instance, p))
+      t.assert.ok(Object.prototype.isPrototypeOf.call(fastify, p))
+      t.assert.ok(p.global)
+    })
+
+    instance.register((i, o, n) => {
+      i.decorate('local', () => {})
+      n()
+    })
+
+    instance.register((i, o, n) => n(), p => t.assert.ok(!p.local))
+
+    instance.register((i, o, n) => {
+      t.assert.ok(i.local)
+      n()
+    }, p => p.decorate('local', () => {}))
+
+    instance.register((i, o, n) => n(), p => t.assert.ok(!p.local))
+
+    instance.register(fp((i, o, n) => {
+      t.assert.ok(i.global_2)
+      n()
+    }), p => p.decorate('global_2', () => 'hello'))
+
+    instance.register((i, o, n) => {
+      i.decorate('global_2', () => 'world')
+      n()
+    }, p => p.get('/', (req, reply) => {
+      t.assert.ok(p.global_2)
+      reply.send({ hello: p.global_2() })
+    }))
+
+    t.assert.ok(!instance.global)
+    t.assert.ok(!instance.global_2)
+    t.assert.ok(!instance.local)
+
+    // the decoration is added at the end
+    instance.after(() => {
+      t.assert.ok(instance.global)
+      t.assert.strictEqual(instance.global_2(), 'hello')
+      t.assert.ok(!instance.local)
+    })
+
+    done()
+  })
+
+  fastify.ready(() => {
+    t.assert.ok(!fastify.global)
+  })
+
+  const fastifyServer = await fastify.listen({ port: 0 })
+  t.after(() => { fastify.close() })
+
+  const result = await fetch(fastifyServer)
+  t.assert.ok(result.ok)
+  t.assert.strictEqual(result.status, 200)
+  const body = await result.text()
+  t.assert.strictEqual(result.headers.get('content-length'), '' + body.length)
+  t.assert.deepStrictEqual(JSON.parse(body), { hello: 'world' })
+})
+
+test('fastify.register with fastify-plugin registers fastify level plugins', async t => {
+  t.plan(14)
+  const fastify = Fastify()
+
+  function fastifyPlugin (instance, opts, done) {
+    instance.decorate('test', 'first')
+    t.assert.ok(instance.test)
+    done()
+  }
+
+  function innerPlugin (instance, opts, done) {
+    instance.decorate('test2', 'second')
+    done()
+  }
+
+  fastify.register(fp(fastifyPlugin))
+
+  fastify.register((instance, opts, done) => {
+    t.assert.ok(instance.test)
+    instance.register(fp(innerPlugin))
+
+    instance.get('/test2', (req, reply) => {
+      t.assert.ok(instance.test2)
+      reply.send({ test2: instance.test2 })
+    })
+
+    done()
+  })
+
+  fastify.ready(() => {
+    t.assert.ok(fastify.test)
+    t.assert.ok(!fastify.test2)
+  })
+
+  fastify.get('/', (req, reply) => {
+    t.assert.ok(fastify.test)
+    reply.send({ test: fastify.test })
+  })
+
+  const fastifyServer = await fastify.listen({ port: 0 })
+  t.after(() => { fastify.close() })
+
+  const result1 = await fetch(fastifyServer)
+  t.assert.ok(result1.ok)
+  t.assert.strictEqual(result1.status, 200)
+  const body1 = await result1.text()
+  t.assert.strictEqual(result1.headers.get('content-length'), '' + body1.length)
+  t.assert.deepStrictEqual(JSON.parse(body1), { test: 'first' })
+
+  const result2 = await fetch(fastifyServer + '/test2')
+  t.assert.ok(result2.ok)
+  t.assert.strictEqual(result2.status, 200)
+  const body2 = await result2.text()
+  t.assert.strictEqual(result2.headers.get('content-length'), '' + body2.length)
+  t.assert.deepStrictEqual(JSON.parse(body2), { test2: 'second' })
+})