Node.js从入门到实战（二）

左手的ㄟ右手 2022-05-21 05:24 194阅读 0赞

一、Node.js中的模块

Node.js使用require引入依赖的模块，因此模块是Node.js中的重要组成部分，这篇博客主要罗列一下常用的Node.js模块，并且在后期会添加在工作中用到的模块参考备用。

二、Node.js EventEmitter

Node.js 所有的异步 I/O 操作在完成时都会发送一个事件到事件队列。Node.js里面的许多对象都会分发事件，所有这些产生事件的对象都是 events.EventEmitter 的实例。

events 模块只提供了一个对象： events.EventEmitter。EventEmitter 的核心就是事件触发与事件监听器功能的封装。你可以通过require("events");来访问该模块。

1.  *// 引入 events 模块*
2.  var events = require( 'events');
3.  *// 创建 eventEmitter 对象*
4.  var eventEmitter = new events.EventEmitter();

EventEmitter 的每个事件由一个事件名和若干个参数组成，事件名是一个字符串，通常表达一定的语义。对于每个事件，EventEmitter 支持 若干个事件监听器。当事件触发时，注册到这个事件的事件监听器被依次调用，事件参数作为回调函数参数传递。

1.  *//event.js 文件*
2.  var events = require( 'events');
3.  var emitter = new events.EventEmitter();
4.  emitter.on( 'someEvent', function(arg1, arg2) \{
5.  console.log( 'listener1', arg1, arg2);
6.  \});
7.  emitter.on( 'someEvent', function(arg1, arg2) \{
8.  console.log( 'listener2', arg1, arg2);
9.  \});
10. emitter.emit( 'someEvent', 'arg1 参数', 'arg2 参数');

emitter 为事件 someEvent 注册了两个事件监听器，然后触发了 someEvent 事件。运行结果中可以看到两个事件监听器回调函数被先后调用。 这就是EventEmitter最简单的用法。EventEmitter 提供了多个属性，如 on 和 emit。 on 函数用于绑定事件函数，emit 属性用于触发一个事件 。接下来我们来具体看下 EventEmitter 的 [属性介绍][Link 1] 。

<table style="border-spacing:0px;color:rgb(51,51,51);background-color:rgb(255,255,255);border:0px;font-family:'Helvetica Neue', Helvetica, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', 'Noto Sans CJK SC', 'WenQuanYi Micro Hei', Arial, sans-serif;font-size:12px;"> 
 <tbody> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <th style="border-color:rgb(85,85,85);color:rgb(255,255,255);background-color:rgb(85,85,85);vertical-align:top;">序号</th> 
 <th style="border-color:rgb(85,85,85);color:rgb(255,255,255);background-color:rgb(85,85,85);vertical-align:top;">方法 &amp; 描述</th> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">1</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">addListener(event, listener) 为指定事件添加一个监听器到监听器数组的尾部。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">2</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">on(event, listener) 为指定事件注册一个监听器，接受一个字符串 event 和一个回调函数。<pre style="font-family:Menlo, Monaco, Consolas, 'Andale Mono', 'lucida console', 'Courier New', monospace;background-color:rgb(251,251,251);border-width:1px 1px 1px 4px;border-style:solid;border-color:rgb(221,221,221);">server.on('connection', function (stream) {
 
 console.log('someone connected!');
});</pre></td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">3</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">once(event, listener) 为指定事件注册一个单次监听器，即 监听器最多只会触发一次，触发后立刻解除该监听器。<pre style="font-family:Menlo, Monaco, Consolas, 'Andale Mono', 'lucida console', 'Courier New', monospace;background-color:rgb(251,251,251);border-width:1px 1px 1px 4px;border-style:solid;border-color:rgb(221,221,221);">server.once('connection', function (stream) {
 
 console.log('Ah, we have our first user!');
});</pre></td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">4</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">removeListener(event, listener) 移除指定事件的某个监听器，监听器必须是该事件已经注册过的监听器。它接受两个参数，第一个是事件名称，第二个是回调函数名称。<pre style="font-family:Menlo, Monaco, Consolas, 'Andale Mono', 'lucida console', 'Courier New', monospace;background-color:rgb(251,251,251);border-width:1px 1px 1px 4px;border-style:solid;border-color:rgb(221,221,221);">var callback = function(stream) {
 
 console.log('someone connected!');
};
server.on('connection', callback);
// ...
server.removeListener('connection', callback);</pre></td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">5</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">removeAllListeners([event]) 移除所有事件的所有监听器， 如果指定事件，则移除指定事件的所有监听器。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">6</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">setMaxListeners(n) 默认情况下， EventEmitters 如果你添加的监听器超过 10 个就会输出警告信息。 setMaxListeners 函数用于提高监听器的默认限制的数量。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">7</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">listeners(event) 返回指定事件的监听器数组。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">8</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">emit(event, [arg1], [arg2], [...]) 按参数的顺序执行每个监听器，如果事件有注册监听返回 true，否则返回 false。</td> 
 </tr> 
 </tbody> 
</table>

### 类方法 ###

### 事件 ###

EventEmitter 定义了一个特殊的事件 error，它包含了错误的语义，我们在遇到 异常的时候通常会触发 error 事件。当 error 被触发时，EventEmitter 规定如果没有响 应的监听器，Node.js 会把它当作异常，退出程序并输出错误信息。我们一般要为会触发 error 事件的对象设置监听器，避免遇到错误后整个程序崩溃。例如：

