Quel module dans nodejs fournit l'API d'opération de fichier

Dans nodejs, le module de système de fichiers fournit une API d'opération de fichiers. Le module de système de fichiers (appelé module fs) permet aux utilisateurs d'accéder et d'interagir avec le système de fichiers sur l'ordinateur ; à l'aide du module fs, la création, l'écriture, la suppression et d'autres opérations de fichiers et de répertoires peuvent être réalisées.

L'environnement d'exploitation de ce tutoriel : système windows7, nodejs version 12.19.0, ordinateur DELL G3.

1 : Comment lire l'intégralité du contenu du fichier ?

Remarque : Lire des fichiers et écrire des fichiers peut être ennuyeux à comprendre, mais chaque fois que j'étudie un article comme celui-ci, je suis prêt pour le prochain article, car j'ai besoin de l'utiliser pour la démo de mon prochain article. J'ai des connaissances dans ce domaine, j'enregistrerai donc toutes les connaissances que j'ai besoin de comprendre.

Dans Node.js, utilisez le module fs pour créer, écrire et supprimer tous les fichiers et répertoires.

1. Méthodes de lecture de fichiers :

Lorsque vous effectuez une opération de lecture de fichier, vous pouvez utiliser la méthode readFile et la méthode readFileSync pour lire le fichier. Celles avec des mots tels que Sync sont des méthodes synchrones, et celles sans cela. word sont des méthodes asynchrones. Prenez, la différence entre la méthode synchrone et la méthode asynchrone est la suivante : la méthode synchrone renvoie immédiatement le résultat de l'opération. Jetons d'abord un coup d'œil à l'API associée :

1) readFileSync lit de manière synchrone l'API du fichier

L'API correspondante. La méthode d'utilisation est la suivante : Paramètre

fs.readFileSync(filename, [options]);

filename : utilisé pour spécifier le chemin complet et le nom du fichier lu.

Paramètre options : Cette valeur est un objet, qui peut spécifier l'action à effectuer sur le fichier en utilisant l'attribut flag lors de la lecture du fichier. La valeur par défaut est 'r' ; les valeurs qui peuvent être spécifiées sont les suivantes :

• 'r' : lecture du fichier, une exception sera levée si le fichier n'existe pas.

• 'r+' : Lire et écrire des fichiers, en lançant une exception si le fichier n'existe pas.

• 'rs' : Lisez le fichier de manière synchrone et informez le système d'exploitation d'ignorer le cache du système de fichiers local. Si le fichier n'existe pas, une exception sera levée.

• 'w' : Écrivez dans le fichier. Si le fichier n'existe pas, créez le fichier. Si le fichier existe déjà, effacez le contenu du fichier.

• 'w+' : lecture et écriture de fichiers, les autres fonctions sont les mêmes que 'w'.

• 'a' : Ajouter au fichier, créer le fichier s'il n'existe pas.

• 'a+' : Lire et ajouter au fichier, créer le fichier s'il n'existe pas.

Dans le paramètre options, nous pouvons utiliser l'attribut encoding pour spécifier le format d'encodage à utiliser pour lire le fichier​​sont 'utf-8', 'ascii', 'base64'. jetez d’abord un œil à la démo simple. Comme indiqué ci-dessous :

Regardez d'abord la structure des répertoires comme suit :

### 目录结构如下：
demo1                                       # 工程名
|   |--- readFile                           # 读取文件的文件夹            
|   | |-- index.html                        # html文件
|   | |-- index.js                          # js文件
|   | |-- package.json          
|   | |-- node_modules

Le code suivant lit le code du fichier :

const fs = require('fs');
try {
  const data = fs.readFileSync('./index.html', 'utf-8');
  // 等待操作结果返回，然后打印结果
  console.log(data);
} catch(e) {
  console.log('读取文件发生错误');
}

Exécutez le nœud index.js dans la ligne de commande, puis imprimez les résultats comme suit :

2) Lecture asynchrone L'utilisation de l'API des fichiers est la suivante :

fs.readFile(filename, [options], callback);

le nom du fichier et les options sont les mêmes que les paramètres de la méthode de synchronisation.

Le paramètre de rappel est la fonction de rappel utilisée pour être exécutée après la lecture du fichier. Comme le montre le code suivant :

const fs = require('fs');
fs.readFile('./index.html', 'utf-8', (err, data) => {
  if (err) {
    console.log('读取文件时发生错误');
  } else {
    console.log(data);
  }
});

Le résultat de l'exécution est le même que ci-dessus. Pas de captures d'écran ici.

2 : Comment écrire l'intégralité du contenu du fichier ?

