fastify
Version:
Fast and low overhead web framework, for Node.js
464 lines (365 loc) • 11.3 kB
JavaScript
/* eslint no-prototype-builtins: 0 */
const t = require('tap')
const test = t.test
const Fastify = require('../fastify')
const fp = require('fastify-plugin')
const fakeTimer = require('@sinonjs/fake-timers')
test('pluginTimeout', t => {
t.plan(5)
const fastify = Fastify({
pluginTimeout: 10
})
fastify.register(function (app, opts, done) {
// to no call done on purpose
})
fastify.ready((err) => {
t.ok(err)
t.equal(err.message,
"fastify-plugin: Plugin did not start in time: 'function (app, opts, done) { -- // to no call done on purpose'. You may have forgotten to call 'done' function or to resolve a Promise")
t.equal(err.code, 'FST_ERR_PLUGIN_TIMEOUT')
t.ok(err.cause)
t.equal(err.cause.code, 'AVV_ERR_PLUGIN_EXEC_TIMEOUT')
})
})
test('pluginTimeout - named function', t => {
t.plan(5)
const fastify = Fastify({
pluginTimeout: 10
})
fastify.register(function nameFunction (app, opts, done) {
// to no call done on purpose
})
fastify.ready((err) => {
t.ok(err)
t.equal(err.message,
"fastify-plugin: Plugin did not start in time: 'nameFunction'. You may have forgotten to call 'done' function or to resolve a Promise")
t.equal(err.code, 'FST_ERR_PLUGIN_TIMEOUT')
t.ok(err.cause)
t.equal(err.cause.code, 'AVV_ERR_PLUGIN_EXEC_TIMEOUT')
})
})
test('pluginTimeout default', t => {
t.plan(5)
const clock = fakeTimer.install({ shouldClearNativeTimers: true })
const fastify = Fastify()
fastify.register(function (app, opts, done) {
// default time elapsed without calling done
clock.tick(10000)
})
fastify.ready((err) => {
t.ok(err)
t.equal(err.message,
"fastify-plugin: Plugin did not start in time: 'function (app, opts, done) { -- // default time elapsed without calling done'. You may have forgotten to call 'done' function or to resolve a Promise")
t.equal(err.code, 'FST_ERR_PLUGIN_TIMEOUT')
t.ok(err.cause)
t.equal(err.cause.code, 'AVV_ERR_PLUGIN_EXEC_TIMEOUT')
})
t.teardown(clock.uninstall)
})
test('plugin metadata - version', t => {
t.plan(1)
const fastify = Fastify()
plugin[Symbol.for('skip-override')] = true
plugin[Symbol.for('plugin-meta')] = {
name: 'plugin',
fastify: '2.0.0'
}
fastify.register(plugin)
fastify.ready(() => {
t.pass('everything right')
})
function plugin (instance, opts, done) {
done()
}
})
test('plugin metadata - version range', t => {
t.plan(1)
const fastify = Fastify()
plugin[Symbol.for('skip-override')] = true
plugin[Symbol.for('plugin-meta')] = {
name: 'plugin',
fastify: '>=2.0.0'
}
fastify.register(plugin)
fastify.ready(() => {
t.pass('everything right')
})
function plugin (instance, opts, done) {
done()
}
})
test('plugin metadata - version not matching requirement', t => {
t.plan(2)
const fastify = Fastify()
plugin[Symbol.for('skip-override')] = true
plugin[Symbol.for('plugin-meta')] = {
name: 'plugin',
fastify: '99.0.0'
}
fastify.register(plugin)
fastify.ready((err) => {
t.ok(err)
t.equal(err.code, 'FST_ERR_PLUGIN_VERSION_MISMATCH')
})
function plugin (instance, opts, done) {
done()
}
})
test('plugin metadata - version not matching requirement 2', t => {
t.plan(2)
const fastify = Fastify()
plugin[Symbol.for('skip-override')] = true
plugin[Symbol.for('plugin-meta')] = {
name: 'plugin',
fastify: '<=3.0.0'
}
fastify.register(plugin)
fastify.ready((err) => {
t.ok(err)
t.equal(err.code, 'FST_ERR_PLUGIN_VERSION_MISMATCH')
})
function plugin (instance, opts, done) {
done()
}
})
test('plugin metadata - version not matching requirement 3', t => {
t.plan(2)
const fastify = Fastify()
plugin[Symbol.for('skip-override')] = true
plugin[Symbol.for('plugin-meta')] = {
name: 'plugin',
fastify: '>=99.0.0'
}
fastify.register(plugin)
fastify.ready((err) => {
t.ok(err)
t.equal(err.code, 'FST_ERR_PLUGIN_VERSION_MISMATCH')
})
function plugin (instance, opts, done) {
done()
}
})
test('plugin metadata - release candidate', t => {
t.plan(2)
const fastify = Fastify()
Object.defineProperty(fastify, 'version', {
value: '99.0.0-rc.1'
})
plugin[Symbol.for('plugin-meta')] = {
name: 'plugin',
fastify: '99.x'
}
fastify.register(plugin)
fastify.ready((err) => {
t.error(err)
t.pass('everything right')
})
function plugin (instance, opts, done) {
done()
}
})
test('fastify-rc loads prior version plugins', t => {
t.plan(2)
const fastify = Fastify()
Object.defineProperty(fastify, 'version', {
value: '99.0.0-rc.1'
})
plugin[Symbol.for('plugin-meta')] = {
name: 'plugin',
fastify: '^98.1.0'
}
plugin2[Symbol.for('plugin-meta')] = {
name: 'plugin2',
fastify: '98.x'
}
fastify.register(plugin)
fastify.ready((err) => {
t.error(err)
t.pass('everything right')
})
function plugin (instance, opts, done) {
done()
}
function plugin2 (instance, opts, done) {
done()
}
})
test('hasPlugin method exists as a function', t => {
t.plan(1)
const fastify = Fastify()
t.equal(typeof fastify.hasPlugin, 'function')
})
test('hasPlugin returns true if the specified plugin has been registered', async t => {
t.plan(4)
const fastify = Fastify()
function pluginA (fastify, opts, done) {
t.ok(fastify.hasPlugin('plugin-A'))
done()
}
pluginA[Symbol.for('fastify.display-name')] = 'plugin-A'
fastify.register(pluginA)
fastify.register(function pluginB (fastify, opts, done) {
t.ok(fastify.hasPlugin('pluginB'))
done()
})
fastify.register(function (fastify, opts, done) {
// one line
t.ok(fastify.hasPlugin('function (fastify, opts, done) { -- // one line'))
done()
})
await fastify.ready()
t.ok(fastify.hasPlugin('fastify'))
})
test('hasPlugin returns false if the specified plugin has not been registered', t => {
t.plan(1)
const fastify = Fastify()
t.notOk(fastify.hasPlugin('pluginFoo'))
})
test('hasPlugin returns false when using encapsulation', async t => {
t.plan(25)
const fastify = Fastify()
fastify.register(function pluginA (fastify, opts, done) {
t.ok(fastify.hasPlugin('pluginA'))
t.notOk(fastify.hasPlugin('pluginAA'))
t.notOk(fastify.hasPlugin('pluginAAA'))
t.notOk(fastify.hasPlugin('pluginAB'))
t.notOk(fastify.hasPlugin('pluginB'))
fastify.register(function pluginAA (fastify, opts, done) {
t.notOk(fastify.hasPlugin('pluginA'))
t.ok(fastify.hasPlugin('pluginAA'))
t.notOk(fastify.hasPlugin('pluginAAA'))
t.notOk(fastify.hasPlugin('pluginAB'))
t.notOk(fastify.hasPlugin('pluginB'))
fastify.register(function pluginAAA (fastify, opts, done) {
t.notOk(fastify.hasPlugin('pluginA'))
t.notOk(fastify.hasPlugin('pluginAA'))
t.ok(fastify.hasPlugin('pluginAAA'))
t.notOk(fastify.hasPlugin('pluginAB'))
t.notOk(fastify.hasPlugin('pluginB'))
done()
})
done()
})
fastify.register(function pluginAB (fastify, opts, done) {
t.notOk(fastify.hasPlugin('pluginA'))
t.notOk(fastify.hasPlugin('pluginAA'))
t.notOk(fastify.hasPlugin('pluginAAA'))
t.ok(fastify.hasPlugin('pluginAB'))
t.notOk(fastify.hasPlugin('pluginB'))
done()
})
done()
})
fastify.register(function pluginB (fastify, opts, done) {
t.notOk(fastify.hasPlugin('pluginA'))
t.notOk(fastify.hasPlugin('pluginAA'))
t.notOk(fastify.hasPlugin('pluginAAA'))
t.notOk(fastify.hasPlugin('pluginAB'))
t.ok(fastify.hasPlugin('pluginB'))
done()
})
await fastify.ready()
})
test('hasPlugin returns true when using no encapsulation', async t => {
t.plan(26)
const fastify = Fastify()
fastify.register(fp((fastify, opts, done) => {
t.equal(fastify.pluginName, 'fastify -> plugin-AA')
t.ok(fastify.hasPlugin('plugin-AA'))
t.notOk(fastify.hasPlugin('plugin-A'))
t.notOk(fastify.hasPlugin('plugin-AAA'))
t.notOk(fastify.hasPlugin('plugin-AB'))
t.notOk(fastify.hasPlugin('plugin-B'))
fastify.register(fp((fastify, opts, done) => {
t.ok(fastify.hasPlugin('plugin-AA'))
t.ok(fastify.hasPlugin('plugin-A'))
t.notOk(fastify.hasPlugin('plugin-AAA'))
t.notOk(fastify.hasPlugin('plugin-AB'))
t.notOk(fastify.hasPlugin('plugin-B'))
fastify.register(fp((fastify, opts, done) => {
t.ok(fastify.hasPlugin('plugin-AA'))
t.ok(fastify.hasPlugin('plugin-A'))
t.ok(fastify.hasPlugin('plugin-AAA'))
t.notOk(fastify.hasPlugin('plugin-AB'))
t.notOk(fastify.hasPlugin('plugin-B'))
done()
}, { name: 'plugin-AAA' }))
done()
}, { name: 'plugin-A' }))
fastify.register(fp((fastify, opts, done) => {
t.ok(fastify.hasPlugin('plugin-AA'))
t.ok(fastify.hasPlugin('plugin-A'))
t.ok(fastify.hasPlugin('plugin-AAA'))
t.ok(fastify.hasPlugin('plugin-AB'))
t.notOk(fastify.hasPlugin('plugin-B'))
done()
}, { name: 'plugin-AB' }))
done()
}, { name: 'plugin-AA' }))
fastify.register(fp((fastify, opts, done) => {
t.ok(fastify.hasPlugin('plugin-AA'))
t.ok(fastify.hasPlugin('plugin-A'))
t.ok(fastify.hasPlugin('plugin-AAA'))
t.ok(fastify.hasPlugin('plugin-AB'))
t.ok(fastify.hasPlugin('plugin-B'))
done()
}, { name: 'plugin-B' }))
await fastify.ready()
})
test('hasPlugin returns true when using encapsulation', async t => {
t.plan(2)
const fastify = Fastify()
const pluginCallback = function (server, options, done) {
done()
}
const pluginName = 'awesome-plugin'
const plugin = fp(pluginCallback, { name: pluginName })
fastify.register(plugin)
fastify.register(async (server) => {
t.ok(server.hasPlugin(pluginName))
})
fastify.register(async function foo (server) {
server.register(async function bar (server) {
t.ok(server.hasPlugin(pluginName))
})
})
await fastify.ready()
})
test('registering plugins with mixed style should return a warning', async t => {
t.plan(12)
const pluginNames = ['error-plugin', 'anonymous', 'anotherPlugin', 'anotherPluginNamed']
const oldWarnings = process.listeners('warning')
process.removeAllListeners('warning')
process.on('warning', onWarning)
function onWarning (warning) {
t.match(warning.message, new RegExp(`.*${pluginNames.shift()} plugin being registered mixes async and callback styles.*`))
t.equal(warning.name, 'FastifyWarning')
t.equal(warning.code, 'FSTWRN002')
}
t.teardown(() => {
process.removeListener('warning', onWarning)
for (const warning of oldWarnings) {
process.on('warning', warning)
}
})
const fastify = Fastify()
const pluginName = 'error-plugin'
const errorPlugin = async (app, opts, done) => {
done()
}
const namedPlugin = fp(errorPlugin, { name: pluginName })
async function anotherPlugin (app, opts, done) {
done()
}
const anotherPluginNamed = async function (app, opts, done) {
done()
}
fastify.register(namedPlugin)
fastify.register(async (app, opts, done) => {
done()
})
fastify.register(anotherPlugin)
fastify.register(anotherPluginNamed)
await fastify.ready()
})