>首页> IT >

当前要闻:node中的fs模块是什么

时间:2022-07-13 05:52:31       来源:PHP中文网

本教程操作环境:windows7系统、nodejs16版,DELL G3电脑。

文件系统模块(简称 fs)允许我们访问计算机上的文件系统并与之交互。

fs 模块是 Node.js 官方提供的、用来操作文件的模块。它提供了一系列的方法和属性,用来满足用户对文件的操作需求。


【资料图】

fs.readFile() 方法,用来读取指定文件中的内容

fs.writeFile() 方法,用来向指定的文件中写入内容 如果要在 JavaScript 代码中

如何使用 fs

文件系统模块是一个核心的 Node.js 模块。这意味着我们不必安装它。我们唯一需要做的就是将 fs 模块导入到自己的文件中。

因此,在文件顶部添加:

const fs = require("fs")

现在,我们可以使用前缀 fs 从文件系统模块调用任何方法。

或者,我们可以只从 fs API 导入所需的方法,如下所示:

const { writeFile, readFile } = require("fs")

注意:为了方便起见,我们还需要导入 path 模块。它是另一个核心 Node.js 模块,它允许我们使用文件和目录路径。

导入 fs 模块后,在文件中添加:

const path = require("path")

使用文件系统模块时,path 模块不是必需的。但它对我们有很大的帮助!

同步与异步

fs模块的文件操作一般支持同步和异步两种API,异步又包括了回调函数和promsie的形式。同步一般后面带sync字样。

fs模块的API大都提供三种操作方式:

同步操作文件:代码会被阻塞,不会继续执行

异步回调函数操作文件:代码不会被阻塞,需要传入回调函数,当获取到结果时,回调函数执行

异步Promise操作文件:代码不会被阻塞,通过fs.promises调用方法操作,会返回一个Promise,可以通过then、catch进行处理。

需要注意的是,默认情况下,所有 fs 方法都是异步的。但是,我们可以通过在方法末尾添加 Sync 来使用同步版本。

例如,writeFile 方法的同步版本为 writeFileSync。同步方法将同步的完成代码,因此它们阻塞了主线程。阻塞 Node.js 中的主线程被认为是不好的做法,我们不应该这么做。

因此,以下我们都将使用文件系统模块中的异步方法。

写入文件

要从 Node.js 应用程序写入文件,请使用 writeFile方法。

writeFile方法至少接受以下参数:

文件名内容回调

如果指定的文件已经存在,它会将旧内容替换为您作为参数提供的内容。如果指定的文件不存在,则创建一个新文件。

导入 fspath模块后,在文件中编写以下代码:

fs.writeFile("content.txt", "All work and no play makes Jack a dull boy!", err => {  if (err) throw err  process.stdout.write("创建成功!")})

上面的代码将创建了一个名为 content.txt的新文件,并添加了文本 All work and no play makes Jack a dull boy!作为内容。如果存在任何错误,回调函数将抛出该错误。否则,它将向控制台输出文件创建成功。

writeFile还有其他变体,例如:

fs.writeFileSync— 同步写入文件fsPromises.writeFile— 使用基于 Promise 的 API 写入文件

从文件中读取

在读取文件之前,需要创建并存储文件的路径。path模块的路径在这里很方便。

使用 join模块中的 path方法,您可以创建文件路径,如下所示:

const filePath = path.join(process.cwd(), "content.txt")

第一个参数 process.cwd()返回当前工作目录。现在您已经有了文件路径,可以读取文件的内容了。

在文件中编写以下代码:

fs.readFile(filePath, (error, content) => {  if (error) throw error  process.stdout.write(content)})

readFile方法至少接受两个参数:

文件的路径回调

如果有错误,它会抛出一个错误。否则,它会在终端中输出文件内容。

readFile还有其他变体,例如:

fs.readFileSync— 同步写入文件fsPromises.readFile— 使用基于 Promise 的 API 写入文件

读取目录的内容

在目录中显示文件与读取文件内容非常相似。但是,不是传递文件路径,而是传递当前工作目录(我们可以传递任何其他目录)。

然后,传递一个回调函数来处理响应。在文件中编写以下代码:

fs.readdir(process.cwd(), (error, files) => {  if (error) throw error  console.log(files)})

