node【文件篇】

  • Post author:
  • Post category:其他





前言

fs模块为node中的文件模块,所有的文件操作你都可以通过它去实现。并且node模块中绝大部分的api都提供类sync和promise风格。
const fs=require('fs');
const fsPromise=require('fs/promise')
fs.mkdir(path,options?,callbakc(err,newMkdirpath)?):undefined //异步创建文件夹
fs.mkdirSync(path,options?):newMkdirpath //同步创建
fsPromise.mkdir(path):Promise //Promise 风格



node版本号

v14+



一、增

不仅仅是下面的方法,通过flag参数,

fs.open


fs.appendFile

等很多方法,都可以实现创建文件


  • fs.mkdir(path,options,callback)

    创建文件夹

    const option = {
      recursive: false, // 当 recursive 为 true 时,如果没有成功创建目录,则 path 仍然为 undefined
      mode: 6, //可读 可写
    };
    
    //options方式读取
    fs.mkdir(dirPath, option, (err) => {
      console.log("err", err);
    });
    


  • fs.mkdtemp(path,options,callback)

    创建临时文件夹文件夹

    临时目录在重启机器后会被删除

    	const option = {
      encoding: "utf8",
    };
    
    //options方式读取
    fs.mkdtemp(dirPath, option, (err, directory) => {
      console.log("err", err);
      console.log("临时文件夹地址", directory);
    });
    


  • fs.appendFile(path,data,options,callback)

    将data:

    <string>|<buffer>

    追加到指定文件中,如果文件不存在则创建文件

    const pathOrFd = "./src/index.js"; //文件名或文件描述符fd
    const data = "-appendxsxsxsxs"; //
    const option = {
      encoding: "utf8", //默认utf8
      mode: 777, //默认777
      flag: "a", //默认a:打开文件进行追加。 如果文件不存在,则创建该文件。
    };
    
    fs.appendFile(pathOrFd, data, option, callback);
    
    function callback(err) {
      console.log("回调函数", err);
    }
    


  • fs.writeFile

    将文件异步写入指定位置,可用来创建文件


    fs.writeFile

    是一个便捷的方法,其在内部执行多次 write 调用以写入传给它的缓冲区。 对于性能敏感的代码,则考虑使用

    fs.createWriteStream()

    const data = "-appendxsxsxsxsxxxxx-"; //写入文件的数据,可以是<String>|<Buffer>
    
    const option = {
      encoding: "utf8",
      mode: 6,
      flag: "a", //打开文件进行追加,如果文件不存在,则创建文件
    };
    
    fs.writeFile(filePath, data, option, (err) => {
      if (err) {
        return console.log("err", err);
      }
      console.log("写入成功");
    });
    


  • fs.createWriteStream

    :创建一个写入流,可以高性能的写入文件

    return:<fs.WriteStream>


    更多详情

    const options = {
      encoding: "utf8",
      mode: 7,
      flags: "r+", //对文件进行修改
      fd: null, //如果指定了 fd,则 <fs.WriteStream> 将忽略 path 参数并使用指定的文件描述符。 这意味着不会触发 'open' 事
      autoClose: true, //如果将 autoClose 设置为 true(默认行为),则在 'error' 或 'finish' 时文件描述符将自动关闭。 如果 autoClose 为 false,则即使出现错误,文件描述符也不会关闭。
      emitClose: true, //默认情况下,流将在销毁后触发 'close' 事件。 将 emitClose 选项设置为 false 以	更改此行为
    };
    
    const writeStream = fs.createWriteStream(filePath, options); //return <fs.WriteStream>
    
    //writeStream准备好使用时触发;
    writeStream.on("ready", () => {
      //写入数据
      writeStream.write("-write data1-", "utf8", (err) => {});
      //调用 writable.end() 方法表示不再有数据写入 Writable,在调用 stream.end() 之后调用 stream.write() 	方法将引发错误。
      writeStream.end("data", "utf8", (err) => {
        writeStream.destroy(); //调用完成之后销毁
      });
    });
    


  • fs.write

    :通过文件标识写入文件

    值得一提的是,数据插入位置flag优先级较高,如果flag为'a'即在文件中追加数据,那么即便设置了position,数据也将在文件的末尾插入


    fs.write()



    fs.writeFile

    的不同是


    • fs.write()

      第一个参数只接受fd

    • fs.write()

      可以通过position指定插入位置
    const data = "-data-"; //写入文件的数据,可以是<String>,或者拥有toString方法的<Objet>
    const position = 10; //指从文件开头数据应被写入的偏移量。 如果 typeof position !== 'number',则数	据将写入当前位置
    const encoding = "utf8"; //是预期的字符串编码。
    const fd = fs.openSync(filePath, "a", 7); //文件修饰符
    
    fs.write(fd, data, position, encoding, (err, bytesWritten, buffer) => {
      if (err) {
        return console.log("err", err);
      }
      console.log(
        "write success",
        "写入文件的size byte单位",
        bytesWritten,
        "注入的数据",
        buffer
      );
    
      //使用文件修饰符操作的api不会自动关闭,必须手动关闭文件修饰符
      fs.close(fd);
    });
    



