express-sharp

express-sharp

express-sharp adds real-time image processing routes to your express application. Images are processed with sharp, a fast Node.js module for resizing images.

Installation

$ npm install express-sharp --save

See sharp installation for additional installation instructions.

Usage

Example app.js:

'use strict';

var express = require('express');
var app = express();
var scale = require('express-sharp');

var options = {baseHost: 'mybasehost.com'};
app.use('/my-scale', scale(options));

app.listen(3000));

Render http://mybasehost.com/image.jpg with 400x400 pixels:

GET /my-scale/resize/400?url=http://mybasehost.com/image.jpg HTTP/1.1
Host: localhost:3000

--> invokes in background:
  GET image.jpg HTTP/1.1
  Host: mybasehost.com

Same as above, but with 80% quality, webp image type and with progressive enabled:

GET /my-scale/resize/400?format=webp&quality=80&progressive=true&url=http://mybasehost.com/image.jpg HTTP/1.1
Host: localhost:3000

Options

var scale = require('express-sharp');
app.use('/some-path', scale(options));

Supported options:

baseHost

Specify the HTTP base host from wich images are to be requested.

Path and query params

format

Output image format.

Default: output format of the requested image.

Valid values: every valid sharp output format string, i.e. jpeg, gif, webp or raw.

progressive

Use progressive (interlace) scan for JPEG and PNG output. This typically reduces compression performance by 30% but results in an image that can be rendered sooner when decompressed.

Use &progressive=true to enable progressive scan.

quality

The output quality to use for lossy JPEG, WebP and TIFF output formats. The default quality is 80.

quality is a Number between 1 and 100.

url

URL/path to original image.