node-"fs-extra"模塊代替fs使用

時間  2019-11-07
標籤 node extra 模塊 代替 使用 简体版
原文   原文鏈接

code

fs-extra是fs的一個擴展，提供了很是多的便利API，而且繼承了fs全部方法和爲fs方法添加了promise的支持。html

它應該是 fs 的替代品。node

爲何？

我厭倦了包括mkdirp，rimraf以及ncp在個人大部分項目中。npm

解決了什麼問題

使用前，必須瞭解第三方庫給現有庫解決了哪些問題，不要爲了使用而使用。json

fs-extra模擬了相似如Linux下的命令：api

root$ rm -rf /
root$ mv tmpDir tmpNewDir
root$ mkdir -p one/two
root$ cp -r tmp tmpNew
...
複製代碼

這很方便不是嗎？這才讓我深深地愛上了它！promise

嘻嘻

安裝

npm install fs-extra -S
複製代碼

用法

應該老是fs-extra代替fs使用，全部fs方法都附在fs-extra，fs若是未傳遞迴調，則全部方法都將返回promise。bash

再也不須要這個異步

const fs = require('fs');
複製代碼

你如今能夠這樣作async

const fs = require('fs-extra');
複製代碼

若是你但願明確表示你在使用fs-extra，能夠將fs標識符改成fse函數

const fse = require('fs-extra');
複製代碼

你能夠保留二者使用，但它是多餘的，由於 fs-extra 繼承了fs

const fs = require('fs');
const fse = require('fs-extra');
複製代碼

Sync vs Async vs Async/Await

大多數方法默認爲異步，若是未傳遞迴調，則全部異步方法將返回一個promise。

一個典型的例子：

const fs = require('fs-extra')

// 異步方法，返回promise
fs.copy('/tmp/myfile', '/tmp/mynewfile')
  .then(() => console.log('success!'))
  .catch(err => console.error(err))

// 異步方法，回調函數
fs.copy('/tmp/myfile', '/tmp/mynewfile', err => {
  if (err) return console.error(err)
  console.log('success!')
})

// 同步方法，注意必須使用try catch包裹着才能捕獲錯誤
try {
  fs.copySync('/tmp/myfile', '/tmp/mynewfile')
  console.log('success!')
} catch (err) {
  console.error(err)
}

