Node.js 官网入门教程（五） 文件模块fs、path、操作系统模块os、事件模块emitter、http 模块、Buffer、流（stream模块）、错误处理、开发生产环境、TypeScript

Node.js 官网入门教程（五） 文件系统模块fs、路径模块path、操作系统模块os、事件模块emitter、http 模块、Buffer、流（stream模块）、错误处理、开发生产环境、TypeScript

总结：

• 通用

  • Node.js安装包：http://nodejs.cn/download/。

  • API检索网址：API 文档 | Node.js 中文网 (nodejs.cn)

  • 第三方模板引擎：art-template官方文档

  • npm init 生成 package.json文件。

  • Express:

    • 提供了创建 Web 服务器的最简单但功能最强大的方法之一。 它的极简主义方法，专注于服务器的核心功能，是其成功的关键。
    • 基于 Node.js 平台，快速、开放、极简的 Web 开发框架。

  • koa: 由 Express 背后的同一个团队构建，旨在变得更简单更轻巧。 新项目的诞生是为了满足创建不兼容的更改而又不破坏现有社区。

  • readyState

    • 存有 XMLHttpRequest 的状态。从 0 到 4 发生变化。
    • 0: 请求未初始化
    • 1: 服务器连接已建立
    • 2: 请求已接收
    • 3: 请求处理中
    • 4: 请求已完成，且响应已就绪

  • status

    • 200, OK，访问正常
    • 301, Moved Permanently，永久移动
    • 302, Moved temporarily，暂时移动
    • 304, Not Modified，未修改
    • 307, Temporary Redirect，暂时重定向
    • 401, Unauthorized，未授权
    • 403, Forbidden，禁止访问
    • 404, Not Found，未发现指定网址
    • 500, Internal Server Error，服务器发生错误

  • MIME Type

    • MIME (Multipurpose Internet Mail Extensions) 是描述消息内容类型的因特网标准，说白了也就是文件的媒体类型。浏览器可以根据它来区分文件，然后决定什么内容用什么形式来显示。

    • 首先，我们要了解浏览器是如何处理内容的。在浏览器中显示的内容有 HTML、有 XML、有 GIF、还有 Flash ……那么，浏览器是如何区分它们，决定什么内容用什么形式来显示呢？答案是 MIME Type，也就是该资源的媒体类型。

    • 媒体类型通常是通过 HTTP 协议，由 Web 服务器告知浏览器的，更准确地说，是通过 Content-Type 来表示的，例如:

      Content-Type: text/HTML

      • 表示内容是 text/HTML 类型，也就是超文本文件。为什么是“text/HTML”而不是“HTML/text”或者别的什么？MIME Type 不是个人指定的，是经过 ietf 组织协商，以 RFC 的形式作为建议的标准发布在网上的，大多数的 Web 服务器和用户代理都会支持这个规范 (顺便说一句，Email 附件的类型也是通过 MIME Type 指定的)。

• CLI

  • 命令行界面（英语：command-line interface，缩写：CLI）是在图形用户界面得到普及之前使用最为广泛的用户界面，它通常不支持鼠标，用户通过键盘输入指令，计算机接收到指令后，予以执行。也有人称之为字符用户界面（CUI）。
  • 通常认为，命令行界面（CLI）没有图形用户界面（GUI）那么方便用户操作。因为，命令行界面的软件通常需要用户记忆操作的命令，但是，由于其本身的特点，命令行界面要较图形用户界面节约计算机系统的资源。在熟记命令的前提下，使用命令行界面往往要较使用图形用户界面的操作速度要快。所以，图形用户界面的操作系统中，都保留着可选的命令行界面。

• buffer

• Buffer 是内存区域。可以将 buffer 视为整数数组，每个整数代表一个数据字节。

• Buffer 被引入用以帮助开发者处理二进制数据，在此生态系统中传统上只处理字符串而不是二进制数据。

  Buffer 与流紧密相连。 当流处理器接收数据的速度快于其消化的速度时，则会将数据放入 buffer 中。

  一个简单的场景是：当观看 YouTube 视频时，红线超过了观看点：即下载数据的速度比查看数据的速度快，且浏览器会对数据进行缓冲。

