node-OS&Domain&Net&Path

OS---------------------------------------------
   Node.js os 模块提供了一些基本的系统操作函数。
var os = require("os")
方法
序号	方法 & 描述
1	os.tmpdir()
返回操作系统的默认临时文件夹。
2	os.endianness()
返回 CPU 的字节序，可能的是 "BE" 或 "LE"。
3	os.hostname()
返回操作系统的主机名。
4	os.type()
返回操作系统名
5	os.platform()
返回编译时的操作系统名
6	os.arch()
返回操作系统 CPU 架构，可能的值有 "x64"、"arm" 和 "ia32"。
7	os.release()
返回操作系统的发行版本。
8	os.uptime()
返回操作系统运行的时间，以秒为单位。
9	os.loadavg()
返回一个包含 1、5、15 分钟平均负载的数组。
10	os.totalmem()
返回系统内存总量，单位为字节。
11	os.freemem()
返回操作系统空闲内存量，单位是字节。
12	os.cpus()
返回一个对象数组，包含所安装的每个 CPU / 内核的信息：型号、速度（单位 MHz）、时间（一个包含 user、nice、sys、idle 和 irq 所使用 CPU / 内核毫秒数的对象）。
13	os.networkInterfaces()
获得网络接口列表。
属性
序号	属性 & 描述
1	os.EOL
定义了操作系统的行尾符的常量。

Path---------------------------------------------
   Node.js path 模块提供了一些用于处理文件路径的小工具
var path = require("path")
方法
序号	方法 & 描述
1	path.normalize(p)
规范化路径，注意'..' 和 '.'。
2	path.join([path1][, path2][, ...])
用于连接路径。该方法的主要用途在于，会正确使用当前系统的路径分隔符，Unix系统是"/"，Windows系统是"\"。
3	path.resolve([from ...], to)
将 to 参数解析为绝对路径，给定的路径的序列是从右往左被处理的，后面每个 path 被依次解析，直到构造完成一个绝对路径。 path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif');
// 如果当前工作目录为 /home/myself/node，
// 则返回 '/home/myself/node/wwwroot/static_files/gif/image.gif'
4	path.isAbsolute(path)
判断参数 path 是否是绝对路径。
5	path.relative(from, to)
用于将绝对路径转为相对路径，返回从 from 到 to 的相对路径（基于当前工作目录）。

在 Windows 上：
path.relative('C:\\orandea\\test\\aaa', 'C:\\orandea\\impl\\bbb');
// 返回: '..\\..\\impl\\bbb'
6	path.dirname(p)
返回路径中代表文件夹的部分，同 Unix 的dirname 命令类似。
7	path.basename(p[, ext])
返回路径中的最后一部分。同 Unix 命令 bashname 类似。
8	path.extname(p)
返回路径中文件的后缀名，即路径中最后一个'.'之后的部分。如果一个路径中并不包含'.'或该路径只包含一个'.' 且这个'.'为路径的第一个字符，则此命令返回空字符串。
9	path.parse(pathString)
返回路径字符串的对象。
10	path.format(pathObject)
从对象中返回路径字符串，和 path.parse 相反。
属性
序号	属性 & 描述
1	path.sep
平台的文件路径分隔符，'\\' 或 '/'。
2	path.delimiter
平台的分隔符, ; or ':'.
3	path.posix
提供上述 path 的方法，不过总是以 posix 兼容的方式交互。
4	path.win32
提供上述 path 的方法，不过总是以 win32 兼容的方式交互。

Net---------------------------------------------
   Net 模块
用于底层的网络通信。提供了服务端和客户端的的操作。
https://www.runoob.com/nodejs/nodejs-net-module.html

DNS---------------------------------------------
   DNS 模块
用于解析域名。
var dns = require("dns")

