Description =========== A node.js module for parsing incoming HTML form data. Requirements ============ * [node.js](http://nodejs.org/) -- v0.8.0 or newer Install ======= npm install busboy Examples ======== * Parsing (multipart) with default options: ```javascript var http = require('http'), inspect = require('util').inspect; var Busboy = require('busboy'); http.createServer(function(req, res) { if (req.method === 'POST') { var busboy = new Busboy({ headers: req.headers }); busboy.on('file', function(fieldname, file, filename, encoding, mimetype) { console.log('File [' + fieldname +']: filename: ' + filename + ', encoding: ' + encoding); file.on('data', function(data) { console.log('File [' + fieldname +'] got ' + data.length + ' bytes'); }); file.on('end', function() { console.log('File [' + fieldname +'] Finished'); }); }); busboy.on('field', function(fieldname, val, valTruncated, keyTruncated) { console.log('Field [' + fieldname + ']: value: ' + inspect(val)); }); busboy.on('end', function() { console.log('Done parsing form!'); res.writeHead(303, { Connection: 'close', Location: '/' }); res.end(); }); req.pipe(busboy); } else if (req.method === 'GET') { res.writeHead(200, { Connection: 'close' }); res.end('\
\
\
\ \
\ '); } }).listen(8000, function() { console.log('Listening for requests'); }); // Example output, using http://nodejs.org/images/ryan-speaker.jpg as the file: // // Listening for requests // File [filefield]: filename: ryan-speaker.jpg, encoding: binary // File [filefield] got 11971 bytes // Field [textfield]: value: 'testing! :-)' // File [filefield] Finished // Done parsing form! ``` * Save all incoming files to disk: ```javascript var http = require('http'), os = require('os'); var Busboy = require('busboy'); http.createServer(function(req, res) { if (req.method === 'POST') { var busboy = new Busboy({ headers: req.headers }); busboy.on('file', function(fieldname, file, filename, encoding, mimetype) { var saveTo = path.join(os.tmpDir(), path.basename(fieldname)); file.pipe(fs.createWriteStream(saveTo)); }); busboy.on('end', function() { res.writeHead(200, { 'Connection': 'close' }); res.end('That's all folks!'); }); return req.pipe(busboy); } res.writeHead(404); res.end(); }).listen(8000, function() { console.log('Listening for requests'); }); ``` * Parsing (urlencoded) with default options: ```javascript var http = require('http'), inspect = require('util').inspect; var Busboy = require('busboy'); http.createServer(function(req, res) { if (req.method === 'POST') { var busboy = new Busboy({ headers: req.headers }); busboy.on('file', function(fieldname, file, filename, encoding, mimetype) { console.log('File [' + fieldname +']: filename: ' + filename); file.on('data', function(data) { console.log('File [' + fieldname +'] got ' + data.length + ' bytes'); }); file.on('end', function() { console.log('File [' + fieldname +'] Finished'); }); }); busboy.on('field', function(fieldname, val, valTruncated, keyTruncated) { console.log('Field [' + fieldname + ']: value: ' + inspect(val)); }); busboy.on('end', function() { console.log('Done parsing form!'); res.writeHead(303, { Connection: 'close', Location: '/' }); res.end(); }); req.pipe(busboy); } else if (req.method === 'GET') { res.writeHead(200, { Connection: 'close' }); res.end('\
\
\
\ Node.js rules!
\ \
\ '); } }).listen(8000, function() { console.log('Listening for requests'); }); // Example output: // // Listening for requests // Field [textfield]: value: 'testing! :-)' // Field [selectfield]: value: '9001' // Field [checkfield]: value: 'on' // Done parsing form! ``` API === _Busboy_ is a _Writable_ stream Busboy (special) events ----------------------- * **file**(< _string_ >fieldname, < _ReadableStream_ >stream, < _string_ >filename, < _string_ >transferEncoding, < _string_ >mimeType) - Emitted for each new file form field found. `transferEncoding` contains the 'Content-Transfer-Encoding' value for the file stream. `mimeType` contains the 'Content-Type' value for the file stream. Notice that when no file is attached to the field, (typeof filename === 'undefined'), the stream is 0-length but still requires draining to signal that the event was handled, otherwise the 'end' event will not fire. call stream.resume() to drain the stream. * **field**(< _string_ >fieldname, < _string_ >value, < _boolean_ >valueTruncated, < _boolean_ >fieldnameTruncated) - Emitted for each new non-file field found. * **partsLimit**() - Emitted when specified `parts` limit has been reached. No more 'file' or 'field' events will be emitted. * **filesLimit**() - Emitted when specified `files` limit has been reached. No more 'file' events will be emitted. * **fieldsLimit**() - Emitted when specified `fields` limit has been reached. No more 'field' events will be emitted. **Note:** The `stream` passed in on the 'file' event will also emit a 'limit' event (no arguments) if the `fileSize` limit is reached. If this happens, no more data will be available on the stream. Busboy methods -------------- * **(constructor)**(< _object_ >config) - Creates and returns a new Busboy instance with the following valid `config` settings: * **headers** - _object_ - These are the HTTP headers of the incoming request, which are used by individual parsers. * **highWaterMark** - _integer_ - highWaterMark to use for this Busboy instance (Default: WritableStream default). * **fileHwm** - _integer_ - highWaterMark to use for file streams (Default: ReadableStream default). * **defCharset** - _string_ - Default character set to use when one isn't defined (Default: 'utf8'). * **limits** - _object_ - Various limits on incoming data. Valid properties are: * **fieldNameSize** - _integer_ - Max field name size (Default: 100 bytes). * **fieldSize** - _integer_ - Max field value size (Default: 1MB). * **fields** - _integer_ - Max number of non-file fields (Default: Infinity). * **fileSize** - _integer_ - For multipart forms, the max file size (Default: Infinity). * **files** - _integer_ - For multipart forms, the max number of file fields (Default: Infinity). * **parts** - _integer_ - For multipart forms, the max number of parts (fields + files) (Default: Infinity). * **headerPairs** - _integer_ - For multipart forms, the max number of header key=>value pairs to parse **Default:** 2000 (same as node's http).