• 流

  • 流是为 Node.js 应用程序提供动力的基本概念之一。它们是一种以高效的方式处理读/写文件、网络通信、或任何类型的端到端的信息交换。

  • Node.js 的 stream 模块 提供了构建所有流 API 的基础。 所有的流都是 EventEmitter 的实例。

  • 优点

    • 内存效率: 无需加载大量的数据到内存中即可进行处理。
    • 时间效率: 当获得数据之后即可立即开始处理数据，这样所需的时间更少，而不必等到整个数据有效负载可用才开始。

  • stream.pipe(res)

    • 它获取来源流，并将其通过管道传输到目标流。

    • pipe() 方法的返回值是目标流，这是非常方便的事情，它使得可以链接多个 pipe() 调用，如下所示：

      src.pipe(dest1).pipe(dest2)
      

  • 分类

    • Readable: 可以通过管道读取、但不能通过管道写入的流（可以接收数据，但不能向其发送数据）。 当推送数据到可读流中时，会对其进行缓冲，直到使用者开始读取数据为止。
    • Writable: 可以通过管道写入、但不能通过管道读取的流（可以发送数据，但不能从中接收数据）。
    • Duplex: 可以通过管道写入和读取的流，基本上相对于是可读流和可写流的组合。
    • Transform: 类似于双工流、但其输出是其输入的转换的转换流。

• TypeScript

  • 它是 JavaScript 的超集，为语言增加了新的功能。
  • 最值得注意的新功能是静态类型定义，这是普通 JavaScript 中所没有的。
  • 多亏于类型，我们可以声明期望的参数类型，以及在函数中确切返回的参数，或者所创建对象的确切是什么。
  • TypeScript 是一个非常强大的工具，它在 JavaScript 项目中开辟了可能性的新世界。
  • 通过在代码交付之前防止大量错误，它使我们的代码更安全，更健壮 - 它会在编写代码时发现问题，并与 Visual Studio Code 这样的代码编辑器完美集成。

1. Node.js 文件系统模块

fs 模块提供了许多非常实用的函数来访问文件系统并与文件系统进行交互。

无需安装。 作为 Node.js 核心的组成部分，可以通过简单地引用来使用它：

const fs = require('fs')

一旦这样做，就可以访问其所有的方法，包括：

• fs.access(): 检查文件是否存在，以及 Node.js 是否有权限访问。
• fs.appendFile(): 追加数据到文件。如果文件不存在，则创建文件。
• fs.chmod(): 更改文件（通过传入的文件名指定）的权限。相关方法：fs.lchmod()、fs.fchmod()。
• fs.chown(): 更改文件（通过传入的文件名指定）的所有者和群组。相关方法：fs.fchown()、fs.lchown()。
• fs.close(): 关闭文件描述符。
• fs.copyFile(): 拷贝文件。
• fs.createReadStream(): 创建可读的文件流。
• fs.createWriteStream(): 创建可写的文件流。
• fs.link(): 新建指向文件的硬链接。
• fs.mkdir(): 新建文件夹。
• fs.mkdtemp(): 创建临时目录。
• fs.open(): 设置文件模式。
• fs.readdir(): 读取目录的内容。
• fs.readFile(): 读取文件的内容。相关方法：fs.read()。
• fs.readlink(): 读取符号链接的值。
• fs.realpath(): 将相对的文件路径指针（.、..）解析为完整的路径。
• fs.rename(): 重命名文件或文件夹。
• fs.rmdir(): 删除文件夹。
• fs.stat(): 返回文件（通过传入的文件名指定）的状态。相关方法：fs.fstat()、fs.lstat()。
• fs.symlink(): 新建文件的符号链接。
• fs.truncate(): 将传递的文件名标识的文件截断为指定的长度。相关方法：fs.ftruncate()。
• fs.unlink(): 删除文件或符号链接。
• fs.unwatchFile(): 停止监视文件上的更改。
• fs.utimes(): 更改文件（通过传入的文件名指定）的时间戳。相关方法：fs.futimes()。
• fs.watchFile(): 开始监视文件上的更改。相关方法：fs.watch()。
• fs.writeFile(): 将数据写入文件。相关方法：fs.write()。

关于 fs 模块的特殊之处是，所有的方法默认情况下都是异步的，但是通过在前面加上 Sync 也可以同步地工作。

例如：

• fs.rename()
• fs.renameSync()
• fs.write()
• fs.writeSync()

这在应用程序流程中会产生巨大的差异。

Node.js 10 包含了对基于 promise API 的实验性支持。

例如，试验一下 fs.rename() 方法。 异步的 API 会与回调一起使用：

const fs = require('fs')

fs.rename('before.json', 'after.json', err => {
   
  if (err) {
   
    return console.error(err)
  }

  //完成
})

同步的 API 则可以这样使用，并使用 try/catch 块来处理错误：

const fs = require('fs')

try {
   
  fs.renameSync('before.json', 'after.json')
  //完成
} catch (err) {
   
  console.error(err)
}

此处的主要区别在于，在第二个示例中，脚本的执行会阻塞，直到文件操作成功。

2. Node.js 路径模块

path 模块提供了许多非常实用的函数来访问文件系统并与文件系统进行交互。

