image-cache

Powerful image cache for NodeJS

What is image-cache?

image-cache is nodejs module for cache image and serve with base64 format. image-cache using Asynchronous calls for best Performance.

New

Now image-cache using google proxy cache for best caching.

Installation

to install image-cache on your project, you can use NPM and Yarn with the following command,

NPM

npm install --save image-cache 

Yarn

yarn add image-cache

Usage

Start using image-cache

var imageCache = require('image-cache');

API

setOptions

is a function to replace options from default options. this function not returning something. for using this function, add this code after defining all variable.

imageCache.setOptions({
   compressed: false
 
   // write your custom options here
});

API

isCached()

Check is your image already cached or not. this function need 2 params.

imageCache.isCached(url, callback);

Params

Example

imageCache.isCached(url, function(exist) {
   if (exist) {
      // do something with cached image
   }
});

isCachedSync()

Check is your image is cached with Synchronous processing. return as boolean

Example

var exists = imageCache.isCachedSync(url);

API

getCache()

Get Cached Image

Example

imageCache.getCache(url, function(error, image) {
   console.log(image);
 
   // do something with image
});

API Callback

getCacheSync

Get Cached image with Synchronous processing.

Example

var image = imageCache.getCache('http://domain/path/to/image.png');

API

API return same like .getCache()

setCache()

Set new Cache, write cache files into options.dir Directory. set cache is working with multiple images.

imageCache.setCache(images, callback);

Params

Example

let images = 'https://eladnava.com/content/images/2015/11/js-6.jpg';
imageCache.setCache(images, function(error) {
   console.log(error);
});

API Callback

flushCache()

Delete all cache files on your directory. this code will delete all cache on options.dir with extension name same as options.extname.

Example

imageCache.flushCache(function(error, results) {
   if (error) {
      console.log(error);
   } else {
      console.log(results);
   }
});

API Callback

flushCacheSync()

same like flushCache, but using Synchronous processing.

Example

var results = imageCache.flushCache();

API

same like flushCache()

fetchImage()

fetchImage is a function to store cache and get cache data in one time. fetchImage using Async processing for best performace. fetchImage() check your cache file first, if your image is not available in cache folder then this function will get image and return your cache data.

fetchImage() using Promise. fetchImage callback is return as Array.

Params

Example

var image = "http://path.to/image.jpg";
 
imageCache.fetchImage(image).then((images) => {
   images.forEach((image) => {
      console.log(image);
 
      // { ... }
   });
   console.log(images);
 
   // [ { ... } ]
});

API

MISS or HIT

MISS

when your image is not available in the cache folder, image will be grab from image URL then cached on cache folder.

HIT

when your image is available in the cache folder, the image will be grab directly from cache folder.