node/deps/npm/node_modules/unique-filename
Kat Marchán d44a9eb11b deps: upgrade npm to 3.10.8
PR-URL: https://github.com/nodejs/node/pull/8706
Reviewed-By: Jeremiah Senkpiel <fishrock123@rocketmail.com>
2016-09-27 16:39:27 -04:00
..
node_modules/unique-slug deps: upgrade npm to 3.10.8 2016-09-27 16:39:27 -04:00
test deps: upgrade npm to 3.6.0 2016-02-01 10:43:34 -05:00
.npmignore deps: upgrade npm to 3.3.6 2015-10-22 13:56:09 -04:00
index.js deps: upgrade npm to 3.3.6 2015-10-22 13:56:09 -04:00
package.json deps: upgrade npm to 3.6.0 2016-02-01 10:43:34 -05:00
README.md deps: upgrade npm to 3.3.6 2015-10-22 13:56:09 -04:00

unique-filename

Generate a unique filename for use in temporary directories or caches.

var uniqueFilename = require('unique-filename')

// returns something like: /tmp/912ec803b2ce49e4a541068d495ab570
var randomTmpfile = uniqueFilename(os.tmpdir())

// returns something like: /tmp/my-test-912ec803b2ce49e4a541068d495ab570
var randomPrefixedTmpfile = uniqueFilename(os.tmpdir(), 'my-test')

var uniqueTmpfile = uniqueFilename('/tmp', 'testing', '/my/thing/to/uniq/on')

uniqueFilename(dir, fileprefix, uniqstr) → String

Returns the full path of a unique filename that looks like: dir/prefix-912ec803b2ce49e4a541068d495ab570 or dir/912ec803b2ce49e4a541068d495ab570

dir The path you want the filename in. os.tmpdir() is a good choice for this.

fileprefix A string to append prior to the unique part of the filename. The parameter is required if uniqstr is also passed in but is otherwise optional and can be undefined/null/''. If present and not empty then this string plus a hyphen are prepended to the unique part.

uniqstr Optional, if not passed the unique part of the resulting filename will be random. If passed in it will be generated from this string in a reproducable way.