// Async/Await:
async function copyFiles () {
  try {
    await fs.copy('/tmp/myfile', '/tmp/mynewfile')
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

copyFiles()
複製代碼

API Methods

下面的全部方法都是fs-extra擴展方法

Async/異步

  • copy
  • emptyDir （別名：emptydir）
  • ensureFile
  • ensureDir （別名：mkdirp、mkdirs）
  • ensureLink
  • ensureSymlink
  • mkdirp
  • mkdirs
  • move
  • outputFile
  • outputJson （別名：outputJSON）
  • pathExists
  • readJson （別名：readJSON）
  • remove
  • writeJson （別名：writeJSON）

Sync/同步

  • copySync
  • emptyDirSync
  • ensureFileSync
  • ensureDirSync
  • ensureLinkSync
  • ensureSymlinkSync
  • mkdirpSync
  • mkdirsSync
  • moveSync
  • outputFileSync
  • outputJsonSync
  • pathExistsSync
  • readJsonSync
  • removeSync
  • writeJsonSync

一、copy(src: string, dest: string, [options: object, callback: func])

複製文件或目錄，目錄能夠包含內容，相似 cp -r

  • src 請注意，若是src是目錄，它將複製此目錄內的全部內容，而不是整個目錄自己
  • dest 請注意，若是src是文件，dest則不能是目錄
  • options
    • overwrite : 覆蓋現有文件或目錄，默認爲true。請注意，若是將此設置爲false而且目標存在，則複製操做將無提示失敗。使用該errorOnExist選項可更改此行爲。
    • errorOnExist : 當overwrite爲false和目標存在時，拋出錯誤。默認是false。
    • dereference : dereference symlinks，默認是false。
    • preserveTimestamps : 若是爲true，將設置對原始源文件的最後修改和訪問時間。若是爲false，則時間戳行爲取決於操做系統。默認是false。
    • filter : 過濾複製文件的功能。返回true包含，false排除。也能夠返回Promise解析爲true或false（或傳入async函數）。
  • callback 回調函數

例子：

const fs = require('fs-extra')

// With a callback:
fs.copy('/tmp/myfile', '/tmp/mynewfile', err => {
  if (err) return console.error(err)

  console.log('success!')
}) // copies file

fs.copy('/tmp/mydir', '/tmp/mynewdir', err => {
  if (err) return console.error(err)

  console.log('success!')
}) // copies directory, even if it has subdirectories or files

// With Promises:
fs.copy('/tmp/myfile', '/tmp/mynewfile')
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example () {
  try {
    await fs.copy('/tmp/myfile', '/tmp/mynewfile')
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example()
複製代碼

使用過濾函數

const fs = require('fs-extra')

const filterFunc = (src, dest) => {
  // your logic here
  // it will be copied if return true
}

fs.copy('/tmp/mydir', '/tmp/mynewdir', { filter: filterFunc }, err => {
  if (err) return console.error(err)

  console.log('success!')
})
複製代碼

二、emptyDir(dir: string, [callback: function])

確保目錄爲空。若是目錄不爲空，則刪除目錄內容。若是該目錄不存在，則建立該目錄。目錄自己不會被刪除。

別名： emptydir()

  • dir 目標路徑
  • callback 回調方法

例子：

const fs = require('fs-extra')

// assume this directory has a lot of files and folders
// With a callback:
fs.emptyDir('/tmp/some/dir', err => {
  if (err) return console.error(err)

  console.log('success!')
})

// With Promises:
fs.emptyDir('/tmp/some/dir')
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example () {
  try {
    await fs.emptyDir('/tmp/some/dir')
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example()
複製代碼

三、ensureFile(file: string, [callback: func])

確保文件存在。若是請求建立的文件位於不存在的目錄中，則會建立這些目錄。若是該文件已存在，則不進行修改。

別名： createFile()

  • file 目標路徑
  • callback 回調方法

例子：

const fs = require('fs-extra')

const file = '/tmp/this/path/does/not/exist/file.txt'

// With a callback:
fs.ensureFile(file, err => {
  console.log(err) // => null
  // file has now been created, including the directory it is to be placed in
})

// With Promises:
fs.ensureFile(file)
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (f) {
  try {
    await fs.ensureFile(f)
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example(file)
複製代碼

四、ensureDir(dir: string, [callback: func])

若是目錄結構不存在，則建立它，若是目錄存在，則不進行建立，相似mkdir -p。

別名： mkdirs(), mkdirp()

  • dir 目標路徑
  • callback 回調方法

例子：

const fs = require('fs-extra')

const dir = '/tmp/this/path/does/not/exist'

// With a callback:
fs.ensureDir(dir, err => {
  console.log(err) // => null
  // dir has now been created, including the directory it is to be placed in
})

// With Promises:
fs.ensureDir(dir)
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (directory) {
  try {
    await fs.ensureDir(directory)
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example(dir)
複製代碼

五、ensureLink(srcpath: string, dstpath: string, [callback: func])

確保連接存在。若是目錄結構不存在，則建立它。

  • srcpath 源路徑
  • dstpath 目標路徑
  • callback 回調方法

例子

const fs = require('fs-extra')

const srcpath = '/tmp/file.txt'
const dstpath = '/tmp/this/path/does/not/exist/file.txt'

// With a callback:
fs.ensureLink(srcpath, dstpath, err => {
  console.log(err) // => null
  // link has now been created, including the directory it is to be placed in
})

// With Promises:
fs.ensureLink(srcpath, dstpath)
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (src, dest) {
  try {
    await fs.ensureLink(src, dest)
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example(srcpath, dstpath)
複製代碼

六、ensureSymlink(srcpath: string, dstpath: string, [callback: func])

確保符號連接存在。若是目錄結構不存在，則建立它。

  • srcpath 源路徑
  • dstpath 目標路徑
  • callback 回調方法
const fs = require('fs-extra')

const srcpath = '/tmp/file.txt'
const dstpath = '/tmp/this/path/does/not/exist/file.txt'

// With a callback:
fs.ensureSymlink(srcpath, dstpath, err => {
  console.log(err) // => null
  // symlink has now been created, including the directory it is to be placed in
})

// With Promises:
fs.ensureSymlink(srcpath, dstpath)
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (src, dest) {
  try {
    await fs.ensureSymlink(src, dest)
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example(srcpath, dstpath)
複製代碼

七、move(src: string, dest: string, [options: object, callback: func])

移動文件或目錄，甚至跨設備。 相似 mv

  • srcpath 源路徑
  • dstpath 目標路徑
  • options
    • overwrite : 覆蓋現有文件或目錄，默認爲false。
  • callback 回調方法

例子：

const fs = require('fs-extra')

const srcpath = '/tmp/file.txt'
const dstpath = '/tmp/this/path/does/not/exist/file.txt'

// With a callback:
fs.move(srcpath, dstpath, err => {
  if (err) return console.error(err)

  console.log('success!')
})

// With Promises:
fs.move(srcpath, dstpath, {
  overwrite: true
})
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (src, dest) {
  try {
    await fs.move(srcpath, dstpath)
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example(srcpath, dstpath)
複製代碼

八、outputFile(file: stirng, data: string|Buffer|Uint8Array, [options: string|object, callback: func])

幾乎與writeFile（即它覆蓋）相同，除了若是父目錄不存在，則建立它。file必須是文件路徑（不容許使用緩衝區或文件描述符）。

  • file 寫入文件路徑
  • data 寫入文件的數據
  • options
  • callback 回調方法

例子：

const fs = require('fs-extra')

const file = '/tmp/this/path/does/not/exist/file.txt'

// With a callback:
fs.outputFile(file, 'hello!', err => {
  console.log(err) // => null

  fs.readFile(file, 'utf8', (err, data) => {
    if (err) return console.error(err)
    console.log(data) // => hello!
  })
})

// With Promises:
fs.outputFile(file, 'hello!')
.then(() => fs.readFile(file, 'utf8'))
.then(data => {
  console.log(data) // => hello!
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (f) {
  try {
    await fs.outputFile(f, 'hello!')

    const data = await fs.readFile(f, 'utf8')

    console.log(data) // => hello!
  } catch (err) {
    console.error(err)
  }
}

example(file)
複製代碼

九、outputJson(file: string, object: object, [options: object, callback: func])

幾乎相同writeJson，除了若是目錄不存在，它就被建立了。

別名： outputJSON()

  • file 寫入文件路徑
  • object 寫入文件的JSON對象
  • options
    • encoding | 默認爲 'utf8'
    • mode 默認爲 0o666
    • flag 詳見支持的文件系統flag, 默認爲 'w'
    • spaces <number|string> 縮進的空格數; 或者用於縮進的字符串（即傳遞'\t'標籤縮進）
    • EOL 設置EOL字符。默認是\n。
    • replacer JSON replacer
  • callback 回調方法

例子：

const fs = require('fs-extra')

const file = '/tmp/this/path/does/not/exist/file.json'

// With a callback:
fs.outputJson(file, {name: 'JP'}, err => {
  console.log(err) // => null

  fs.readJson(file, (err, data) => {
    if (err) return console.error(err)
    console.log(data.name) // => JP
  })
})

// With Promises:
fs.outputJson(file, {name: 'JP'})
.then(() => fs.readJson(file))
.then(data => {
  console.log(data.name) // => JP
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (f) {
  try {
    await fs.outputJson(f, {name: 'JP'})

    const data = await fs.readJson(f)

    console.log(data.name) // => JP
  } catch (err) {
    console.error(err)
  }
}

example(file)
複製代碼

十、pathExists(file: string [, callback: func])

經過檢查文件系統來測試給定路徑是否存在。相似fs.exists

  • file 文件路徑
  • callback 回調函數

例子：

const fs = require('fs-extra')

const file = '/tmp/this/path/does/not/exist/file.txt'

// With a callback:
fs.pathExists(file, (err, exists) => {
  console.log(err) // => null
  console.log(exists) // => false
})

// Promise usage:
fs.pathExists(file)
  .then(exists => console.log(exists)) // => false

// With async/await:
async function example (f) {
  const exists = await fs.pathExists(f)

  console.log(exists) // => false
}

example(file)
複製代碼

十一、readJson(file: string, [options: object, callback: func])

讀取JSON文件，而後將其解析爲對象

別名： readJSON()

  • file JSON文件路徑
  • options
    • throws 若是爲false而且JSON無效，它將不會拋出err, 默認true
  • callback 回調函數

例子：

const fs = require('fs-extra')

// With a callback:
fs.readJson('./package.json', (err, packageObj) => {
  if (err) console.error(err)

  console.log(packageObj.version) // => 0.1.3
})

// With Promises:
fs.readJson('./package.json')
.then(packageObj => {
  console.log(packageObj.version) // => 0.1.3
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example () {
  try {
    const packageObj = await fs.readJson('./package.json')

    console.log(packageObj.version) // => 0.1.3
  } catch (err) {
    console.error(err)
  }
}

example()
複製代碼

十二、remove(path: string, [callback: func])

刪除文件或目錄。該目錄能夠包含內容, 相似 rm -rf

  • path 目標路徑
  • callback 回調函數

例子：

const fs = require('fs-extra')

// remove file
// With a callback:
fs.remove('/tmp/myfile', err => {
  if (err) return console.error(err)

  console.log('success!')
})

fs.remove('/home/jprichardson', err => {
  if (err) return console.error(err)

  console.log('success!') // I just deleted my entire HOME directory.
})

// With Promises:
fs.remove('/tmp/myfile')
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example (src, dest) {
  try {
    await fs.remove('/tmp/myfile')
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example()
複製代碼

1三、writeJson(file, object, [options, callback])

將對象寫入JSON文件, 幾乎與outputJson相同，除了必須保證目錄存在外。

別名： writeJSON()

  • file 寫入文件路徑
  • object 寫入文件的JSON對象
  • options
    • encoding | 默認爲 'utf8'
    • mode 默認爲 0o666
    • flag 詳見支持的文件系統flag, 默認爲 'w'
    • spaces <number|string> 縮進的空格數; 或者用於縮進的字符串（即傳遞'\t'標籤縮進）
    • EOL 設置EOL字符。默認是\n。
    • replacer JSON replacer
  • callback 回調方法

例子：

const fs = require('fs-extra')

// With a callback:
fs.writeJson('./package.json', {name: 'fs-extra'}, err => {
  if (err) return console.error(err)

  console.log('success!')
})

// With Promises:
fs.writeJson('./package.json', {name: 'fs-extra'})
.then(() => {
  console.log('success!')
})
.catch(err => {
  console.error(err)
})

// With async/await:
async function example () {
  try {
    await fs.writeJson('./package.json', {name: 'fs-extra'})
    console.log('success!')
  } catch (err) {
    console.error(err)
  }
}

example()
複製代碼

寫在最後

毋庸置疑fs-extra用在生產環境絕對是不錯的選擇，可是想要玩轉黑科技仍是要多多瞭解fs模塊，畢竟它纔是老大。

原文連接

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程