Pour écrire un fichier, nous utilisons la méthode writeFile ou la méthode wirteFileSync dans le module fs. La méthode d'utilisation de writeFile est la suivante (la méthode wirteFileSync est similaire, sauf qu'il n'y a pas de paramètre de rappel) : le paramètre

fs.writeFile(filename, data, [options], callback);

filename spécifie le chemin complet et le nom du fichier qui doit être écrit.

paramètre data Pour spécifier le contenu qui doit être écrit, la valeur peut être une chaîne ou un objet Buffer, et le contenu de la chaîne ou du tampon sera entièrement écrit dans le fichier.

la valeur des options est un objet (facultatif), le nom de l'option est flag, elle a les valeurs d'option suivantes :

• 'flag' : utilisé pour spécifier quelle opération effectuer pour le fichier, la valeur par défaut est 'w' , la signification est Écrire dans un fichier. Toutes les valeurs de cet élément spécifié sont les mêmes que les valeurs de readFile ci-dessus.
  (Créez le fichier s'il n'existe pas et écrasez le fichier s'il existe).

• 'mode' : Cet attribut est utilisé pour spécifier les autorisations de lecture et d'écriture du fichier lors de son ouverture. La valeur par défaut est 0666 (lisible et inscriptible). Il existe de nombreuses valeurs que vous pouvez découvrir sur Baidu.

• 'encoding' : utilisé pour préciser quel format d'encodage utiliser pour écrire le fichier. Les valeurs d'attribut qui peuvent être spécifiées sont « utf8 », « ascii » et « base64 ».

• callback : Ce paramètre est utilisé pour la fonction de rappel exécutée lorsque la lecture du fichier est terminée.

Faisons simplement une démo, écrivons du code dans le fichier index.js de notre répertoire, créons un fichier message.txt dans ce répertoire et écrivons deux lignes de texte. Le code suivant :

const fs = require('fs');
const str = '这是第一行。\r\n这是第二行';
fs.writeFile('./message.txt', str, (err) => {
  if (err) {
    console.log('写入文件操作失败');
  } else {
    console.log('写入文件操作成功');
  }
});

Exécutez la commande comme indiqué ci-dessous :

Le fichier message.txt sera généré dans le répertoire, comme indiqué ci-dessous

然后我们打开文件，会看到其写入的内容。

2）写入buffer对象，如下代码：

const fs = require('fs');
const str = new Buffer('我喜爱编程');
fs.writeFile('./message.txt', str, (err) => {  if (err) {
    console.log('写入文件操作失败');
  } else {
    console.log('写入文件操作成功');
  }
});

在message.txt中可以看到 '我喜爱编程' 几个字。

3）设置options参数flag属性选项，比如追加数据这些，如下代码：

const fs = require('fs');
const options = {
  flag: 'a'};
fs.writeFile('./message.txt', '这是追加的数据', options, (err) => {  if (err) {
    console.log('写入文件操作失败');
  } else {
    console.log('写入文件操作成功');
  }
});

message.txt内容编程如下了：我喜爱编程这是追加的数据

4）复制图片文件

我们可以通过readFile方法读取应用程序对应目录下的一个图片文件，在读取文件时使用base64编码，在该回调函数中使用writeFile方法，在该方法中使用base64编码将读取到的图片文件数据复制到另一个图片文件中。如下代码：

const fs = require('fs');

fs.readFile('./images/1.png', 'base64', (err, data) => {
  fs.writeFile('./images/xx.png', data.toString(), 'base64', (err) => {    if (err) {
      console.log('写文件操作失败');
    } else {
      console.log('写文件操作成功');
    }
  });
});

在image下有一个 1.png, 它会先复制，然后写入 xx.png中(该文件之前不存在的，会创建该图片文件)。

三：如何在文件中的指定位置处读入内容？

3.1）打开文件open方法或openSync方法

要实现在文件中的指定位置处读入内容，首先我们需要打开该文件，fs模块中的open方法或openSync方法打开文件。open方法使用方式如下所示：

fs.open(filename, flags, [mode], callback);

前三个参数和readFile的参数是一个意思的。最后一个参数是执行完成后的回调函数。该回调函数有两个参数，第一个是打开文件失败时的错误对象，第二个参数为一个整数值，代表打开文件时返回的文件描述符。

下面我们来打开我们刚刚创建的 message.txt文件，如下代码：

const fs = require('fs');

fs.open('./message.txt', 'r', (err, fd) => {
  console.log(fd);
});

执行结果如下所示：

3.2）从指定的位置读取文件

如上面打开文件之后，我们可以在其回调函数使用fs模块中的read方法或readSync方法从文件的指定位置处读取文件，也可以使用fs模块中的write方法或writeSync方法从文件中指定处写入数据。

fs.read(fd, buffer, offset, length, position, callback);

fd参数是 上面open打开文件返回的文件描述符。

buffer参数 是一个buffer对象，用于指定将文件数据读取到那个缓存区中。

offset：用于指定向缓冲区中写入数据的开始位置。

length：用于指定从文件中读取的字节数。

position: 用于指定读取文件时的开始位置。

callback：用于指定文件操作完毕时的回调函数。如下所示：

function(err, bytesRead, buffer) {}

• err: 为操作失败时的错误对象。

• bytesRead: 代表实际读取的字节数。

• buffer：为被读取的缓冲区对象。

下面我们来看个demo代码如下：

const fs = require('fs');
// message.txt 内容为：我喜爱编程这是追加的数据
fs.open('./message.txt', 'r', (err, fd) => {
  const buf = new Buffer(255);
  // 一个汉字的utf编码为三个字节数据
  fs.read(fd, buf, 0, 9, 3, (err, bytesRead, buffer) => {
    console.log(buffer.slice(0, bytesRead).toString()); // 喜爱编  });
});

如上代码message.txt内容为：我喜爱编程这是追加的数据，position为3，从第三个字节开始读取文件，然后长度为9个字节，一个汉字3个字节，因此结果为 '喜爱编';

四：如何在文件中的指定位置处写入内容？

在文件被打开后，可以使用fs模块中的write方法或writeSync方法从一个缓存区中读取数据并从文件的指定位置处写入这些数据。使用方法如下所示：

fs.write(fd, buffer, offset, length, position, callback);

fd参数为描述符。

buffer参数为一个Buffer对象，用于指定从哪个缓存区中读取数据。

offset参数用于指定从缓存区中读取数据时的开始读取位置。

length参数用于指定从缓存区中读取的字节数。

position参数值用于指定写入文件时的开始位置。

callback参数用于指定文件写入操作执行完毕时的回调函数。该回调函数如下：

function(err, written, buffer) {}

• err参数为写入失败时的错误对象。

• written: 代表被写入的字节数。

• buffer： 代表被读取的缓冲区对象。

下面是一个简单的demo，如下所示：

const fs = require('fs');

const buf = new Buffer('我喜爱编程');

fs.open('./message.txt', 'w', (err, fd) => {
  fs.write(fd, buf, 3, 9, 0, (err, written, buffer) => {    if (err) {
      console.log('写文件操作失败');
    } else {
      console.log('写文件操作成功');
    }
  });
});

在message.txt中显示为 喜爱编 这三个字。

五：如何创建与读取目录？

5.1) 创建目录mkdir和mkdirSync方法

在fs模块中，可以使用mkdir方法创建目录，该方法使用方式如下所示：

fs.mkdir(path, [mode], callback);

• path参数用于指定需要被创建的目录完整路径及目录名。

• mode参数用于指定该目录的权限，默认值为0777(表示任何人可读写该目录)。

• callback是回调函数。

下面是一个简单的demo，如下所示：

const fs = require('fs');

fs.mkdir('./test', (err) => {  if (err) {
    console.log('创建目录操作失败');
  } else {
    console.log('创建目录操作成功');
  }
});

如下所示：

5.2）读取目录readdir和readdirSync方法

在fs模块中，使用readdir方法读取目录，该方法使用如下所示

fs.readdir(path, callback);

path参数用于指定需要被读取的目录的完整路径及目录名。

callback参数用于指定读取目录操作的回调函数。该回调函数如下所示：

function(err, file) {}

• err 为读取目录操作失败的回调函数。

• file参数值为一个数组，读取到的文件中的所有文件名。

如下demo所示：

const fs = require('fs');

fs.readdir('./', (err, files) => {  if (err) {
    console.log('读取目录操作失败');
  } else {
    console.log(files);
  }
});

如下图所示：

六：如何查看与修改文件或目录的信息？

6.1）查看文件或目录的信息

在fs模块中，可以使用stat方法或lstat方法查看一个文件或目录的信息。这两个方法唯一的区别是当查看符号链接文件的信息
时，必须使用lstat方法。使用方法如下所示：

fs.stat(path, callback);
fs.lstat(path, callback);

path参数用于被查看的文件或目录的完整路径及文件名或目录名。

callback是回调函数。如下回调函数

function(err, stats) {}

• err 参数值为查看文件或目录信息操作失败时触发的错误对象。

• stats参数值为一个 fs.Stats对象，该对象有如下一些方法，在这些方法中不包含任何参数。

isFile: 用于判断被查看的对象是否为一个文件，如果是则返回true，否则的话返回false。

isDirectory: 用于判断被查看的对象是否为一个目录，如果是的话返回true，否则的话返回false。

还有很多很多其他的方法，这里不一一介绍，用的比较少，有需要的话，可以自己百度一下看看。

下面是使用 stat的使用demo，查看应用程序根目录下的 message.txt文件并且在回调函数中的第二个参数值 fs.Stats对象在控制台中的输出有哪些？

const fs = require('fs');

fs.stat('./message.txt', (err, stats) => {
  console.log(stats);
});

如下图所示显示：

6.2）检查文件或目录是否存在exists和existsSync方法

在fs模块中，可以使用exists方法检查一个文件或目录是否存在，该方法使用方式如下所示：

fs.exists(path, callback);

path参数：用于指定需要被检查的文件或目录的完整路径。
callback: 是回调函数，该回调函数如下所示：

function(exists) {}

• exists参数，当文件或目录存在时，该参数值为true，否则的话，该参数值为false。

下面是一个简单的demo，如下代码所示：

const fs = require('fs');

// 该目录是存在的
fs.exists('./message.txt', (exists) => {
  console.log(exists); // true
});

// 该目录是不存在的
fs.exists('./message2.txt', (exists) => {
  console.log(exists); // false
});

6.3) 获取文件或目录的绝对路径realpath和realpathSync方法

在fs模块中，可以使用 realpath方法获取一个文件或目录的绝对路径，该方法使用如下所示：

fs.realpath(path, [cache], callback);

• cache 参数是可选的，path和callback是必须的。

• path参数为需要查看的文件或目录的完整路径。

• cache参数为一个对象，其中存放了一些预先指定的路径。具体的百度下，这个参数用的不多。

• callback是回调函数，该回调函数有2个参数，err参数值为获取目录的绝对路径失败的错误对象。resolvedPath参数值为获取
  到的文件或目录的绝对路径。

下面是一个简单的demo，如下所示：

const fs = require('fs');

fs.realpath('./message.txt', (err, resolvedPath) => {  if (err) {    throw err;
  } else {
    console.log(resolvedPath);
  }
});

执行如下所示：

6.4) 使用ReadStream对象读取文件