到目前为止,我们只使用 process.stdout.write将内容输出到终端。但是,您可以简单地使用 console.log,就像上面的代码片段一样。

如果运行该应用程序,我们应该会得到一个包含目录中所有文件的数组。

删除文件

文件系统模块有一种方法,允许您删除文件。但是,需要注意的是,它只适用于文件,不适用于目录。

当以文件路径作为参数调用 unlink方法时,它将删除该文件。将以下代码段添加到文件中:

fs.unlink(filePath, error => {  if (error) throw error  console.log("文件已删除!")})

如果您重新运行代码,您的文件将被删除!

创建目录

我们可以使用 mkdir方法异步创建目录。在文件中编写以下代码:

fs.mkdir(`${process.cwd()}/myFolder/secondFolder`, { recursive: true }, (err) => {  if (err) throw err  console.log("已成功创建文件夹!")})

首先,要在当前工作目录中创建一个新文件夹。如前所述,您可以使用 cwd()方法从 process对象获取当前工作目录。

然后,传递要创建的一个或多个文件夹。但是,这并不意味着您必须在当前工作目录中创建新文件夹。你可以在任何地方创建它们。

现在,第二个参数是递归选项。如果未将其设置为 true,则无法创建多个文件夹。如果将 recursive选项设置为 false,上述代码将给出一个错误。试试看!

但是,如果您只想创建一个文件夹,则无需将 recursive选项设置为 true

以下代码可以正常工作!

fs.mkdir(`${process.cwd()}/myFolder`, err => {  if (err) throw err  console.log("已成功创建文件夹!")});

因此,我想强调使用 recursive。如果要在文件夹中创建文件夹,则需要将其设置为 true。它将创建所有文件夹,即使它们不存在。

另一方面,如果您只想创建一个文件夹,可以将其保留为 false

删除目录

删除目录的逻辑类似于创建目录。如果您查看为创建目录而编写的代码和下面的代码,您会发现相似之处。

因此,在文件中编写以下代码:

fs.rmdir(`${process.cwd()}/myFolder/`, { recursive: true }, err => {  if (err) throw err  console.log("已成功删除文件夹!")})

使用文件系统模块中的 rmdir方法,并传递以下参数:

要删除的目录递归属性回调

如果将 recursive属性设置为 true,它将删除文件夹及其内容。请务必注意,如果文件夹中包含内容,则需要将其设置为 true。否则,您将得到一个错误。

以下代码段仅在文件夹为空时有效:

fs.rmdir(`${process.cwd()}/myFolder/`, err => {  if (err) throw err  console.log("已成功删除文件夹!")})

如果 myFolder中有其他文件和/或文件夹,如果未传递 { recursive: true },则会出现错误。

知道何时使用 recursive选项以及何时不避免问题是很重要的。

目录/文件重命名

使用 fs模块,您可以重命名目录和文件。下面的代码片段显示了如何使用 rename方法进行此操作。

// 重命名一个目录fs.rename(`${process.cwd()}/myFolder/secondFolder`, `${process.cwd()}/myFolder/newFolder`, err => {  if (err) throw err  console.log("目录重命名!")});// 重命名一个文件fs.rename(`${process.cwd()}/content.txt`, `${process.cwd()}/newFile.txt`, err => {  if (err) throw err  console.log("文件重命名!")});

rename方法包含三个参数:

第一个参数是现有的文件夹/文件第二个参数是新名称回调

因此,要重命名文件或目录,我们需要传递当前文件/目录的名称和新名称。运行应用程序后,应更新目录/文件的名称。

向文件中添加内容

我们还可以使用 appendFile方法向现有文件添加新内容。

如果比较 writeFileappendFile这两种方法,我们可以发现它们是相似的。传递文件路径、内容和回调。

fs.appendFile(filePath, "\nAll work and no play makes Jack a dull boy!", err => {  if (err) throw err    console.log("All work and no play makes Jack a dull boy!")})

上面的代码片段演示了如何向现有文件添加新内容。如果运行应用程序并打开文件,您应该会看到其中的新内容。

更多node相关知识,请访问:nodejs 教程!

以上就是node中的fs模块是什么的详细内容,更多请关注php中文网其它相关文章!

关键词: 文件系统 回调函数 创建目录