1.  var events = require( 'events');
2.  var emitter = new events.EventEmitter();
3.  emitter.emit( 'error');

运行时会显示以下错误：

node.js:201 
 throw e; // process.nextTick error, or 'error' event on first tick 
 ^ 
 Error: Uncaught, unspecified 'error' event. 
 at EventEmitter.emit (events.js:50:15) 
 at Object.<anonymous> (/home/byvoid/error.js:5:9) 
 at Module._compile (module.js:441:26) 
 at Object..js (module.js:459:10) 
 at Module.load (module.js:348:31) 
 at Function._load (module.js:308:12) 
 at Array.0 (module.js:479:10) 
 at EventEmitter._tickCallback (node.js:192:40)

三、Node.js Buffer

JavaScript 语言自身只有字符串数据类型，没有二进制数据类型。但在处理像TCP流或文件流时，必须使用到二进制数据。因此在 Node.js中，定义了一个 Buffer 类，该类用来创建一个专门存放二进制数据的缓存区。在 Node.js 中，Buffer 类是随 Node 内核一起发布的核心库。Buffer 库为 Node.js 带来了一种存储原始数据的方法，可以让 Node.js 处理二进制数据，每当需要在 Node.js 中处理I/O操作中移动的数据时，就有可能使用 Buffer 库。原始数据存储在 Buffer 类的实例中。一个 Buffer 类似于一个整数数组，但它对应于 V8 堆内存之外的一块原始内存。

Buffer 实例一般用于表示编码字符的序列，比如 UTF-8 、 UCS2 、 Base64 、或十六进制编码的数据。 通过使用显式的字符编码，就可以在 Buffer 实例与普通的 JavaScript 字符串之间进行相互转换。Node.js 目前支持的字符编码包括：

1.  ascii - 仅支持 7 位 ASCII 数据。如果设置去掉高位的话，这种编码是非常快的。
2.  utf8 - 多字节编码的 Unicode 字符。许多网页和其他文档格式都使用 UTF-8 。
3.  utf16le - 2 或 4 个字节，小字节序编码的 Unicode 字符。支持代理对（U+10000 至 U+10FFFF）。
4.  ucs2 - utf16le 的别名。
5.  base64 - Base64 编码。
6.  latin1 - 一种把 Buffer 编码成一字节编码的字符串的方式。
7.  binary - latin1 的别名。
8.  hex - 将每个字节编码为两个十六进制字符。

Buffer类中的方法如下：

buf.writeUIntLE(0x1234567890ab, 0, 6);

// 输出: &lt;Buffer ab 90 78 56 34 12&gt;
console.log(buf);</pre>noAssert 值为 true 时，不再验证 value 和 offset 的有效性。 默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">7</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeUIntBE(value, offset, byteLength[, noAssert]) 将 value 写入到 buffer 里， 它由 offset 和 byteLength 决定，最高支持 48 位无符号整数，大端对齐。noAssert 值为 true 时，不再验证 value 和 offset 的有效性。 默认是 false。<pre style="font-family:Menlo, Monaco, Consolas, 'Andale Mono', 'lucida console', 'Courier New', monospace;background-color:rgb(251,251,251);border-width:1px 1px 1px 4px;border-style:solid;border-color:rgb(221,221,221);">const buf = Buffer.allocUnsafe(6);

buf.writeUIntBE(0x1234567890ab, 0, 6);

