Convenience wrappers around MongoDB GridFS methods.

npm install grid-fs --save

Require GridFs constructor and create a gridFs instance

var GridFs = require('grid-fs');
var gridFs = new GridFs(db[, collectionName]);

Where

• db is a opened database instance
• collectionName (optional, defaults to 'fs') is the collection name for the stored files

Example

var MongoClient = require('mongodb').MongoClient;
var GridFs = require('grid-fs');
MongoClient.connect('mongodb://127.0.0.1:27017/db', function(err, db) {
    var gridFs = new GridFs(db);
});

gridFs.listFile(filename, callback)

Where

• filename is the name of the file to list
• callback is the function to run with arguments (err, info). Info object contains the following properties
  • filename
  • contentType
  • uploadDate – Date object
  • length – length in bytes
  • metadata – metadata object used when creating the write stream
  • internalMd5 – MD5 hash of the contents

Example

gridFs.listFile('test.txt', function(err, info){
    if(err){
        console.log('Error or file not found');
    }else{
        console.log('File uploaded: %s', info.uploadDate);
    }
});

List all files in the collection

gridFs.list(callback)

Where

• callback is the function to run when file list is fetched, uses arguments (err, list) where list is an array of file names

Example

gridFs.list(function(err, list){
    if(err){
        console.log(err);
    }else{
        list.forEach(function(filename){
            console.log(filename);
        });
    }
});

Create Writable stream

var stream = gridFs.createWriteStream(filename[, options]);

Where

• filename is the name of file to write to (overwrites existing file if present)
• options is the optional options object (metadata object propery is probably most important)

Listen for the 'close' event to find out when the file has been stored to the GridFs

Example

var stream = gridFs.createWriteStream('test.txt', {metadata: {author: 'Andris'}});
stream.end('text.txt');
stream.on('close', function(){
    console.log('File stored and closed');
});

Create Readable stream

var stream = gridFs.createReadStream(filename);

Where

• filename is the name of the file to read from

Example

var stream = gridFs.createReadStream('test.txt');
stream.pipe(process.stdout);

Unlink a file with

gridFs.unlink(filename, callback);

Where

• filename is the name of the file to unlink
• callback is the function to run once the file is deleted

Example

gridFs.unlink('test.txt', function(err){
    if(err){
        console.log('Unlink failed');
    }
});

MIT