readdirstat v1.0.2

readdirStat

Installation

This is a Node.js module available through the npm registry.

Before installing, download and install Node.js.

Installation is done using the npm install command:

$ npm install readdirstat

Quick start

After installing the module, we need to import it:

const readdirStat = require('readdirstat')

Now we can use the readdirStat function.

Examples

For example, To get information about files and subdirectories, which are inside the current directory, We will type the following command:

readdirStat('.')

And we get a similar result:

[
  {
    name: 'Internal folder for example',
    path: 'Internal folder for example',
    fullName: 'Internal folder for example',
    lastAccessTime: 2022-12-21T00:32:51.691Z,
    creationTime: 2022-12-21T00:32:51.655Z,
    lastModificationTime: 2022-12-21T00:32:51.655Z,
    isDirectory: true,
    isFile: false
  },
  {
    name: 'readdirStat',
    path: 'readdirStat.js',
    fullName: 'readdirStat.js',
    lastAccessTime: 2022-12-21T00:34:43.289Z,
    creationTime: 2022-11-27T23:39:01.652Z,
    lastModificationTime: 2022-12-21T00:34:09.430Z,
    isDirectory: false,
    isFile: true,
    size: 74,
    extension: '.js'
  },
  {
    name: 'sample file',
    path: 'sample file.txt',
    fullName: 'sample file.txt',
    lastAccessTime: 2022-12-21T00:32:51.655Z,
    creationTime: 2022-12-21T00:32:51.655Z,
    lastModificationTime: 2022-12-21T00:32:51.655Z,
    isDirectory: false,
    isFile: true,
    size: 15,
    extension: '.txt'
  }
]

Another example: To get information about files and subdirectories, that are inside the Sample folder directory, We will type the following command:

readdirStat('./Sample folder')

And we get a similar result:

[
  {
    name: 'Internal folder for example',
    path: 'Sample folder/Internal folder for example',
    fullName: 'Internal folder for example',
    lastAccessTime: 2022-11-27T22:11:41.057Z,
    creationTime: 2022-11-27T22:10:51.218Z,
    lastModificationTime: 2022-11-27T22:11:41.057Z,
    isDirectory: true,
    isFile: false
  },
  {
    name: 'sample file',
    path: 'Sample folder/sample file.txt',
    fullName: 'sample file.txt',
    lastAccessTime: 2022-11-27T22:11:41.117Z,
    creationTime: 2022-11-27T22:11:19.077Z,
    lastModificationTime: 2022-11-27T22:11:19.077Z,
    isDirectory: false,
    isFile: true,
    size: 0,
    extension: '.txt'
  }
]

How it works

The readdirStat function takes a folder path as a string argument, and returns an array of objects that represent its files and folders.

The array can return 2 types of objects:

1. An object that represents a folder

2. An object that represents a file with the following values

License

MIT