Module 基礎模塊

模塊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

創建一個 SocketSslSocket 對象並建立連接

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

返回結果:


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;