在fs模块中，可以使用createReadStream方法创建一个将文件内容读取为流数据的ReadStream对象，该方法使用如下所示：

fs.createReadStream(path, [options]);

path 该参数用于指定需要被读取的文件的完整路径及文件名。

options为一个对象，它有如下属性：

• flags: 用于指定对该文件采取什么操作，默认值为 'r', 它的用法和readFile方法中的flags属性一样的。

• encoding: 指定使用什么编码来读取该文件，可指定的值有 'utf8', 'ascii', 'base64'. 默认值为null.

• start: 指定文件的开始读取位置。

• end: 指定文件的结束读取位置。

还有很多其他的参数，这里不一一讲解，可以自行百度下即可。

下面简单的使用一个demo来了解下使用：如下代码：

const fs = require('fs');/*
 一个汉字三个字节，message.txt的内容为：我喜爱编写代码
 因此从第三个位置开始，到第十二个位置结束，因此数据应该为 喜爱编写*/const options = {
  start: 3, 
  end: 12};
const file = fs.createReadStream('./message.txt', options);

file.on('open', (fd) => {
  console.log('开始读取文件');
});

file.on('data', (data) => {
  console.log('读取到的数据：' + data);
});

file.on('end', () => {
  console.log('文件已全部读取完毕');
});

file.on('close', () => {
  console.log('文件被关闭');
});

file.on('error', (err) => {
  console.log('读取文件失败');
});

如下图所示：

我们可以使用 ReadStream对象的pause方法暂停data事件的触发，同时也意味着停止文件的读取操作。而已经被读取到的操作系统缓存区中的数据也将被暂时保存在操作系统缓冲区中，在使用了pause方法暂停data事件的触发之后，也可以使用ReadStream对象的resume方法恢复data事件的触发，也就意味着可以继续读取文件的数据。

如下demo：

const fs = require('fs');

const readStream = fs.createReadStream('./message.txt');

readStream.pause();

readStream.on('data', (data) => {
  console.log('获取到的数据为:' +data);
});

setTimeout(() => {
  readStream.resume();
}, 1000);

读取过程中，断听了一秒后，继续把数据读出来了。

注意：写入文件的方法是 WriteStream， 使用方式和读方式类似，这里不多介绍。

【推荐学习：《nodejs 教程》】

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!