isDirectory method

README.md

@@ -68,6 +68,8 @@ Methods
 - [ensureFileSync](#ensurefilefile-callback)
 - [ensureDir](#ensuredirdir-callback)
 - [ensureDirSync](#ensuredirdir-callback)
+- [isDirectory](#isdirectoryfile-callback)
+- [isDirectorySync](#isdirectoryfile-callback)
 - [mkdirs](#mkdirsdir-callback)
 - [mkdirsSync](#mkdirsdir-callback)
 - [move](#movesrc-dest-options-callback)
@@ -197,6 +199,28 @@ fs.ensureDir(dir, function (err) {
 
 
 
+### isDirectory(file, callback)
+
+Check if a file is a directory. Shortcut for `fs.stat()` followed by running `isDirectory()` on the result.
+
+Alias: `isDir()`
+
+Sync: `isDirectorySync()` (alias `isDirSync()`)
+
+
+Example:
+
+```js
+var fs = require('fs-extra')
+
+var file = '/tmp/path/to/a/file'
+fs.isDirectory(file, function (err, isDir) {
+  console.log(isDir) // => true if is directory, false if not
+})
+```
+
+
+
 ### mkdirs(dir, callback)
 
 Creates a directory. If the parent hierarchy doesn't exist, it's created. Like `mkdir -p`.

lib/index.js

@@ -87,6 +87,12 @@ Object.keys(empty).forEach(function (method) {
   fs[method] = empty[method]
 })
 
+var isDir = require('./is-dir')
+fs.isDirectory = isDir.isDirectory
+fs.isDirectorySync = isDir.isDirectorySync
+fs.isDir = isDir.isDirectory
+fs.isDirSync = isDir.isDirectorySync
+
 module.exports = fs
 
 jsonFile.spaces = 2 // set to 2

lib/is-dir.js

@@ -0,0 +1,18 @@
+var fs = require('fs')
+
+function isDirectory (path, callback) {
+  fs.stat(path, function (err, stats) {
+    if (err) return callback(err)
+
+    callback(null, stats.isDirectory())
+  })
+}
+
+function isDirectorySync (path) {
+  return fs.statSync(path).isDirectory()
+}
+
+module.exports = {
+  isDirectory: isDirectory,
+  isDirectorySync: isDirectorySync
+}