Node.jsツールモジュール

Node.js モジュール ライブラリには、便利なモジュールが多数あります。 次に、一般的に使用されるいくつかのモジュールの使用法を紹介します。

Node.js OS モジュール

Node.js os モジュールは、いくつかの基本的なシステム操作機能を提供します。 このモジュールは次の方法でインポートできます。

var os = require("os")

方法

属性

例

main.js ファイルを作成します。コードは次のとおりです。

var os = require("os");

// CPU バイトオーダー
console.log('endianness : ' + os.endianness());

// オペレーティング システム名
console.log('type : ' + os.type());

// オペレーティング システム名
console.log('platform : ' + os.platform());

// 総システムメモリ
console.log('total memory : ' + os.totalmem() + " bytes.");

// オペレーティング システムの空きメモリの量
console.log('free memory : ' + os.freemem() + " bytes.");

コードの実行結果は次のとおりです。

$ node main.js 
endianness : LE
type : Linux
platform : linux
total memory : 25103400960 bytes.
free memory : 20676710400 bytes.

Node.js パス モジュール

Node.js パス モジュールには、ファイル パスを処理するための小さなツールがいくつか用意されています。このモジュールは次の方法でインポートできます:

var path = require("path")

方法

path.resolve('/foo/bar', './baz');
// 戻り値: '/foo/bar/baz'

path.resolve('/foo/bar', '/tmp/file/');
// 戻り値: '/tmp/file'

path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif');
// 現在の作業ディレクトリが /home/myself/node の場合、
// その後、「/home/myself/node/wwwroot/static_files/gif/image.gif」を返します

path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb');
// 戻る: '../../impl/bbb'

path.relative('C:\\orandea\\test\\aaa', 'C:\\orandea\\impl\\bbb');
// 戻る: '..\\..\\impl\\bbb'

属性

例

main.js ファイルを作成します。コードは次のとおりです。

var path = require("path");

// フォーマットパス
console.log('normalization : ' + path.normalize('/test/test1//2slashes/1slash/tab/..'));

// 接続パス
console.log('joint path : ' + path.join('/test', 'test1', '2slashes/1slash', 'tab', '..'));

// 絶対パスに変換
console.log('resolve : ' + path.resolve('main.js'));

// パス内のファイルの拡張子
console.log('ext name : ' + path.extname('main.js'));

コードの実行結果は次のとおりです。

$ node main.js 
normalization : /test/test1/2slashes/1slash
joint path : /test/test1/2slashes/1slash
resolve : /web/com/1427176256_27423/main.js
ext name : .js

Node.js Net モジュール

Node.js Net モジュールは、サーバー/クライアントの作成方法など、基盤となるネットワーク通信用の小さなツールをいくつか提供します。このモジュールは次の方法でインポートできます。

var net = require("net")

方法

ネット.サーバー

net.Server は通常、TCP サーバーまたはローカル サーバーを作成するために使用されます。

イベント

net.S1ocket

net.Socket オブジェクトは、TCP または UNIX ソケットを抽象化したものです。 net.Socket インスタンスは二重ストリーム インターフェイスを実装します。 これらは、ユーザーがクライアントを作成するときに (connect() を使用して) 使用することも、Node によって作成して接続サーバー イベントを介してユーザーに渡すこともできます。

イベント

net.Socket イベントは次のとおりです:

属性

net.Socket は、ソケットの対話を制御するための便利なプロパティを多数提供します。

方法

例

server.js ファイルを作成します。コードは次のとおりです。

var net = require('net');
var server = net.createServer(function(connection) { 
   console.log('client connected');
   connection.on('end', function() {
      console.log('クライアントが接続を閉じました');
   });
   connection.write('Hello World!\r\n');
   connection.pipe(connection);
});
server.listen(8080, function() { 
  console.log('server is listening');
});

上記のサーバー コードを実行します。

$ node server.js
server is listening   # サービスが作成され、ポート 8080 でリッスンします

新しいウィンドウを開いて client.js ファイルを作成します。コードは次のとおりです。

var net = require('net');
var client = net.connect({port: 8080}, function() {
   console.log('サーバーに接続!');  
});
client.on('data', function(data) {
   console.log(data.toString());
   client.end();
});
client.on('end', function() { 
   console.log('サーバーから切断');
});

上記のクライアント コードを実行します。

サーバーに接続!
Hello World!

サーバーから切断

Node.js DNS モジュール

Node.js の DNS モジュールは、ドメイン名を解決するために使用されます。 DNS モジュールをインポートするための構文は次のとおりです。

var dns = require("dns")

メソッド

rrtypes

以下は、dns.resolve() メソッドの有効な rrtypes 値です。

• 'A' IPV4 アドレス、デフォルト
• 'AAAA' IPV6 アドレス
• 'MX' メール交換記録
• 'TXT' テキスト レコード
• '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: ihlpapi.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"]

Node.js Domain モジュール

Node.js Domain(domain) は、非同期コードの例外処理を簡素化し、try catch ではキャッチできない例外をキャッチして処理できます。 Domain モジュールをインポートする構文は次のとおりです。

var domain = require("domain")

domain モジュールは、複数の異なる IO 操作をグループとして処理します。 イベントを登録し、domain にコールバックします。エラー イベントが発生するかエラーがスローされると、ドメイン オブジェクトに通知されます。これによりコンテキストが失われることはなく、エラーによりプログラムが直ちに終了することもありません。これは異なります。 process.on('uncaughtException') から。

Domain モジュールは、暗黙的バインディングと明示的バインディングに分類できます。

• 暗黙的バインディング: domain コンテキストで定義された変数をドメイン オブジェクトに自動的にバインドします
• 明示的なバインディング: domain コンテキストで定義されていない変数をコード内の do1main オブジェクトにバインドする

メソッド

属性

例

main.js ファイルを作成します。コードは次のとおりです。

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 によって処理されます'));

var domain2 = domain.create();

domain2.on('error', function(err){
   console.log("domain2 このエラーを処理する ("+err.message+")");
});

// 隐式绑定
domain2.run(function(){
   var emitter2 = new EventEmitter();
   emitter2.emit('error',new Error('domain2 によって処理されます'));   
});


domain1.remove(emitter1);
emitter1.emit('error', new Error('例外に変換されると、システムがクラッシュします。'));

执行以上代码，结果如下所示:

このエラーを処理するリスナー (リスナーによって処理される)
domain1 がこのエラーを処理します (domain1 によって処理されます)
domain2 がこのエラーを処理します (domain2 によって処理されます)

events.js:72
        throw er; // Unhandled 'error' event
              ^
Error: 例外に変換されると、システムがクラッシュします。
    at Object.<anonymous> (/www/node/main.js:40:24)
    at Module._compile (module.js:456:26)
    at Object.Module._extensions..js (module.js:474:10)
    at Module.load (module.js:356:32)
    at Function.Module._load (module.js:312:12)
    at Function.Module.runMain (module.js:497:10)
    at startup (node.js:119:16)
    at node.js:929:3