heic-to-jpeg-middleware

2.0.0 • Public • Published
const multipart = require('connect-multiparty')();
const heicToJpeg = require('heic-to-jpeg-middleware')();
const app = require('express')();
app.post('/upload', multipart, heicToJpeg, function(req, res) {
  // Access req.files as you normally would here.
  //
  // You will see `.jpg` where you would otherwise
  // see `.heic`.
});

This is middleware to convert the iOS HEIC/HEIF image format to JPEG, so that your Express route sees the JPEG as if it were the original file.

This middleware expects that the file upload has already been accepted via connect-multiparty or any other middleware that provides a req.files object in which each sub-object has path, name and type properties. The sub-objects of req.files may also be arrays of such objects.

Alternatives

The very latest versions of ImageMagick support HEIF too.

Warnings

To prevent a denial of service, middleware that does CPU- and RAM-intensive stuff like this should always be added only to the specific routes that require it. It's also a good idea to use other middleware to check the user's permissions first, rather than later in the route code itself.

Changelog

2.0.0: Use heic-convert in replacement of tifig. Since heic-convert is pure JavaScript there is no more need to install a hand-compiled dependency that is not well-supported. Thanks to Gabriel L. Maljkovich for this contribution. Also fixed an error in the documentation; thanks to Vũ Quang Thịnh for pointing this out.

1.0.2: supports more types of file upload middleware. In particular, the sub-objects of req.files may be arrays, and if path does not have any extension to change then a .jpg extension is added.

1.0.1: more docs, repo push.

1.0.0: initial release.

Readme

Keywords

Package Sidebar

Install

npm i heic-to-jpeg-middleware

Weekly Downloads

175

Version

2.0.0

License

MIT

Unpacked Size

6.26 kB

Total Files

5

Last publish

Collaborators

  • haroun
  • bodonkey
  • etlaurent
  • alexgilbert
  • stuartromanek
  • boutell
  • valjed
  • romanek