imgbb-uploader

imgbb-uploader

Lightweight nodejs module to easily upload images through imgbb API

Compatibility:

Node >= 8 recommended ( this module uses async/await )

Install

npm install imgbb-uploader

Use

• I) First get a free API key from imgbb(estimated time ~1 minute)
• II) (facultative) Put that key in an environment variable
• III) imgbbUploader takes exactly two String arguments; first your API key, then the absolute path of your image :

var imgbbUploader = require('imgbb-uploader');

imgbbUploader("your-imgbb-api-key-string", "home/absolute-path-to-your-image/image.png")
  .then(response => console.log(response))
  .catch(error => console.log(error))

Output example of .then(response => console.log(response)) :

{
  id: '5jKj6XV',
  url_viewer: 'https://ibb.co/5jKj6XV',
  url: 'https://i.ibb.co/94Z4Nmj/test.jpg',
  display_url: 'https://i.ibb.co/94Z4Nmj/test.jpg',
  title: 'test',
  time: '1574431312',
  image: {
    filename: 'test.jpg',
    name: 'test',
    mime: 'image/jpeg',
    extension: 'jpg',
    url: 'https://i.ibb.co/94Z4Nmj/test.jpg',
    size: 91264
  },
  thumb: {
    filename: 'test.jpg',
    name: 'test',
    mime: 'image/jpeg',
    extension: 'jpg',
    url: 'https://i.ibb.co/5jKj6XV/test.jpg',
    size: '12875'
  },
  delete_url: 'https://ibb.co/5jKj6XV/ffd8ef0b1c803f02443553535cf4a5f4'
}

This function returns a promise, this is why console.log(imgbbUploader(myKey, myPath) // output : Promise { <pending> } You access it in your .then(res => res) as shown above.

Learn more

This module doesn't support array uploads and other fancy stuff. For heavy duty uploads, you'll probably have to work with fs.readdir and forEach methods.

In which case you may also be interested in path. For example, you can create a baseDir.js file wherever your images are:

// baseDir.js
const path = require('path');
const dirPath = path.join(__dirname);
module.exports = dirPath;

Then you can require this file elsewhere, and use something like path.join(myDirpath, "subfolder", "subsubfolder") to cross directories programmatically. Once you're there you can fs.readdir and iterate forEach file of that directory, then do whatever you want. That is just a simple example, see fs documentation and Stack Overflow for more inspiration.

Anyway, the module is ~20 lines long & totally unlicensed, so even the most junior Nodejs dev should be able to easily adapt it to its needs.