mirror of
https://github.com/nodejs/node.git
synced 2026-11-21 12:59:16 -05:00
Add fs.mkstemp(), fs.mkstempSync() and fsPromises.mkstemp(), which create and open a unique temporary file in one operation. They expose uv_fs_mkstemp(), the file counterpart of the function behind fs.mkdtemp(). The callback and sync versions return the path and a file descriptor, the promise version returns the path and a FileHandle. libuv clears the path of the request when mkstemp() fails, so the template is saved in the request and used for the path of the error. The functions are also supported on mounted virtual file systems. Refs: https://github.com/nodejs/node/pull/33549 Refs: https://github.com/nodejs/node/issues/33890 Refs: https://github.com/nodejs/node/issues/5332 Signed-off-by: marcopiraccini <marco.piraccini@gmail.com> PR-URL: https://github.com/nodejs/node/pull/66484 Reviewed-By: Paolo Insogna <paolo@cowtech.it> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Gürgün Dayıoğlu <hey@gurgun.day>
108 lines
3.8 KiB
JavaScript
108 lines
3.8 KiB
JavaScript
'use strict';
|
|
|
|
const common = require('../common');
|
|
const assert = require('assert');
|
|
const fs = require('fs');
|
|
const path = require('path');
|
|
|
|
const tmpdir = require('../common/tmpdir');
|
|
tmpdir.refresh();
|
|
|
|
function handler(err, folder) {
|
|
assert.ifError(err);
|
|
assert(fs.existsSync(folder));
|
|
assert.strictEqual(this, undefined);
|
|
}
|
|
|
|
// Test with plain string
|
|
{
|
|
const tmpFolder = fs.mkdtempSync(tmpdir.resolve('foo.'));
|
|
|
|
assert.strictEqual(path.basename(tmpFolder).length, 'foo.XXXXXX'.length);
|
|
assert(fs.existsSync(tmpFolder));
|
|
|
|
const utf8 = fs.mkdtempSync(tmpdir.resolve('\u0222abc.'));
|
|
assert.strictEqual(Buffer.byteLength(path.basename(utf8)),
|
|
Buffer.byteLength('\u0222abc.XXXXXX'));
|
|
assert(fs.existsSync(utf8));
|
|
|
|
fs.mkdtemp(tmpdir.resolve('bar.'), common.mustCall(handler));
|
|
|
|
// Same test as above, but making sure that passing an options object doesn't
|
|
// affect the way the callback function is handled.
|
|
fs.mkdtemp(tmpdir.resolve('bar.'), {}, common.mustCall(handler));
|
|
|
|
const warningMsg = 'mkdtemp() and mkstemp() templates ending with X are ' +
|
|
'not portable. ' +
|
|
'For details see: https://nodejs.org/api/fs.html';
|
|
common.expectWarning('Warning', warningMsg);
|
|
fs.mkdtemp(tmpdir.resolve('bar.X'), common.mustCall(handler));
|
|
}
|
|
|
|
// Test with URL object
|
|
{
|
|
const tmpFolder = fs.mkdtempSync(tmpdir.fileURL('foo.'));
|
|
|
|
assert.strictEqual(path.basename(tmpFolder).length, 'foo.XXXXXX'.length);
|
|
assert(fs.existsSync(tmpFolder));
|
|
|
|
const utf8 = fs.mkdtempSync(tmpdir.fileURL('\u0222abc.'));
|
|
assert.strictEqual(Buffer.byteLength(path.basename(utf8)),
|
|
Buffer.byteLength('\u0222abc.XXXXXX'));
|
|
assert(fs.existsSync(utf8));
|
|
|
|
fs.mkdtemp(tmpdir.fileURL('bar.'), common.mustCall(handler));
|
|
|
|
// Same test as above, but making sure that passing an options object doesn't
|
|
// affect the way the callback function is handled.
|
|
fs.mkdtemp(tmpdir.fileURL('bar.'), {}, common.mustCall(handler));
|
|
|
|
// Warning fires only once
|
|
fs.mkdtemp(tmpdir.fileURL('bar.X'), common.mustCall(handler));
|
|
}
|
|
|
|
// Test with Buffer
|
|
{
|
|
const tmpFolder = fs.mkdtempSync(Buffer.from(tmpdir.resolve('foo.')));
|
|
|
|
assert.strictEqual(path.basename(tmpFolder.toString()).length, 'foo.XXXXXX'.length);
|
|
assert(fs.existsSync(tmpFolder));
|
|
|
|
const utf8 = fs.mkdtempSync(Buffer.from(tmpdir.resolve('\u0222abc.')));
|
|
assert.strictEqual(Buffer.byteLength(path.basename(utf8.toString())),
|
|
Buffer.byteLength('\u0222abc.XXXXXX'));
|
|
assert(fs.existsSync(utf8));
|
|
fs.mkdtemp(Buffer.from(tmpdir.resolve('bar.')), common.mustCall(handler));
|
|
|
|
// Same test as above, but making sure that passing an options object doesn't
|
|
// affect the way the callback function is handled.
|
|
fs.mkdtemp(Buffer.from(tmpdir.resolve('bar.')), {}, common.mustCall(handler));
|
|
|
|
// Warning fires only once
|
|
fs.mkdtemp(Buffer.from(tmpdir.resolve('bar.X')), common.mustCall(handler));
|
|
}
|
|
|
|
// Test with Uint8Array
|
|
{
|
|
const encoder = new TextEncoder();
|
|
|
|
const tmpFolder = fs.mkdtempSync(encoder.encode(tmpdir.resolve('foo.')));
|
|
|
|
assert.strictEqual(path.basename(tmpFolder).length, 'foo.XXXXXX'.length);
|
|
assert(fs.existsSync(tmpFolder));
|
|
|
|
const utf8 = fs.mkdtempSync(encoder.encode(tmpdir.resolve('\u0222abc.')));
|
|
assert.strictEqual(Buffer.byteLength(path.basename(utf8)),
|
|
Buffer.byteLength('\u0222abc.XXXXXX'));
|
|
assert(fs.existsSync(utf8));
|
|
|
|
fs.mkdtemp(encoder.encode(tmpdir.resolve('bar.')), common.mustCall(handler));
|
|
|
|
// Same test as above, but making sure that passing an options object doesn't
|
|
// affect the way the callback function is handled.
|
|
fs.mkdtemp(encoder.encode(tmpdir.resolve('bar.')), {}, common.mustCall(handler));
|
|
|
|
// Warning fires only once
|
|
fs.mkdtemp(encoder.encode(tmpdir.resolve('bar.X')), common.mustCall(handler));
|
|
}
|