Node.js: How to convert byte arrays to images

Updated: December 30, 2023 By: Guest Contributor Post a comment


Converting byte arrays into image files is a common task when dealing with multimedia and web development. In Node.js, this process mostly uses buffers and streams, which interact with the file system to create an image file from the binary data. This tutorial progressively guides you through several methods for providing you with the understanding and tools necessary to handle things efficiently using modern Node.js syntax, including the use of arrow functions, async/await, and ES modules.

Using Buffers

const fs = require('fs').promises;

const byteArray = [/* Your byte array */];

const bufferFromArray = Buffer.from(byteArray);

await fs.writeFile('output-image.png', bufferFromArray);

This example turns a byte array into a Node.js Buffer, then writes it directly to an image file using async/await for handling asynchronous file operations.

Using Streams

const fs = require('fs');
const stream = require('stream');

const byteArray = [/* Your byte array */];
const readable = new stream.Readable();

// Push your byte array and then indicate the end of the stream

const writable = fs.createWriteStream('output-image.jpg');

// Pipe the readable stream to the writable file stream

Using Async Iterators with Streams

const fs = require('fs').promises;

async function writeImageFromByteArray(byteArray, filepath) {
  const readStream = new stream.Readable({
    read() {}

  for await (const chunk of getChunksAsBuffers(byteArray)) {

  const writeStream = fs.createWriteStream(filepath);

writeImageFromByteArray([/* Your byte array */], 'output-image.png').catch(console.error);

Advanced applications may split data into chunks and utilize async iterators to process these chunks. Here, we utilize async functions to interact with the streams API in a more modern and scalable approach.

Error Handling

It is important to manage errors gracefully when working with file operations, by wrapping your code in try/catch blocks or using ‘.catch()’ when dealing with promises, to ensure robustness.


In conclusion, Node.js offers several efficient methods to convert byte arrays to images using buffers and streams. Asynchronous programming, with advanced features of modern JavaScript, plays a central role in implementing these operations effectively and safely.