Socket
Socket
Sign inDemoInstall

rimraf

Package Overview
Dependencies
1
Maintainers
1
Versions
75
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

rimraf

A deep deletion module for node (like `rm -rf`)


Version published
Maintainers
1
Weekly downloads
85,212,438
decreased by-8.69%

Weekly downloads

Package description

What is rimraf?

The rimraf npm package is a Node.js module that provides a way to perform a deep deletion of files and directories, similar to the 'rm -rf' Unix command. It is designed to work on both Windows and Unix file systems, handling the intricacies of different environments. It is often used to clean up directories before rebuilding a project or to remove temporary files.

What are rimraf's main functionalities?

Asynchronous file and directory removal

This feature allows for the asynchronous removal of a directory and its contents. The provided code sample demonstrates how to use rimraf to delete a directory asynchronously. The callback function is used to handle any errors or to perform actions after the removal is complete.

const rimraf = require('rimraf');
rimraf('/path/to/directory', function (err) { 
  if (err) throw err; 
  console.log('Directory and its contents have been removed');
});

Synchronous file and directory removal

This feature allows for the synchronous removal of a directory and its contents. The provided code sample demonstrates how to use rimraf to delete a directory synchronously. The operation will block the event loop until the removal is complete.

const rimraf = require('rimraf');
rimraf.sync('/path/to/directory');
console.log('Directory and its contents have been removed synchronously');

Promisified file and directory removal

This feature allows for the removal of a directory and its contents using promises, which can be more convenient when working with modern asynchronous code patterns. The provided code sample demonstrates how to promisify the rimraf function and use it with then/catch for handling the resolution and rejection of the promise.

const rimraf = require('rimraf');
const { promisify } = require('util');
const rimrafPromise = promisify(rimraf);

rimrafPromise('/path/to/directory').then(() => {
  console.log('Directory and its contents have been removed');
}).catch((err) => {
  console.error('An error occurred:', err);
});

Other packages similar to rimraf

Readme

Source

A rm -rf for node.

Install with npm install rimraf, or just drop rimraf.js somewhere.

API

rimraf(f, callback)

The callback will be called with an error if there is one. Certain errors are handled for you:

  • EBUSY - rimraf will back off a maximum of opts.maxBusyTries times before giving up.
  • EMFILE - If too many file descriptors get opened, rimraf will patiently wait until more become available.

rimraf.sync

It can remove stuff synchronously, too. But that's not so good. Use the async API. It's better.

FAQs

Last updated on 06 Feb 2013

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc