Skip to content

Node.JS Image Validation

How it works

  1. The image gets uploaded to your server.
  2. Before storing the image on disk, it is being validated on server side.

Jump to Complete Example

Image Upload

In the Server Upload article we explain the steps to upload an image on your server. When you insert an image in the rich text editor, you can validate its format. However that check is done only on the filename and not on the mime type. We recommend to make additional checks on server side just to make sure that users don't upload images in bad formats.

Validate Extension

The WYSIWYG editor's Node.JS SDK comes with the possibility to check the image extension when it is being stored on the disk. Additional to the file name extension, it is using the mime type of the file for better accuracy.

var options = {
  validation: {
    'allowedExts': ['gif', 'jpeg', 'jpg', 'png', 'svg', 'blob'],
    'allowedMimeTypes': ['image/gif', 'image/jpeg', 'image/pjpeg', 'image/x-png', 'image/png', 'image/svg+xml']
  }
}

FroalaEditor.Image.upload(req, '/uploads/', options, function(err, data) { ... });

Custom Validation

You can also pass a custom method instead of validating the extension and mime type. This gives you full control on what types of images you want to store on disk. Below is an example of how to validate if an image is square.

var options = {
  // Include imageMagick.
  var gm = require('gm').subClass({imageMagick: true});

  validation: function(filePath, mimetype, callback) {
    gm(filePath).size(function(err, value){

      if (err) {
        return callback(err);
      }

      if (!value) {
        return callback('Error occurred.');
      }

      if (value.width != value.height) {
        return callback(null, false);
      }
      return callback(null, true);
    });
  }
}

FroalaEditor.Image.upload(req, '/uploads/', options, function(err, data) { ... });

Complete Example

<script>
  new FroalaEditor('.selector', {
    // Set the image upload URL.
    imageUploadURL: '/image_upload'
  })
</script>
var express = require('express');
var app = express();
var bodyParser = require('body-parser')
var path = require('path');
var fs = require('fs');
var FroalaEditor = require('PATH_TO_FROALA_SDK/lib/froalaEditor.js');

app.use(express.static(__dirname + '/'));
app.use('/bower_components',  express.static(path.join(__dirname, '../bower_components')));
app.use(bodyParser.urlencoded({ extended: false }));

app.post('/upload_image', function (req, res) {
  var options = {
    validation: {
      'allowedExts': ['gif', 'jpeg', 'jpg', 'png', 'svg', 'blob'],
      'allowedMimeTypes': ['image/gif', 'image/jpeg', 'image/pjpeg', 'image/x-png', 'image/png', 'image/svg+xml']
    }
  }

  FroalaEditor.Image.upload(req, '/uploads/', options, function(err, data) {

    if (err) {
      return res.send(JSON.stringify(err));
    }
    res.send(data);
  });
});
File: 2080