hexo-fs v4.1.3
hexo-fs
File system module for Hexo.
Features
- Support for both Promise and callback interface.
- Use graceful-fs to avoid EMFILE error and various improvements.
- Use chokidar for consistent file watching.
Installation
$ npm install hexo-fs --save
Usage
const fs = require('hexo-fs');
Some methods in the original fs module are not listed below, but they're available in hexo-fs.
exists(path)
Test whether or not the given path
exists by checking with the file system.
existsSync(path)
Synchronous version of fs.exists
.
mkdirs(path)
Creates a directory and its parent directories if they does not exist.
mkdirsSync(path)
Synchronous version of fs.mkdirs
.
writeFile(path, data, options)
Writes data to a file.
Option | Description | Default |
---|---|---|
encoding | File encoding | utf8 |
mode | Mode | 438 (0666 in octal) |
flag | Flag | w |
writeFileSync(path, data, options)
Synchronous version of fs.writeFile
.
appendFile(path, data, options)
Appends data to a file.
Option | Description | Default |
---|---|---|
encoding | File encoding | utf8 |
mode | Mode | 438 (0666 in octal) |
flag | Flag | w |
appendFileSync(path, data, options)
Synchronous version of fs.appendFile
.
copyFile(src, dest, callback)
Copies a file from src
to dest
.
copyDir(src, dest, options)
Copies a directory from src
to dest
. It returns an array of copied files.
Option | Description | Default |
---|---|---|
ignoreHidden | Ignore hidden files | true |
ignorePattern | Ignore files which pass the regular expression |
listDir(path, options)
Lists files in a directory.
Option | Description | Default |
---|---|---|
ignoreHidden | Ignore hidden files | true |
ignorePattern | Ignore files which pass the regular expression |
listDirSync(path, options)
Synchronous version of fs.listDir
.
readFile(path, options)
Reads the entire contents of a file.
Option | Description | Default |
---|---|---|
encoding | File encoding | utf8 |
flag | Flag | r |
escape | Escape UTF BOM and line ending in the content | true |
readFileSync(path, options)
Synchronous version of fs.readFile
.
emptyDir(path, options)
Deletes all files in a directory. It returns an array of deleted files.
Option | Description | Default |
---|---|---|
ignoreHidden | Ignore hidden files | true |
ignorePattern | Ignore files which pass the regular expression | |
exclude | Ignore files in the array |
emptyDirSync(path, options)
Synchronous version of fs.emptyDir
.
rmdir(path)
Removes a directory and all files in it.
rmdirSync(path)
Synchronous version of fs.rmdir
.
watch(path, options)
Watches changes of a file or a directory.
See Chokidar API for more info.
ensurePath(path)
Ensures the given path is available to use or appends a number to the path.
ensurePathSync(path)
Synchronous version of fs.ensurePath
.
ensureWriteStream(path, options)
Creates the parent directories if they does not exist and returns a writable stream.
ensureWriteStreamSync(path, options)
Synchronous version of fs.ensureWriteStream
.
License
MIT
8 months ago
8 months ago
2 years ago
2 years ago
2 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
6 years ago
6 years ago
6 years ago
7 years ago
7 years ago
7 years ago
8 years ago
9 years ago
9 years ago
9 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago