progress-stream

What is progress-stream?

The `progress-stream` npm package is used to monitor the progress of data being streamed. It is particularly useful for tracking the progress of file uploads, downloads, or any other data transfer operations. The package provides a simple interface to get updates on the amount of data transferred, the speed of transfer, and the estimated time remaining.

What are progress-stream's main functionalities?

Basic Progress Tracking

This feature allows you to track the progress of a file being read and written. The `progress` event provides updates on the percentage completed, the speed of transfer, and the estimated time remaining.

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

const stat = fs.statSync('file.txt');
const str = progress({ length: stat.size, time: 100 });

str.on('progress', function(progress) {
  console.log(progress);
});

fs.createReadStream('file.txt').pipe(str).pipe(fs.createWriteStream('copy.txt'));

Custom Progress Handling

This feature allows for custom handling of progress updates. You can log specific details such as the number of bytes transferred, the speed of transfer, and the estimated time remaining.

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

const stat = fs.statSync('file.txt');
const str = progress({ length: stat.size, time: 100 });

str.on('progress', function(progress) {
  console.log(`Transferred: ${progress.transferred} bytes`);
  console.log(`Speed: ${progress.speed} bytes/sec`);
  console.log(`ETA: ${progress.eta} seconds`);
});

fs.createReadStream('file.txt').pipe(str).pipe(fs.createWriteStream('copy.txt'));

Other packages similar to progress-stream

progress

The `progress` package provides a simple way to create a progress bar in the terminal. It is useful for command-line applications that need to display progress updates. Unlike `progress-stream`, it does not provide detailed information about data transfer but focuses on visual representation.

node-fetch-progress

The `node-fetch-progress` package is used to track the progress of HTTP requests made using the `node-fetch` library. It provides similar functionality to `progress-stream` but is specifically designed for HTTP requests. It is useful for tracking the progress of file downloads or uploads over HTTP.

stream-progressbar

The `stream-progressbar` package provides a progress bar for Node.js streams. It is similar to `progress-stream` in that it tracks the progress of data being streamed, but it focuses on providing a visual progress bar in the terminal.

README

progress-stream

Read the progress of a stream. You can either instantiate it with a specific length, or it will read the length automatically if you're using the request module or http module.

npm install progress-stream

Usage

This example reads 100 MB from stdin, and writes out the percentage every 100ms.

var progress = require('progress-stream');

p = progress({
	time: 100,
	length: 100000000
});
p.on('progress', function(progress) {
	console.log(progress.percentage);
});

process.stdin.pipe();

Options

time(integer)

Sets how often progress events is emitted. If omitted then defaults to emit every time a chunk is received.

length(integer)

If you already know the length of the stream, then you can set it. Defaults to 0.

drain(boolean)

In case you don't want to include a readstream after progress-stream, set to true to drain automatically. Defaults to false.

Examples

Using the request module

This example uses request to download a 100 MB file, and writes out the percentage every second.

You can also find an example in test/request.js.

var progress = require('progress-steram);
var req = require('request');
var fs = require('fs');

var p = progress({
	time: 1000
});

p.on('progress', function(progress) {
	console.log(Math.round(progress.percentage)+'%');
});

req('http://cachefly.cachefly.net/100mb.test', { headers: { 'user-agent': 'test' }})
	.pipe(p)
	.pipe(fs.createWriteStream('test.data'));

Using the http module

In test/http.js it's shown how to do it with the http module.