A simple temporary file and directory creator for node.js.

This is a widely used library to create temporary files and directories in a node.js environment.

Tmp offers both an asynchronous and a synchronous API. For all API calls, all the parameters are optional. There also exists a promisified version of the API, see tmp-promise.

Tmp uses crypto for determining random file names, or, when using templates, a six letter random identifier. And just in case that you do not have that much entropy left on your system, Tmp will fall back to pseudo random numbers.

You can set whether you want to remove the temporary file on process exit or not.

If you do not want to store your temporary directories and files in the standard OS temporary directory, then you are free to override that as well.

All breaking changes that had been introduced, i.e.

• tmpdir must be located under the system defined tmpdir root.
• Spaces being collapsed into single spaces
• Removal of all single and double quote characters

have been reverted in v0.2.2 and tmp should now behave as it did before the introduction of these breaking changes.

Other breaking changes, i.e.

• template must be relative to tmpdir
• name must be relative to tmpdir
• dir option must be relative to tmpdir

are still in place.

In order to override the system's tmpdir, you will have to use the newly introduced tmpdir option.

See the CHANGELOG for more information.

• Node version <= 14.4 has been dropped.
• rimraf has been dropped from the dependencies

Since version 0.2.2, all support for node version <= 14 has been dropped.

Since version 0.1.0, all support for node versions < 0.10.0 has been dropped.

Most importantly, any support for earlier versions of node-tmp was also dropped.

If you still require node versions < 0.10.0, then you must limit your node-tmp dependency to versions below 0.1.0.

Since version 0.0.33, all support for node versions < 0.8 has been dropped.

If you still require node version 0.8, then you must limit your node-tmp dependency to version 0.0.33.

For node versions < 0.8 you must limit your node-tmp dependency to versions < 0.0.33.

npm install tmp

Please also check API docs.

If graceful cleanup is set, tmp will remove all controlled temporary objects on process exit, otherwise the temporary objects will remain in place, waiting to be cleaned up on system restart or otherwise scheduled temporary object removal.

To enforce this, you can call the setGracefulCleanup() method:

const tmp = require('tmp');

tmp.setGracefulCleanup();

Simple temporary file creation, the file will be closed and unlinked on process exit.

const tmp = require('tmp');

tmp.file(function _tempFileCreated(err, path, fd, cleanupCallback) {
  if (err) throw err;

  console.log('File: ', path);
  console.log('Filedescriptor: ', fd);
  
  // If we don't need the file anymore we could manually call the cleanupCallback
  // But that is not necessary if we didn't pass the keep option because the library
  // will clean after itself.
  cleanupCallback();
});

A synchronous version of the above.

const tmp = require('tmp');

const tmpobj = tmp.fileSync();
console.log('File: ', tmpobj.name);
console.log('Filedescriptor: ', tmpobj.fd);
  
// If we don't need the file anymore we could manually call the removeCallback
// But that is not necessary if we didn't pass the keep option because the library
// will clean after itself.
tmpobj.removeCallback();

Note that this might throw an exception if either the maximum limit of retries for creating a temporary name fails, or, in case that you do not have the permission to write to the directory where the temporary file should be created in.

Simple temporary directory creation, it will be removed on process exit.

If the directory still contains items on process exit, then it won't be removed.

const tmp = require('tmp');

tmp.dir