// 输出: &lt;Buffer 12 34 56 78 90 ab&gt;
console.log(buf);</pre></td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">8</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeIntLE(value, offset, byteLength[, noAssert]) 将value 写入到 buffer 里， 它由offset 和 byteLength 决定，最高支持48位有符号整数，小端对齐。noAssert 值为 true 时，不再验证 value 和 offset 的有效性。 默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">9</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeIntBE(value, offset, byteLength[, noAssert]) 将value 写入到 buffer 里， 它由offset 和 byteLength 决定，最高支持48位有符号整数，大端对齐。noAssert 值为 true 时，不再验证 value 和 offset 的有效性。 默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">10</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readUIntLE(offset, byteLength[, noAssert]) 支持读取 48 位以下的无符号数字，小端对齐。noAssert 值为 true 时， offset 不再验证是否超过 buffer 的长度，默认为 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">11</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readUIntBE(offset, byteLength[, noAssert]) 支持读取 48 位以下的无符号数字，大端对齐。noAssert 值为 true 时， offset 不再验证是否超过 buffer 的长度，默认为 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">12</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readIntLE(offset, byteLength[, noAssert]) 支持读取 48 位以下的有符号数字，小端对齐。noAssert 值为 true 时， offset 不再验证是否超过 buffer 的长度，默认为 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">13</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readIntBE(offset, byteLength[, noAssert]) 支持读取 48 位以下的有符号数字，大端对齐。noAssert 值为 true 时， offset 不再验证是否超过 buffer 的长度，默认为 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">14</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.toString([encoding[, start[, end]]]) 根据 encoding 参数（默认是 'utf8'）返回一个解码过的 string 类型。还会根据传入的参数 start (默认是 0) 和 end (默认是 buffer.length)作为取值范围。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">15</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.toJSON() 将 Buffer 实例转换为 JSON 对象。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">16</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf[index] 获取或设置指定的字节。返回值代表一个字节，所以返回值的合法范围是十六进制0x00到0xFF 或者十进制0至 255。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">17</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.equals(otherBuffer) 比较两个缓冲区是否相等，如果是返回 true，否则返回 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">18</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.compare(otherBuffer) 比较两个 Buffer 对象，返回一个数字，表示 buf 在 otherBuffer 之前，之后或相同。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">19</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.copy(targetBuffer[, targetStart[, sourceStart[, sourceEnd]]]) buffer 拷贝，源和目标可以相同。 targetStart 目标开始偏移和 sourceStart 源开始偏移默认都是 0。 sourceEnd 源结束位置偏移默认是源的长度 buffer.length 。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">20</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.slice([start[, end]]) 剪切 Buffer 对象，根据 start(默认是 0 ) 和 end (默认是 buffer.length ) 偏移和裁剪了索引。 负的索引是从 buffer 尾部开始计算的。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">21</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readUInt8(offset[, noAssert]) 根据指定的偏移量，读取一个无符号 8 位整数。若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 如果这样 offset 可能会超出buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">22</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readUInt16LE(offset[, noAssert]) 根据指定的偏移量，使用特殊的 endian 字节序格式读取一个无符号 16 位整数。若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出 buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">23</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readUInt16BE(offset[, noAssert]) 根据指定的偏移量，使用特殊的 endian 字节序格式读取一个无符号 16 位整数，大端对齐。若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出 buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">24</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readUInt32LE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian 字节序格式读取一个无符号 32 位整数，小端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">25</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readUInt32BE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian 字节序格式读取一个无符号 32 位整数，大端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">26</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readInt8(offset[, noAssert]) 根据指定的偏移量，读取一个有符号 8 位整数。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出 buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">27</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readInt16LE(offset[, noAssert]) 根据指定的偏移量，使用特殊的 endian 格式读取一个 有符号 16 位整数，小端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出 buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">28</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readInt16BE(offset[, noAssert]) 根据指定的偏移量，使用特殊的 endian 格式读取一个 有符号 16 位整数，大端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出 buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">29</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readInt32LE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian 字节序格式读取一个有符号 32 位整数，小端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">30</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readInt32BE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian 字节序格式读取一个有符号 32 位整数，大端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">31</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readFloatLE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian 字节序格式读取一个 32 位双浮点数，小端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">32</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readFloatBE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian 字节序格式读取一个 32 位双浮点数，大端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">33</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readDoubleLE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian字节序格式读取一个 64 位双精度数，小端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">34</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.readDoubleBE(offset[, noAssert]) 根据指定的偏移量，使用指定的 endian字节序格式读取一个 64 位双精度数，大端对齐。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 offset 可能会超出buffer 的末尾。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">35</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeUInt8(value, offset[, noAssert]) 根据传入的 offset 偏移量将 value 写入 buffer。注意：value 必须是一个合法的无符号 8 位整数。 若参数 noAssert 为 true 将不会验证 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出 buffer 的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">36</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeUInt16LE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个合法的无符号 16 位整数，小端对齐。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出buffer的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">37</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeUInt16BE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个合法的无符号 16 位整数，大端对齐。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出buffer的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">38</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeUInt32LE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式(LITTLE-ENDIAN:小字节序)将 value 写入buffer。注意：value 必须是一个合法的无符号 32 位整数，小端对齐。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着value 可能过大，或者offset可能会超出buffer的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">39</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeUInt32BE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式(Big-Endian:大字节序)将 value 写入buffer。注意：value 必须是一个合法的有符号 32 位整数。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者offset可能会超出buffer的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">40</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeInt8(value, offset[, noAssert])&lt;br根据传入的 offset="" 偏移量将="" value="" 写入="" buffer="" 。注意：value="" 必须是一个合法的="" signed="" 8="" 位整数。="" 若参数="" noassert="" 为="" true="" 将不会验证="" 和="" 偏移量参数。="" 这意味着="" 可能过大，或者="" 可能会超出="" 的末尾从而造成="" 被丢弃。="" 除非你对这个参数非常有把握，否则尽量不要使用。默认是="" false。&lt;="" td=""&gt;</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">41</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeInt16LE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个合法的 signed 16 位整数。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出 buffer 的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false 。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">42</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeInt16BE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个合法的 signed 16 位整数。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出 buffer 的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false 。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">43</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeInt32LE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个合法的 signed 32 位整数。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出 buffer 的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">44</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeInt32BE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个合法的 signed 32 位整数。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出 buffer 的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">45</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeFloatLE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer 。注意：当 value 不是一个 32 位浮点数类型的值时，结果将是不确定的。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value可能过大，或者 offset 可能会超出 buffer 的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">46</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeFloatBE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer 。注意：当 value 不是一个 32 位浮点数类型的值时，结果将是不确定的。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value可能过大，或者 offset 可能会超出 buffer 的末尾从而造成 value 被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">47</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeDoubleLE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个有效的 64 位double 类型的值。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出 buffer 的末尾从而造成value被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">48</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.writeDoubleBE(value, offset[, noAssert]) 根据传入的 offset 偏移量和指定的 endian 格式将 value 写入 buffer。注意：value 必须是一个有效的 64 位double 类型的值。 若参数 noAssert 为 true 将不会验证 value 和 offset 偏移量参数。 这意味着 value 可能过大，或者 offset 可能会超出 buffer 的末尾从而造成value被丢弃。 除非你对这个参数非常有把握，否则尽量不要使用。默认是 false。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">49</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">buf.fill(value[, offset][, end]) 使用指定的 value 来填充这个 buffer。如果没有指定 offset (默认是 0) 并且 end (默认是 buffer.length) ，将会填充整个buffer。</td> 
 </tr> 
 </tbody> 
