tempy (0.6.0)

Published 2026-02-24 14:06:07 +00:00 by atheaadmin

Installation

registry=
npm install tempy@0.6.0
"tempy": "0.6.0"

About this package

tempy Build Status

Get a random temporary file or directory path

Install

$ npm install tempy

Usage

const tempy = require('tempy');

tempy.file();
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/4f504b9edb5ba0e89451617bf9f971dd'

tempy.file({extension: 'png'});
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/a9fb0decd08179eb6cf4691568aa2018.png'

tempy.file({name: 'unicorn.png'});
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/f7f62bfd4e2a05f1589947647ed3f9ec/unicorn.png'

tempy.directory();
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/2f3d094aec2cb1b93bb0f4cffce5ebd6'

tempy.directory({prefix: 'name'});
//=> '/private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T/name_3c085674ad31223b9653c88f725d6b41'

API

tempy.file(options?)

Get a temporary file path you can write to.

options

Type: object

You usually won't need either the extension or name option. Specify them only when actually needed.

extension

Type: string

File extension.

name

Type: string

Filename. Mutually exclusive with the extension option.

tempy.directory([options])

Get a temporary directory path. The directory is created for you.

options

Type: Object

prefix

Type: string

Directory prefix.

Useful for testing by making it easier to identify cache directories that are created.

You usually won't need this option. Specify it only when actually needed.

tempy.write(fileContent, options?)

Write data to a random temp file.

fileContent

Type: string | Buffer | TypedArray | DataView | stream.Readable

Data to write to the temp file.

options

See options.

tempy.writeSync(fileContent, options?)

Synchronously write data to a random temp file.

fileContent

Type: string | Buffer | TypedArray | DataView

Data to write to the temp file.

options

See options.

tempy.root

Get the root temporary directory path. For example: /private/var/folders/3x/jf5977fn79jbglr7rk0tq4d00000gn/T

FAQ

Why doesn't it have a cleanup method?

Temp files will be periodically cleaned up on macOS. Most Linux distros will clean up on reboot. If you're generating a lot of temp files, it's recommended to use a complementary module like del for cleanup.

Dependencies

Dependencies

ID Version
is-stream ^2.0.0
temp-dir ^2.0.0
type-fest ^0.16.0
unique-string ^2.0.0

Development Dependencies

ID Version
ava ^2.4.0
tsd ^0.13.1
xo ^0.32.1

Keywords

temp temporary path file directory folder tempfile tempdir tmpdir tmpfile random unique
Details
npm
2026-02-24 14:06:07 +00:00
0
Sindre Sorhus
MIT
latest
3.1 KiB
Assets (1)
tempy-0.6.0.tgz 3.1 KiB
Versions (1) View all
0.6.0 2026-02-24