destroy

What is destroy?

The 'destroy' npm package is used to destroy a stream, such as a request or response, ensuring that it cannot be used anymore. It is particularly useful for ensuring that file descriptors are closed and memory usage is cleaned up after streams are no longer needed.

What are destroy's main functionalities?

Destroy a stream

This code sample demonstrates how to destroy a readable stream using the 'destroy' package. Once the stream is destroyed, it cannot emit any more events or be used to read data.

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

const stream = fs.createReadStream('file.txt');
stream.on('data', (chunk) => {
  console.log(chunk);
});

// Destroy the stream
destroy(stream);

Other packages similar to destroy

pump

The 'pump' package is similar to 'destroy' in that it helps manage stream lifecycle. It pipes streams together and destroys all of them if one of them closes. Compared to 'destroy', 'pump' is more about connecting streams and handling their collective destruction.

end-of-stream

The 'end-of-stream' package is used to call a callback when a stream has finished or failed, which is somewhat similar to 'destroy' in managing stream end lifecycle. Unlike 'destroy', it does not destroy the stream but rather provides a way to detect the end of a stream.

through2

The 'through2' package is a tiny wrapper around Node.js streams.Transform, making it easier to create transform streams. While it does not directly destroy streams like 'destroy', it can be used to manage stream transformations and can be combined with stream destruction for cleanup purposes.

README

Destroy

Destroy a stream.

API

var destroy = require('destroy')

var fs = require('fs')
var stream = fs.createReadStream('package.json')
destroy(stream)