二、删


  • fs.rm(path,option,callback)

    :异步删除文件或目录

    	const option = {
    	  maxRetries: 0, //尝试删除目录发生异常时,最大重试删除操作次数,默认为0
    	  recursive: true, //是否为递归删除目录,默认为false,已弃用
    	  retryDelay: 100, //重试操作等待时间,单位毫秒
    	  force: true, //当为 true 时,如果 path 不存在,则异常将被忽略。 默认值: false
    	};
    	fs.rm("./src", option, callback);
    	
    	function callback(err) {
    	  console.log("回调函数", err);
    	}
    



三、改


  • fs.chmod(path,mode,callback)

    :修改文件权限。

    mode详情

    构建 mode 的一种更简单的方法是使用三个八进制数字的序列(例如 765)。 最左边的数字(示例中的 7)指定文件所有者的权限。 中间的数字(示例中的 6)指定群组的权限。 最右边的数字(示例中的 5)指定其他人的权限。

    	fs.chmod("./src", 765, callback);
    	function callback(err) {
    	  console.log("回调函数", err);
    	}
    


  • fs.copyFile(src,dest,mode,callback)



    mode详情

    copyFile只能拷贝文件拷贝目录,拷贝生成的文件权限

    即mode参数

    不能超过源文件

    	const src = "./src/index.js"; //源文件
    	const dest = "./test.txt"; //copy输出文件位置
    	const mode = 1; //生成的文件读写、执行权限
    	fs.copyFile(src, dest, mode, callback);
    	function callback(err) {
    	  console.log("回调函数", err);
    	}
    



