模块 net

网络访问模块

基础模块。可用于创建和操作网络资源，引用方式：

1
var net = require('net');

对象

Socket

创建一个 Socket 对象，参见 Socket

1
Socket net.Socket;

---

Smtp

创建一个 Smtp 对象，参见 Smtp

1
Smtp net.Smtp;

---

TcpServer

创建一个 TcpServer 对象，参见 TcpServer

1
TcpServer net.TcpServer;

---

Url

创建一个 UrlObject 对象，参见 UrlObject

1
UrlObject net.Url;

静态函数

info

查询当前运行环境网络信息

1
static Object net.info();

返回结果:

• Object, 返回网卡信息

---

resolve

查询给定的主机名的地址

1
2
static String net.resolve(String name,
    Integer family = AF_INET) async;

调用参数:

• name: String, 指定主机名
• family: Integer, 指定查询返回类型，缺省为 AF_INET

返回结果:

• String, 返回查询的 ip 字符串

---

ip

快速查询的主机地址，等效与 resolve(name)

1
static String net.ip(String name) async;

调用参数:

• name: String, 指定主机名

返回结果:

• String, 返回查询的 ip 字符串

---

ipv6

快速查询的主机 ipv6 地址，等效与 resolve(name, net.AF_INET6)

1
static String net.ipv6(String name) async;

调用参数:

• name: String, 指定主机名

返回结果:

• String, 返回查询的 ipv6 字符串

---

connect

创建一个 Socket 或 SslSocket 对象并建立连接

1
2
static Stream net.connect(String url,
    Integer timeout = 0) async;

调用参数:

• url: String, 指定连接的协议，可以是：tcp://host:port 或者 ssl://host:port，也可以是：unix:/usr/local/proc1 或者 pipe://./pipe/proc1，连接 pipe 时需要用 / 替换 \
• timeout: Integer, 指定超时时间，单位是毫秒，默认为 0

返回结果:

• Stream, 返回连接成功的 Socket 或者 SslSocket 对象

---

openSmtp

创建一个 Smtp 对象并建立连接，参见 Smtp

1
2
static Smtp net.openSmtp(String url,
    Integer timeout = 0) async;

调用参数:

• url: String, 指定连接的协议，可以是：tcp://host:port 或者 ssl://host:port
• timeout: Integer, 指定超时时间，单位是毫秒，默认为 0

返回结果:

• Smtp, 返回连接成功的 Smtp 对象

---

backend

查询当前系统异步网络引擎

1
static String net.backend();

返回结果:

• String, 返回网络引擎名称

---

isIP

检测输入是否是 IP 地址

1
static Integer net.isIP(String ip = "");

调用参数:

• ip: String, 指定要检测的字符串

返回结果:

• Integer, 非合法的 IP 地址，返回 0, 如果是 IPv4 则返回 4，如果是 IPv6 则返回 6

---

isIPv4

检测输入是否是 IPv4 地址

1
static Boolean net.isIPv4(String ip = "");

调用参数:

• ip: String, 指定要检测的字符串

返回结果:

• Boolean, 如果是 IPv4 则返回 true.否则返回 false

---

isIPv6

检测输入是否是 IPv6 地址

1
static Boolean net.isIPv6(String ip = "");

调用参数:

• ip: String, 指定要检测的字符串

返回结果:

• Boolean, 如果是 IPv6 则返回 true.否则返回 false

静态属性

use_uv_socket

Boolean, 查询和设置 socket 后端是否使用 uv，缺省为 false

1
static Boolean net.use_uv_socket;

常量

AF_UNIX

地址集常量，指定 unix socket

1
const net.AF_UNIX = 1;

---

AF_PIPE

地址集常量，指定 Windows pipe

1
const net.AF_PIPE = 1;

---

AF_INET

地址集常量，指定 ipv4

1
const net.AF_INET = 2;

---

AF_INET6

地址集常量，指定 ipv6

1
const net.AF_INET6 = 10;