</table>

# 四、Node.js Stream #

Stream 是一个抽象接口，Node 中有很多对象实现了这个接口。例如，对http 服务器发起请求的request 对象就是一个 Stream，还有stdout（标准输出）。Node.js，Stream 有四种流类型：

1.  Readable - 可读操作。
2.  Writable - 可写操作。
3.  Duplex - 可读可写操作.
4.  Transform - 操作被写入数据，然后读出结果。

所有的 Stream 对象都是 EventEmitter 的实例。常用的事件有：

1.  data - 当有数据可读时触发。
2.  end - 没有更多的数据可读时触发。
3.  error - 在接收和写入过程中发生错误时触发。
4.  finish - 所有数据已被写入到底层系统时触发。

如下代码展示了Stream ReadStream的用法：

1.  var fs = require( "fs");
2.  var data = '';
3.  
4.  *// 创建可读流*
5.  var readerStream = fs.createReadStream( 'input.txt');
6.  
7.  *// 设置编码为 utf8。*
8.  readerStream.setEncoding( 'UTF8');
9.  
10. *// 处理流事件 --> data, end, and error*
11. readerStream.on( 'data', function(chunk) \{
12. data += chunk;
13. \});
14. 
15. readerStream.on( 'end', function()\{
16. console.log(data);
17. \});
18. 
19. readerStream.on( 'error', function(err)\{
20. console.log(err.stack);
21. \});
22. 
23. console.log( "程序执行完毕");

如下代码显示了Stream WriteStream的用法：

1.  var fs = require( "fs");
2.  var data = '菜鸟教程官网地址：www.runoob.com';
3.  
4.  *// 创建一个可以写入的流，写入到文件 output.txt 中*
5.  var writerStream = fs.createWriteStream( 'output.txt');
6.  
7.  *// 使用 utf8 编码写入数据*
8.  writerStream.write(data, 'UTF8');
9.  
10. *// 标记文件末尾*
11. writerStream.end();
12. 
13. *// 处理流事件 --> data, end, and error*
14. writerStream.on( 'finish', function() \{
15. console.log( "写入完成。");
16. \});
17. 
18. writerStream.on( 'error', function(err)\{
19. console.log(err.stack);
20. \});
21. 
22. console.log( "程序执行完毕");

Stream具备管道流和链式流两种用法：

管道流：

1.  var fs = require( "fs");
2.  
3.  *// 创建一个可读流*
4.  var readerStream = fs.createReadStream( 'input.txt');
5.  
6.  *// 创建一个可写流*
7.  var writerStream = fs.createWriteStream( 'output.txt');
8.  
9.  *// 管道读写操作*
10. *// 读取 input.txt 文件内容，并将内容写入到 output.txt 文件中*
11. readerStream.pipe(writerStream);
12. 
13. console.log( "程序执行完毕");

管道流可以处理读写操作。

链式流：

链式是通过连接输出流到另外一个流并创建多个流操作链的机制。链式流一般用于管道操作。

接下来我们就是用管道和链式来压缩和解压文件。创建 compress.js 文件, 代码如下：

1.  var fs = require( "fs");
2.  var zlib = require( 'zlib');
3.  
4.  *// 压缩 input.txt 文件为 input.txt.gz*
5.  fs.createReadStream( 'input.txt')
6.  .pipe(zlib.createGzip())
7.  .pipe(fs.createWriteStream( 'input.txt.gz'));
8.  
9.  console.log( "文件压缩完成。");

五、Node.js路由

Node.js路由中对HTTP请求的URL的解析需要依赖以下url 和querystring 模块：

url.parse(string).query
                                               |
               url.parse(string).pathname      |
                           |                   |
                           |                   |
                         ------ -------------------
    http://localhost:8888/start?foo=bar&hello=world
                                    ---       -----
                                     |          |
                                     |          |
                  querystring.parse(queryString)["foo"]    |
                                                |
                             querystring.parse(queryString)["hello"]

现在我们来给 onRequest() 函数加上一些逻辑，用来找出浏览器请求的 URL 路径，server.js文件的内容如下：

1.  var http = require( "http");
2.  var url = require( "url");
3.  
4.  function start() \{
5.  function onRequest(request, response) \{
6.  var pathname = url.parse(request.url).pathname;
7.  console.log( "Request for " \+ pathname + " received.");
8.  response.writeHead( 200, \{ "Content-Type": "text/plain"\});
9.  response.write( "Hello World");
10. response.end();
11. \}
12. 
13. http.createServer(onRequest).listen( 8888);
14. console.log( "Server has started.");
15. \}
16. 
17. exports.start = start;

此时的server并无区分pathname映射的能力，如下添加router.js用于处理来自不同路径的请求：

1.  function route(pathname) \{
2.  console.log( "About to route a request for " \+ pathname);
3.  \}
4.  
5.  exports.route = route;

首先，我们来扩展一下服务器的 start() 函数，以便将路由函数作为参数传递过去：

