added uint8array as input and output option

Author: nnmrts

lib/input.js

@@ -28,9 +28,9 @@ function _createInputDescriptor (input, inputOptions, containerOptions) {
   if (is.string(input)) {
     // filesystem
     inputDescriptor.file = input;
-  } else if (is.buffer(input)) {
-    // Buffer
-    inputDescriptor.buffer = input;
+  } else if (is.uint8Array(input)) {
+    // Buffer or Uint8Array
+    inputDescriptor.buffer = Buffer.from(input);
   } else if (is.plainObject(input) && !is.defined(inputOptions)) {
     // Plain Object descriptor, e.g. create
     inputOptions = input;

lib/is.js

@@ -48,6 +48,14 @@ const buffer = function (val) {
   return val instanceof Buffer;
 };
 
+/**
+ * Is this value a Uint8Array?
+ * @private
+ */
+const uint8Array = function (val) {
+  return val instanceof Uint8Array;
+};
+
 /**
  * Is this value a non-empty string?
  * @private
@@ -110,6 +118,7 @@ module.exports = {
   fn: fn,
   bool: bool,
   buffer: buffer,
+  uint8Array: uint8Array,
   string: string,
   number: number,
   integer: integer,

lib/output.js

@@ -116,6 +116,38 @@ function toBuffer (options, callback) {
   return this._pipeline(is.fn(options) ? options : callback);
 }
 
+/**
+ * Same as toBuffer, but writes output to a Uint8Array.
+ *
+ * @example
+ * sharp(input)
+ *   .toBuffer((err, data, info) => { ... });
+ *
+ * @example
+ * sharp(input)
+ *   .toUint8Array()
+ *   .then(data => { ... })
+ *   .catch(err => { ... });
+ *
+ * @example
+ * sharp(input)
+ *   .toUint8Array({ resolveWithObject: true })
+ *   .then(({ data, info }) => { ... })
+ *   .catch(err => { ... });
+ *
+ * @param {Object} [options]
+ * @param {boolean} [options.resolveWithObject] Resolve the Promise with an Object containing `data` and `info` properties instead of resolving only with `data`.
+ * @param {Function} [callback]
+ * @returns {Promise<Buffer>} - when no callback is provided
+ */
+function toUint8Array (options, callback) {
+  return new Promise((resolve, reject) => {
+    this.toBuffer(options, callback).then((buff) => {
+      resolve(Uint8Array.from(buff));
+    })
+  });
+}
+
 /**
  * Include all metadata (EXIF, XMP, IPTC) from the input image in the output image.
  * This will also convert to and add a web-friendly sRGB ICC profile.
@@ -797,6 +829,7 @@ module.exports = function (Sharp) {
     // Public
     toFile,
     toBuffer,
+    toUint8Array,
     withMetadata,
     toFormat,
     jpeg,

test/unit/toUint8Array.js

@@ -0,0 +1,19 @@
+'use strict';
+
+const assert = require('assert');
+
+const sharp = require('../../lib');
+const fixtures = require('../fixtures');
+
+describe('toUint8Array', () => {
+  it('reusing same sharp object does not reset previously passed parameters to toUint8Array', (done) => {
+    const image = sharp(fixtures.inputJpg);
+    image.toUint8Array({ resolveWithObject: true }).then((obj) => {
+      image.toUint8Array().then((buff) => {
+        assert.strictEqual(buff.constructor === Uint8Array, true);
+        assert.strictEqual(typeof obj, 'object');
+        done();
+      });
+    });
+  });
+});