fastify · Dipali127 · Oct 7, 2025 · Oct 8, 2025 · Oct 9, 2025 · Oct 9, 2025
diff --git a/index.js b/index.js
@@ -19,8 +19,10 @@ send.mime.default_type = 'application/octet-stream'
 
 /** @type {import("fastify").FastifyPluginAsync<import("./types").FastifyStaticOptions>} */
 async function fastifyStatic (fastify, opts) {
-  opts.root = normalizeRoot(opts.root)
-  checkRootPathForErrors(fastify, opts.root)
+  if (opts.serve !== false) {
+    opts.root = normalizeRoot(opts.root)
+    checkRootPathForErrors(fastify, opts.root)
+  }
 
   const setHeaders = opts.setHeaders
   if (setHeaders !== undefined && typeof setHeaders !== 'function') {

diff --git a/test/root/example.html b/test/root/example.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>test file</title>
+</head>
+<body>
+    <h1>hello fastify</h1>
+</body>
+</html>
diff --git a/test/serve-option.test.js b/test/serve-option.test.js
@@ -0,0 +1,40 @@
+'use strict'
+
+const path = require('node:path')
+const assert = require('node:assert')
+const { test } = require('node:test')
+const Fastify = require('fastify')
+const fastifyStatic = require('../index.js')
+
+test('should not serve static files when serve is false', async t => {
+  const fastify = Fastify()
+  fastify.register(fastifyStatic, {
+    serve: false
+  })
+
+  t.after(() => fastify.close())
+  await fastify.listen({ port: 0 })
+  console.log('Server running at http://localhost:0')
+  fastify.server.unref()
-  fastify.server.unref()
+  t.after(() => fastify.close())
-  fastify.server.unref()
+  t.after(() => fastify.close())
+
+  const res = await fetch('http://localhost:' + fastify.server.address().port + '/public/example.html')
+  assert.strictEqual(res.status, 404);
+})
+
+test('should serve static files when serve is true', async t => {
+  const fastify = Fastify()
+  fastify.register(fastifyStatic, {
+    root: path.join(__dirname, 'root'),
+    prefix: '/public/'
+  })
+
+  t.after(() => fastify.close())
+  await fastify.listen({ port: 0 })
+  fastify.server.unref()
-  fastify.server.unref()
+  t.after(() => fastify.close())
-  fastify.server.unref()
+  t.after(() => fastify.close())
+
+  const res = await fetch('http://localhost:' + fastify.server.address().port + '/public/example.html')
+  assert.strictEqual(res.status, 200);
+
+  const content = await res.text()
+  assert.ok(content.includes('hello'), 'File content should contain "hello"');
+})