1.  var http = require( "http");
2.  var url = require( "url");
3.  
4.  function start(route) \{
5.  function onRequest(request, response) \{
6.  var pathname = url.parse(request.url).pathname;
7.  console.log( "Request for " \+ pathname + " received.");
8.  
9.  route(pathname);
10. 
11. response.writeHead( 200, \{ "Content-Type": "text/plain"\});
12. response.write( "Hello World");
13. response.end();
14. \}
15. 
16. http.createServer(onRequest).listen( 8888);
17. console.log( "Server has started.");
18. \}
19. 
20. exports.start = start;

同时，我们会相应扩展 index.js，使得路由函数可以被注入到服务器中：

1.  var server = require( "./server");
2.  var router = require( "./router");
3.  
4.  server.start(router.route);

此时请求localhost:8888时即经过了router的处理。

# 五、Node.js 全局变量 #

JavaScript 中有一个特殊的对象，称为全局对象（Global Object），它及其所有属性都可以在程序的任何地方访问，即全局变量。  
在浏览器 JavaScript 中，通常 window 是全局对象， 而 Node.js 中的全局对象是 global，所有全局变量（除了 global 本身以外）都是 global 对象的属性。在 Node.js 我们可以直接访问到 global 的属性，而不需要在应用中包含它。

global 最根本的作用是作为全局变量的宿主。按照 ECMAScript 的定义，满足以下条 件的变量是全局变量：

1.  在最外层定义的变量；
2.  全局对象的属性；
3.  隐式定义的变量（未定义直接赋值的变量）。

当你定义一个全局变量时，这个变量同时也会成为全局对象的 属性 ，反之亦然。需要注意的是，在 Node.js 中你不可能在最外层定义变量，因为所有用户代码都是属于当前模块的， 而模块本身不是最外层上下文。  
注意： 永远使用 var 定义变量以 避免引入全局变量 ，因为全局变量会污染 命名空间，提高代码的耦合风险。  
Node.js中常用的全局变量有：

1.  \_\_filename                    \_\_filename 表示当前正在执行的脚本的文件名。它将输出文件所在位置的绝对路径，且和命令行参数所指定的文件名不一定相同。 如果在模块中，返回的值是模块文件的路径。
2.  \_\_dirname                     \_\_dirname 表示当前执行脚本所在的目录。
3.  setTimeout(cb, ms)       setTimeout(cb, ms) 全局函数在指定的毫秒(ms)数后执行指定函数(cb)。：setTimeout() 只执行一次指定函数。
4.  返回一个代表定时器的句柄值。
5.  clearTimeout(t)             clearTimeout( t ) 全局函数用于停止一个之前通过 setTimeout() 创建的定时器。 参数 t 是通过 setTimeout() 函数创建的定时器。
6.  setInterval(cb, ms)       setInterval(cb, ms) 全局函数在指定的毫秒(ms)数后执行指定函数(cb)。返回一个代表定时器的句柄值。可以使用 clearInterval(t) 函数来清除定时器。setInterval() 方法会不停地调用函数，直到 clearInterval() 被调用或窗口被关闭。
7.  console                        console 用于提供控制台标准输出，它是由 Internet Explorer 的 JScript 引擎提供的调试工具，后来逐渐成为浏览器的实施标准。Node.js 沿用了这个标准，提供与习惯行为一致的 console 对象，用于向标准输出流（stdout）或标准错误流（stderr）输出字符。

process        process 是一个全局变量，即 global 对象的属性。它用于描述当前Node.js 进程状态的对象，提供了一个与操作系统的简单接口。通常在你写本地命令行程序的时候，少不了要 和它打交道。下面将会介绍 process 对象的一些最常用的成员方法。

# 六、Node.js util 工具 #

util 是一个Node.js 核心模块，提供常用函数的集合，用于弥补核心JavaScript 的功能 过于精简的不足。

## util.inherits ##

util.inherits(constructor, superConstructor)是一个实现对象间原型继承 的函数。JavaScript 的面向对象特性是基于原型的，与常见的基于类的不同。JavaScript 没有 提供对象继承的语言级别特性，而是通过原型复制来实现的。

1.  var util = require( 'util');
2.  function Base() \{
3.  this.name = 'base';
4.  this.base = 1991;
5.  this.sayHello = function() \{
6.  console.log( 'Hello ' \+ this.name);
7.  \};
8.  \}
9.  Base.prototype.showName = function() \{
10. console.log( this.name);
11. \};
12. function Sub() \{
13. this.name = 'sub';
14. \}
15. util.inherits(Sub, Base);
16. var objBase = new Base();
17. objBase.showName();
18. objBase.sayHello();
19. console.log(objBase);
20. var objSub = new Sub();
21. objSub.showName();
22. *//objSub.sayHello();* 
23. console.log(objSub);

运行结果如下：

1.  base
2.  Hello base
3.  \{ name: 'base', base: 1991, sayHello: \[ Function\] \}
4.  sub
5.  \{ name: 'sub' \}

## util.inspect ##

util.inspect(object,\[showHidden\],\[depth\],\[colors\])是一个将任意对象转换为字符串的方法，通常用于调试和错误输出。它至少接受一个参数 object，即要转换的对象。