无需安装。 作为 Node.js 核心的组成部分，可以通过简单地引用来使用它：

const path = require('path')

该模块提供了 path.sep（作为路径段分隔符，在 Windows 上是 \，在 Linux/macOS 上是 /）和 path.delimiter（作为路径定界符，在 Windows 上是 ;，在 Linux/macOS 上是 :）。

还有这些 path 方法：

path.basename()

返回路径的最后一部分。 第二个参数可以过滤掉文件的扩展名：

require('path').basename('/test/something') //something
require('path').basename('/test/something.txt') //something.txt
require('path').basename('/test/something.txt', '.txt') //something

path.dirname()

返回路径的目录部分：

require('path').dirname('/test/something') // /test
require('path').dirname('/test/something/file.txt') // /test/something

path.extname()

返回路径的扩展名部分。

require('path').extname('/test/something') // ''
require('path').extname('/test/something/file.txt') // '.txt'

path.isAbsolute()

如果是绝对路径，则返回 true。

require('path').isAbsolute('/test/something') // true
require('path').isAbsolute('./test/something') // false

path.join()

连接路径的两个或多个部分：

const name = 'joe'
require('path').join('/', 'users', name, 'notes.txt') //'/users/joe/notes.txt'

path.normalize()

当包含类似 .、.. 或双斜杠等相对的说明符时，则尝试计算实际的路径：

require('path').normalize('/users/joe/..//test.txt') //'/users/test.txt'

path.parse()

解析对象的路径为组成其的片段：

• root: 根路径。
• dir: 从根路径开始的文件夹路径。
• base: 文件名 + 扩展名
• name: 文件名
• ext: 文件扩展名

例如：

require('path').parse('/users/test.txt')

结果是：

{
   
  root: '/',
  dir: '/users',
  base: 'test.txt',
  ext: '.txt',
  name: 'test'
}

path.relative()

接受 2 个路径作为参数。 基于当前工作目录，返回从第一个路径到第二个路径的相对路径。

例如：

require('path').relative('/Users/joe', '/Users/joe/test.txt') //'test.txt'
require('path').relative('/Users/joe', '/Users/joe/something/test.txt') //'something/test.txt'

path.resolve()

可以使用 path.resolve() 获得相对路径的绝对路径计算：

path.resolve('joe.txt') //'/Users/joe/joe.txt' 如果从主文件夹运行

通过指定第二个参数，resolve 会使用第一个参数作为第二个参数的基准：

path.resolve('tmp', 'joe.txt') //'/Users/joe/tmp/joe.txt' 如果从主文件夹运行

如果第一个参数以斜杠开头，则表示它是绝对路径：

path.resolve('/etc', 'joe.txt') //'/etc/joe.txt'

3. Node.js 操作系统模块

该模块提供了许多函数，可用于从底层的操作系统和程序运行所在的计算机上检索信息并与其进行交互。

const os = require('os')

有一些有用的属性可以告诉我们一些与处理文件有关的关键事项：

os.EOL 可给出行定界符序列。 在 Linux 和 macOS 上为 \n，在 Windows 上为 \r\n。

os.constants.signals 可告知所有与处理过程信号相关的常量，例如 SIGHUP、SIGKILL 等。

os.constants.errno 可设置用于错误报告的常量，例如 EADDRINUSE、EOVERFLOW 等。

可以在 http://nodejs.cn/api/os.html#os_signal_constants 上阅读所有的内容。

现在看一下 os 提供的主要方法：

os.arch()

返回标识底层架构的字符串，例如 arm、x64、arm64。

os.cpus()

返回关于系统上可用的 CPU 的信息。

例如：

[
  {
   
    model: 'Intel(R) Core(TM)2 Duo CPU     P8600  @ 2.40GHz',
    speed: 2400,
    times: {
   
      user: 281685380,
      nice: 0,
      sys: 187986530,
      idle: 685833750,
      irq: 0
    }
  },
  {
   
    model: 'Intel(R) Core(TM)2 Duo CPU     P8600  @ 2.40GHz',
    speed: 2400,
    times: {
   
      user: 282348700,
      nice: 0,
      sys: 161800480,
      idle: 703509470,
      irq: 0
    }
  }
]

os.endianness()

根据是使用大端序或小端序编译 Node.js，返回 BE 或 LE。

os.freemem()

返回代表系统中可用内存的字节数。

os.homedir()

返回到当前用户的主目录的路径。

例如：

'/Users/joe'

os.hostname()

返回主机名。

os.loadavg()

返回操作系统对平均负载的计算。

这仅在 Linux 和 macOS 上返回有意义的值。

例如：

[3.68798828125, 4.00244140625, 11.1181640625]

os.networkInterfaces()