Node.js FS模块方法速查

时间: 2018-12-13阅读: 1137标签: node

1. File System

  • 所有文件操作提供同步和异步的两种方式,本笔记只记录异步的API
  • 异步方式其最后一个参数是回调函数。回调函数的第一个参数往往是错误对象,如果没有发生参数,那么第一个参数可能是null或者undefinded。
  • 同步函数可以使用try catch 捕获异常
  • 多个异步函数在同一层次执行,是无法保证顺序的。最好将一个函数放在另一个函数的回调函数中去执行。这种回调的嵌套层次一旦过深,就会造成回调地狱
  • 一般情况下,非常不建议使用同步的fs方法,因为同步的方法会阻断其他事情,直到fs方法完成。


1.1. 文件路径

  • filepaths目前支持4中

    • string
    • Buffer
    • URL Object
    • 以file:开头的协议
  • string 路径会被解释为utf-8格式,可以使用相对路径和绝对路径,相对路径是当前工作路径,可以从process.cwd()获取当前工作路径。


1.2. 文件描述符

  • 操作系统会限制文件描述符的数量
  • 忘记关闭文件可能导致内存泄露或者程序崩溃
  • 任何文件描述符都支持写操作
  • 如果文件描述符的类型是文件,那么它不会自动关闭
  • 写操作会从文件的开头,而不会覆盖之后的内容。举例:文件内容是Hello World, 如果在写入'Aloha',那么文件的内容是Aloha World ,而不是'Aloha'.


1.3. 线程池使用

fs所有的api,除了那些同步的api和fs.FSWatcher(), 基本上都使用libuv的线程池。在有些应用程序上,这个可能导致非常糟糕的性能表现。libuv的线程池有固定的大小,默认只有4个,可以通过设置环境变量UV_THREADPOOL_SIZE去增加libuv的线程的数量。



1.4. Class: fs.Dirent 判断文件类型

  • 当fs.readdir()或者fs.readdirSync()被调用,并且参数withFileTypes是true, 那么返回结果就是fs.Dirent objects, 而不是strings or Buffers
  • dirent方法

    • dirent.isBlockDevice()
    • dirent.isCharacterDevice()
    • dirent.isDirectory()
    • dirent.isFIFO()
    • dirent.isFile()
    • dirent.isSocket()
    • dirent.isSymbolicLink()
    • dirent.name

1.5. Class: fs.FSWatcher 文件变动监控

来自 fs.watch()

  • Event

    • change
    • close
    • error
  • watcher.close()

注意:某些系统可能不会返回filename。如果encoding参数是buffer,那么文件名是以buffer的形式返回,默认文件名是utf-8格式的字符串。

fs.watch('./tmp', { encoding: 'buffer' }, (eventType, filename) => {
  if (filename) {
    console.log(filename);
    // Prints: <Buffer ...>
  }
});


1.6. Class: fs.ReadStream 可读流

来自fs.createReadStream()

  • Event

    • close
    • open
    • ready 第一次触发是在open事件之后
  • readStream.bytesRead
  • readStream.path
  • readStream.pending


1.7. Class: fs.Stats 获取文件信息

来自 fs.stat(), fs.lstat() and fs.fstat() 以及他们的同步版本。

  • stats.isBlockDevice()
  • stats.isCharacterDevice()
  • stats.isDirectory()
  • stats.isFIFO()
  • stats.isFile()
  • stats.isSocket()
  • stats.isSymbolicLink()
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 
}


1.8. Class: fs.WriteStream 可写流

  • Event

    • close
    • open
    • ready
  • writeStream.bytesWritten
  • writeStream.path
  • writeStream.pending