1.  showHidden 是一个可选参数，如果值为 true，将会输出更多隐藏信息。
2.  depth 表示最大递归的层数，如果对象很复杂，你可以指定层数以控制输出信息的多 少。如果不指定depth，默认会递归2层，指定为 null 表示将不限递归层数完整遍历对象。 如果color 值为 true，输出格式将会以ANSI 颜色编码，通常用于在终端显示更漂亮 的效果。
3.  util.inspect  并不会简单地直接把对象转换为字符串，即使该对 象定义了toString 方法也不会调用。
4.  util.isArray(object) 如果给定的参数 "object" 是一个数组返回true，否则返回false。  
    
5.  util.isRegExp(object)  如果给定的参数 "object" 是一个正则表达式返回true，否则返回false。  
    
6.  util.isDate(object)       如果给定的参数 "object" 是一个日期返回true，否则返回false。  
    
7.  util.isError(object)       如果给定的参数 "object" 是一个错误对象返回true，否则返回false。

# 七、Node.js 文件系统 #

Node.js 提供一组类似 UNIX（POSIX）标准的文件操作API。 Node 导入文件系统模块(fs)语法如下所示：

var fs = require("fs")

异步和同步  
Node.js 文件系统（fs 模块）模块中的方法均有异步和同步版本，例如读取文件内容的函数有异步的 fs.readFile() 和同步的 fs.readFileSync()。异步的方法函数最后一个参数为回调函数，回调函数的第一个参数包含了错误信息(error)。建议大家使用异步方法，比起同步，异步方法性能更高，速度更快，而且没有阻塞。

文件的打开方法如下：

fs.open(path, flags\[, mode\], callback)

参数使用说明如下：

1.  path - 文件的路径。
2.  flags - 文件打开的行为。具体值详见下文。
3.  mode - 设置文件模式(权限)，文件创建默认权限为 0666(可读，可写)。
4.  callback - 回调函数，带有两个参数如：callback(err, fd)。

flags 参数可以是以下值：

<table style="border-spacing:0px;border:0px;color:rgb(51,51,51);font-family:'Helvetica Neue', Helvetica, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', 'Noto Sans CJK SC', 'WenQuanYi Micro Hei', Arial, sans-serif;font-size:12px;"> 
 <tbody> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <th style="border-color:rgb(85,85,85);color:rgb(255,255,255);background-color:rgb(85,85,85);vertical-align:top;">Flag</th> 
 <th style="border-color:rgb(85,85,85);color:rgb(255,255,255);background-color:rgb(85,85,85);vertical-align:top;">描述</th> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">r</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以读取模式打开文件。如果文件不存在抛出异常。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">r+</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以读写模式打开文件。如果文件不存在抛出异常。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">rs</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以同步的方式读取文件。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">rs+</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以同步的方式读取和写入文件。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">w</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以写入模式打开文件，如果文件不存在则创建。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">wx</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">类似 'w'，但是如果文件路径存在，则文件写入失败。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">w+</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以读写模式打开文件，如果文件不存在则创建。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">wx+</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">类似 'w+'， 但是如果文件路径存在，则文件读写失败。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">a</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以追加模式打开文件，如果文件不存在则创建。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">ax</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">类似 'a'， 但是如果文件路径存在，则文件追加失败。</td> 
 </tr> 
 <tr style="border-top:0px;"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">a+</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">以读取追加模式打开文件，如果文件不存在则创建。</td> 
 </tr> 
 <tr style="border-top:0px;background-color:rgb(246,244,240);"> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">ax+</td> 
 <td style="border-color:rgb(212,212,212);font-size:13px;line-height:2em;min-width:24px;vertical-align:top;">类似 'a+'， 但是如果文件路径存在，则文件读取追加失败。</td> 
 </tr> 
 </tbody> 
</table>

接下来我们创建 file.js 文件，并打开 input.txt 文件进行读写，代码如下所示：

1.  var fs = require( "fs");
2.  
3.  *// 异步打开文件*
4.  console.log( "准备打开文件！");
5.  fs.open( 'input.txt', 'r+', function(err, fd) \{
6.  if (err) \{
7.  return console.error(err);
8.  \}
9.  console.log( "文件打开成功！");
10. \});

1.  var fs = require( "fs");
2.  
3.  *// 异步读取*
4.  fs.readFile( 'input.txt', function (err, data) \{
5.  if (err) \{
6.  return console.error(err);
7.  \}
8.  console.log( "异步读取: " \+ data.toString());
9.  \});
10. 
11. *// 同步读取*
12. var data = fs.readFileSync( 'input.txt');
13. console.log( "同步读取: " \+ data.toString());
14. 
15. console.log( "程序执行完毕。");

# 八、Node.js GET/POST请求 #

由于GET请求直接被嵌入在路径中，URL是完整的请求路径，包括了?后面的部分，因此你可以手动解析后面的内容作为GET请求的参数。node.js 中 url 模块中的 parse 函数提供了这个功能。

1.  var http = require( 'http');
2.  var url = require( 'url');
3.  var util = require( 'util');
4.  
5.  http.createServer( function(req, res)\{
6.  res.writeHead( 200, \{ 'Content-Type': 'text/plain'\});
7.  
8.  *// 解析 url 参数*
9.  var params = url.parse(req.url, true).query;
10. res.write( "网站名：" \+ params.name);
11. res.write( "\\n");
12. res.write( "网站 URL：" \+ params.url);
13. res.end();
14. 
15. \}).listen( 3000);