方法
序号	方法 & 描述
1	dns.lookup(hostname[, options], callback)
将域名（比如 'runoob.com'）解析为第一条找到的记录 A （IPV4）或 AAAA(IPV6) 。参数 options可以是一个对象或整数。如果没有提供 options，IP v4 和 v6 地址都可以。如果 options 是整数，则必须是 4 或 6。
2	dns.lookupService(address, port, callback)
使用 getnameinfo 解析传入的地址和端口为域名和服务。
3	dns.resolve(hostname[, rrtype], callback)
将一个域名（如 'runoob.com'）解析为一个 rrtype 指定记录类型的数组。
4	dns.resolve4(hostname, callback)
和 dns.resolve() 类似, 仅能查询 IPv4(A 记录）。 addresses IPv4 地址数组(比如，['74.125.79.104', '74.125.79.105', '74.125.79.106']）。
   5	dns.resolve6(hostname, callback)
和 dns.resolve4() 类似， 仅能查询 IPv6(AAAA 查询）
      6	dns.resolveMx(hostname, callback)
和 dns.resolve() 类似, 仅能查询邮件交换(MX 记录) 。
      7	dns.resolveTxt(hostname, callback)
和 dns.resolve() 类似, 仅能进行文本查询(TXT 记录）。 addresses 是 2 - d 文本记录数组。(比如，[['v=spf1 ip4:0.0.0.0 ', '~all']]）。 每个子数组包含一条记录的 TXT 块。根据使用情况可以连接在一起，也可单独使用。
         8	dns.resolveSrv(hostname, callback)
和 dns.resolve() 类似, 仅能进行服务记录查询(SRV 记录）。 addresses 是 hostname可用的 SRV 记录数组。 SRV 记录属性有优先级（priority），权重（weight）, 端口（port）, 和名字（name）(比如，[{ 'priority': 10, 'weight': 5, 'port': 21223, 'name': 'service.example.com' }, ...]）。
            9	dns.resolveSoa(hostname, callback)
和 dns.resolve() 类似, 仅能查询权威记录(SOA 记录）。
               10	dns.resolveNs(hostname, callback)
和 dns.resolve() 类似, 仅能进行域名服务器记录查询(NS 记录）。 addresses 是域名服务器记录数组（hostname 可以使用）(比如, ['ns1.example.com', 'ns2.example.com']）。
                  11	dns.resolveCname(hostname, callback)
和 dns.resolve() 类似, 仅能进行别名记录查询(CNAME记录) 。addresses 是对 hostname 可用的别名记录数组(比如，, ['bar.example.com']）。
                     12	dns.reverse(ip, callback)
反向解析 IP 地址，指向该 IP 地址的域名数组。
                     13	dns.getServers()
返回一个用于当前解析的 IP 地址数组的字符串。
                     14	dns.setServers(servers)
指定一组 IP 地址作为解析服务器。
                     rrtypes
以下列出了 dns.resolve() 方法中有效的 rrtypes值:

                     'A' IPV4 地址, 默认
'AAAA' IPV6 地址
'MX' 邮件交换记录
'TXT' text 记录
'SRV' SRV 记录
'PTR' 用来反向 IP 查找
'NS' 域名服务器记录
'CNAME' 别名记录
'SOA' 授权记录的初始值
错误码
每次 DNS 查询都可能返回以下错误码：

                     dns.NODATA: 无数据响应。
                     dns.FORMERR: 查询格式错误。
                     dns.SERVFAIL: 常规失败。
                     dns.NOTFOUND: 没有找到域名。
                     dns.NOTIMP: 未实现请求的操作。
                     dns.REFUSED: 拒绝查询。
                     dns.BADQUERY: 查询格式错误。
                     dns.BADNAME: 域名格式错误。
                     dns.BADFAMILY: 地址协议不支持。
                     dns.BADRESP: 回复格式错误。
                     dns.CONNREFUSED: 无法连接到 DNS 服务器。
                     dns.TIMEOUT: 连接 DNS 服务器超时。
                     dns.EOF: 文件末端。
                     dns.FILE: 读文件错误。
                     dns.NOMEM: 内存溢出。
                     dns.DESTRUCTION: 通道被摧毁。
                     dns.BADSTR: 字符串格式错误。
                     dns.BADFLAGS: 非法标识符。
                     dns.NONAME: 所给主机不是数字。
                     dns.BADHINTS: 非法HINTS标识符。
                     dns.NOTINITIALIZED: c c - ares 库尚未初始化。
                     dns.LOADIPHLPAPI: 加载 iphlpapi.dll 出错。
                     dns.ADDRGETNETWORKPARAMS: 无法找到 GetNetworkParams 函数。
                     dns.CANCELLED: 取消 DNS 查询。
                     实例
创建 main.js 文件，代码如下所示：

var dns = require('dns');

dns.lookup('www.github.com', function onLookup(err, address, family) {
   console.log('ip 地址:', address);
   dns.reverse(address, function (err, hostnames) {
      if (err) {
         console.log(err.stack);
      }

      console.log('反向解析 ' + address + ': ' + JSON.stringify(hostnames));
   });
});
执行以上代码，结果如下所示:

address: 192.30.252.130
reverse for 192.30.252.130: ["github.com"]

Domain---------------------------------------------
   Domain 模块
简化异步代码的异常处理，可以捕捉处理try catch无法捕捉的异常。

方法
序号	方法 & 描述
1	domain.run(function)
在域的上下文运行提供的函数，隐式的绑定了所有的事件分发器，计时器和底层请求。
2	domain.add(emitter)
显式的增加事件
3	domain.remove(emitter)
删除事件。
4	domain.bind(callback)
返回的函数是一个对于所提供的回调函数的包装函数。当调用这个返回的函数时，所有被抛出的错误都会被导向到这个域的 error 事件。
5	domain.intercept(callback)
和 domain.bind(callback) 类似。除了捕捉被抛出的错误外，它还会拦截 Error 对象作为参数传递到这个函数。
6	domain.enter()
进入一个异步调用的上下文，绑定到domain。
7	domain.exit()
退出当前的domain，切换到不同的链的异步调用的上下文中。对应domain.enter() 。
8	domain.dispose()
释放一个domain对象，让node进程回收这部分资源。
9	domain.create()
返回一个domain对象。

var EventEmitter = require("events").EventEmitter;
var domain = require("domain");

var emitter1 = new EventEmitter();

// 创建域
var domain1 = domain.create();

domain1.on('error', function (err) {
   console.log("domain1 处理这个错误 (" + err.message + ")");
});

// 显式绑定
domain1.add(emitter1);

emitter1.on('error', function (err) {
   console.log("监听器处理此错误 (" + err.message + ")");
});

emitter1.emit('error', new Error('通过监听器来处理'));

emitter1.removeAllListeners('error');

emitter1.emit('error', new Error('通过 domain1 处理'));

domain1.remove(emitter1);
emitter1.emit('error', new Error('转换为异常，系统将崩溃!'));