This package has been deprecated

Author message:

This package is moved to https://www.npmjs.com/package/unggah

gcs-upload

This is a convenient wrapper around multer and google cloud storage API as a single express middleware to upload file from user to Google Cloud Storage.

It will change the field for the uploaded file with a url string like http://storage.googleapis.com/bucket-name/filename that you can save in database.

Requirements

1. Make sure you have a google cloud project with billing enabled.
2. Enable Google Storage API for the project.
3. Create a bucket to store the files.
4. Create a service account and download the credential in JSON format.

Installation

npm install gcs-upload

Usage

options:

• limit: limits of uploaded data in object form (similar to limits option in multer)
• gcsConfig:
  • keyFilename: file path for credential that you have downloaded before.
  • bucketName: the bucket name that will contain the uploaded file, you can create one through google cloud console.
  • prefix (optional): it's a string or a function that return a string which will be used as a prefix for filenames being stored.

It will return an upload object that have 3 methods: (.single(), .array(), and .fields()). You can use all of them just like how you would use multer.

note:

Instead of providing keyFilename in config, you can also use GOOGLE_APPLICATION_CREDENTIALS environment variable to store absolute path to the credential file.

Basic Example

Don't forget the enctype="multipart/form-data" in your form.

<form action="/upload-single" method="post" enctype="multipart/form-data">
  <input type="file" name="file" />
</form>

const express = require('express')
const gcsUpload = require('gcs-upload')
 
const app = express()
 
// .......
 
const upload = gcsUpload({
  limits: {
    fileSize: 1e6 // in bytes
  },
  gcsConfig: {
    keyFilename: '/Users/me/google-credential-keyfile.json',  // this can also be set using GOOGLE_APPLICATION_CREDENTIALS environment variable 
    bucketName: 'my-bucket',
    prefix: () => `${Date.now()}-` // optional, this is it's default value
  }
})
 
app.post('/upload-single', upload.single('file'), (req, res) => {
  console.log(req.body)
  res.end()
})
 
app.post('/upload-array', upload.array('files'), (req, res) => {
  console.log(req.body)
  res.end()
})
 
app.post('/upload-fields',
  upload.fields([{ name: 'file1' }, { name: 'file2' }]),
  (req, res) => {
    console.log(req.body)
    res.end()
  }
)
 
// .......

To make uploaded files available for public view, add Storage Object Viewer role for allUsers. Step by step instruction can be found here