获取 POST 请求内容：  
POST 请求的内容全部的都在请求体中，http.ServerRequest 并没有一个属性内容为请求体，原因是等待请求体传输可能是一件耗时的工作。比如上传文件，而很多时候我们可能并不需要理会请求体的内容，恶意的POST请求会大大消耗服务器的资源，所以 node.js 默认是不会解析请求体的，当你需要的时候，需要手动来做。

1.  var http = require( 'http');
2.  var querystring = require( 'querystring');
3.  
4.  http.createServer( function(req, res)\{
5.  *// 定义了一个post变量，用于暂存请求体的信息*
6.  var post = '';
7.  
8.  *// 通过req的data事件监听函数，每当接受到请求体的数据，就累加到post变量中*
9.  req.on( 'data', function(chunk)\{
10. post += chunk;
11. \});
12. 
13. *// 在end事件触发后，通过querystring.parse将post解析为真正的POST请求格式，然后向客户端返回。*
14. req.on( 'end', function()\{
15. post = querystring.parse(post);
16. res.end(util.inspect(post));
17. \});
18. \}).listen( 3000);

以下实例表单通过 POST 提交并输出数据：

1. var http = require( 'http');
2. var querystring = require( 'querystring');
3. 
4. var postHTML =
5. '<html><head><meta charset="utf-8"><title>Node.js 实例</title></head>' \+
6. '<body>' \+
7. '<form method="post">' \+
8. '网站名： <input name="name"> ' \+
9. '网站 URL： <input name="url"> ' \+
10. '<input type="submit">' \+
11. '</form>' \+
12. '</body></html>';
13. 
14. http.createServer( function (req, res) \{
15. var body = "";
16. req.on( 'data', function (chunk) \{
17. body += chunk;
18. \});
19. req.on( 'end', function () \{
20. *// 解析参数*
21. body = querystring.parse(body);
22. *// 设置响应头部信息及编码*
23. res.writeHead( 200, \{ 'Content-Type': 'text/html; charset=utf8'\});
24. 
25. if(body.name && body.url) \{ *// 输出提交的数据*
26. res.write( "网站名：" \+ body.name);
27. res.write( " ");
28. res.write( "网站 URL：" \+ body.url);
29. \} else \{ *// 输出表单*
30. res.write(postHTML);
31. \}
32. res.end();
33. \});
34. \}).listen( 3000);

![20180121141130322][]

# 九、Node.js Web 模块 #

Node.js 提供了 http 模块，http 模块主要用于搭建 HTTP 服务端和客户端，使用 HTTP 服务器或客户端功能必须调用 http 模块，代码如下：

var http = require('http');

Node.js创建的服务器端使用Node.js文件作为服务器，使用Html+CSS作为前台界面，如下是一个基本Web服务器的后台代码：

1.  var http = require( 'http');
2.  var fs = require( 'fs');
3.  var url = require( 'url');
4.  
5.  
6.  *// 创建服务器*
7.  http.createServer( function (request, response) \{
8.  *// 解析请求，包括文件名*
9.  var pathname = url.parse(request.url).pathname;
10. 
11. *// 输出请求的文件名*
12. console.log( "Request for " \+ pathname + " received.");
13. 
14. *// 从文件系统中读取请求的文件内容*
15. fs.readFile(pathname.substr( 1), function (err, data) \{
16. if (err) \{
17. console.log(err);
18. *// HTTP 状态码: 404 : NOT FOUND*
19. *// Content Type: text/plain*
20. response.writeHead( 404, \{ 'Content-Type': 'text/html'\});
21. \} else\{
22. *// HTTP 状态码: 200 : OK*
23. *// Content Type: text/plain*
24. response.writeHead( 200, \{ 'Content-Type': 'text/html'\});
25. 
26. *// 响应文件内容*
27. response.write(data.toString());
28. \}
29. *// 发送响应数据*
30. response.end();
31. \});
32. \}).listen( 8080);
33. 
34. *// 控制台会输出以下信息*
35. console.log( 'Server running at http://127.0.0.1:8080/');

接下来我们在该目录下创建一个 index.html 文件，代码如下：

1. <!DOCTYPE html>
2. <html>
3. <head>
4. <meta charset="utf-8">
5. <title>My First Page </title>
6. </head>
7. <body>
8. <h1>我的第一个标题 </h1>
9. 我的第一个段落。 
10. </body>
11. </html>

# 十、Node.js Express框架 #

Express 是一个简洁而灵活的 node.js Web应用框架, 提供了一系列强大特性帮助你创建各种 Web 应用，和丰富的 HTTP 工具。  
使用 Express 可以快速地搭建一个完整功能的网站。Express 框架核心特性：

1.  可以设置中间件来响应 HTTP 请求。
2.  定义了路由表用于执行不同的 HTTP 请求动作。
3.  可以通过向模板传递参数来动态渲染 HTML 页面。

Express的安装如下：

$ npm install express --save

以上命令会将 Express 框架安装在当前目录的node\_modules 目录中， node\_modules 目录下会自动创建express 目录。以下几个重要的模块是需要与 express 框架一起安装的：

1.  body-parser - node.js 中间件，用于处理 JSON, Raw, Text 和 URL 编码的数据。
2.  cookie-parser - 这就是一个解析Cookie的工具。通过req.cookies可以取到传过来的cookie，并把它们转成对象。
3.  multer - node.js 中间件，用于处理 enctype="multipart/form-data"（设置表单的MIME编码）的表单数据。