2. 常用方法

  • 测试

    • 访问权限测试 fs.access(path[, mode], callback) 测试是否可以访问某个路径。不建议fs.open(), fs.readFile() or fs.writeFile()调用前,调用fs.access去检查
    • 测试路径是否存在 fs.exists(path, callback), 不建议fs.open(), fs.readFile() or fs.writeFile()调用前,调用fs.exists去检测文件是否存在
  • 流操作

    • 创建可读流 fs.createReadStream(path[, options])
    • 创建可写流 fs.createWriteStream(path[, options])
  • 文件夹操作

    • 创建文件夹 fs.mkdir(path[, options], callback)
    • 删除目录 fs.rmdir(path, callback)
    • 创建临时文件夹 fs.mkdtemp(prefix[, options], callback)
    • 读取文件夹 fs.readdir(path[, options], callback)
  • 文件操作

    • 打开文件 fs.open(path[, flags[, mode]], callback)
    • 读取文件 fs.read(fd, buffer, offset, length, position, callback)
    • 读取文件 fs.readFile(path[, options], callback)
    • 重命名文件 fs.rename(oldPath, newPath, callback)
    • 读取文件信息 fs.stat(path[, options], callback)
    • 删除文件 fs.unlink(path, callback)
    • 停止监控文件 fs.unwatchFile(filename[, listener])
    • 修改时间 fs.utimes(path, atime, mtime, callback)
    • 监控文件变化 fs.watch(filename, options)
    • 关闭文件 fs.close(fd, callback)
    • 追加文件 fs.appendFile(path, data[, options], callback)
    • 改变文件模式 fs.chmod(path, mode, callback)
    • 改变文件所属 fs.chown(path, uid, gid, callback)
    • 复制文件 fs.copyFile(fs.copyFile(src, dest[, flags], callback))
    • 写文件 fs.write(fd, buffer[, offset[, length[, position]]], callback)
    • 写文件 fs.write(fd, string[, position[, encoding]], callback)
    • 写文件 fs.writeFile(file, data[, options], callback)
  • 其他

  • 注意事项

    • fs.watch并不是百分百跨平台。例如它的recursive参数仅支持macOS和windows。fs.watch的底层通知机制在不同平台上的实现是不同的,如果底层不支持某个特性,那么fs.watch也是不能支持的。另外回调函数中的filename参数,也是不保证一定存在。
    • fs.watch()比fs.watchFile()更高效,可能的话,尽量使用前者。


3. 参考

来源:https://segmentfault.com/a/1190000017359113



站长推荐

1.云服务推荐: 国内主流云服务商,各类云产品的最新活动,优惠券领取。地址:阿里云腾讯云华为云

2.广告联盟: 整理了目前主流的广告联盟平台,如果你有流量,可以作为参考选择适合你的平台点击进入

链接: http://www.fly63.com/article/detial/1570

关闭

关于 Node.js 里 ES6 Modules 的一次更新说明

关于 Node.js 里 ES6 Modules 的一次更新说明,总结来说:CommonJS 与 ES6 Modules 之间的关键不同在于代码什么时候知道一个模块的结构和使用它。

nodejs 文本逐行读写功能的实现

利用nodejs实现:逐行读写(从一个文件逐行复制到另外一个文件);逐行读取、处理和写入(读取一行,处理后,写入另一个文件)1.所需要的模块: fs,os,readline。功能的实现:readWriteFileByLine.js,功能的调用:index.js

node初步学习

Node.js 是单进程单线程应用程序,但是因为 V8 引擎提供的异步执行回调接口,通过这些接口可以处理大量的并发,所以性能非常高。Node.js 几乎每一个 API 都是支持回调函数的

深入解析Node.js Event Loop各阶段

今天小编就为大家分享一篇关于Node.js Event Loop各阶段讲解,写的十分的全面细致,具有一定的参考价值,对此有需要的朋友可以参考学习下。timer阶段处理setTimeout于setInterval回调,开始处理的时机与poll阶段有关联。

基于node服务器的大文件(G级)上传

3G的大文件分1500个2M二进度文件,通post方法发送给node服务,服务器全部接收到文件后,进组装生成你上文件。

node.js+react.js+xterm.js构建webssh

先讲一下简单的原理:前端和后端的通信,使用的是socket.js,后端连接服务器,使用的是ssh2.js,页面显示出控制台这个操作页面,使用的是xterm.js。整个工作流程就是:前端在xterm.js里面输入文字,通过socket和后端通信

node有哪些弊端及优点?

Node 是一个让 JavaScript 运行在服务端的开发平台,它让JavaScript成为与PHP、Python、Perl、Ruby 等服务端语言平起平坐的脚本语言。使用node有很多好处但也存在一些弊端,下面就然我们来看一下nodejs有哪些弊端。

当node升级后导致webpack打包出错,node-saas出问题的解决办法

node-saas就需要python环境了,所以很多人又不知道,就升级了node,导致node-saas无法使用了,结果导致node-saas出错,解决办法如下:npm install -g node-gyp ,npm install --global --production windows-build-tools

node.js反向代理的实现

在实际工程开发中,会有前后端分离的需求。使用node.js反向代理的目的:实现前后端分离,前端减少路径请求的所需的路由文件;通过http-proxy-middleware中间件、Http Proxy 模块这2种方式实现node.js的反向代理

为什么NodeJS那么流行?

Node.js用于创建和运行各种类型的Web应用程序,这与其他一些框架类似。在Nodejs开发中,JavaScript用作主要语言。该节点程序包管理器(NPM)具有由轻量级的内置Web服务器,它允许您自定义应用程序构建满足您的需求管理插件过量。

点击更多...

内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!