四、查


  • fs.access(path,mode.acllback)

    查询用户对指定的文件是否拥有指定

    mode

    的权限.更多mode请查看

    文件常量

    通过它来判断文件或目录是否存在也是一种常见的使用场景

    const pathOrFd = "./src/index.js"; //文件名或文件描述符fd
    
    // 检查当前目录中是否存在该文件。
    access(pathOrFd, fs.constants.F_OK, (err) => {
      console.log(`${file} ${err ? "does not exist" : "exists"}`);
    });
    
    // 检查文件是否可读。
    access(pathOrFd, fs.constants.R_OK, (err) => {
      console.log(`${file} ${err ? "is not readable" : "is readable"}`);
    });
    


  • fs.open(path[, flags, mode, callback)

    打开一个文件

    通过此方法拿到文件修饰符

    fd

    ,可以为一些需要文件修饰符的方法提供参数,比如

    fs.write


    fs.read

    const filePath = "./src/index.js"; //文件名或文件描述符fd
    const mode = 7; //mode
    const flag = "r";
    
    fs.open(filePath, flag, mode, (err, fd) => {
      if (err) {
    	return console.log("查询失败", err);
      }
      console.log("文件修饰符", fd);
    });
    


  • fs.opendir(path, options, callback)

    打开一个文件夹,返回:<

    fs.Dir>

    const dirPath = "./src"; //文件名或文件描述符fd
    const option = {
      encoding: "utf8", //默认utf8
      bufferSize: 32, //当从目录读取时,在内部缓冲的目录条目数。 值越大,性能越好,但内存使用率越高。 默认32
    };
    
    fs.opendir(dirPath, option, (err, dir) => {
      if (err) {
        return console.log("查询失败", err);
      }
      console.log("文件夹句柄", dir); //<fs.Dir>	
      dir.close(); //操作完成之后关闭目录的底层资源句柄。 后续读取将导致错误
    });
    


  • fs.read(fd, options,callback)

    使用

    fd

    文件修饰符读取文件数据

    options参数可以省略

    fs.read(fd,callback)

    const filePath = "./src/index.js"; //文件名或文件描述符fd
    const mode = 7; //mode
    const flag = "r";
    
    const option = {
      buffer: Buffer.alloc(16384), //数据将写入的缓冲区<Buffer> | <TypedArray> | <DataView>
      offset: 100, //要写入数据的 buffer 中的位置。
      length: 100, // 读取的字节数。
      position: null, //指定从文件中开始读取的位置。 如果 position 为 null 或 -1 ,则将从当前文件位置读取数据,并更新文件位	置。 如果 position 是整数,则文件位置将保持不变。
    };
    
    fs.open(filePath, flag, mode, (err, fd) => {
      if (err) return;
      fs.read(fd, option, (err2, bytesRead, buffer) => {
        console.log("read", err2, "字节数", bytesRead, "二进制数据", buffer);
      });
    });
    


  • fs.readFile(path[, options], callback)

    使用

    文件path



    文件修饰符

    读取文件数据

    • 读数将从当前位置开始。 例如,如果文件已经具有 ‘Hello World’ 并且使用文件描述符读取了六个字节,则使用相同文件描述符对 fs.readFile() 的调用将得到 ‘World’,而不是 ‘Hello World’
    • 如果将文件描述符指定为 path,则它将不会自动关闭。
    • 指定编码方式

      fs.readFile(filePath, "utf8", callback)
    const option = {
      encoding: "utf8",
      flag: "r", //请参阅对文件系统 flags 的支持。 默认值: 'r'
    };
    
    //options方式读取
    fs.readFile(filePath, option, (err, data) => {
      console.log("错误信息", err, "data", data);
    });
    


  • fs.readdir(path,options, callback)

    读取文件夹信息

    options参数可以省略

    const option = {
      encoding: "utf8",
      withFileTypes: true, //是否在files中返回文件类型1为文件 2为目录,即便返回也不可读取,默认为false
    };
    
    fs.readdir(dirPath, option, (err, files) => {
      console.log("错误信息", err, "files", files);
    });
    


  • fs.stat(path[, options], callback)

    调用此方法可以获取条目(文件或目录)的

    Stats实例


    • <fs.Stats>

      包含了文件基本信息如

      是否是文件、size大小、创建时间、mode等等


      更多stats属性

    • fs.fstat(fd[, options], callback)

      和此方法相识,只不过fstat第一个参数是

      文件修饰符:fd
    const option = {
     bigint: true, //返回的 <fs.Stats> 对象中的数值是否应为 bigint。 默认值: false。
    };
    
    //options方式读取
    fs.stat(filePath, option, (err, stats) => {
      if (err) return console.log("err", err);
      console.log("是文件", stats.isFile());
      console.log("是目录", stats.isDirectory());
      console.log("文件大小", stats.size());
      console.log("创建时间戳毫秒", stats.birthtimeMs());
      console.log("最后一次修改时间戳毫秒", stats.mtimeMs());
      console.log("最后一次访问时间戳", stats.atimeMs());
    });
    


    bigint:false


    stats

    {


    dev: 2114,

    ino: 48064969,

    mode: 33188,

    nlink: 1,

    uid: 85,

    gid: 100,

    rdev: 0,

    size: 527,

    blksize: 4096,

    blocks: 8,

    atimeMs: 1318289051000.1,

    mtimeMs: 1318289051000.1,

    ctimeMs: 1318289051000.1,

    birthtimeMs: 1318289051000.1,

    atime: Mon, 10 Oct 2011 23:24:11 GMT,

    mtime: Mon, 10 Oct 2011 23:24:11 GMT,

    ctime: Mon, 10 Oct 2011 23:24:11 GMT,

    birthtime: Mon, 10 Oct 2011 23:24:11 GMT }


    bigint:true


    stats

    {


    dev: 2114n,

    ino: 48064969n,

    mode: 33188n,

    nlink: 1n,

    uid: 85n,

    gid: 100n,

    rdev: 0n,

    size: 527n,

    blksize: 4096n,

    blocks: 8n,

    atimeMs: 1318289051000.1n,

    mtimeMs: 1318289051000.1n,

    ctimeMs: 1318289051000.1n,

    birthtimeMs: 1318289051000.1n,

    atime: Mon, 10 Oct 2011 23:24:11 GMT,

    mtime: Mon, 10 Oct 2011 23:24:11 GMT,

    ctime: Mon, 10 Oct 2011 23:24:11 GMT,

    birthtime: Mon, 10 Oct 2011 23:24:11 GMT }




常量



  • 对文件系统 flags 的支持


    flag 也可以是 open(2) 记录的数字;常用的常量可从 fs.constants 获得


    a:

    打开文件进行追加。 如果文件不存在,则创建该文件。


    ax:

    类似于 ‘a’ 但如果路径存在则失败。


    a+:

    打开文件进行读取和追加。 如果文件不存在,则创建该文件。


    ax+:

    类似于 ‘a+’ 但如果路径存在则失败。


    as:

    以同步模式打开文件进行追加。 如果文件不存在,则创建该文件。


    as+:

    以同步模式打开文件进行读取和追加。 如果文件不存在,则创建该文件。


    r:

    打开文件进行读取。 如果文件不存在,则会发生异常。


    r+:

    打开文件进行读写。 如果文件不存在,则会发生异常。


    rs+:

    以同步模式打开文件进行读写。 指示操作系统绕过本地文件系统缓存。

    这主要用于在 NFS 挂载上打开文件,因为它允许跳过可能过时的本地缓存。 它对 I/O 性能有非常实际的影响,因此除非需要,否则不建议使用此标志。这不会将 fs.open() 或 fsPromises.open() 变成同步阻塞调用。 如果需要同步操作,应该使用类似 fs.openSync() 的东西。


    w:

    打开文件进行写入。 创建(如果它不存在)或截断(如果它存在)该文件。


    wx:

    类似于 ‘w’ 但如果路径存在则失败。


    w+:

    打开文件进行读写。 创建(如果它不存在)或截断(如果它存在)该文件。


    wx+:

    类似于 ‘w+’ 但如果路径存在则失败。




  • 文件系统mode支持


    第一个7

    :表示当前文件的拥有者的权限


    第二个7

    :表示当前文件的所属组(同组用户)权限


    第三个7

    :表示当前文件的组外权限


    mode

    代码 描述
    7 可读、可写和可执行
    6 可读和可写
    5 可读和可执行
    4 只读
    3 可写和可执行
    2 只写
    1 只可执行
    0 无权限



版权声明:本文为qq_32019935原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。