## 10.1 Request和Response对象 ##

Request 对象 - request 对象表示 HTTP 请求，包含了请求查询字符串，参数，内容，HTTP 头部等属性。常见属性有：

*  req.app：当callback为外部文件时，用req.app访问express的实例
 *  req.baseUrl：获取路由当前安装的URL路径
 *  req.body / req.cookies：获得「请求主体」/ Cookies
 *  req.fresh / req.stale：判断请求是否还「新鲜」
 *  req.hostname / req.ip：获取主机名和IP地址
 *  req.originalUrl：获取原始请求URL
 *  req.params：获取路由的parameters
 *  req.path：获取请求路径
 *  req.protocol：获取协议类型
 *  req.query：获取URL的查询参数串
 *  req.route：获取当前匹配的路由
 *  req.subdomains：获取子域名
 *  req.accepts()：检查可接受的请求的文档类型
 *  req.acceptsCharsets / req.acceptsEncodings / req.acceptsLanguages：返回指定字符集的第一个可接受字符编码
 *  req.get()：获取指定的HTTP请求头
 *  req.is()：判断请求头Content-Type的MIME类型

Response 对象 - response 对象表示 HTTP 响应，即在接收到请求时向客户端发送的 HTTP 响应数据。常见属性有：

*  res.app：同req.app一样
 *  res.append()：追加指定HTTP头
 *  res.set()在res.append()后将重置之前设置的头
 *  res.cookie(name，value \[，option\])：设置Cookie
 *  opition: domain / expires / httpOnly / maxAge / path / secure / signed
 *  res.clearCookie()：清除Cookie
 *  res.download()：传送指定路径的文件
 *  res.get()：返回指定的HTTP头
 *  res.json()：传送JSON响应
 *  res.jsonp()：传送JSONP响应
 *  res.location()：只设置响应的Location HTTP头，不设置状态码或者close response
 *  res.redirect()：设置响应的Location HTTP头，并且设置状态码302
 *  res.render(view,\[locals\],callback)：渲染一个view，同时向callback传递渲染后的字符串，如果在渲染过程中有错误发生next(err)将会被自动调用。callback将会被传入一个可能发生的错误以及渲染后的页面，这样就不会自动输出了。
 *  res.send()：传送HTTP响应
 *  res.sendFile(path \[，options\] \[，fn\])：传送指定路径的文件 -会自动根据文件extension设定Content-Type
 *  res.set()：设置HTTP头，传入object可以一次设置多个头
 *  res.status()：设置HTTP状态码
 *  res.type()：设置Content-Type的MIME类型

路由

在HTTP请求中，我们可以通过路由提取出请求的URL以及GET/POST参数。接下来我们扩展 Hello World，添加一些功能来处理更多类型的 HTTP 请求。创建 express\_demo2.js 文件，代码如下所示：

1.  var express = require( 'express');
2.  var app = express();
3.  
4.  *// 主页输出 "Hello World"*
5.  app.get( '/', function (req, res) \{
6.  console.log( "主页 GET 请求");
7.  res.send( 'Hello GET');
8.  \})
9.  
10. 
11. *// POST 请求*
12. app.post( '/', function (req, res) \{
13. console.log( "主页 POST 请求");
14. res.send( 'Hello POST');
15. \})
16. 
17. *// /del\_user 页面响应*
18. app.get( '/del\_user', function (req, res) \{
19. console.log( "/del\_user 响应 DELETE 请求");
20. res.send( '删除页面');
21. \})
22. 
23. *// /list\_user 页面 GET 请求*
24. app.get( '/list\_user', function (req, res) \{
25. console.log( "/list\_user GET 请求");
26. res.send( '用户列表页面');
27. \})
28. 
29. *// 对页面 abcd, abxcd, ab123cd, 等响应 GET 请求*
30. app.get( '/ab\*cd', function(req, res) \{
31. console.log( "/ab\*cd GET 请求");
32. res.send( '正则匹配');
33. \})
34. 
35. 
36. var server = app.listen( 8081, function () \{
37. 
38. var host = server.address().address
39. var port = server.address().port
40. 
41. console.log( "应用实例，访问地址为 http://%s:%s", host, port)
42. 
43. \})

执行以上代码后，接下来你可以尝试访问 http://127.0.0.1:8081 不同的地址，查看效果。  
在浏览器中访问 http://127.0.0.1:8081/list\_user，结果如下图所示：

![20180121220516495][]  
访问不同url获得不同的响应结果。

## 静态文件 ##

Express 提供了内置的中间件 express.static 来设置静态文件如：图片， CSS, JavaScript 等。你可以使用 express.static 中间件来设置静态文件路径。例如，如果你将图片， CSS, JavaScript 文件放在 public 目录下，你可以这么写：

app.use(express.static('public'));

我们可以到 public/images 目录下放些图片,如下所示：

node_modules
    server.js
    public/
    public/images
    public/images/logo.png

[Link 1]: http://www.runoob.com/nodejs/nodejs-event.html
[20180121141130322]: /images/20220521/c41a46a7d5b741d09d491a3922f96169.png
[20180121220516495]: /images/20220521/f01ff5320aa84bd2aec83214e63b75b4.png