fs.Stats constructor with a sane signature and defaults.
Sane defaults.
var Stats = require('stats-ctor');
var stat = new Stats();
console.log(stat.mode); // 0
console.log(stat.uid); // 1000 - from `process.getuid()`
console.log(stat.mtime); // 2018-03-29T17:01:48.883Z - from `new Date()`Sane single argument signature.
var fs = require('fs');
var Stats = require('stats-ctor');
var umask = 0o002;
var stat = new Stats({
mode: fs.constats.S_IFREG | (umask ^ 0o777)
});
console.log(stat.mode); // 33277Free copy constructor.
var fs = require('fs');
var Stats = require('stats-ctor');
var stat = fs.statSync('./README.md');
var copy = new Stats(stat);
console.log(stat === copy); // false
console.log(stat.mtime.getTime() === copy.mtime.getTime()); // true - same for all properties on the copy instanceIdentical to the fs.Stats constructor in node core, except it has a single
options argument instead of fourteen named arguments.
Type: Object
Simply uses the named arguments from fs.Stats as property names.
Type: Number
Default: 0
Type: Number
Default: 0
You should create a real mode for most use cases. See fs.constants. For example when creating a new regular file do fs.constants.S_IFREG | (process.umask() ^ 0o666).
Type: Number
Default: 0
Type: Number
Default: process.getuid()
Type: Number
Default: process.getgid()
Type: Number
Default: 0
Type: Number
Default: 0
Type: Number
Default: 0
Type: Number
Default: 0
Type: Number
Default: 0
Type: Number
Default: Date.now()
This property creates a Date instance called atime.
Type: Number
Default: Date.now()
This property creates a Date instance called mtime.
Type: Number
Default: Date.now()
This property creates a Date instance called ctime.
Type: Number
Default: Date.now()
This property creates a Date instance called birthtime.
Type: Number
A millisecond getter/setter for atime.
If available on the instance, setter will update atimeMs.
Type: Number
A millisecond getter/setter for mtime.
If available on the instance, setter will update mtimeMs.
Type: Number
A millisecond getter/setter for ctime.
If available on the instance, setter will update ctimeMs.
Type: Number
A millisecond getter/setter for birthtime.
If available on the instance, setter will update birthtimeMs.
Node added millisecond properties starting with v8.1.0. However, these are
instance properties and are disconnected with the Date equivalent. For
example, updating stat.mtimeMs will not update stat.mtime.
As such this module makes atimeMs, ctimeMs, mtimeMs, & birthtimeMs
non-enumerable. Instead use the prototype properties above.
- clone-stats Copying existing
fs.Statsinstances. - stat-mode Sane handling of the
modeproperty.
ISC - Copyright © 2018, Cody A. Taylor.