This plugin is used to replace fastify-formidable and fastify-busboy.
It provides a generic API which allows users to not only using formidable
or busboy for parsing multipart/form-data, but provide custom adapter
for parsing and custom storage engine to handle file stream. You may
also try the async iterator same as @fastify/multipart for advanced usage.
You can checkout @fastify/multipart if you prefer offcial plugin.
Install
npm install @kakang/fastify-multipart --saveyarn add @kakang/fastify-multipart// For BusboyAdapternpm install busboy --saveyarn add busboy// For FormidableAdapternpm install formidable --saveyarn add formidable
Usage
import FastifyMultipart from '@kakang/fastify-multipart'import { BusboyAdapter } from '@kakang/fastify-multipart/lib/adapter/busboy'import { FileStorage } from '@kakang/fastify-multipart/lib/storage/file'import { BufferStorage } from '@kakang/fastify-multipart/lib/storage/buffer'fastify.register(FastifyMultipart, { adapter: BusboyAdapter, storage: FileStorage, storageOption: { uploadDir: '/' }})fastify.post('/', async function(request, reply) { // you need to call the parser if you do not pass any option through plugin registration await request.parseMultipart() // you can use async iterator for file handling for await (const
Options
options.adapter
The option for content type parser adapter.
By default, we provide BusboyAdapter and FormidableAdapter.
You may also extends Adapter and built your own one.
import FastifyMultipart from '@kakang/fastify-multipart'import { Adapter } from '@kakang/fastify-multipart/lib/adapter/adapter'import { BusboyAdapter } from '@kakang/fastify-multipart/lib/adapter/busboy'import { FormidableAdapter } from '@kakang/fastify-multipart/lib/adapter/formidable'import { BufferStorage } from '@kakang/fastify-multipart/lib/storage/buffer'fastify.register(FastifyBusboy, { adapter: BusboyAdapter, storage: BufferStorage,})
options.storage
The option for storage engine.
By default, we provide FileStorage and BufferStorage.
You may also extends Storage and built your own one.
import FastifyMultipart from '@kakang/fastify-multipart'import { BusboyAdapter } from '@kakang/fastify-multipart/lib/adapter/busboy'import { Storage } from '@kakang/fastify-multipart/lib/storage/storage'import { BufferStorage } from '@kakang/fastify-multipart/lib/storage/buffer'import { FileStorage } from '@kakang/fastify-multipart/lib/storage/file'fastify.register(FastifyBusboy, { adapter: BusboyAdapter, storage: MemoryStorage,})
options.removeFilesFromBody
This options will not add any files fields to body when enabled.
import FastifyMultipart from '@kakang/fastify-multipart'import { BusboyAdapter } from '@kakang/fastify-multipart/lib/adapter/busboy'import { BufferStorage } from '@kakang/fastify-multipart/lib/storage/buffer'fastify.register(FastifyBusboy, { adapter: BusboyAdapter, storage: BufferStorage, removeFilesFromBody: true})