Using JavaScript Camera SDK to Capture and Upload Images

Dynamsoft Camera SDK allows developers to build web camera apps with pure HTML, CSS, and JavaScript. In most cases, front-end programming skill is enough. Occasionally, you may want to add some server-side functionalities, such as file uploading and processing. In this article, let’s see how to upload captured images from within web browsers to the server using JavaScript camera APIs and Node.js.

JavaScript Camera App for Browsers

Development Environment

Getting Started

Create index.htm. If you have installed the DCS extension, simply type the prefix ‘dcs’ to quickly insert the code snippet.

DCS code snippet for visual studio code

The code snippet has included the functionality of capturing images. Add a new button for uploading files.

<input type="button" value="Upload" class="d-btn bgBlue" onclick="onUpload();" />
function onUpload() {
            if (!dcsObject || !imageViewer) return;
            if (imageViewer.image.getCount() === 0) {
                alert('Please grab an image first.');

            var counter,
                url = getCurPagePath() + 'upload',
                fileName = new Date().getMilliseconds() + '.jpg',
                imageType =,
                bMultiImages = false,
                imageIndexArray = [];

            if (bMultiImages) {
                for (counter = 0; counter < imageViewer.image.getCount(); counter++) imageIndexArray.push(counter);
            } else imageIndexArray.push(imageViewer.image.getIndex());
                "fileName": fileName
  , imageIndexArray, imageType, onUploadSuccess, onUploadFailure);

What parameters used in httpUploadAsync()?

  • URL: the action page.
  • indices: the indices of images that needed to be sent.
  • imageType: the format of the file you want to upload as. E.g. jpg.
  • onHttpUploadSuccess: the callback function triggered when the file is uploaded successfully.
  • onHttpUploadFailure: the callback function triggered when the file failed to be uploaded.

So far, the client-side code is finished. The next step is to implement the action page logic.

Create server.js and setup the web server using Express.

var formidable = require('formidable');
var express = require('express');
var fs = require('fs');
var app = express();
var path = require('path');

app.use(function (req, res, next) {
    res.header("Access-Control-Allow-Origin", "]");
    res.header("Access-Control-Allow-Methods", "PUT, POST, GET, DELETE, OPTIONS");
    res.header("Access-Control-Allow-Headers", "X-Requested-With, content-type");
    res.header("Access-Control-Allow-Credentials", true);

var server = app.listen(2017, function () {
    var host = server
    var port = server
    console.log('listening at http://%s:%s', host, port);

Use Formidable to parse the incoming form data. Then save images and send a response.'/upload', function (req, res) {
    var form = new formidable.IncomingForm();
    form.parse(req, function (err, fields, files) {
        var dir = 'uploads';
        fs.mkdir(dir, function (err) {
                .readFile(files.RemoteFile.path, function (err, data) {
                    // save file from temp dir to new dir
                    var fileName = path.join(]]dirname, dir,;
                    fs.writeFile(fileName, data, function (err) {
                        if (err)
                            throw err;
                        res.json({success: 'true'});

Although the code is very simple, you may not be able to answer the questions: why the field name is  RemoteFile and what data should be sent back to client-side.

When invoking the DCS API, you do not need to specify the form field. The default name is RemoteFile.

After saving uploaded images, you have to send a response with JSON data which at least contains the key ‘success’ and its corresponding boolean value. Otherwise, the callback functions onUploadSuccess and onUploadFailure will not be triggered.

Here is the final look of my web camera application.

javascript camera app

Source Code