From 80a86dea7b59d9e8d07456660d181049b763444a Mon Sep 17 00:00:00 2001 From: koichik Date: Sat, 20 Nov 2010 23:26:51 +0900 Subject: [PATCH 01/40] added workaround for HTML comment --- tools/doctool/markdown.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/doctool/markdown.js b/tools/doctool/markdown.js index 56387c19154f..13a17f36849d 100644 --- a/tools/doctool/markdown.js +++ b/tools/doctool/markdown.js @@ -63,7 +63,7 @@ var Markdown = expose.Markdown = function Markdown(dialect) { expose.parse = function( source, dialect ) { // dialect will default if undefined var md = new Markdown( dialect ); - return md.toTree( source ); + return md.toTree( source.replace(//mg, '') ); } /** From 7dd9a4c7a93ff4be25a5193d831a9354b2007189 Mon Sep 17 00:00:00 2001 From: koichik Date: Sat, 20 Nov 2010 23:37:40 +0900 Subject: [PATCH 02/40] translated toc --- doc/api/_toc.markdown | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/doc/api/_toc.markdown b/doc/api/_toc.markdown index bed902915552..dc16f5231b77 100644 --- a/doc/api/_toc.markdown +++ b/doc/api/_toc.markdown @@ -1,5 +1,6 @@ ## Table of Contents + +* [概要](synopsis.html) +* [グローバル](globals.html) +* [タイマー](timers.html) +* [モジュール](modules.html) +* [C/C++ アドオン](addons.html) +* [プロセス](process.html) +* [ユーティリティ](util.html) +* [イベント](events.html) +* [バッファ](buffers.html) +* [ストリーム](streams.html) +* [暗号化](crypto.html) + * [安全なストリーム](securepair.html) +* [文字列デコーダ](string_decoder.html) +* [ファイルシステム](fs.html) +* [パス](path.html) +* [Net](net.html) +* [DNS](dns.html) +* [データグラム](dgram.html) +* [HTTP](http.html) +* [URL](url.html) +* [クエリ文字列](querystring.html) +* [Readline](readline.html) +* [REPL](repl.html) +* [VM](vm.html) +* [子プロセス](child_processes.html) +* [表明とテスティング](assert.html) +* 付録 + * [付録 1: 推奨されるサードパーティ製のモジュール](appendix_1.html) + * [付録 2: 廃止された API](appendix_2.html) + From db956515b62cc8625d084c85573408b62ba8339a Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 00:37:23 +0900 Subject: [PATCH 03/40] translated addons --- doc/api/addons.markdown | 67 +++++++++++++++++++++++++++++++++++++++-- 1 file changed, 65 insertions(+), 2 deletions(-) diff --git a/doc/api/addons.markdown b/doc/api/addons.markdown index 1b29a0333b68..e280c7ae2cae 100644 --- a/doc/api/addons.markdown +++ b/doc/api/addons.markdown @@ -1,39 +1,84 @@ ## Addons + +アドオンは動的に共有オブジェクトをリンクします。 +それらは、C や C++ のライブラリに接合点を提供します。 +API はいくつかのライブラリの知識が必要で、(現時点では) かなり複雑です。 + + - V8 JavaScript は C++ のライブラリです。 + JavaScript のオブジェクト作成や関数呼び出し等のインタフェースに使用されます。 + ドキュメントは主に、`v8.h` のヘッダファイル + (Node のソースツリーの中の `deps/v8/include/v8.h`) に記されています。 + + - libev は C の event loop ライブラリです。 + ファイル記述子が読み取り可能になるのを待つとき、タイマーを待つとき、シグナルを受信するのを待つときはいつでも、 + libv のインタフェースが必要になります。 + つまり、何らかの I/O 処理をすると必ず libev を使う必要があるということです。 + Node は `EV_DEFAULT` というイベントループを使います。 + ドキュメントは、[こちら](http:/cvs.schmorp.de/libev/ev.html) にあります。 + + + - libeio は C のスレッドプールライブラリです。 + ブロックする POSIX システムコールを非同期に実行するために使用されます。 + こういった呼び出しのための大抵のラッパーは、既に `src/file.cc` に用意されているので、 + おそらくこれを使う必要はないしょう。 + 必要になったら、`deps/libeio/eio.h` のヘッダファイルを参照して下さい。 + + + - Node の内部ライブラリ。 + もっとも重要なのは `node::ObjectWrap` クラスで、 + このクラスから派生させることが多くなるでしょう。 + + - その他。どのような物が利用できるかは `deps/` 以下を参照してさい。 + +Node は全ての依存ライブラリを実行ファイルに静的にコンパイルします。 +モジュールのコンパイル時には、それらのリンクについて一切気にする必要は有りません。 + +では、 C++ で以下の様に動作する小さなアドオンを作成してみましょう。 exports.hello = 'world'; + +まず `hello.cc` というファイルを作成します: + #include @@ -46,9 +91,13 @@ To get started we create a file `hello.cc`: target->Set(String::New("hello"), String::New("World")); } + +このソースコードは、`hello.node` というバイナリアドオンとしてビルドされる必要が有ります。 +そのために `wscript` と呼ばれる以下のようなコードを Python で書きました: srcdir = '.' blddir = 'build' @@ -66,15 +115,29 @@ like this: obj.target = 'hello' obj.source = 'hello.cc' + +`node-waf configure build` を実行すると、`build/default/hello.node` が作成されます。これが作成したアドオンです。 + +`node-waf` は [WAF](http://code.google.com/p/waf/) にある Python ベースのビルドシステムです。 +`node-waf` は、ユーザの負担を減らすために提供されています。 + +全ての Node アドオンは次のシグネチャを持つ `init` という関数をエクスポートする必要が有ります: extern 'C' void init (Handle target) + +現時点では、アドオンのドキュメントはこれで全てです。 +実際の例は、 を参照してください。 From ce5436a33d8103665bcab4f72f707d030824a9cf Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 01:11:38 +0900 Subject: [PATCH 04/40] converted to utf-8 --- doc/api/_toc.markdown | 44 +++++++++++++------------- doc/api/addons.markdown | 68 ++++++++++++++++++++--------------------- 2 files changed, 56 insertions(+), 56 deletions(-) diff --git a/doc/api/_toc.markdown b/doc/api/_toc.markdown index dc16f5231b77..4610313efbe7 100644 --- a/doc/api/_toc.markdown +++ b/doc/api/_toc.markdown @@ -31,33 +31,33 @@ * [Appendix 1: Recommended Third-party Modules](appendix_1.html) * [Appendix 2: Deprecated API's](appendix_2.html) --> -* [概要](synopsis.html) -* [グローバル](globals.html) -* [タイマー](timers.html) -* [モジュール](modules.html) -* [C/C++ アドオン](addons.html) -* [プロセス](process.html) -* [ユーティリティ](util.html) -* [イベント](events.html) -* [バッファ](buffers.html) -* [ストリーム](streams.html) -* [暗号化](crypto.html) - * [安全なストリーム](securepair.html) -* [文字列デコーダ](string_decoder.html) -* [ファイルシステム](fs.html) -* [パス](path.html) +* [讎りｦ‐(synopsis.html) +* [繧ｰ繝ｭ繝ｼ繝舌Ν](globals.html) +* [繧ｿ繧､繝槭ｼ](timers.html) +* [繝｢繧ｸ繝･繝ｼ繝ｫ](modules.html) +* [C/C++ 繧｢繝峨が繝ｳ](addons.html) +* [繝励Ο繧ｻ繧ｹ](process.html) +* [繝ｦ繝ｼ繝繧｣繝ｪ繝繧｣](util.html) +* [繧､繝吶Φ繝](events.html) +* [繝舌ャ繝輔ぃ](buffers.html) +* [繧ｹ繝医Μ繝ｼ繝](streams.html) +* [證怜捷蛹望(crypto.html) + * [螳牙ｨ縺ｪ繧ｹ繝医Μ繝ｼ繝](securepair.html) +* [譁蟄怜励ョ繧ｳ繝ｼ繝](string_decoder.html) +* [繝輔ぃ繧､繝ｫ繧ｷ繧ｹ繝繝](fs.html) +* [繝代せ](path.html) * [Net](net.html) * [DNS](dns.html) -* [データグラム](dgram.html) +* [繝繝ｼ繧ｿ繧ｰ繝ｩ繝](dgram.html) * [HTTP](http.html) * [URL](url.html) -* [クエリ文字列](querystring.html) +* [繧ｯ繧ｨ繝ｪ譁蟄怜余(querystring.html) * [Readline](readline.html) * [REPL](repl.html) * [VM](vm.html) -* [子プロセス](child_processes.html) -* [表明とテスティング](assert.html) -* 付録 - * [付録 1: 推奨されるサードパーティ製のモジュール](appendix_1.html) - * [付録 2: 廃止された API](appendix_2.html) +* [蟄舌励Ο繧ｻ繧ｹ](child_processes.html) +* [陦ｨ譏弱→繝繧ｹ繝繧｣繝ｳ繧ｰ](assert.html) +* 莉倬鹸 + * [莉倬鹸 1: 謗ｨ螂ｨ縺輔ｌ繧九し繝ｼ繝峨ヱ繝ｼ繝繧｣陬ｽ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ](appendix_1.html) + * [莉倬鹸 2: 蟒豁｢縺輔ｌ縺 API](appendix_2.html) diff --git a/doc/api/addons.markdown b/doc/api/addons.markdown index e280c7ae2cae..1803c8030519 100644 --- a/doc/api/addons.markdown +++ b/doc/api/addons.markdown @@ -5,19 +5,19 @@ Addons are dynamically linked shared objects. They can provide glue to C and C++ libraries. The API (at the moment) is rather complex, involving knowledge of several libraries: --> -アドオンは動的に共有オブジェクトをリンクします。 -それらは、C や C++ のライブラリに接合点を提供します。 -API はいくつかのライブラリの知識が必要で、(現時点では) かなり複雑です。 +繧｢繝峨が繝ｳ縺ｯ蜍慕噪縺ｫ蜈ｱ譛峨が繝悶ず繧ｧ繧ｯ繝医ｒ繝ｪ繝ｳ繧ｯ縺励∪縺吶 +縺昴ｌ繧峨ｯ縲， 繧 C++ 縺ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｫ謗･蜷育せ繧呈署萓帙＠縺ｾ縺吶 +API 縺ｯ縺縺上▽縺九ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｮ遏･隴倥′蠢隕√〒縲(迴ｾ譎らせ縺ｧ縺ｯ) 縺九↑繧願､髮代〒縺吶 - - V8 JavaScript は C++ のライブラリです。 - JavaScript のオブジェクト作成や関数呼び出し等のインタフェースに使用されます。 - ドキュメントは主に、`v8.h` のヘッダファイル - (Node のソースツリーの中の `deps/v8/include/v8.h`) に記されています。 + - V8 JavaScript 縺ｯ C++ 縺ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｧ縺吶 + JavaScript 縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝井ｽ懈舌ｄ髢｢謨ｰ蜻ｼ縺ｳ蜃ｺ縺礼ｭ峨ｮ繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｫ菴ｿ逕ｨ縺輔ｌ縺ｾ縺吶 + 繝峨く繝･繝｡繝ｳ繝医ｯ荳ｻ縺ｫ縲〜v8.h` 縺ｮ繝倥ャ繝繝輔ぃ繧､繝ｫ + (Node 縺ｮ繧ｽ繝ｼ繧ｹ繝繝ｪ繝ｼ縺ｮ荳ｭ縺ｮ `deps/v8/include/v8.h`) 縺ｫ險倥＆繧後※縺縺ｾ縺吶 - - libev は C の event loop ライブラリです。 - ファイル記述子が読み取り可能になるのを待つとき、タイマーを待つとき、シグナルを受信するのを待つときはいつでも、 - libv のインタフェースが必要になります。 - つまり、何らかの I/O 処理をすると必ず libev を使う必要があるということです。 - Node は `EV_DEFAULT` というイベントループを使います。 - ドキュメントは、[こちら](http:/cvs.schmorp.de/libev/ev.html) にあります。 + - libev 縺ｯ C 縺ｮ event loop 繝ｩ繧､繝悶Λ繝ｪ縺ｧ縺吶 + 繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌′隱ｭ縺ｿ蜿悶ｊ蜿ｯ閭ｽ縺ｫ縺ｪ繧九ｮ繧貞ｾ縺､縺ｨ縺阪√ち繧､繝槭ｼ繧貞ｾ縺､縺ｨ縺阪√す繧ｰ繝翫Ν繧貞女菫｡縺吶ｋ縺ｮ繧貞ｾ縺､縺ｨ縺阪ｯ縺縺､縺ｧ繧ゅ + libv 縺ｮ繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺悟ｿ隕√↓縺ｪ繧翫∪縺吶 + 縺､縺ｾ繧翫∽ｽ輔ｉ縺九ｮ I/O 蜃ｦ逅繧偵☆繧九→蠢縺 libev 繧剃ｽｿ縺蠢隕√′縺ゅｋ縺ｨ縺縺縺薙→縺ｧ縺吶 + Node 縺ｯ `EV_DEFAULT` 縺ｨ縺縺繧､繝吶Φ繝医Ν繝ｼ繝励ｒ菴ｿ縺縺ｾ縺吶 + 繝峨く繝･繝｡繝ｳ繝医ｯ縲ー縺薙■繧云(http:/cvs.schmorp.de/libev/ev.html) 縺ｫ縺ゅｊ縺ｾ縺吶 - - libeio は C のスレッドプールライブラリです。 - ブロックする POSIX システムコールを非同期に実行するために使用されます。 - こういった呼び出しのための大抵のラッパーは、既に `src/file.cc` に用意されているので、 - おそらくこれを使う必要はないしょう。 - 必要になったら、`deps/libeio/eio.h` のヘッダファイルを参照して下さい。 + - libeio 縺ｯ C 縺ｮ繧ｹ繝ｬ繝繝峨励ｼ繝ｫ繝ｩ繧､繝悶Λ繝ｪ縺ｧ縺吶 + 繝悶Ο繝繧ｯ縺吶ｋ POSIX 繧ｷ繧ｹ繝繝繧ｳ繝ｼ繝ｫ繧帝撼蜷梧悄縺ｫ螳溯｡後☆繧九◆繧√↓菴ｿ逕ｨ縺輔ｌ縺ｾ縺吶 + 縺薙≧縺縺｣縺溷他縺ｳ蜃ｺ縺励ｮ縺溘ａ縺ｮ螟ｧ謚ｵ縺ｮ繝ｩ繝繝代ｼ縺ｯ縲∵里縺ｫ `src/file.cc` 縺ｫ逕ｨ諢上＆繧後※縺繧九ｮ縺ｧ縲 + 縺翫◎繧峨￥縺薙ｌ繧剃ｽｿ縺蠢隕√ｯ縺ｪ縺縺励ｇ縺縲 + 蠢隕√↓縺ｪ縺｣縺溘ｉ縲〜deps/libeio/eio.h` 縺ｮ繝倥ャ繝繝輔ぃ繧､繝ｫ繧貞盾辣ｧ縺励※荳九＆縺縲 - - Node の内部ライブラリ。 - もっとも重要なのは `node::ObjectWrap` クラスで、 - このクラスから派生させることが多くなるでしょう。 + - Node 縺ｮ蜀驛ｨ繝ｩ繧､繝悶Λ繝ｪ縲 + 繧ゅ▲縺ｨ繧る崎ｦ√↑縺ｮ縺ｯ `node::ObjectWrap` 繧ｯ繝ｩ繧ｹ縺ｧ縲 + 縺薙ｮ繧ｯ繝ｩ繧ｹ縺九ｉ豢ｾ逕溘＆縺帙ｋ縺薙→縺悟､壹￥縺ｪ繧九〒縺励ｇ縺縲 - - その他。どのような物が利用できるかは `deps/` 以下を参照してさい。 + - 縺昴ｮ莉悶ゅ←縺ｮ繧医≧縺ｪ迚ｩ縺悟茜逕ｨ縺ｧ縺阪ｋ縺九ｯ `deps/` 莉･荳九ｒ蜿らｧ縺励※縺輔＞縲 -Node は全ての依存ライブラリを実行ファイルに静的にコンパイルします。 -モジュールのコンパイル時には、それらのリンクについて一切気にする必要は有りません。 +Node 縺ｯ蜈ｨ縺ｦ縺ｮ萓晏ｭ倥Λ繧､繝悶Λ繝ｪ繧貞ｮ溯｡後ヵ繧｡繧､繝ｫ縺ｫ髱咏噪縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励∪縺吶 +繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繧ｳ繝ｳ繝代う繝ｫ譎ゅ↓縺ｯ縲√◎繧後ｉ縺ｮ繝ｪ繝ｳ繧ｯ縺ｫ縺､縺縺ｦ荳蛻豌励↓縺吶ｋ蠢隕√ｯ譛峨ｊ縺ｾ縺帙ｓ縲 -では、 C++ で以下の様に動作する小さなアドオンを作成してみましょう。 +縺ｧ縺ｯ縲 C++ 縺ｧ莉･荳九ｮ讒倥↓蜍穂ｽ懊☆繧句ｰ上＆縺ｪ繧｢繝峨が繝ｳ繧剃ｽ懈舌＠縺ｦ縺ｿ縺ｾ縺励ｇ縺縲 exports.hello = 'world'; -まず `hello.cc` というファイルを作成します: +縺ｾ縺 `hello.cc` 縺ｨ縺縺繝輔ぃ繧､繝ｫ繧剃ｽ懈舌＠縺ｾ縺: #include @@ -96,8 +96,8 @@ This source code needs to be built into `hello.node`, the binary Addon. To do this we create a file called `wscript` which is python code and looks like this: --> -このソースコードは、`hello.node` というバイナリアドオンとしてビルドされる必要が有ります。 -そのために `wscript` と呼ばれる以下のようなコードを Python で書きました: +縺薙ｮ繧ｽ繝ｼ繧ｹ繧ｳ繝ｼ繝峨ｯ縲〜hello.node` 縺ｨ縺縺繝舌う繝翫Μ繧｢繝峨が繝ｳ縺ｨ縺励※繝薙Ν繝峨＆繧後ｋ蠢隕√′譛峨ｊ縺ｾ縺吶 +縺昴ｮ縺溘ａ縺ｫ `wscript` 縺ｨ蜻ｼ縺ｰ繧後ｋ莉･荳九ｮ繧医≧縺ｪ繧ｳ繝ｼ繝峨ｒ Python 縺ｧ譖ｸ縺阪∪縺励◆: srcdir = '.' blddir = 'build' @@ -119,19 +119,19 @@ like this: Running `node-waf configure build` will create a file `build/default/hello.node` which is our Addon. --> -`node-waf configure build` を実行すると、`build/default/hello.node` が作成されます。これが作成したアドオンです。 +`node-waf configure build` 繧貞ｮ溯｡後☆繧九→縲〜build/default/hello.node` 縺御ｽ懈舌＆繧後∪縺吶ゅ％繧後′菴懈舌＠縺溘い繝峨が繝ｳ縺ｧ縺吶 -`node-waf` は [WAF](http://code.google.com/p/waf/) にある Python ベースのビルドシステムです。 -`node-waf` は、ユーザの負担を減らすために提供されています。 +`node-waf` 縺ｯ [WAF](http://code.google.com/p/waf/) 縺ｫ縺ゅｋ Python 繝吶ｼ繧ｹ縺ｮ繝薙Ν繝峨す繧ｹ繝繝縺ｧ縺吶 +`node-waf` 縺ｯ縲√Θ繝ｼ繧ｶ縺ｮ雋諡繧呈ｸ帙ｉ縺吶◆繧√↓謠蝉ｾ帙＆繧後※縺縺ｾ縺吶 -全ての Node アドオンは次のシグネチャを持つ `init` という関数をエクスポートする必要が有ります: +蜈ｨ縺ｦ縺ｮ Node 繧｢繝峨が繝ｳ縺ｯ谺｡縺ｮ繧ｷ繧ｰ繝阪メ繝｣繧呈戟縺､ `init` 縺ｨ縺縺髢｢謨ｰ繧偵お繧ｯ繧ｹ繝昴ｼ繝医☆繧句ｿ隕√′譛峨ｊ縺ｾ縺: extern 'C' void init (Handle target) @@ -139,5 +139,5 @@ All Node addons must export a function called `init` with this signature: For the moment, that is all the documentation on addons. Please see for a real example. --> -現時点では、アドオンのドキュメントはこれで全てです。 -実際の例は、 を参照してください。 +迴ｾ譎らせ縺ｧ縺ｯ縲√い繝峨が繝ｳ縺ｮ繝峨く繝･繝｡繝ｳ繝医ｯ縺薙ｌ縺ｧ蜈ｨ縺ｦ縺ｧ縺吶 +螳滄圀縺ｮ萓九ｯ縲 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 From 3f962e926a518b576401160cbfe0e8360afb88cd Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 17:09:14 +0900 Subject: [PATCH 05/40] translated appendex_1 --- doc/api/appendix_1.markdown | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/api/appendix_1.markdown b/doc/api/appendix_1.markdown index 3274fdacd38d..99a20d87ada1 100644 --- a/doc/api/appendix_1.markdown +++ b/doc/api/appendix_1.markdown @@ -1,13 +1,23 @@ ## Appendix 1 - Third Party Modules + +Node 蜷代¢縺ｫ繧ｵ繝ｼ繝峨ヱ繝ｼ繝繧｣陬ｽ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺梧焚螟壹￥縺ゅｊ縺ｾ縺吶 +蝓ｷ遲譎らせ (2010 蟷ｴ 8 譛) 縺ｧ縺ｯ縲√Δ繧ｸ繝･繝ｼ繝ｫ縺ｮ繝槭せ繧ｿ繝ｪ繝昴ず繝医Μ縺ｯ +http://github.com/ry/node/wiki/modules[wiki 繝壹ｼ繧ｸ] 縺ｧ縺吶 + +縺薙ｮ莉倬鹸縺ｯ縲∬憶雉ｪ縺縺ｨ閠縺医ｉ繧後※縺繧九Δ繧ｸ繝･繝ｼ繝ｫ繧貞晏ｿ閠縺檎ｴ譌ｩ縺剰ｦ九▽縺代ｋ縺薙→繧呈焔蜉ｩ縺代☆繧九悟ｰ上＆縺ｪ縲阪ぎ繧､繝峨ｒ諢丞峙縺励※縺縺ｾ縺吶 +縺薙ｌ縺ｯ螳悟ｨ縺ｪ繝ｪ繧ｹ繝医ｯ諢丞峙縺励※縺縺ｾ縺帙ｓ縲 +縺ｩ縺薙°縺ｧ繧医ｊ螳悟ｨ縺ｪ繝｢繧ｸ繝･繝ｼ繝ｫ縺瑚ｦ九▽縺九ｋ縺九ｂ縺励ｌ縺ｾ縺帙ｓ縲 - Module Installer: [npm](http://github.com/isaacs/npm) @@ -41,4 +51,7 @@ elsewhere. [expresso](http://github.com/visionmedia/expresso), [mjsunit.runner](http://github.com/tmpvar/mjsunit.runner) + +縺薙ｮ繝ｪ繧ｹ繝医∈縺ｮ繝代ャ繝√ｒ豁楢ｿ弱＠縺ｾ縺吶 From fb2b3e2df07e5d4ec6a1853c96b03de73c22631c Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 17:19:08 +0900 Subject: [PATCH 06/40] translated assert --- doc/api/assert.markdown | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/doc/api/assert.markdown b/doc/api/assert.markdown index 6f5e91a984c9..db34f1334cc5 100644 --- a/doc/api/assert.markdown +++ b/doc/api/assert.markdown @@ -1,48 +1,87 @@ ## Assert + +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ繧｢繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺ｮ蜊倅ｽ薙ユ繧ｹ繝医ｒ險倩ｿｰ縺吶ｋ縺溘ａ縺ｫ菴ｿ逕ｨ縺輔ｌ縲 +`require('assert')` 縺ｧ繧｢繧ｯ繧ｻ繧ｹ縺ｧ縺阪∪縺吶 ### assert.fail(actual, expected, message, operator) + +`actual` 縺 `expected` 縺ｨ遲峨＠縺縺九∵署萓帙＆繧後◆貍皮ｮ怜ｭ舌ｒ菴ｿ縺｣縺ｦ繝繧ｹ繝医＠縺ｾ縺吶 ### assert.ok(value, [message]) + +`value` 縺 `true` 縺九ユ繧ｹ繝医＠縺ｾ縺吶 +縺薙ｌ縺ｯ `assert.equal(true, value, message);` 縺ｨ遲我ｾ｡縺ｧ縺吶 ### assert.equal(actual, expected, [message]) + +`==` 貍皮ｮ怜ｭ舌ｒ蠑ｷ蛻ｶ縺励※豬縺蜷悟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.notEqual(actual, expected, [message]) + +`==` 貍皮ｮ怜ｭ舌ｒ蠑ｷ蛻ｶ縺励※豬縺髱槫酔蛟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.deepEqual(actual, expected, [message]) + +豺ｱ縺蜷悟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.notDeepEqual(actual, expected, [message]) + +豺ｱ縺髱槫酔蛟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.strictEqual(actual, expected, [message]) + +`===` 貍皮ｮ怜ｭ舌〒蜴ｳ蟇縺ｪ蜷悟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.notStrictEqual(actual, expected, [message]) + +`!==` 貍皮ｮ怜ｭ舌〒蜴ｳ蟇縺ｪ髱槫酔蛟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.throws(block, [error], [message]) + +`block` 縺後お繝ｩ繝ｼ繧偵せ繝ｭ繝ｼ縺吶ｋ縺薙→繧呈悄蠕縺励∪縺吶 ### assert.doesNotThrow(block, [error], [message]) + +`block` 縺後お繝ｩ繝ｼ繧偵せ繝ｭ繝ｼ縺励↑縺縺薙→繧呈悄蠕縺励∪縺吶 ### assert.ifError(value) + +`value` 縺 false 縺ｧ縺ｪ縺縺薙→繧偵ユ繧ｹ繝医＠縲》rue 縺縺｣縺溘ｉ縺昴ｌ繧偵せ繝ｭ繝ｼ縺励∪縺吶 +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｮ隨ｬ 1 蠑墓焚縺ｧ縺ゅｋ `error` 繧偵ユ繧ｹ繝医☆繧九ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 From ab26b895e562776a5a36950f69651d50dbbb4793 Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 17:43:59 +0900 Subject: [PATCH 07/40] translated buffers --- doc/api/buffers.markdown | 90 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) diff --git a/doc/api/buffers.markdown b/doc/api/buffers.markdown index 33fbed55843c..7221c2366d84 100644 --- a/doc/api/buffers.markdown +++ b/doc/api/buffers.markdown @@ -1,19 +1,38 @@ ## Buffers + +邏皮ｲ九↑ JavaScript 縺ｯ Unicode 縺ｨ逶ｸ諤ｧ縺後＞縺繧ゅｮ縺ｮ縲√ヰ繧､繝翫Μ繝繝ｼ繧ｿ縺ｮ謇ｱ縺縺ｯ縺縺ｾ縺上≠繧翫∪縺帙ｓ縲 +TCP 繧ｹ繝医Μ繝ｼ繝繧繝輔ぃ繧､繝ｫ繧ｷ繧ｹ繝繝繧呈桶縺蝣ｴ蜷医ｯ縲√が繧ｯ繝繝繝医せ繝医Μ繝ｼ繝繧貞ｦ逅縺吶ｋ蠢隕√′縺ゅｊ縺ｾ縺吶 +Node 縺ｫ縺ｯ繧ｪ繧ｯ繝繝繝医せ繝医Μ繝ｼ繝繧呈桃菴懊∽ｽ懈舌∵ｶ郁ｲｻ縺吶ｋ縺溘ａ縺ｫ縺縺上▽縺九ｮ謌ｦ逡･縺後≠繧翫∪縺吶 + +逕溘ｮ繝繝ｼ繧ｿ縺ｯ `Buffer` 繧ｯ繝ｩ繧ｹ縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｫ菫晏ｭ倥＆繧後∪縺吶 +`Buffer` 縺ｯ謨ｴ謨ｰ縺ｮ驟榊励→莨ｼ縺ｦ縺縺ｾ縺吶′縲 +V8 繝偵ｼ繝励ｮ螟夜Κ縺ｫ蜑ｲ繧雁ｽ薙※繧峨ｌ縺溽函縺ｮ繝｡繝｢繝ｪ縺ｫ蟇ｾ蠢懊＠縺ｾ縺吶 +`Buffer` 縺ｮ繧ｵ繧､繧ｺ繧貞､画峩縺吶ｋ縺薙→縺ｯ縺ｧ縺阪∪縺帙ｓ縲 + +`Buffer` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ繧ｰ繝ｭ繝ｼ繝舌Ν縺ｧ縺吶 + +繝舌ャ繝輔ぃ繧 JavaScript 譁蟄怜励が繝悶ず繧ｧ繧ｯ繝医→縺ｮ髢薙〒螟画鋤縺吶ｋ縺ｫ縺ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上ｒ譏守､ｺ縺吶ｋ蠢隕√′縺ゅｊ縺ｾ縺吶 +縺縺上▽縺九ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上′縺ゅｊ縺ｾ縺吶 + +* `'ascii'` - 7bit 縺ｮ ASCII 繝繝ｼ繧ｿ蟆ら畑縺ｧ縺吶 + 縺薙ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上ｯ縺ｨ縺ｦ繧るｫ倬溘〒縲√ｂ縺嶺ｸ贋ｽ阪ン繝繝医′繧ｻ繝繝医＆繧後※縺繧後ｰ蜿悶ｊ髯､縺九ｌ縺ｾ縺吶 +* `'utf8'` - Unicode譁蟄励 + 螟壹￥縺ｮWeb繝壹ｼ繧ｸ繧縺昴ｮ莉悶ｮ繝峨く繝･繝｡繝ｳ繝医ｯ UTF-8 繧剃ｽｿ縺｣縺ｦ縺縺ｾ縺吶 +* `'base64'` - Base64 譁蟄怜励お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ. +* `'binary'` - 逕溘ｮ繝舌う繝翫Μ繝繝ｼ繧ｿ繧貞推譁蟄励ｮ譛蛻昴ｮ 8bit 縺ｨ縺励※菴ｿ逕ｨ縺吶ｋ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上 +縺薙ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上ｯ繧ゅｯ繧萓｡蛟､縺後↑縺上〜Buffer` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺ｯ蜿ｯ閭ｽ縺ｪ髯舌ｊ菴ｿ逕ｨ縺吶∋縺阪〒縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 +縺薙ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ縲¨ode 縺ｮ蟆譚･縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ蜑企勁縺輔ｌ繧倶ｺ亥ｮ壹〒縺吶 ### new Buffer(size) + +`size` 繧ｪ繧ｯ繝繝繝医ｮ譁ｰ縺励＞繝舌ャ繝輔ぃ繧貞牡繧雁ｽ薙※縺ｾ縺吶 ### new Buffer(array) + +繧ｪ繧ｯ繝繝繝医ｮ `array` 繧剃ｽｿ逕ｨ縺吶ｋ譁ｰ縺励＞繝舌ャ繝輔ぃ繧貞牡繧雁ｽ薙※縺ｾ縺吶 ### new Buffer(str, encoding='utf8') + +荳弱∴繧峨ｌ縺 `str` 繧貞螳ｹ縺ｨ縺吶ｋ譁ｰ縺励＞繝舌ャ繝輔ぃ繧貞牡繧雁ｽ薙※縺ｾ縺吶 ### buffer.write(string, offset=0, encoding='utf8') + +荳弱∴繧峨ｌ縺溘お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧剃ｽｿ逕ｨ縺励※縲〜string` 繧偵ヰ繝繝輔ぃ縺ｮ `offset` 縺九ｉ譖ｸ縺崎ｾｼ縺ｿ縺ｾ縺吶 +譖ｸ縺崎ｾｼ縺ｾ繧後◆繧ｪ繧ｯ繝繝繝域焚繧定ｿ斐＠縺ｾ縺吶 +繧ゅ＠ `buffer` 縺梧枚蟄怜怜ｨ菴薙ｒ謖ｿ蜈･縺吶ｋ縺ｮ縺ｫ蜊∝縺ｪ繧ｹ繝壹ｼ繧ｹ繧貞性繧薙〒縺縺ｪ縺代ｌ縺ｰ縲∵枚蟄怜励ｮ荳驛ｨ縺縺代ｒ譖ｸ縺崎ｾｼ縺ｿ縺ｾ縺吶 +`'utf8'` 繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｮ蝣ｴ蜷医√％縺ｮ繝｡繧ｽ繝繝峨ｯ譁蟄励ｮ荳驛ｨ縺縺代ｒ譖ｸ縺崎ｾｼ繧縺薙→縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 + +萓: utf8 縺ｮ譁蟄怜励ｒ繝舌ャ繝輔ぃ縺ｫ譖ｸ縺崎ｾｼ縺ｿ縲√◎繧後ｒ繝励Μ繝ｳ繝医＠縺ｾ縺 buf = new Buffer(256); len = buf.write('\u00bd + \u00bc = \u00be', 0); @@ -57,18 +103,33 @@ Example: write a utf8 string into a buffer, then print it ### buffer.toString(encoding, start=0, end=buffer.length) + +`encoding` 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆繝舌ャ繝輔ぃ繝繝ｼ繧ｿ縺ｮ `start` 縺九ｉ +`end` 縺ｾ縺ｧ繧偵ョ繧ｳ繝ｼ繝峨＠縺滓枚蟄怜励ｒ霑斐＠縺ｾ縺吶 + +荳翫ｮ `buffer.write()` 縺ｮ萓九ｒ蜿らｧ縺励※縺上□縺輔＞縲 ### buffer[index] + +`index` 縺ｮ菴咲ｽｮ縺ｮ繧ｪ繧ｯ繝繝繝医ｒ蜿門ｾ励♀繧医ｳ險ｭ螳壹＠縺ｾ縺吶 +縺昴ｮ蛟､縺ｯ蛟九縺ｮ繝舌う繝医ｒ蜿らｧ縺吶ｋ縺ｮ縺ｧ縲∝ｦ･蠖薙↑遽蝗ｲ縺ｯ 16 騾ｲ縺ｮ `0x00` 縺九ｉ `0xFF` +縺ｾ縺溘ｯ `0` 縺九ｉ`255`縺ｾ縺ｧ縺ｮ髢薙〒縺吶 + +萓: ASCII 譁蟄怜励ｒ 1 繝舌う繝医★縺､繝舌ャ繝輔ぃ縺ｫ繧ｳ繝斐ｼ縺励∪縺 str = "node.js"; buf = new Buffer(str.length); @@ -84,11 +145,18 @@ Example: copy an ASCII string into a buffer, one byte at a time: ### Buffer.byteLength(string, encoding='utf8') + +譁蟄怜励ｮ螳滄圀縺ｮ繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 +縺薙ｌ縺ｯ譁蟄怜励ｮ*譁蟄*謨ｰ繧定ｿ斐☆ `String.prototype.length` 縺ｨ蜷後§縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 + +萓: str = '\u00bd + \u00bc = \u00be'; @@ -100,9 +168,14 @@ Example: ### buffer.length + +繝舌う繝域焚縺ｫ繧医ｋ繝舌ャ繝輔ぃ縺ｮ繧ｵ繧､繧ｺ縲 +縺薙ｌ縺ｯ螳滄圀縺ｮ蜀螳ｹ縺ｮ繧ｵ繧､繧ｺ縺ｧ縺ｯ縺ｪ縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +`length` 縺ｯ繝舌ャ繝輔ぃ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蜑ｲ繧雁ｽ薙※繧峨ｌ縺溘Γ繝｢繝ｪ蜈ｨ菴薙ｒ蜿らｧ縺励∪縺吶 buf = new Buffer(1234); @@ -115,10 +188,17 @@ buffer object. It does not change when the contents of the buffer are changed. ### buffer.copy(targetBuffer, targetStart, sourceStart, sourceEnd=buffer.length) + +繝舌ャ繝輔ぃ髢薙〒 memcpy() 繧偵＠縺ｾ縺吶 + +萓: 繝舌ャ繝輔ぃ繧2蛟倶ｽ懈舌＠縲〜buf1` 縺ｮ 16 繝舌う繝育岼縺九ｉ 19 繝舌う繝育岼繧偵 +`buf2` 縺ｮ 8 繝舌う繝育岼縺九ｉ蟋九∪繧倶ｽ咲ｽｮ縺ｸ繧ｳ繝斐ｼ縺励∪縺吶 buf1 = new Buffer(26); buf2 = new Buffer(26); @@ -136,14 +216,24 @@ into `buf2`, starting at the 8th byte in `buf2`. ### buffer.slice(start, end=buffer.length) + +蜈縺ｮ繝舌ャ繝輔ぃ縺ｨ蜷後§繝｡繝｢繝ｪ繧貞盾辣ｧ縺励∪縺吶′縲〜start` 縺ｨ `end` +縺ｧ遉ｺ縺輔ｌ繧九が繝輔そ繝繝医〒蟋九∪繧顔洒縺上＆繧後◆譁ｰ縺励＞繝舌ャ繝輔ぃ繧定ｿ斐＠縺ｾ縺吶 + +**譁ｰ縺励＞繝舌ャ繝輔ぃ繧ｹ繝ｩ繧､繧ｹ縺ｮ螟画峩縺ｯ縲√が繝ｪ繧ｸ繝翫Ν繝舌ャ繝輔ぃ縺ｮ繝｡繝｢繝ｪ繧貞､画峩縺吶ｋ縺薙→縺ｫ縺ｪ繧翫∪縺呻ｼ** + +萓: ASCII 縺ｮ繧｢繝ｫ繝輔ぃ繝吶ャ繝医〒繝舌ャ繝輔ぃ繧呈ｧ狗ｯ峨＠縺ｦ繧ｹ繝ｩ繧､繧ｹ縺励∝縺ｮ繝舌ャ繝輔ぃ縺ｧ 1 繝舌う繝医ｒ螟画峩縺励∪縺吶 var buf1 = new Buffer(26); From 88a842dee3af511b61b610162b7e52d5d608fa54 Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 18:06:06 +0900 Subject: [PATCH 08/40] translated child_processes --- doc/api/child_processes.markdown | 102 ++++++++++++++++++++++++++++++- 1 file changed, 100 insertions(+), 2 deletions(-) diff --git a/doc/api/child_processes.markdown b/doc/api/child_processes.markdown index d186a94d9d0a..eb452612c3bf 100644 --- a/doc/api/child_processes.markdown +++ b/doc/api/child_processes.markdown @@ -1,47 +1,90 @@ ## Child Processes + +Node縺ｯ `ChildProcess` 繧ｯ繝ｩ繧ｹ繧帝壹§縺ｦ 3 譁ｹ蜷代ｮ `popen(3)` 讖溯ｽ繧呈署萓帙＠縺ｾ縺吶 + +縺昴ｌ縺ｯ螳悟ｨ縺ｫ繝弱Φ繝悶Ο繝繧ｭ繝ｳ繧ｰ縺ｪ譁ｹ豕輔〒蟄舌励Ο繧ｻ繧ｹ縺ｮ `stdin`縲〜stdout`縲 +縺昴＠縺ｦ `stderr` 繧帝壹§縺溘ョ繝ｼ繧ｿ繧ｹ繝医Μ繝ｼ繝繧貞ｮ溽樟縺励∪縺吶 + +蟄舌励Ο繧ｻ繧ｹ縺ｮ逕滓舌ｯ `require('child_process').spawn()` 繧剃ｽｿ縺縺ｾ縺吶 + +蟄舌励Ο繧ｻ繧ｹ縺ｯ蟶ｸ縺ｫ 3 譛ｬ縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｨ髢｢騾｣縺･縺代ｉ繧後※縺縺ｾ縺吶 +`child.stdin`縲〜child.stdout`縲√◎縺励※ `child.stderr` 縺ｧ縺吶 + +`ChildProcess` 縺ｯ `EventEmitter` 縺ｧ縺吶 ### Event: 'exit' `function (code, signal) {}` + +縺薙ｮ繧､繝吶Φ繝医ｯ蟄舌励Ο繧ｻ繧ｹ縺檎ｵゆｺ縺励◆蠕後〒逕滓舌＆繧後∪縺吶 +繝励Ο繧ｻ繧ｹ縺梧勸騾壹↓邨ゆｺ縺励◆蝣ｴ蜷医〜code` 縺ｯ繝励Ο繧ｻ繧ｹ縺ｮ邨ゆｺ繧ｳ繝ｼ繝峨〒縺吶 +縺昴ｌ莉･螟悶ｮ蝣ｴ蜷医ｯ `null` 縺ｧ縺吶 +繝励Ο繧ｻ繧ｹ縺後す繧ｰ繝翫Ν繧貞女縺大叙縺｣縺ｦ邨ゆｺ縺励◆蝣ｴ蜷医〜signal` 縺ｯ譁蟄怜励↓繧医ｋ繧ｷ繧ｰ繝翫Ν縺ｮ蜷榊燕縺ｧ縺吶 +縺昴ｌ莉･螟悶ｮ蝣ｴ蜷医ｯ `null` 縺ｧ縺吶 + + +`waitpid(2)` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### child.stdin + +蟄舌励Ο繧ｻ繧ｹ縺ｮ `stdin` 繧定｡ｨ迴ｾ縺吶ｋ `Writable Stream` 縺ｧ縺吶 +螟壹￥縺ｮ蝣ｴ蜷医〜end()` 繧帝壹§縺ｦ縺薙ｮ繧ｹ繝医Μ繝ｼ繝繧帝哩縺倥ｋ縺ｨ蟄舌励Ο繧ｻ繧ｹ縺檎ｵゆｺ縺吶ｋ蜴溷屏縺ｨ縺ｪ繧翫∪縺吶 ### child.stdout + +蟄舌励Ο繧ｻ繧ｹ縺ｮ `stdout` 繧定｡ｨ迴ｾ縺吶ｋ `Readable Stream` 縺ｧ縺吶 ### child.stderr + +蟄舌励Ο繧ｻ繧ｹ縺ｮ `stderr` 繧定｡ｨ迴ｾ縺吶ｋ `Readable Stream` 縺ｧ縺吶 ### child.pid + +蟄舌励Ο繧ｻ繧ｹ縺ｮ PID 縺ｧ縺吶 + +萓: var spawn = require('child_process').spawn, grep = spawn('grep', ['ssh']); @@ -52,22 +95,38 @@ Example: ### child_process.spawn(command, args=[], [options]) + +`args` 繧偵さ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚縺ｨ縺励※縲∽ｸ弱∴繧峨ｌ縺 `command` 縺ｧ譁ｰ縺励＞繝励Ο繧ｻ繧ｹ繧定ｵｷ蜍輔＠縺ｾ縺吶 +`args` 縺檎怐逡･縺輔ｌ縺溷ｴ蜷医∫ｩｺ縺ｮ驟榊励′繝繝輔か繝ｫ繝医→縺ｪ繧翫∪縺吶 + +隨ｬ 3 蠑墓焚縺ｯ霑ｽ蜉縺ｮ繧ｪ繝励す繝ｧ繝ｳ繧呈欠螳壹☆繧九◆繧√↓菴ｿ繧上ｌ縲√◎縺ｮ繝繝輔か繝ｫ繝医ｯ: { cwd: undefined , env: process.env, , customFds: [-1, -1, -1] } + +`cwd` 縺ｧ襍ｷ蜍輔＆繧後◆繝励Ο繧ｻ繧ｹ縺ｮ繝ｯ繝ｼ繧ｭ繝ｳ繧ｰ繝繧｣繝ｬ繧ｯ繝医Μ繧呈欠螳壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 +`env` 縺ｯ譁ｰ縺励＞繝励Ο繧ｻ繧ｹ縺ｫ隕九∴繧狗腸蠅螟画焚繧呈欠螳壹☆繧九◆繧√↓菴ｿ縺縺ｾ縺吶 +`customFds` 縺ｯ譁ｰ縺励＞繝励Ο繧ｻ繧ｹ縺ｮ [stdin, stout, stderr] 繧呈里蟄倥ｮ繧ｹ繝医Μ繝ｼ繝縺ｫ謗･邯壹☆繧九％縺ｨ繧貞庄閭ｽ縺ｫ縺励∪縺; +`-1` 縺ｯ譁ｰ縺励＞繧ｹ繝医Μ繝ｼ繝縺御ｽ懊ｉ繧後↑縺代ｌ縺ｰ縺ｪ繧峨↑縺縺薙→繧呈э蜻ｳ縺励∪縺吶 + +`ls -lh /usr` 繧貞ｮ溯｡後＠縺ｦ `stdout`縲〜stderr`縲√♀繧医ｳ邨ゆｺ繧ｳ繝ｼ繝峨ｒ蜿門ｾ励☆繧倶ｾ: var util = require('util'), spawn = require('child_process').spawn, @@ -86,7 +145,10 @@ Example of running `ls -lh /usr`, capturing `stdout`, `stderr`, and the exit cod }); + +縺ｨ縺ｦ繧よ焔縺ｮ霎ｼ繧薙□譁ｹ豕輔〒螳溯｡後☆繧 'ps ax | grep ssh' 縺ｮ萓: var util = require('util'), spawn = require('child_process').spawn, @@ -123,7 +185,10 @@ Example: A very elaborate way to run 'ps ax | grep ssh' }); + +exec 縺ｮ螟ｱ謨励ｒ繝√ぉ繝繧ｯ縺吶ｋ萓: var spawn = require('child_process').spawn, child = spawn('bad_command'); @@ -135,12 +200,18 @@ Example of checking for failed exec: }); + +髢｢騾｣鬆逶ｮ: `child_process.exec()` ### child_process.exec(command, [options], callback) + +繧ｳ繝槭Φ繝峨ｒ蟄舌励Ο繧ｻ繧ｹ縺ｨ縺励※螳溯｡後＠縲√◎縺ｮ蜃ｺ蜉帙ｒ闢縺医※縲√◎縺ｮ蜈ｨ縺ｦ繧偵さ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ貂｡縺咎ｫ俶ｰｴ貅悶ｮ譁ｹ豕輔〒縺吶 var util = require('util'), exec = require('child_process').exec, @@ -155,12 +226,23 @@ output, and return it all in a callback. } }); + +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(error, stdout, stderr)` 繧貞ｾ励∪縺吶 +謌仙粥縺吶ｋ縺ｨ縲〜error` 縺ｯ `null` 縺ｫ縺ｪ繧翫∪縺吶 +繧ｨ繝ｩ繝ｼ縺縺ｨ縲〜error` 縺ｯ `Error` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｨ縺ｪ繧翫 +`err.code` 縺ｯ蟄舌励Ο繧ｻ繧ｹ縺ｮ邨ゆｺ繧ｳ繝ｼ繝峨 +`err.signal` 縺ｯ繝励Ο繧ｻ繧ｹ繧堤ｵゆｺ縺輔○縺溘す繧ｰ繝翫Ν縺ｨ縺ｪ繧翫∪縺吶 + + +莉ｻ諢上ｮ隨ｬ 2 蠑墓焚縺ｧ縺縺上▽縺九ｮ繧ｪ繝励す繝ｧ繝ｳ繧呈欠螳壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｮ繝繝輔か繝ｫ繝医ｯ { encoding: 'utf8' , timeout: 0 @@ -170,17 +252,28 @@ There is a second optional argument to specify several options. The default opti , env: null } + +繧ゅ＠ `timeout` 縺 0 繧医ｊ螟ｧ縺阪＞縺ｨ縲 +蟄舌励Ο繧ｻ繧ｹ縺ｯ螳溯｡梧凾髢薙′ `timeout` 繝溘Μ遘偵ｈ繧翫ｂ髟ｷ縺上↑繧九→ kill 縺輔ｌ縺ｾ縺吶 +蟄舌励Ο繧ｻ繧ｹ縺ｯ `killSignal` 縺ｧ kill 縺輔ｌ縺ｾ縺 (繝繝輔か繝ｫ繝: `'SIGTERM'`)縲 +`maxBuffer` 縺ｯ讓呎ｺ門ｺ蜉帙→讓呎ｺ悶お繝ｩ繝ｼ縺ｮ譛螟ｧ縺ｮ繝繝ｼ繧ｿ驥上ｒ謖螳壹＠縺ｾ縺 ｼ 縺薙ｮ蛟､繧定ｶ縺医ｋ縺ｨ蟄舌励Ο繧ｻ繧ｹ縺ｯ kill 縺輔ｌ縺ｾ縺吶 ### child.kill(signal='SIGTERM') + +蟄舌励Ο繧ｻ繧ｹ縺ｫ繧ｷ繧ｰ繝翫Ν繧帝√ｊ縺ｾ縺吶 +蠑墓焚縺御ｸ弱∴繧峨ｌ縺ｪ縺蝣ｴ蜷医∝ｭ舌励Ο繧ｻ繧ｹ縺ｫ縺ｯ `'SIGTERM'` 縺碁√ｉ繧後∪縺吶 +蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ繧ｷ繧ｰ繝翫Ν縺ｮ荳隕ｧ縺ｯ `signal(7)` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 var spawn = require('child_process').spawn, grep = spawn('grep', ['ssh']); @@ -192,7 +285,12 @@ be sent `'SIGTERM'`. See `signal(7)` for a list of available signals. // send SIGHUP to process grep.kill('SIGHUP'); + +縺薙ｮ髢｢謨ｰ縺ｯ `kill` 縺ｨ蜻ｼ縺ｰ繧後ｋ繧ゅｮ縺ｮ縲 +蟄舌励Ο繧ｻ繧ｹ縺ｫ螻翫¢繧峨ｌ繧九す繧ｰ繝翫Ν縺悟ｮ滄圀縺ｫ縺ｯ蟄舌励Ο繧ｻ繧ｹ繧呈ｮｺ縺輔↑縺縺九ｂ縺励ｌ縺ｪ縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +`kill` 縺ｯ縺溘□繝励Ο繧ｻ繧ｹ縺ｫ繧ｷ繧ｰ繝翫Ν繧帝√ｋ縺縺代〒縺吶 See `kill(2)` From 5c351b0ddd708ddc23b1928fe02c100f264cf249 Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 18:39:01 +0900 Subject: [PATCH 09/40] translated crypto --- doc/api/crypto.markdown | 124 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 124 insertions(+) diff --git a/doc/api/crypto.markdown b/doc/api/crypto.markdown index c38b37fce50f..500ce454d311 100644 --- a/doc/api/crypto.markdown +++ b/doc/api/crypto.markdown @@ -1,107 +1,231 @@ ## Crypto + +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｫ縺ｯ `require('crypto')` 繧剃ｽｿ逕ｨ縺励∪縺吶 + +證怜捷蛹悶Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ荳句ｱ､縺ｮ繝励Λ繝繝医ヵ繧ｩ繝ｼ繝縺ｧ OpenSSL 縺梧怏蜉ｹ縺ｧ縺ゅｋ縺薙→繧貞ｿ隕√→縺励∪縺吶 +縺昴ｌ縺ｯ螳牙ｨ縺ｪ HTTPS 繝阪ャ繝医Ρ繝ｼ繧ｯ繧 http 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ荳驛ｨ縺ｨ縺励※菴ｿ繧上ｌ繧九 +螳牙ｨ縺ｪ隱崎ｨｼ諠蝣ｱ繧偵き繝励そ繝ｫ蛹悶☆繧区婿豕輔ｒ謠蝉ｾ帙＠縺ｾ縺吶 + +蜷梧凾縺ｫ OpenSSL 縺ｮ繝上ャ繧ｷ繝･縲？MAC縲∵囓蜿ｷ縲∝ｾｩ蜿ｷ縲∫ｽｲ蜷阪√◎縺励※讀懆ｨｼ縺ｸ縺ｮ繝ｩ繝繝代ｼ繧剃ｸ蠑乗署萓帙＠縺ｾ縺吶 ### crypto.createCredentials(details) + +隱崎ｨｼ諠蝣ｱ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｾ縺吶ゅが繝励す繝ｧ繝ｳ縺ｮ `details` 縺ｯ莉･荳九ｮ繧ｭ繝ｼ繧呈戟縺､霎樊嶌縺ｧ縺: + +* `key` : PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆遘伜ｯ骰ｵ繧剃ｿ晄戟縺吶ｋ譁蟄怜 +* `cert` : PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆險ｼ譏取嶌繧剃ｿ晄戟縺吶ｋ譁蟄怜 +* `ca` : 菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌縺 PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆譁蟄怜励∪縺溘ｯ譁蟄怜励ｮ驟榊 + +'ca' 縺ｮ隧ｳ邏ｰ縺御ｸ弱∴繧峨ｌ縺ｪ縺九▲縺溷ｴ蜷医］ode.js 縺ｯ繝繝輔か繝ｫ繝医→縺励※ +http://mxr.mozilla.org/mozilla/source/security/nss/lib/ckfw/builtins/certdata.txt +縺ｧ荳弱∴繧峨ｌ繧九∽ｿ｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ蜈ｬ髢九＆繧後◆繝ｪ繧ｹ繝医ｒ菴ｿ逕ｨ縺励∪縺吶 ### crypto.createHash(algorithm) + +繝上ャ繧ｷ繝･繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ逕滓舌＠縺ｦ霑斐＠縺ｾ縺吶 +荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ繧医ｋ證怜捷繝上ャ繧ｷ繝･髢｢謨ｰ縺ｯ繝繧､繧ｸ繧ｧ繧ｹ繝医ｮ逕滓舌↓菴ｿ繧上ｌ縺ｾ縺吶 + +`algorithm` 縺ｯ縲√励Λ繝繝医ヵ繧ｩ繝ｼ繝荳翫ｮ OpenSSL +縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ繧ｵ繝昴ｼ繝医＆繧後※縺繧句茜逕ｨ蜿ｯ閭ｽ縺ｪ繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ萓晏ｭ倥＠縺ｾ縺吶 +萓九∴縺ｰ sha1縲［d5縲《ha256縲《ha512縲√↑縺ｩ縺ｧ縺吶 +譛霑代ｮ繝ｪ繝ｪ繝ｼ繧ｹ縺ｧ縺ｯ縲〜openssl list-message-digest-algorithms` +縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ繝繧､繧ｸ繧ｧ繧ｹ繝医い繝ｫ繧ｴ繝ｪ繧ｺ繝縺瑚｡ｨ遉ｺ縺輔ｌ縺ｾ縺吶 ### hash.update(data) + +荳弱∴繧峨ｌ縺 `data` 縺ｧ繝上ャ繧ｷ繝･縺ｮ蜀螳ｹ繧呈峩譁ｰ縺励∪縺吶 +縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### hash.digest(encoding='binary') + +貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ繝繝ｼ繧ｿ縺後ワ繝繧ｷ繝･蛹悶＆繧後◆繝繧､繧ｸ繧ｧ繧ｹ繝医ｒ險育ｮ励＠縺ｾ縺吶 +`encoding` 縺ｯ 'hex'縲'binary'縲√∪縺溘ｯ 'base64' 縺ｮ縺縺壹ｌ縺九〒縺吶 ### crypto.createHmac(algorithm, key) + +荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｨ繧ｭ繝ｼ縺ｧ HMAC 繧定ｨ育ｮ励☆繧九？MAC 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 + +`algorithm` 縺ｯ OpenSSL 縺ｧ繧ｵ繝昴ｼ繝医＆繧後※縺繧九い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ萓晏ｭ倥＠縺ｾ縺 ｼ +蜑崎ｿｰ縺ｮ `createHash` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### hmac.update(data) + +荳弱∴繧峨ｌ縺 `data` 縺ｧ HMAC 縺ｮ蜀螳ｹ繧呈峩譁ｰ縺励∪縺吶 +縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### hmac.digest(encoding='binary') + +貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ繝繝ｼ繧ｿ縺 HMAC 蛹悶＆繧後◆繝繧､繧ｸ繧ｧ繧ｹ繝医ｒ險育ｮ励＠縺ｾ縺吶 +`encoding` 縺ｯ 'hex'縲'binary'縲√∪縺溘ｯ 'base64' 縺ｮ縺縺壹ｌ縺九〒縺吶 ### crypto.createCipher(algorithm, key) + +荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｨ繧ｭ繝ｼ繧剃ｽｿ逕ｨ縺吶ｋ證怜捷繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 + +`algorithm` 縺ｯ縲＾penSSL 縺ｫ萓晏ｭ倥＠縺ｾ縺吶ゆｾ九∴縺ｰ aes192 縺ｪ縺ｩ縺ｧ縺吶 +譛霑代ｮ繝ｪ繝ｪ繝ｼ繧ｹ縺ｧ縺ｯ縲〜openssl list-cipher-algorithms` +縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ證怜捷繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝縺瑚｡ｨ遉ｺ縺輔ｌ縺ｾ縺吶 ### cipher.update(data, input_encoding='binary', output_encoding='binary') + +`data` 縺ｧ證怜捷繧呈峩譁ｰ縺励∪縺吶 +`input_encoding` 縺ｧ荳弱∴繧峨ｌ繧九お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ 'utf8'縲'ascii'縲'binary' 縺ｮ縺縺壹ｌ縺九〒縺吶 +`output_encoding` 縺ｯ證怜捷蛹悶＆繧後◆繝繝ｼ繧ｿ縺ｮ蜃ｺ蜉帙ヵ繧ｩ繝ｼ繝槭ャ繝医ｒ謖螳壹☆繧九ｂ縺ｮ縺ｧ縲 +'binary'縲'base64' 縺ｾ縺溘ｯ 'hex' 縺ｮ縺縺壹ｌ縺九〒縺吶 + +證怜捷蛹悶＆繧後◆繧ｳ繝ｳ繝繝ｳ繝縺瑚ｿ斐＆繧後∪縺吶ゅ％繧後ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### cipher.final(output_encoding='binary') + +證怜捷蛹悶＆繧後◆繧ｳ繝ｳ繝繝ｳ繝縺ｮ谿九ｊ繧定ｿ斐＠縺ｾ縺吶 +`output_encoding` 縺ｯ谺｡縺ｮ縺縺壹ｌ縺九〒縺: 'binary'縲'base64' 縺ｾ縺溘ｯ 'hex' ### crypto.createDecipher(algorithm, key) + +荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｨ繧ｭ繝ｼ繧剃ｽｿ逕ｨ縺吶ｋ蠕ｩ蜿ｷ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 +縺薙ｌ縺ｯ蜑崎ｿｰ縺ｮ證怜捷繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ髀｡蜀吶＠縺ｧ縺吶 ### decipher.update(data, input_encoding='binary', output_encoding='binary') + +'binary'縲'base64' 縺ｾ縺溘ｯ 'hex' 縺ｮ縺縺壹ｌ縺九〒繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆蠕ｩ蜿ｷ繧 `data` 縺ｧ譖ｴ譁ｰ縺励∪縺吶 +`output_decoding` 縺ｯ蠕ｩ蜿ｷ蛹悶＆繧後◆繝励Ξ繝ｼ繝ｳ繝繧ｭ繧ｹ繝医ｮ繝輔か繝ｼ繝槭ャ繝医ｒ謖螳壹☆繧九ｂ縺ｮ縺ｧ縲 +'binary'縲'ascii' 縺ゅｋ縺縺ｯ 'utf8' 縺ｮ縺縺壹ｌ縺九〒縺吶 ### decipher.final(output_encoding='binary') + +蠕ｩ蜿ｷ蛹悶＆繧後◆繝励Ξ繝ｼ繝ｳ繝繧ｭ繧ｹ繝医ｮ谿九ｊ繧定ｿ斐＠縺ｾ縺吶 +`output_decoding` 縺ｯ 'binary'縲'ascii' 縺ゅｋ縺縺ｯ 'utf8' 縺ｮ縺縺壹ｌ縺九〒縺吶 ### crypto.createSign(algorithm) + +荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｧ鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 +譛霑代ｮOpenSSL縺ｮ繝ｪ繝ｪ繝ｼ繧ｹ縺ｧ縺ｯ縲〜openssl list-public-key-algorithms` +縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ鄂ｲ蜷阪い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｮ荳隕ｧ縺瑚｡ｨ遉ｺ縺輔ｌ縺ｾ縺吶ゆｾ九∴縺ｰ 'RSA-SHA256'縲 ### signer.update(data) + +鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医ｒ繝繝ｼ繧ｿ縺ｧ譖ｴ譁ｰ縺励∪縺吶 +縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### signer.sign(private_key, output_format='binary') + +鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医↓貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ譖ｴ譁ｰ繝繝ｼ繧ｿ縺ｧ鄂ｲ蜷阪ｒ險育ｮ励＠縺ｾ縺吶 +`private_key` 縺ｯ PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆遘伜ｯ骰ｵ繧貞螳ｹ縺ｨ縺吶ｋ譁蟄怜励〒縺吶 + +'binary'縲'hex'縲√≠繧九＞縺ｯ 'base64' 縺ｮ縺縺壹ｌ縺九ｒ謖螳壹＠縺 `output_format` 縺ｫ繧医ｋ鄂ｲ蜷阪ｒ霑斐＠縺ｾ縺吶 ### crypto.createVerify(algorithm) + +荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｧ讀懆ｨｼ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶ゅ％繧後ｯ蜑崎ｿｰ縺ｮ鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医→髀｡蜀吶＠縺ｧ縺吶 ### verifier.update(data) + +讀懆ｨｼ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繝繝ｼ繧ｿ縺ｧ譖ｴ譁ｰ縺励∪縺吶 +縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### verifier.verify(public_key, signature, signature_format='binary') + +鄂ｲ蜷阪＆繧後◆繝繝ｼ繧ｿ繧 `public_key` 縺ｨ `signature` 縺ｧ讀懆ｨｼ縺励∪縺吶 +`public_key` 縺ｯ PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆蜈ｬ髢矩嵯繧貞性繧譁蟄怜励〒縺吶 +`signature` 縺ｯ蜈医↓險育ｮ励＠縺溘ョ繝ｼ繧ｿ縺ｮ鄂ｲ蜷阪〒縲 +縺昴ｮ `signature_format` 縺ｯ 'binary'縲'hex'縲√∪縺溘ｯ 'base64' 縺ｮ縺縺壹ｌ縺九〒縺吶 + +鄂ｲ蜷阪＆繧後◆繝繝ｼ繧ｿ縺ｨ蜈ｬ髢矩嵯縺ｫ繧医ｋ讀懆ｨｼ縺ｮ邨先棡縺ｫ繧医▲縺ｦ true 縺ｾ縺溘ｯ false 繧定ｿ斐＠縺ｾ縺吶 From 5cbe90b967dc4a0d853f48e07403a2f3a0fc57c5 Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 18:53:26 +0900 Subject: [PATCH 10/40] translate dgram --- doc/api/dgram.markdown | 92 ++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 89 insertions(+), 3 deletions(-) diff --git a/doc/api/dgram.markdown b/doc/api/dgram.markdown index 6b18d6578841..4a6649b6693b 100644 --- a/doc/api/dgram.markdown +++ b/doc/api/dgram.markdown @@ -1,45 +1,79 @@ ## dgram + +繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝医ｯ `require('dgram')` 縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｫ縺ｪ繧翫∪縺吶 +繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｯ縺ｻ縺ｨ繧薙←縺ｮ蝣ｴ蜷 IP/UDP 繝｡繝繧ｻ繝ｼ繧ｸ縺ｧ謇ｱ繧上ｌ縺ｾ縺吶′縲ゞNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医〒繧ゆｽｿ逕ｨ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 ### Event: 'message' `function (msg, rinfo) { }` + +繧ｽ繧ｱ繝繝井ｸ翫〒譁ｰ縺励＞繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺悟芦逹縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶Ａmsg` 縺ｯ `Buffer` 縺ｧ縲 +`rinfo` 縺ｯ騾∽ｿ｡閠縺ｮ繧｢繝峨Ξ繧ｹ諠蝣ｱ縺ｨ繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｮ繝舌う繝域焚繧呈戟縺｣縺溘が繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### Event: 'listening' `function () { }` + +繧ｽ繧ｱ繝繝医〒繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｮ蠕縺｡蜿励¢繧帝幕蟋九☆繧九→逕滓舌＆繧後∪縺吶 +縺薙ｌ縺ｯ UDP 繧ｽ繧ｱ繝繝医′菴懈舌＆繧後ｋ縺ｨ縺吶＄縺ｫ逋ｺ逕溘＠縺ｾ縺吶 +UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医〒縺ｯ `bind()` 繧貞他縺ｳ蜃ｺ縺吶∪縺ｧ蠕縺｡蜿励¢繧帝幕蟋九＠縺ｾ縺帙ｓ縲 ### Event: 'close' `function () { }` + +`close()` 縺ｫ繧医▲縺ｦ繧ｽ繧ｱ繝繝医′繧ｯ繝ｭ繝ｼ繧ｺ縺吶ｋ縺ｨ逕滓舌＆繧後∪縺吶 +縺薙ｮ繧ｽ繧ｱ繝繝医〒縺ｯ譁ｰ縺励＞ `message` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後↑縺上↑繧翫∪縺吶 ### dgram.createSocket(type, [callback]) + +謖螳壹＆繧後◆遞ｮ鬘槭ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝医ｒ菴懈舌＠縺ｾ縺吶 +螯･蠖薙↑遞ｮ鬘槭ｯ: `udp4`縲〜udp6`縲√◎縺励※`unix_dgram` 縺ｧ縺吶 + +繧ｪ繝励す繝ｧ繝ｳ縺ｮ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ `message` 繧､繝吶Φ繝医ｮ繝ｪ繧ｹ繝翫ｼ縺ｨ縺励※蜉縺医ｉ繧後∪縺吶 ### dgram.send(buf, offset, length, path, [callback]) + +UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝育畑縺ｧ縺吶ら嶌謇句医ｮ繧｢繝峨Ξ繧ｹ縺ｯ繝輔ぃ繧､繝ｫ繧ｷ繧ｹ繝繝縺ｮ繝代せ蜷阪〒縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｮ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯOS縺ｫ繧医▲縺ｦ`sendto`縺ｮ蜻ｼ縺ｳ蜃ｺ縺励′螳御ｺ縺励◆蠕後↓襍ｷ蜍輔＆繧後ｋ縺溘ａ縺ｫ謠蝉ｾ帙＆繧後ｋ縺九ｂ縺励ｌ縺ｾ縺帙ｓ縲 +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺悟他縺ｳ蜃ｺ縺輔ｌ繧九∪縺ｧ `buf` 縺ｮ蜀榊茜逕ｨ縺ｯ螳牙ｨ縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 +`bind()` 縺ｫ繧医▲縺ｦ繧ｽ繧ｱ繝繝医′繝代せ繝阪ｼ繝縺ｫ繝舌う繝ｳ繝峨＆繧後※縺縺ｪ縺髯舌ｊ縲 +縺薙ｮ繧ｽ繧ｱ繝繝医〒繝｡繝繧ｻ繝ｼ繧ｸ繧貞女菫｡縺吶ｋ縺薙→縺ｯ縺ｪ縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 + + +UNIX繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝 `/var/run/syslog` 繧帝壹§縺ｦ OSX 荳翫ｮ syslogd 縺ｫ繝｡繝繧ｻ繝ｼ繧ｸ繧帝∽ｿ｡縺吶ｋ萓: var dgram = require('dgram'); var message = new Buffer("A message to log."); @@ -54,14 +88,24 @@ Example of sending a message to syslogd on OSX via Unix domain socket `/var/run/ ### dgram.send(buf, offset, length, port, address, [callback]) + +UDP 繧ｽ繧ｱ繝繝育畑縺ｧ縺吶ら嶌謇句医ｮ繝昴ｼ繝医→ IP 繧｢繝峨Ξ繧ｹ縺ｯ蠢縺壽欠螳壹＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 +`address` 繝代Λ繝｡繝ｼ繧ｿ縺ｫ譁蟄怜励ｒ謠蝉ｾ帙☆繧九→縲√◎繧後ｯ DNS 縺ｫ繧医▲縺ｦ隗｣豎ｺ縺輔ｌ縺ｾ縺吶 +DNS 繧ｨ繝ｩ繝ｼ縺ｨ `buf` 縺悟榊茜逕ｨ蜿ｯ閭ｽ縺ｫ縺ｪ縺｣縺滓凾縺ｮ縺溘ａ縺ｫ繧ｪ繝励す繝ｧ繝ｳ縺ｮ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧呈欠螳壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 +DNS 繝ｫ繝繧ｯ繧｢繝繝励ｯ騾∽ｿ｡繧貞ｰ代↑縺上→繧よｬ｡縺ｮ讖滉ｼ壹∪縺ｧ驕繧峨○繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +騾∽ｿ｡縺瑚｡後ｏ繧後◆縺薙→繧堤｢ｺ螳溘↓遏･繧句髪荳縺ｮ謇区ｮｵ縺ｯ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧剃ｽｿ縺縺薙→縺ｧ縺吶 + + +`localhost` 縺ｮ驕ｩ蠖薙↑繝昴ｼ繝医↓ UDP 繝代こ繝繝医ｒ騾∽ｿ｡縺吶ｋ萓; var dgram = require('dgram'); var message = new Buffer("Some bytes"); @@ -72,11 +116,20 @@ Example of sending a UDP packet to a random port on `localhost`; ### dgram.bind(path) + +UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝育畑縺ｧ縺吶 +`path` 縺ｧ謖螳壹＆繧後◆繧ｽ繧ｱ繝繝井ｸ翫〒繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｮ逹菫｡蠕縺｡蜿励¢繧帝幕蟋九＠縺ｾ縺吶 +繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ `bind()` 縺励↑縺上※繧 `send()` 縺吶ｋ縺薙→縺後〒縺阪∪縺吶′縲 +`bind()` 縺励↑縺縺ｧ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧貞女菫｡縺吶ｋ縺薙→縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 + +蜿嶺ｿ｡縺励◆蜈ｨ縺ｦ縺ｮ繝｡繝繧ｻ繝ｼ繧ｸ繧偵お繧ｳ繝ｼ繝舌ャ繧ｯ縺吶ｋ UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝医し繝ｼ繝舌ｮ萓: var dgram = require("dgram"); var serverPath = "/tmp/dgram_server_sock"; @@ -93,7 +146,10 @@ Example of a Unix domain datagram server that echoes back all messages it receiv server.bind(serverPath); + +縺薙ｮ繧ｵ繝ｼ繝舌→蟇ｾ隧ｱ縺吶ｋ UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ萓: var dgram = require("dgram"); var serverPath = "/tmp/dgram_server_sock"; @@ -116,10 +172,17 @@ Example of a Unix domain datagram client that talks to this server: ### dgram.bind(port, [address]) + +UDP 繧ｽ繧ｱ繝繝育畑縺ｧ縺吶Ａport` 縺ｨ繧ｪ繝励す繝ｧ繝ｳ縺ｮ `address` 縺ｧ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧貞ｾ縺｡蜿励¢縺ｾ縺吶 +`address` 縺梧欠螳壹＆繧後↑縺代ｌ縺ｰ縲＾S 縺ｯ蜈ｨ縺ｦ縺ｮ繧｢繝峨Ξ繧ｹ縺九ｉ縺ｮ蠕縺｡蜿励¢繧定ｩｦ縺ｿ縺ｾ縺吶 + +41234 逡ｪ繝昴ｼ繝医ｒ蠕縺｡蜿励¢繧 UDP 繧ｵ繝ｼ繝舌ｮ萓: var dgram = require("dgram"); @@ -143,28 +206,51 @@ Example of a UDP server listening on port 41234: ### dgram.close() + +荳句ｱ､縺ｮ繧ｽ繧ｱ繝繝医ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺励√ョ繝ｼ繧ｿ縺ｮ蠕縺｡蜿励¢繧堤ｵゆｺ縺励∪縺吶 +`bind()` 縺悟他縺ｳ蜃ｺ縺輔ｌ縺ｦ縺縺ｪ縺縲∬ｪ蜍慕噪縺ｫ繝｡繝繧ｻ繝ｼ繧ｸ繧貞ｾ縺｡蜿励¢縺ｦ縺縺 UDP 繧ｽ繧ｱ繝繝医〒繧ょ酔縺倥〒縺吶 ### dgram.address() + +繧ｪ繝悶ず繧ｧ繧ｯ繝医′謖√▲縺ｦ縺繧九た繧ｱ繝繝医ｮ繧｢繝峨Ξ繧ｹ諠蝣ｱ繧定ｿ斐＠縺ｾ縺吶 +UDP 繧ｽ繧ｱ繝繝医〒縺ｯ縲√％縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ `address` 縺ｨ `port` 繧呈戟縺｣縺ｦ縺縺ｾ縺吶 +UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医〒縺ｯ縲〜address` 縺縺代ｒ謖√▲縺ｦ縺縺ｾ縺吶 ### dgram.setBroadcast(flag) + +繧ｽ繧ｱ繝繝医ｮ繧ｪ繝励す繝ｧ繝ｳ `SO_BROADCAST` 繧定ｨｭ螳壹∪縺溘ｯ繧ｯ繝ｪ繧｢縺励∪縺吶 +縺薙ｮ繧ｪ繝励す繝ｧ繝ｳ縺瑚ｨｭ螳壹＆繧後ｋ縺ｨ縲ゞDP 繝代こ繝繝医ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｮ繝悶Ο繝ｼ繝峨く繝｣繧ｹ繝育畑繧｢繝峨Ξ繧ｹ縺ｫ騾∽ｿ｡縺輔ｌ縺ｾ縺吶 ### dgram.setTTL(ttl) + +繧ｽ繧ｱ繝繝医が繝励す繝ｧ繝ｳ縺ｮ `IP_TTL` 繧定ｨｭ螳壹＠縺ｾ縺吶 +TTL 縺ｯ縲檎函蟄俶悄髢薙阪ｒ陦ｨ縺励∪縺吶′縲√％縺ｮ繧ｳ繝ｳ繝繧ｭ繧ｹ繝医〒縺ｯ繝代こ繝繝医′騾夐℃繧定ｨｱ蜿ｯ縺輔ｌ繧 IP 縺ｮ繝帙ャ繝玲焚繧呈欠螳壹＠縺ｾ縺吶 +蜷繝ｫ繝ｼ繧ｿ繝ｼ縺ｾ縺溘ｯ繧ｲ繝ｼ繝医え繧ｧ繧､縺ｯ繝代こ繝繝医ｒ騾∝ｺ縺吶ｋ髫 TTL 繧偵ョ繧ｯ繝ｪ繝｡繝ｳ繝医＠縺ｾ縺吶 +繝ｫ繝ｼ繧ｿ縺ｫ繧医▲縺ｦ TTL 縺後ョ繧ｯ繝ｪ繝｡繝ｳ繝医＆繧後※ 0 縺ｫ縺ｪ繧九→縺昴ｌ縺ｯ騾∝ｺ縺輔ｌ縺ｾ縺帙ｓ縲 +TTL 蛟､縺ｮ螟画峩縺ｯ騾壼ｸｸ縲√ロ繝繝医Ρ繝ｼ繧ｯ縺ｮ隱ｿ譟ｻ繧繝槭Ν繝√く繝｣繧ｹ繝医〒菴ｿ繧上ｌ縺ｾ縺吶 + + +`setTTL()` 縺ｮ蠑墓焚縺ｯ 1 縺九ｉ 255 縺ｮ繝帙ャ繝玲焚縺ｧ縺ｧ縺吶ゅ⊇縺ｨ繧薙←縺ｮ繧ｷ繧ｹ繝繝縺ｧ繝繝輔か繝ｫ繝医ｯ 64 縺ｧ縺吶 From 1282ae42f6ad120934dca03a1446cdfd12264716 Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 19:04:40 +0900 Subject: [PATCH 11/40] translated dns --- doc/api/dns.markdown | 78 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) diff --git a/doc/api/dns.markdown b/doc/api/dns.markdown index b55f93de6b0a..12ff304f5707 100644 --- a/doc/api/dns.markdown +++ b/doc/api/dns.markdown @@ -1,9 +1,15 @@ ## DNS + +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｫ縺ｯ `require('dns')` 繧剃ｽｿ逕ｨ縺励∪縺吶 + +縺薙ｌ縺ｯ `'www.google.com'` 繧定ｧ｣豎ｺ縺励※縲∬ｿ斐＆繧後◆ IP 繧｢繝峨Ξ繧ｹ繧帝蠑輔″縺ｧ隗｣豎ｺ縺吶ｋ萓九〒縺吶 var dns = require('dns'); @@ -27,76 +33,148 @@ resolves the IP addresses which are returned. ### dns.lookup(domain, family=null, callback) + +繝峨Γ繧､繝ｳ (萓 `'google.com'`) 繧定ｧ｣豎ｺ縺励※譛蛻昴↓隕九▽縺九▲縺 +A (IPv4) 縺ｾ縺溘ｯ AAAA (IPv6) 繝ｬ繧ｳ繝ｼ繝峨↓縺励∪縺吶 + +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(err, address, family)` 繧呈戟縺｡縺ｾ縺吶 +`address` 蠑墓焚縺ｯ IP v4 縺ｾ縺溘ｯ v6 繧｢繝峨Ξ繧ｹ繧定｡ｨ迴ｾ縺吶ｋ譁蟄怜励〒縺吶 +`family` 蠑墓焚縺ｯ 4 縺ｾ縺溘ｯ 6 縺ｮ謨ｴ謨ｰ縺ｧ縲〜address` 縺ｮ繝輔ぃ繝溘Μ繝ｼ繧呈э蜻ｳ縺励∪縺 +(縺薙ｮ蛟､縺ｯ蠢縺壹＠繧よ怙蛻昴↓ `lookup` 縺ｫ貂｡縺吝ｿ隕√ｯ縺ゅｊ縺ｾ縺帙ｓ)縲 ### dns.resolve(domain, rrtype='A', callback) + +繝峨Γ繧､繝ｳ (萓 `'google.com'`) 繧定ｧ｣豎ｺ縺励※ `rrtype` 縺ｧ謖螳壹＆繧後◆繝ｬ繧ｳ繝ｼ繝峨ち繧､繝励ｮ驟榊励↓縺励∪縺吶 +螯･蠖薙↑ `rrtype` 縺ｯ `A` (IPV4繧｢繝峨Ξ繧ｹ)縲〜AAAA` (IPV6繧｢繝峨Ξ繧ｹ)縲 +`MX` (mail exchange繝ｬ繧ｳ繝ｼ繝), `TXT` (繝繧ｭ繧ｹ繝医Ξ繧ｳ繝ｼ繝)縲〜SRV` (SRV繝ｬ繧ｳ繝ｼ繝)縲 +`PTR` (IP 繧帝蠑輔″縺ｧ繝ｫ繝繧ｯ繧｢繝繝励☆繧九◆繧√↓菴ｿ繧上ｌ繧) 縺ｧ縺吶 + +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(err, addresses)` 繧呈戟縺｡縺ｾ縺吶 +`addresses` 縺ｮ蜷隕∫ｴ縺ｮ遞ｮ鬘槭ｯ繝ｬ繧ｳ繝ｼ繝峨ｮ遞ｮ鬘槭↓繧医▲縺ｦ豎ｺ縺ｾ繧翫 +蟇ｾ蠢懊☆繧句ｾ瑚ｿｰ縺ｮ繝ｫ繝繧ｯ繧｢繝繝励Γ繧ｽ繝繝峨〒險倩ｿｰ縺輔ｌ縺ｾ縺吶 + +繧ｨ繝ｩ繝ｼ逋ｺ逕滓凾縲〜err` 縺ｯ `Error` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺ゅｊ縲 +`err.errno` 縺ｯ蠕瑚ｿｰ縺吶ｋ繧ｨ繝ｩ繝ｼ繧ｳ繝ｼ繝峨ｮ縺縺壹ｌ縺九 +`err.message` 縺ｯ繧ｨ繝ｩ繝ｼ繧定恭隱槭〒隱ｬ譏弱☆繧区枚蟄怜励→縺ｪ繧翫∪縺吶 ### dns.resolve4(domain, callback) + +`dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲！Pv4 繧｢繝峨Ξ繧ｹ (`A` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 +`addresses` 縺ｯ IPv4 繧｢繝峨Ξ繧ｹ縺ｮ驟榊励〒縺 (萓
+`['74.125.79.104', '74.125.79.105', '74.125.79.106']`) ### dns.resolve6(domain, callback) + +IPv6 (`AAAA` 繝ｬ繧ｳ繝ｼ繝) 繧貞撫縺蜷医ｏ縺帙ｋ縺薙→繧帝勁縺縺ｦ `dns.resolve4()` 縺ｨ蜷後§縺ｧ縺吶 ### dns.resolveMx(domain, callback) + +`dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲［ail exchange (`MX` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 + +`addresses`縺ｯ MX 繝ｬ繧ｳ繝ｼ繝峨ｮ驟榊励〒縲√◎繧後◇繧後ｯ priority 縺ｨ exchange 縺ｮ螻樊ｧ繧呈戟縺｡縺ｾ縺 +(萓 `[{'priority': 10, 'exchange': 'mx.example.com'},...]`)縲 ### dns.resolveTxt(domain, callback) + +`dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲√ユ繧ｭ繧ｹ繝 (`TXT` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 +`addresses` 縺ｯ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ `domain` 縺ｮ繝繧ｭ繧ｹ繝医Ξ繧ｳ繝ｼ繝峨ｮ驟榊励〒縺吶 +(萓九〜['v=spf1 ip4:0.0.0.0 ~all']`) ### dns.resolveSrv(domain, callback) + +`dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲√し繝ｼ繝薙せ繝ｬ繧ｳ繝ｼ繝 (`SRV` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 +`addresses` 縺ｯ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ `domain` 縺ｮ SRV 繝ｬ繧ｳ繝ｼ繝峨ｮ驟榊励〒縺吶 +SRV 繝ｬ繧ｳ繝ｼ繝峨ｮ繝励Ο繝代ユ繧｣縺ｯ priority縲『eight縲｝ort縲√◎縺励※ name 縺ｧ縺 +(萓 `[{'priority': 10, {'weight': 5, 'port': 21223, 'name': 'service.example.com'}, ...]`)縲 ### dns.reverse(ip, callback) + +IP 繧｢繝峨Ξ繧ｹ縺九ｉ繝峨Γ繧､繝ｳ蜷阪ｮ驟榊励∈騾蠑輔″縺ｧ隗｣豎ｺ縺励∪縺吶 + +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(err, domains)` 繧呈戟縺｡縺ｾ縺吶 + +繧ｨ繝ｩ繝ｼ縺後≠縺｣縺溷ｴ蜷医〜err` 縺ｯ髱 null 縺ｧ Error 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｨ縺ｪ繧翫∪縺吶 + +縺ｩ縺ｮ DNS 蝠上＞蜷医ｏ縺帙ｂ繧ｨ繝ｩ繝ｼ繧ｳ繝ｼ繝峨ｒ霑斐○縺ｾ縺吶 + +- `dns.TEMPFAIL`: 繧ｿ繧､繝繧｢繧ｦ繝医ヾERVFAIL 縺ゅｋ縺縺ｯ蜷梧ｧ倥ｮ繧ゅｮ縲 +- `dns.PROTOCOL`: 蠢懃ｭ斐′荳肴ｭ｣縲 +- `dns.NXDOMAIN`: 繝峨Γ繧､繝ｳ縺悟ｭ伜惠縺励↑縺縲 +- `dns.NODATA`: 繝峨Γ繧､繝ｳ縺ｯ蟄伜惠縺吶ｋ縺後∬ｦ∵ｱゅ＆繧後◆遞ｮ鬘槭ｮ繝繝ｼ繧ｿ縺後↑縺縲 +- `dns.NOMEM`: 蜃ｦ逅荳ｭ縺ｫ繝｡繝｢繝ｪ縺御ｸ崎ｶｳ縲 +- `dns.BADQUERY`: 蝠上＞蜷医ｏ縺帙′荳肴ｭ｣縺ｪ蠖｢蠑上 From a322ba672ca42c96576a6beeb95b26bec7bf3178 Mon Sep 17 00:00:00 2001 From: koichik Date: Sun, 21 Nov 2010 21:43:27 +0900 Subject: [PATCH 12/40] translated events --- doc/api/events.markdown | 53 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 52 insertions(+), 1 deletion(-) diff --git a/doc/api/events.markdown b/doc/api/events.markdown index 85715a735055..0c544ffe2fa7 100644 --- a/doc/api/events.markdown +++ b/doc/api/events.markdown @@ -1,33 +1,63 @@ ## Events + +Node 縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ螟壹￥縺ｯ繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺: +`net.Server`縺ｯ逶ｸ謇九°繧画磁邯壹☆繧九◆縺ｳ縺ｫ繧､繝吶Φ繝医ｒ逕滓舌＠縲 +`fs.readStream`縺ｯ繝輔ぃ繧､繝ｫ縺後が繝ｼ繝励Φ縺輔ｌ繧九◆縺ｳ縺ｫ繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺吶 +繧､繝吶Φ繝医ｒ逕滓舌☆繧句ｨ縺ｦ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ `events.EventEmitter` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 +谺｡縺ｮ繧医≧縺ｫ縺吶ｋ縺薙→縺ｧ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺ｧ縺阪∪縺: `require("events");` + + +騾壼ｸｸ縲√う繝吶Φ繝亥錐縺ｯ繧ｭ繝｣繝｡繝ｫ險俶ｳ輔↓繧医ｋ譁蟄怜励〒陦ｨ迴ｾ縺輔ｌ縺ｾ縺吶′縲 +蜴ｳ譬ｼ縺ｪ蛻ｶ髯舌〒縺ｯ縺ｪ縺上√←繧薙↑譁蟄怜励〒繧ょ女縺大･繧後ｉ繧後∪縺吶 + +髢｢謨ｰ繧偵が繝悶ず繧ｧ繧ｯ繝医↓繧｢繧ｿ繝繝√☆繧九％縺ｨ縺後〒縺阪√◎繧後ｯ繧､繝吶Φ繝医′逕滓舌＆繧後◆譎ゅ↓螳溯｡後＆繧後∪縺吶 +縺薙ｌ繧峨ｮ髢｢謨ｰ縺ｯ*繝ｪ繧ｹ繝翫ｼ*縺ｨ蜻ｼ縺ｰ繧後∪縺吶 ### events.EventEmitter + +EventEmitter繧ｯ繝ｩ繧ｹ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｫ縺ｯ縲〜require('events').EventEmitter` 繧剃ｽｿ縺縺ｾ縺吶 + +`EventEmitter` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺後お繝ｩ繝ｼ縺ｫ驕ｭ驕縺励◆譎ゅ +蜈ｸ蝙狗噪縺ｪ蜍穂ｽ懊ｯ `'error'` 繧､繝吶Φ繝医ｒ逕滓舌☆繧九％縺ｨ縺ｧ縺吶 +node 縺ｧ縺ｯ繧ｨ繝ｩ繝ｼ繧､繝吶Φ繝医ｯ迚ｹ蛻･縺ｫ謇ｱ繧上ｌ縺ｾ縺呻ｼ +繧ゅ＠縺昴ｮ繝ｪ繧ｹ繝翫ｼ縺後↑縺代ｌ縺ｰ縲√ョ繝輔か繝ｫ繝医ｮ蜍穂ｽ懊ｯ繧ｹ繧ｿ繝繧ｯ繝医Ξ繝ｼ繧ｹ繧貞ｺ蜉帙＠縺ｦ繝励Ο繧ｰ繝ｩ繝繧堤ｵゆｺ縺吶ｋ縺薙→縺ｧ縺吶 + +蜈ｨ縺ｦ縺ｮ EventEmitter 縺ｯ縲∵眠縺励＞繝ｪ繧ｹ繝翫ｼ縺悟刈縺医ｉ繧後ｋ縺ｨ繧､繝吶Φ繝 `'newListener'` 繧堤函謌舌＠縺ｾ縺吶 #### emitter.addListener(event, listener) #### emitter.on(event, listener) + +謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励ｮ譛蠕後↓繝ｪ繧ｹ繝翫ｼ繧定ｿｽ蜉縺励∪縺吶 server.on('connection', function (stream) { console.log('someone connected!'); @@ -35,9 +65,13 @@ Adds a listener to the end of the listeners array for the specified event. #### emitter.once(event, listener) + +**荳蝗樣剞繧**縺ｮ繝ｪ繧ｹ繝翫ｼ繧偵う繝吶Φ繝医↓霑ｽ蜉縺励∪縺吶 +縺薙ｮ繝ｪ繧ｹ繝翫ｼ縺ｯ繧､繝吶Φ繝医′譛蛻昴↓逋ｺ逕溘＠縺滓凾縺ｫ髯舌ｊ襍ｷ蜍輔＆繧後√◎縺ｮ蠕後〒蜑企勁縺輔ｌ縺ｾ縺吶 server.once('connection', function (stream) { console.log('Ah, we have our first user!'); @@ -45,8 +79,12 @@ it is removed. #### emitter.removeListener(event, listener) + +謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励°繧峨Μ繧ｹ繝翫ｼ繧貞炎髯､縺励∪縺吶 +**豕ｨ諢**: 繝ｪ繧ｹ繝翫ｼ縺ｮ閭悟ｾ後↓縺ゅｋ繝ｪ繧ｹ繝翫ｼ驟榊励ｮ繧､繝ｳ繝繝繧ｯ繧ｹ縺悟､牙喧縺励∪縺吶 var callback = function(stream) { console.log('someone connected!'); @@ -58,13 +96,20 @@ Remove a listener from the listener array for the specified event. #### emitter.removeAllListeners(event) + +謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励°繧牙ｨ縺ｦ縺ｮ繝ｪ繧ｹ繝翫ｼ繧貞炎髯､縺励∪縺吶 #### emitter.listeners(event) + +謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励ｒ霑斐＠縺ｾ縺吶 +縺薙ｮ驟榊励ｯ螟画峩縺吶ｋ縺薙→縺後〒縺阪∪縺吶∽ｾ九∴縺ｰ繝ｪ繧ｹ繝翫ｼ繧貞炎髯､縺吶ｋ縺ｪ縺ｩ縲 server.on('connection', function (stream) { console.log('someone connected!'); @@ -73,10 +118,16 @@ manipulated, e.g. to remove listeners. #### emitter.emit(event, [arg1], [arg2], [...]) + +謠蝉ｾ帙＆繧後◆蠑墓焚縺ｮ荳ｦ縺ｳ縺ｧ縺昴ｌ縺槭ｌ縺ｮ繝ｪ繧ｹ繝翫ｼ繧貞ｮ溯｡後＠縺ｾ縺吶 #### Event: 'newListener' `function (event, listener) { }` + +縺薙ｮ繧､繝吶Φ繝医ｯ隱ｰ縺九′譁ｰ縺励＞繝ｪ繧ｹ繝翫ｼ繧定ｿｽ蜉縺吶ｋ縺ｨ縺縺､縺ｧ繧ら函謌舌＆繧後∪縺吶 From 296c79633599fed79b86da87e56bd9adb305bd6a Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 16:06:40 +0900 Subject: [PATCH 13/40] translated fs --- doc/api/fs.markdown | 262 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 261 insertions(+), 1 deletion(-) diff --git a/doc/api/fs.markdown b/doc/api/fs.markdown index fbd98c9f1932..306b246ab7e7 100644 --- a/doc/api/fs.markdown +++ b/doc/api/fs.markdown @@ -1,15 +1,29 @@ ## File System + +File I/O 縺ｯ POSIX 讓呎ｺ悶ｮ髢｢謨ｰ縺ｫ蟇ｾ縺吶ｋ蜊倡ｴ斐↑繝ｩ繝繝代ｼ縺ｨ縺励※謠蝉ｾ帙＆繧後∪縺吶 +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ逕ｨ縺吶ｋ縺ｫ縺ｯ `require('fs')` 縺励※縺上□縺輔＞縲 +蜈ｨ縺ｦ縺ｮ繝｡繧ｽ繝繝峨ｯ髱槫酔譛溘→蜷梧悄縺ｮ蠖｢蠑上′縺ゅｊ縺ｾ縺吶 + +髱槫酔譛溘ｮ蠖｢蠑上ｯ蟶ｸ縺ｫ譛蠕後ｮ蠑墓焚縺ｨ縺励※螳御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧貞女縺大叙繧翫∪縺吶 +蠑墓焚縺ｨ縺励※貂｡縺輔ｌ繧句ｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ繝｡繧ｽ繝繝峨↓萓晏ｭ倥＠縺ｾ縺吶′縲 +譛蛻昴ｮ蠑墓焚縺ｯ蟶ｸ縺ｫ萓句､悶ｮ縺溘ａ縺ｫ莠育ｴ縺輔ｌ縺ｦ縺縺ｾ縺吶 +謫堺ｽ懊′謌仙粥縺ｧ螳御ｺ縺吶ｋ縺ｨ譛蛻昴ｮ蠑墓焚縺ｯ `null` 縺ｾ縺溘ｯ `undefined` 縺ｨ縺ｪ繧翫∪縺 + +髱槫酔譛溘ヰ繝ｼ繧ｸ繝ｧ繝ｳ縺ｮ萓九〒縺: var fs = require('fs'); @@ -18,15 +32,22 @@ Here is an example of the asynchronous version: console.log('successfully deleted /tmp/hello'); }); + +蜷梧悄繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ縺: var fs = require('fs'); fs.unlinkSync('/tmp/hello') console.log('successfully deleted /tmp/hello'); + +髱槫酔譛溘Γ繧ｽ繝繝峨〒縺ｯ鬆蠎上ｮ菫晁ｨｼ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 +莉･荳九ｮ繧医≧縺ｪ蛯ｾ蜷代ｮ繧ｨ繝ｩ繝ｼ縺後≠繧翫∪縺吶 fs.rename('/tmp/hello', '/tmp/world', function (err) { if (err) throw err; @@ -37,8 +58,12 @@ following is prone to error: console.log('stats: ' + JSON.stringify(stats)); }); + +`fs.stat` 縺ｯ `fs.rename` 繧医ｊ蜈医↓螳溯｡後＆繧後ｋ蜿ｯ閭ｽ諤ｧ縺後≠繧較縺ｾ縺吶 +豁｣縺励＞譁ｹ豕輔ｯ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧偵メ繧ｧ繝ｼ繝ｳ縺吶ｋ縺薙→縺ｧ縺吶 fs.rename('/tmp/hello', '/tmp/world', function (err) { if (err) throw err; @@ -48,37 +73,63 @@ The correct way to do this is to chain the callbacks. }); }); + +蠢吶＠縺繝励Ο繧ｻ繧ｹ縺ｧ縺ｯ縲√励Ο繧ｰ繝ｩ繝槭ｯ縺薙ｌ繧峨ｮ髱槫酔譛溘ヰ繝ｼ繧ｸ繝ｧ繝ｳ繧剃ｽｿ縺縺薙→縺*蠑ｷ縺乗耳螂ｨ*縺輔ｌ縺ｾ縺吶 +蜷梧悄繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｯ縺昴ｌ縺悟ｮ御ｺ縺吶ｋ縺ｾ縺ｧ繝励Ο繧ｻ繧ｹ蜈ｨ菴薙ｒ繝悶Ο繝繧ｯ縺励∪縺 ｼ 蜈ｨ縺ｦ縺ｮ謗･邯壹ｒ蛛懈ｭ｢縺励∪縺吶 ### fs.rename(path1, path2, [callback]) + +髱槫酔譛溘ｮ rename(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.renameSync(path1, path2) + +蜷梧悄縺ｮ rename(2)縲 ### fs.truncate(fd, len, [callback]) + +髱槫酔譛溘ｮ ftruncate(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.truncateSync(fd, len) + +蜷梧悄縺ｮ ftruncate(2)縲 ### fs.chmod(path, mode, [callback]) + +髱槫酔譛溘ｮ chmod(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.chmodSync(path, mode) + +蜷梧悄縺ｮ chmod(2)縲 ### fs.stat(path, [callback]) + +髱槫酔譛溘ｮ stat(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, stats)`縺ｧ縲 +`stats` 縺ｯ `fs.Stats` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶よｬ｡縺ｮ繧医≧縺ｫ縺ｪ繧翫∪縺吶 { dev: 2049 , ino: 305352 @@ -95,185 +146,336 @@ Asynchronous stat(2). The callback gets two arguments `(err, stats)` where `stat , ctime: '2009-06-29T11:11:40Z' } + +繧医ｊ隧ｳ縺励￥縺ｯ蠕瑚ｿｰ縺ｮ `fs.Stats` 縺ｮ遽繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### fs.lstat(path, [callback]) + +髱槫酔譛溘ｮ lstat(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, stats)`縺ｧ縲 +`stats` 縺ｯ `fs.Stats` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### fs.fstat(fd, [callback]) + +髱槫酔譛溘ｮ fstat(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, stats)` 縺ｧ縲 +`stats` 縺ｯ `fs.Stats` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### fs.statSync(path) + +蜷梧悄縺ｮ stat(2)縲Ａfs.Stats` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.lstatSync(path) + +蜷梧悄縺ｮ lstat(2)縲Ａfs.Stats` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.fstatSync(fd) + +蜷梧悄縺ｮ fstat(2)縲Ａfs.Stats` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.link(srcpath, dstpath, [callback]) + +髱槫酔譛溘ｮ link(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.linkSync(dstpath, srcpath) + +蜷梧悄縺ｮ link(2)縲 ### fs.symlink(linkdata, path, [callback]) + +髱槫酔譛溘ｮ symlink(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.symlinkSync(linkdata, path) + +蜷梧悄縺ｮ symlink(2)縲 ### fs.readlink(path, [callback]) + +髱槫酔譛溘ｮ readlink(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, resolvedPath)`縺ｧ縺吶 ### fs.readlinkSync(path) + +蜷梧悄縺ｮ readlink(2)縲りｧ｣豎ｺ縺輔ｌ縺溘ヱ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.realpath(path, [callback]) + +髱槫酔譛溘ｮ realpath(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, resolvedPath)`縺ｧ縺吶 ### fs.realpathSync(path) + +蜷梧悄縺ｮ realpath(2)縲りｧ｣豎ｺ縺輔ｌ縺溘ヱ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.unlink(path, [callback]) + +髱槫酔譛溘ｮ unlink(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.unlinkSync(path) + +蜷梧悄縺ｮ unlink(2)縲 ### fs.rmdir(path, [callback]) + +髱槫酔譛溘ｮ rmdir(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.rmdirSync(path) + +蜷梧悄縺ｮ rmdir(2)縲 ### fs.mkdir(path, mode, [callback]) + +髱槫酔譛溘ｮ mkdir(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.mkdirSync(path, mode) + +蜷梧悄縺ｮ mkdir(2)縲 ### fs.readdir(path, [callback]) + +髱槫酔譛溘ｮ readdir(3)縲ゅョ繧｣繝ｬ繧ｯ繝医Μ縺ｮ蜀螳ｹ繧定ｪｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶 +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, files)`縺ｧ縲 +`files` 縺ｯ `'.'` 縺ｨ `'..'` 繧帝勁縺上ョ繧｣繝ｬ繧ｯ繝医Μ蜀縺ｮ繝輔ぃ繧､繝ｫ蜷阪ｮ驟榊励〒縺吶 ### fs.readdirSync(path) + +蜷梧悄縺ｮ readdir(3)縲Ａ'.'` 縺ｨ `'..'` 繧帝勁縺上ョ繧｣繝ｬ繧ｯ繝医Μ蜀縺ｮ繝輔ぃ繧､繝ｫ蜷阪ｮ驟榊励ｒ霑斐＠縺ｾ縺吶 ### fs.close(fd, [callback]) + +髱槫酔譛溘ｮ close(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.closeSync(fd) + +蜷梧悄縺ｮ close(2)縲 ### fs.open(path, flags, mode=0666, [callback]) + +髱槫酔譛溘ｮ繝輔ぃ繧､繝ｫ繧ｪ繝ｼ繝励Φ縲Ｐpen(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 +繝輔Λ繧ｰ縺ｯ 'r'縲'r+'縲'w'縲'w+'縲'a'縲√≠繧九＞縺ｯ 'a+' 縺ｧ縺吶 +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, fd)`縺ｧ縺吶 ### fs.openSync(path, flags, mode=0666) + +蜷梧悄縺ｮ open(2)縲 ### fs.write(fd, buffer, offset, length, position, [callback]) + +`fd` 縺ｧ謖螳壹＆繧後◆繝輔ぃ繧､繝ｫ縺ｫ `buffer` 繧呈嶌縺崎ｾｼ縺ｿ縺ｾ縺吶 + + +`position` 縺ｯ繝繝ｼ繧ｿ縺梧嶌縺崎ｾｼ縺ｾ繧後ｋ菴咲ｽｮ繧偵ヵ繧｡繧､繝ｫ縺ｮ蜈磯ｭ縺九ｉ縺ｮ繧ｪ繝輔そ繝繝医〒遉ｺ縺励∪縺吶 +`position` 縺 `null` 縺ｮ蝣ｴ蜷医√ョ繝ｼ繧ｿ縺ｯ迴ｾ蝨ｨ縺ｮ菴咲ｽｮ縺九ｉ譖ｸ縺崎ｾｼ縺ｾ繧後∪縺吶 +pwrite(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 + +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚縺御ｸ弱∴繧峨ｌ繧 `(err, written)` 縺ｧ縲 +`written` 縺ｯ譖ｸ縺崎ｾｼ縺ｾ繧後◆*繝舌う繝域焚*繧堤､ｺ縺励∪縺吶 ### fs.writeSync(fd, buffer, offset, length, position) + +蜷梧悄迚医ｮ繝舌ャ繝輔ぃ縺ｫ蝓ｺ縺･縺 `fs.write()`縲よ嶌縺崎ｾｼ縺ｾ繧後◆繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 ### fs.writeSync(fd, str, position, encoding='utf8') + +蜷梧悄迚医ｮ譁蟄怜励↓蝓ｺ縺･縺 `fs.write()`縲よ嶌縺崎ｾｼ縺ｾ繧後◆繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 ### fs.read(fd, buffer, offset, length, position, [callback]) + +`fd` 縺ｧ謖螳壹＆繧後◆繝輔ぃ繧､繝ｫ縺九ｉ繝繝ｼ繧ｿ繧定ｪｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶 + +`buffer` 縺ｯ繝繝ｼ繧ｿ縺梧嶌縺崎ｾｼ縺ｾ繧後ｋ繝舌ャ繝輔ぃ縺ｧ縺吶 + +`offset` 縺ｯ譖ｸ縺崎ｾｼ縺ｿ繧帝幕蟋九☆繧九ヰ繝繝輔ぃ蜀縺ｮ繧ｪ繝輔そ繝繝医〒縺吶 + +`length` 縺ｯ隱ｭ縺ｿ霎ｼ繧繝舌う繝域焚繧呈欠螳壹☆繧区紛謨ｰ縺ｧ縺吶 + +`position` 縺ｯ繝輔ぃ繧､繝ｫ縺ｮ隱ｭ縺ｿ霎ｼ縺ｿ繧帝幕蟋九☆繧倶ｽ咲ｽｮ繧呈欠螳壹☆繧区紛謨ｰ縺ｧ縺吶 +`position` 縺 `null` 縺ｮ蝣ｴ蜷医√ョ繝ｼ繧ｿ縺ｯ迴ｾ蝨ｨ縺ｮ菴咲ｽｮ縺九ｉ隱ｭ縺ｿ霎ｼ縺ｾ繧後∪縺吶 + +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ2縺､縺ｮ蠑墓焚縺御ｸ弱∴繧峨ｌ繧 `(err, bytesRead)` 縺ｧ縺吶 ### fs.readSync(fd, buffer, offset, length, position) + +蜷梧悄迚医ｮ繝舌ャ繝輔ぃ縺ｫ蝓ｺ縺･縺 `fs.read`縲ＡbytesRead` 縺ｮ謨ｰ繧定ｿ斐＠縺ｾ縺吶 ### fs.readSync(fd, length, position, encoding) + +蜷梧悄迚医ｮ譁蟄怜励↓蝓ｺ縺･縺 `fs.read`縲ＡbytesRead` 縺ｮ謨ｰ繧定ｿ斐＠縺ｾ縺吶 ### fs.readFile(filename, [encoding], [callback]) + +繝輔ぃ繧､繝ｫ蜈ｨ菴薙ｮ蜀螳ｹ繧帝撼蜷梧悄縺ｫ隱ｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶ゆｾ: fs.readFile('/etc/passwd', function (err, data) { if (err) throw err; console.log(data); }); + +繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚縺梧ｸ｡縺輔ｌ繧 `(err, data)` 縺ｧ縲〜data` 縺ｯ繝輔ぃ繧､繝ｫ縺ｮ蜀螳ｹ縺ｧ縺吶 + +繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺梧欠螳壹＆繧後↑縺代ｌ縺ｰ縲∫函縺ｮ繝舌ャ繝輔ぃ縺梧ｸ｡縺輔ｌ縺ｾ縺吶 ### fs.readFileSync(filename, [encoding]) + +蜷梧悄迚医ｮ `fs.readFile`縲Ａfilename` 縺ｮ蜀螳ｹ繧定ｿ斐＠縺ｾ縺吶 + +`encoding` 縺梧欠螳壹＆繧後ｋ縺ｨ縺薙ｮ髢｢謨ｰ縺ｯ譁蟄怜励ｒ霑斐＠縺ｾ縺吶 +縺昴≧縺ｧ縺ｪ縺代ｌ縺ｰ繝舌ャ繝輔ぃ繧定ｿ斐＠縺ｾ縺吶 ### fs.writeFile(filename, data, encoding='utf8', [callback]) + +髱槫酔譛溘↓繝繝ｼ繧ｿ繧偵ヵ繧｡繧､繝ｫ縺ｫ譖ｸ縺崎ｾｼ縺ｿ縺ｾ縺吶Ａdata` 縺ｯ譁蟄怜励∪縺溘ｯ繝舌ャ繝輔ぃ縺ｧ縺吶 + +萓: fs.writeFile('message.txt', 'Hello Node', function (err) { if (err) throw err; @@ -282,35 +484,56 @@ Example: ### fs.writeFileSync(filename, data, encoding='utf8') + +蜷梧悄迚医ｮ `fs.writeFile`縲 ### fs.watchFile(filename, [options], listener) + +`filename` 縺ｮ螟画峩繧堤屮隕悶＠縺ｾ縺吶ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｮ `listener` 縺ｯ繝輔ぃ繧､繝ｫ縺悟､画峩縺輔ｌ繧句ｺｦ縺ｫ蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 + + +`listener` 縺ｯ迴ｾ蝨ｨ縺ｮ迥ｶ諷九が繝悶ず繧ｧ繧ｯ繝医→蜑阪ｮ迥ｶ諷九が繝悶ず繧ｧ繧ｯ繝医ｮ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧翫∪縺: fs.watchFile(f, function (curr, prev) { console.log('the current mtime is: ' + curr.mtime); console.log('the previous mtime was: ' + prev.mtime); }); + +縺薙ｌ繧峨ｮ迥ｶ諷九が繝悶ず繧ｧ繧ｯ繝医ｯ `fs.Stat` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 ### fs.unwatchFile(filename) + +`filename` 縺ｮ螟画峩縺ｫ蟇ｾ縺吶ｋ逶｣隕悶ｒ邨ゆｺ縺励∪縺吶 ## fs.Stats + +`fs.stat()` 縺ｨ `fs.lstat()` 縺九ｉ霑斐＆繧後ｋ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ縺薙ｮ蝙九〒縺吶 + + - `stats.isFile()` + - `stats.isDirectory()` + - `stats.isBlockDevice()` + - `stats.isCharacterDevice()` + - `stats.isSymbolicLink()` (`fs.lstat()`縺ｧ縺ｮ縺ｿ譛牙柑) + - `stats.isFIFO()` + - `stats.isSocket()` ## fs.ReadStream + +`ReadStream` 縺ｯ `Readable Stream` 縺ｧ縺吶 ### fs.createReadStream(path, [options]) + +譁ｰ縺励＞ ReadStream 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺 (`Readable Stream` 繧貞盾辣ｧ縺励※縺上□縺輔＞)縲 + +`options` 縺ｯ莉･荳九ｮ繝繝輔か繝ｫ繝亥､繧呈戟縺､繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺: { 'flags': 'r' , 'encoding': null @@ -336,30 +575,51 @@ Returns a new ReadStream object (See `Readable Stream`). , 'bufferSize': 4 * 1024 } + +繝輔ぃ繧､繝ｫ蜈ｨ菴薙ｒ隱ｭ縺ｿ霎ｼ繧莉｣繧上ｊ縺ｫ荳驛ｨ縺ｮ遽蝗ｲ繧定ｪｭ縺ｿ霎ｼ繧縺溘ａ縲 +`options` 縺ｫ `start` 縺翫ｈ縺ｳ `end` 繧貞性繧√ｋ縺薙→縺後〒縺阪∪縺吶 +`start` 縺ｨ `end` 縺ｯ縺ｩ縺｡繧峨ｂ蛹蜷ｫ逧縺ｧ0縺九ｉ蟋九∪繧翫∪縺吶 +菴ｿ縺髫帙↓縺ｯ縺縺､縺ｧ繧ゅ∽ｸ｡譁ｹ繧貞酔譎ゅ↓謖螳壹＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 + +100 繝舌う繝医ｮ髟ｷ縺輔ｒ謖√▽繝輔ぃ繧､繝ｫ縺ｮ譛蠕後ｮ 10 繝舌う繝医ｒ隱ｭ縺ｿ霎ｼ繧萓: fs.createReadStream('sample.txt', {start: 90, end: 99}); ## fs.WriteStream + +`WriteStream` 縺ｯ `Writable Stream` 縺ｧ縺吶 ### Event: 'open' `function (fd) { }` + +`fd` 縺ｯ WriteStream 縺ｫ菴ｿ繧上ｌ縺ｦ縺繧九ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌〒縺吶 ### fs.createWriteStream(path, [options]) + +譁ｰ縺励＞ WriteStream 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺 (`Writable Stream` 繧貞盾辣ｧ縺励※縺上□縺輔＞)縲 + +`options` 縺ｯ莉･荳九ｮ繝繝輔か繝ｫ繝亥､繧呈戟縺､繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺: { 'flags': 'w' , 'encoding': null From 17ffaa6205e8069c2024fb559bfe5defde640041 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 16:15:00 +0900 Subject: [PATCH 14/40] translated globals --- doc/api/globals.markdown | 41 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/doc/api/globals.markdown b/doc/api/globals.markdown index 55e591282eb1..112a734f92d9 100644 --- a/doc/api/globals.markdown +++ b/doc/api/globals.markdown @@ -1,49 +1,85 @@ ## Global Objects + +縺薙ｌ繧峨ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｹ繧ｳ繝ｼ繝励〒譛牙柑縺ｧ縺ゅｊ縲√←縺薙°繧峨〒繧ゅい繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 ### global + +繧ｰ繝ｭ繝ｼ繝舌Ν縺ｪ繝阪ｼ繝繧ｹ繝壹ｼ繧ｹ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### process + +繝励Ο繧ｻ繧ｹ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶Ａ'process object'` 縺ｮ遽繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### require() + +require 繝｢繧ｸ繝･繝ｼ繝ｫ繧呈欠縺励∪縺吶Ａ'Modules'` 縺ｮ遽繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### require.resolve() + +`require()` 縺ｮ蜀驛ｨ縺ｧ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ菴咲ｽｮ繧呈､懃ｴ｢縺吶ｋ縺溘ａ縺ｫ菴ｿ繧上ｌ縺ｾ縺吶 +繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繝ｭ繝ｼ繝峨ｯ陦後ｏ縺壹√ヵ繧｡繧､繝ｫ蜷阪ｒ隗｣豎ｺ縺励※霑斐☆縺縺代〒縺吶 ### require.paths + +`require()` 縺ｮ縺溘ａ縺ｮ繧ｵ繝ｼ繝√ヱ繧ｹ縺ｮ驟榊励〒縺吶 +縺薙ｮ驟榊励ｯ繧ｫ繧ｹ繧ｿ繝繝代せ繧定ｿｽ蜉縺吶ｋ縺溘ａ縺ｫ螟画峩縺吶ｋ縺薙→縺後〒縺阪∪縺吶 + +萓: 繧ｵ繝ｼ繝√Μ繧ｹ繝医ｮ蜈磯ｭ縺ｫ譁ｰ縺励＞繝代せ繧定ｿｽ蜉縺吶ｋ require.paths.unshift('/usr/local/node'); ### __filename + +螳溯｡後＆繧後※縺繧九せ繧ｯ繝ｪ繝励ヨ縺ｮ繝輔ぃ繧､繝ｫ蜷阪〒縺吶ゅ％繧後ｯ邨ｶ蟇ｾ繝代せ縺ｧ縺ゅｊ縲 +蠢縺壹＠繧ゅさ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚縺ｧ貂｡縺輔ｌ縺溘ヵ繧｡繧､繝ｫ蜷阪→蜷後§縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 + +萓: `node example.js` 繧 `/Users/mjr` 縺ｧ螳溯｡後☆繧 console.log(__filename); // /Users/mjr/example.js ### __dirname + +繧ｹ繧ｯ繝ｪ繝励ヨ縺悟ｮ溯｡後＆繧後※縺繧九ョ繧｣繝ｬ繧ｯ繝医Μ蜷阪〒縺吶 + +萓: `node example.js` 繧 `/Users/mjr` 縺ｧ螳溯｡後☆繧 console.log(__dirname); // /Users/mjr @@ -51,6 +87,11 @@ Example: running `node example.js` from `/Users/mjr` ### module + +迴ｾ蝨ｨ縺ｮ (`process.Module` 蝙九〒縺ゅｋ) 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｸ縺ｮ蜿らｧ縺ｧ縺吶 +迚ｹ縺ｫ `module.exports` 縺ｯ `exports` 繧ｪ繝悶ず繧ｧ繧ｯ繝医→蜷後§縺ｧ縺吶 +繧医ｊ隧ｳ縺励￥縺ｯ `src/process.js` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 From 18ecd1587f76e81dae11066eec0d9ac06ab1bb09 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 17:25:43 +0900 Subject: [PATCH 15/40] translated http --- doc/api/http.markdown | 431 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 429 insertions(+), 2 deletions(-) diff --git a/doc/api/http.markdown b/doc/api/http.markdown index f317d6e7a552..995426a4c4c7 100644 --- a/doc/api/http.markdown +++ b/doc/api/http.markdown @@ -1,14 +1,27 @@ ## HTTP + +HTTP 繧ｵ繝ｼ繝舌♀繧医ｳ繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｒ菴ｿ逕ｨ縺吶ｋ縺ｫ縺ｯ縺縺壹ｌ繧 `require('http')` 縺悟ｿ隕√〒縺吶 + +Node 縺ｮ HTTP 繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｯ縲 +莨晉ｵｱ逧縺ｫ謇ｱ縺縺碁屮縺励°縺｣縺溘励Ο繝医さ繝ｫ縺ｮ螟壹￥縺ｮ讖溯ｽ繧偵し繝昴ｼ繝医☆繧九ｈ縺縺ｫ險ｭ險医＆繧後※縺縺ｾ縺吶 +縺ｨ繧翫ｏ縺大､ｧ縺阪￥縺ｦ縲∝ｴ蜷医↓繧医▲縺ｦ縺ｯ繝√Ε繝ｳ繧ｯ蛹悶＆繧後◆繝｡繝繧ｻ繝ｼ繧ｸ縺ｧ縺吶 +繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｯ豎ｺ縺励※繝ｪ繧ｯ繧ｨ繧ｹ繝医∪縺溘ｯ繝ｬ繧ｹ繝昴Φ繧ｹ蜈ｨ菴薙ｒ繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺励↑縺繧医≧縺ｫ豌励ｒ縺､縺代※縺縺ｾ縺 +ｼ 蛻ｩ逕ｨ閠縺ｯ繧ｹ繝医Μ繝ｼ繝繝繝ｼ繧ｿ繧剃ｽｿ縺縺薙→縺後〒縺阪∪縺吶 + + +HTTP 繝｡繝繧ｻ繝ｼ繧ｸ繝倥ャ繝縺ｯ縺薙ｮ繧医≧縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医→縺励※陦ｨ迴ｾ縺輔ｌ縺ｾ縺: { 'content-length': '123' , 'content-type': 'text/plain' @@ -16,170 +29,302 @@ HTTP message headers are represented by an object like this: , 'accept': '*/*' } + +繧ｭ繝ｼ縺ｯ蟆乗枚蟄怜喧縺輔ｌ縺ｾ縺吶ょ､縺ｯ螟画峩縺輔ｌ縺ｾ縺帙ｓ縲 + +閠縺医ｉ繧後ｋ HTTP 繧｢繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ繧貞ｮ悟ｨ縺ｫ繧ｵ繝昴ｼ繝医☆繧九◆繧√↓縲 +Node 縺ｮ HTTP API 縺ｯ縺ｨ縺ｦ繧ゆｽ取ｰｴ貅悶〒縺吶ゅ◎繧後ｯ繧ｹ繝医Μ繝ｼ繝縺ｮ繝上Φ繝峨Μ繝ｳ繧ｰ縺ｨ繝｡繝繧ｻ繝ｼ繧ｸ縺ｮ隗｣譫舌□縺代↓蟇ｾ蜃ｦ縺励∪縺吶 +隗｣譫舌ｯ繝｡繝繧ｻ繝ｼ繧ｸ繧偵倥ャ繝縺ｨ繝懊ョ繧｣縺ｫ蛻縺代∪縺吶′縲∝ｮ滄圀縺ｮ繝倥ャ繝縺ｨ繝懊ョ繧｣縺ｯ隗｣譫舌＠縺ｾ縺帙ｓ縲 + +繝励Λ繝繝医ヵ繧ｩ繝ｼ繝縺ｧ OpenSSL 縺悟茜逕ｨ蜿ｯ閭ｽ縺ｧ縺ゅｌ縺ｰ HTTPS 縺後し繝昴ｼ繝医＆繧後∪縺吶 ## http.Server + +縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: ### Event: 'request' `function (request, response) { }` + +`request` 縺ｯ `http.ServerRequest` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縲 +`response` 縺ｯ `http.ServerResponse` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 ### Event: 'connection' `function (stream) { }` + +譁ｰ縺励＞ TCP 繧ｹ繝医Μ繝ｼ繝縺檎｢ｺ遶九＠縺滓凾縲 +`stream` 縺ｯ `net.Stream` 蝙九ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 +騾壼ｸｸ縺ｮ蛻ｩ逕ｨ閠縺後％縺ｮ繧､繝吶Φ繝医↓繧｢繧ｯ繧ｻ繧ｹ縺励◆縺上↑繧九％縺ｨ縺ｯ縺ｪ縺縺ｧ縺励ｇ縺縲 +`stream` 縺ｯ `request.connection` 縺九ｉ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→繧ゅ〒縺阪∪縺吶 ### Event: 'close' `function (errno) { }` + +繧ｵ繝ｼ繝舌′繧ｯ繝ｭ繝ｼ繧ｺ縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 ### Event: 'request' `function (request, response) {}` + +繝ｪ繧ｯ繧ｨ繧ｹ繝医ｮ蠎ｦ縺ｫ逕滓舌＆繧後∪縺吶ゅさ繝阪け繧ｷ繝ｧ繝ｳ縺斐→縺ｫ隍謨ｰ縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医′縺ゅｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞ +(Keep Alive 縺ｪ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ蝣ｴ蜷)縲 ### Event: 'checkContinue' `function (request, response) {}` + +http縺ｮ Expect: 100-continue 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ蜿嶺ｿ｡縺吶ｋ蠎ｦ縺ｫ逕滓舌＆繧後∪縺吶 +縺薙ｮ繧､繝吶Φ繝医′逶｣隕悶＆繧後↑縺蝣ｴ蜷医√し繝ｼ繝舌ｯ閾ｪ蜍慕噪縺ｫ 100 Continue 繧貞ｿ懃ｭ斐＠縺ｾ縺吶 + +縺薙ｮ繧､繝吶Φ繝医ｒ蜃ｦ逅縺吶ｋ蝣ｴ蜷医√け繝ｩ繧､繧｢繝ｳ繝医′繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧帝∽ｿ｡縺礼ｶ壹¢繧九∋縺阪↑繧 +`response.writeContinue` 繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺吶 +縺ゅｋ縺縺ｯ縲√け繝ｩ繧､繧｢繝ｳ繝医′繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧帝∽ｿ｡縺礼ｶ壹¢繧九∋縺阪〒縺ｪ縺縺ｪ繧峨 +驕ｩ蛻縺ｪ HTTP 繝ｬ繧ｹ繝昴Φ繧ｹ (萓九∴縺ｰ 400 Bad Request) 繧堤函謌舌＠縺ｾ縺吶 + +縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後※蜃ｦ逅縺輔ｌ縺溷ｴ蜷医〜request`繧､繝吶Φ繝医ｯ逕滓舌＆繧後↑縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 ### Event: 'upgrade' `function (request, socket, head)` + +繧ｯ繝ｩ繧､繧｢繝ｳ繝医′ HTTP 縺ｮ繧｢繝繝励げ繝ｬ繝ｼ繝峨ｒ隕∵ｱゅ☆繧句ｺｦ縺ｫ逕滓舌＆繧後∪縺吶 +縺薙ｮ繧､繝吶Φ繝医′逶｣隕悶＆繧後↑縺蝣ｴ蜷医√い繝繝励げ繝ｬ繝ｼ繝峨ｒ隕∵ｱゅ＠縺溘け繝ｩ繧､繧｢繝ｳ繝医ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺ｾ縺吶 + +* `request` 縺ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医う繝吶Φ繝医→蜷梧ｧ倥↓ HTTP 繝ｪ繧ｯ繧ｨ繧ｹ繝医∈縺ｮ蠑墓焚縺ｧ縺吶 +* `socket` 縺ｯ繧ｵ繝ｼ繝舌→繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ髢薙ｮ繝阪ャ繝医Ρ繝ｼ繧ｯ繧ｽ繧ｱ繝繝医〒縺吶 +* `head` 縺ｯ繧｢繝繝励げ繝ｬ繝ｼ繝峨せ繝医Μ繝ｼ繝縺ｮ譛蛻昴ｮ繝代こ繝繝医ｒ謖√▽ Buffer 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 +遨ｺ縺ｮ蝣ｴ蜷医ｂ縺ゅｊ縺ｾ縺吶 + +縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後◆蠕後√Μ繧ｯ繧ｨ繧ｹ繝亥縺ｮ繧ｽ繧ｱ繝繝医ｯ繧ゅ≧ `data` 繧､繝吶Φ繝医Μ繧ｹ繝翫ｼ繧呈戟縺｡縺ｾ縺帙ｓ縲 +縺薙ｮ繧ｽ繧ｱ繝繝医〒繧ｵ繝ｼ繝舌∈騾√ｉ繧後◆繝繝ｼ繧ｿ繧呈桶縺縺溘ａ縺ｫ縺昴ｌ繧偵ヰ繧､繝ｳ繝峨＠縺ｪ縺代ｌ縺ｰ縺ｪ繧峨↑縺縺薙→繧呈э蜻ｳ縺励∪縺吶 ### Event: 'clientError' `function (exception) {}` + +繧ｯ繝ｩ繧､繧｢繝ｳ繝医さ繝阪け繧ｷ繝ｧ繝ｳ縺 'error' 繧､繝吶Φ繝医ｒ逋ｺ縺励◆蝣ｴ蜷 ｼ 縺薙％縺ｫ霆｢騾√＆繧後∪縺吶 ### http.createServer(requestListener) + +譁ｰ縺励＞ Web 繧ｵ繝ｼ繝舌が繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 + +`requestListener` 縺ｯ閾ｪ蜍慕噪縺ｫ `'request'` 繧､繝吶Φ繝医↓蜉縺医ｉ繧後ｋ髢｢謨ｰ縺ｧ縺吶 ### server.listen(port, [hostname], [callback]) + +謖螳壹＆繧後◆繝昴ｼ繝医→繝帙せ繝亥錐縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ蜿励¢蜈･繧後ｒ髢句ｧ九＠縺ｾ縺吶 +繝帙せ繝亥錐縺檎怐逡･縺輔ｌ繧九→縲√し繝ｼ繝舌ｯ縺ｩ繧薙↑ IPv4 繧｢繝峨Ξ繧ｹ縺ｸ縺ｮ謗･邯壹ｂ蜿励¢蜈･繧後∪縺 (`INADDR_ANY`)縲 + +UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｒ蠕縺｡蜿励¢繧句ｴ蜷医√昴ｼ繝医→繝帙せ繝亥錐縺ｧ縺ｯ縺ｪ縺上ヵ繧｡繧､繝ｫ蜷阪ｒ謠蝉ｾ帙＠縺ｾ縺吶 + +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶よ怙蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝昴ｼ繝医ｒ繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### server.listen(path, [callback]) + +`path` 縺ｧ荳弱∴繧峨ｌ縺溘さ繝阪け繧ｷ繝ｧ繝ｳ繧貞ｾ縺｡蜿励¢繧 UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｮ繧ｵ繝ｼ繝舌ｒ髢句ｧ九＠縺ｾ縺吶 + +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶よ怙蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### server.setSecure(credentials) + +遘伜ｯ骰ｵ縺ｨ繧ｵ繝ｼ繝占ｨｼ譏取嶌繧呈欠螳壹＠縺滓囓蜿ｷ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ隱崎ｨｼ諠蝣ｱ縺ｧ縲√し繝ｼ繝舌↓蟇ｾ縺励※ HTTPS 繧ｵ繝昴ｼ繝医ｒ譛牙柑縺ｫ縺励∪縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｧ隱崎ｨｼ螻縺ｧ險ｼ譏弱＆繧後◆繧ｯ繝ｩ繧､繧｢繝ｳ繝郁ｪ崎ｨｼ繧剃ｽｿ縺縺薙→繧ゅ〒縺阪∪縺吶 + +隱崎ｨｼ諠蝣ｱ縺御ｸ縺､莉･荳翫ｮ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌繧呈戟縺｣縺ｦ縺繧句ｴ蜷医 +繧ｵ繝ｼ繝舌ｯ HTTPS 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｫ縺翫¢繧九ワ繝ｳ繝峨す繧ｧ繝ｼ繧ｯ縺ｮ荳驛ｨ縺ｨ縺励※繧ｯ繝ｩ繧､繧｢繝ｳ繝郁ｨｼ譏取嶌繧帝√ｋ繧医≧繧ｯ繝ｩ繧､繧｢繝ｳ繝医↓隕∵ｱゅ＠縺ｾ縺吶 +縺昴ｮ譛牙柑諤ｧ縺ｨ蜀螳ｹ縺ｯ縲√し繝ｼ繝舌ｮ `resuest.connection` 縺九ｉ +`verifyPeer()` 縺ｨ `getPeerCertificate()` 繧帝壹§縺ｦ繧｢繧ｯ繧ｻ繧ｹ縺ｧ縺阪∪縺吶 ### server.close() + +繧ｵ繝ｼ繝舌′譁ｰ縺励＞繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺台ｻ倥¢繧九ｮ繧堤ｵゆｺ縺励∪縺吶 ## http.ServerRequest + +縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ HTTP 繧ｵ繝ｼ繝仙驛ｨ ｼ 繝ｦ繝ｼ繧ｶ縺ｧ縺ｯ縺ｪ縺 ｼ 縺ｧ菴懈舌＆繧後 +`'request'` 繝ｪ繧ｹ繝翫ｼ縺ｮ隨ｬ1蠑墓焚縺ｨ縺励※貂｡縺輔ｌ縺ｾ縺吶 + +縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: ### Event: 'data' `function (chunk) { }` + +繝｡繝繧ｻ繝ｼ繧ｸ繝懊ョ繧｣縺ｮ譁ｭ迚繧貞女菫｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 + +萓: 荳縺､縺ｮ蠑墓焚縺ｨ縺励※繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ縺御ｸ弱∴繧峨ｌ縺ｾ縺吶 +霆｢騾√お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ繝繧ｳ繝ｼ繝峨＆繧後∪縺吶 +繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ縺ｯ譁蟄怜励〒縺吶 +繝懊ョ繧｣縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ `request.setBodyEncoding()` 縺ｧ險ｭ螳壹＆繧後∪縺吶 ### Event: 'end' `function () { }` + +繝｡繝繧ｻ繝ｼ繧ｸ縺斐→縺ｫ蜴ｳ蟇縺ｫ荳蝗樒函謌舌＆繧後∪縺吶ょｼ墓焚縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 +縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後◆蠕後√％縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医〒逕滓舌＆繧後ｋ繧､繝吶Φ繝医ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### request.method + +繝ｪ繧ｯ繧ｨ繧ｹ繝医Γ繧ｽ繝繝峨ｒ陦ｨ縺呎枚蟄怜励〒縺吶ょ盾辣ｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺吶 +萓: `'GET'`縲〜'DELETE'` ### request.url + +繝ｪ繧ｯ繧ｨ繧ｹ繝 URL 繧定｡ｨ縺呎枚蟄怜励〒縺吶 +縺薙ｌ縺ｯ螳滄圀縺ｮ HTTP 繝ｪ繧ｯ繧ｨ繧ｹ繝医↓蟄伜惠縺吶ｋ URL 縺縺代ｒ蜷ｫ縺ｿ縺ｾ縺吶 +繝ｪ繧ｯ繧ｨ繧ｹ繝医′縺薙≧縺ｪ繧: GET /status?name=ryan HTTP/1.1\r\n Accept: text/plain\r\n \r\n + +縺薙ｮ蝣ｴ蜷医ｮ `request.url` 縺ｯ縺薙≧縺ｪ繧翫∪縺: '/status?name=ryan' + +URL 縺ｮ隕∫ｴ繧定ｧ｣譫舌＠縺溘＞蝣ｴ蜷医ｯ縲 +`require('url').parse(request.url)` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲ゆｾ: node> require('url').parse('/status?name=ryan') { href: '/status?name=ryan' @@ -188,9 +333,14 @@ If you would like to parse the URL into its parts, you can use , pathname: '/status' } + +蝠上＞蜷医ｏ縺帶枚蟄怜励°繧峨ヱ繝ｩ繝｡繝ｼ繧ｿ繧貞叙繧雁ｺ縺励◆縺蝣ｴ蜷医ｯ縲 +`require('querystring').parse` 髢｢謨ｰ繧貞盾辣ｧ縺吶ｋ縺九 +`require('url').parse` 縺ｮ隨ｬ 2 蠑墓焚縺ｫ `true` 繧呈ｸ｡縺励※縺上□縺輔＞縲ゆｾ: node> require('url').parse('/status?name=ryan', true) { href: '/status?name=ryan' @@ -203,65 +353,116 @@ you can use the `require('querystring').parse` function, or pass ### request.headers + +蜿らｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺吶 ### request.trailers + +蜿らｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺; HTTP 縺ｮ繝医Ξ繝ｼ繝ｩ縺ｧ縺 (繧ゅ＠縺ゅｌ縺ｰ)縲'end' 繧､繝吶Φ繝医ｮ蠕後↓縺縺醍匱逕溘＠縺ｾ縺吶 ### request.httpVersion + +HTTP 繝励Ο繝医さ繝ｫ縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ繧定｡ｨ縺呎枚蟄怜励〒縺吶ょ盾辣ｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺吶ゆｾ: +`'1.1'`縲〜'1.0'`縲 +蜷梧ｧ倥↓ `request.httpVersionMajor` 縺ｯ譛蛻昴ｮ謨ｴ謨ｰ縲 +`request.httpVersionMinor` 縺ｯ 2 逡ｪ逶ｮ縺ｮ謨ｴ謨ｰ縺ｧ縺吶 ### request.setEncoding(encoding=null) + +繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧定ｨｭ螳壹＠縺ｾ縺吶 +`'utf8'` 縺ｾ縺溘ｯ `'binary'` 縺ｮ縺縺壹ｌ縺九〒縺吶 +繝繝輔か繝ｫ繝医ｯ `null` 縺ｧ縲〜'data'` 繧､繝吶Φ繝医′ +`Buffer` 繧堤函謌舌☆繧九％縺ｨ繧呈э蜻ｳ縺励∪縺吶 ### request.pause() + +繝ｪ繧ｯ繧ｨ繧ｹ繝医↓繧医ｋ繧､繝吶Φ繝医ｮ逕滓舌ｒ荳ｭ譁ｭ縺励∪縺吶ゅい繝繝励Ο繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 ### request.resume() + +荳ｭ譁ｭ縺輔ｌ縺溘Μ繧ｯ繧ｨ繧ｹ繝医ｒ蜀埼幕縺励∪縺吶 ### request.connection + +繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｫ髢｢騾｣縺･縺代ｉ繧後◆ `net.Stream` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 + +HTTPS 縺ｧ縺ｯ `request.connection.verifyPeer()` 縺ｨ +`request.connection.getPeerCertificate()` 縺ｧ +繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ隱崎ｨｼ縺ｮ隧ｳ邏ｰ繧貞叙蠕励〒縺阪∪縺吶 ## http.ServerResponse + +縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ HTTP 繧ｵ繝ｼ繝仙驛ｨ ｼ 繝ｦ繝ｼ繧ｶ縺ｧ縺ｯ縺ｪ縺 ｼ 縺ｧ菴懈舌＆繧後∪縺吶 +`'request'` 繝ｪ繧ｹ繝翫ｼ縺ｮ隨ｬ 2 蠑墓焚縺ｨ縺励※貂｡縺輔ｌ縺ｾ縺吶 +縺薙ｌ縺ｯ `Writable Stream` 縺ｧ縺吶 ### response.writeContinue() + +HTTP/1.1 縺ｮ 100 Continue 繝｡繝繧ｻ繝ｼ繧ｸ繧偵け繝ｩ繧､繧｢繝ｳ繝医↓騾∽ｿ｡縺励 +繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧帝∽ｿ｡縺励※繧ゅｈ縺縺薙→繧堤､ｺ縺励∪縺吶 +`Server`縺ｮ`checkContinue`繧､繝吶Φ繝医ｒ蜿らｧ縺励※縺上□縺輔＞縲 ### response.writeHead(statusCode, [reasonPhrase], [headers]) + +繝ｬ繧ｹ繝昴Φ繧ｹ繝倥ャ繝繧帝∽ｿ｡縺励∪縺吶 +繧ｹ繝繝ｼ繧ｿ繧ｹ繧ｳ繝ｼ繝峨ｯ `404` 縺ｮ繧医≧縺ｪ 3 譯√ｮ謨ｰ蟄励↓繧医ｋ HTTP 繧ｹ繝繝ｼ繧ｿ繧ｹ繧ｳ繝ｼ繝峨〒縺吶 +譛蠕後ｮ蠑墓焚 `headers` 縺ｯ縲√Ξ繧ｹ繝昴Φ繧ｹ繝倥ャ繝縺ｧ縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｨ縺励※莠ｺ縺ｫ隱ｭ繧√ｋ蠖｢蠑上ｮ `reasonPhrase` 繧堤ｬｬ 2 蠑墓焚縺ｧ荳弱∴繧九％縺ｨ縺後〒縺阪∪縺吶 + +萓: var body = 'hello world'; response.writeHead(200, { @@ -269,39 +470,75 @@ Example: 'Content-Type': 'text/plain' }); + +縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝｡繝繧ｻ繝ｼ繧ｸ縺斐→縺ｫ 1 蝗槭□縺大他縺ｳ蜃ｺ縺輔ｌ縺ｪ縺上※縺ｯ縺ｪ繧峨★縲 +`response.end()` 縺ｮ蜑阪↓蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 ### response.write(chunk, encoding='utf8') + +縺薙ｮ繝｡繧ｽ繝繝峨ｯ `writeHead` 縺ｮ蠕後↓蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 +縺薙ｌ縺ｯ繝ｬ繧ｹ繝昴Φ繧ｹ繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ繧帝∽ｿ｡縺励∪縺吶 +縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝懊ョ繧｣縺ｮ騾｣邯壹＠縺滄Κ蛻繧呈署萓帙☆繧九◆繧√↓隍謨ｰ蝗槫他縺ｳ蜃ｺ縺輔ｌ繧九°繧ゅ＠繧後∪縺帙ｓ縲 + +`chunk` 縺ｯ譁蟄怜励∪縺溘ｯ繝舌ャ繝輔ぃ縺ｫ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 +`chunk` 縺梧枚蟄怜励ｮ蝣ｴ蜷医√←縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝峨〒繝舌う繝医せ繝医Μ繝ｼ繝縺ｫ縺吶ｋ縺九ｒ隨ｬ 2 蠑墓焚縺ｧ謖螳壹＠縺ｾ縺吶 +繝繝輔か繝ｫ繝医ｮ `encoding` 縺ｯ `'utf8'` 縺ｧ縺吶 + +**豕ｨ諢**: 縺薙ｌ縺ｯ逕溘ｮ HTTP 繝懊ョ繧｣縺ｧ縲 +鬮俶ｰｴ貅悶ｮ繝槭Ν繝√ヱ繝ｼ繝医懊ョ繧｣繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ菴ｿ繧上ｌ繧九ｂ縺ｮ縺ｨ縺ｯ辟｡髢｢菫ゅ〒縺吶 + +蛻昴ａ縺ｦ `response.write()` 縺悟他縺ｳ蜃ｺ縺輔ｌ繧九→縲 +繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺輔ｌ縺ｦ縺縺溘倥ャ繝諠蝣ｱ縺ｨ譛蛻昴ｮ繝懊ョ繧｣縺後け繝ｩ繧､繧｢繝ｳ繝医↓騾∽ｿ｡縺輔ｌ縺ｾ縺吶 +2 蝗樒岼縺ｫ `response.write()` 縺悟他縺ｰ繧後ｋ縺ｨ縲 +Node 縺ｯ繧ｹ繝医Μ繝ｼ繝溘Φ繧ｰ繝繝ｼ繧ｿ繧貞蜑ｲ縺励※騾∽ｿ｡縺励ｈ縺縺ｨ縺励※縺繧九→莉ｮ螳壹＠縺ｾ縺吶 +縺吶↑繧上■縲√Ξ繧ｹ繝昴Φ繧ｹ縺ｯ繝懊ョ繧｣縺ｮ譛蛻昴ｮ繝√Ε繝ｳ繧ｯ縺ｾ縺ｧ繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺輔ｌ縺ｾ縺吶 ### response.addTrailers(headers) + +縺薙ｮ繝｡繧ｽ繝繝峨ｯ HTTP 繝医Ξ繝ｼ繝ｩ繝倥ャ繝 (繝｡繝繧ｻ繝ｼ繧ｸ縺ｮ譛蠕後↓鄂ｮ縺九ｌ繧九倥ャ繝) 繧偵Ξ繧ｹ繝昴Φ繧ｹ縺ｫ霑ｽ蜉縺励∪縺吶 + +繝医Ξ繝ｼ繝ｩ縺ｯ繝ｬ繧ｹ繝昴Φ繧ｹ縺後メ繝｣繝ｳ繧ｯ蛹悶＆繧後◆繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ**縺ｮ縺ｿ**逕滓舌＆繧後∪縺; +縺昴≧縺ｧ縺ｪ縺代ｌ縺ｰ (萓九∴縺ｰ繝ｪ繧ｯ繧ｨ繧ｹ繝医′ HTTP/1.0)縲鮟吶▲縺ｦ遐ｴ譽縺輔ｌ縺ｾ縺吶 + +HTTP 縺ｯ縲√ヨ繝ｬ繝ｼ繝ｩ繧堤函謌舌☆繧九↑繧峨◎縺ｮ繝倥ャ繝繝輔ぅ繝ｼ繝ｫ繝峨ｮ繝ｪ繧ｹ繝医ｒ蛟､縺ｨ縺励※ +`Trailer` 繝倥ャ繝繧帝∽ｿ｡縺吶ｋ縺薙→繧定ｦ∵ｱゅ＠縺ｦ縺繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 response.writeHead(200, { 'Content-Type': 'text/plain', 'Trailer': 'TraceInfo' }); @@ -312,24 +549,43 @@ emit trailers, with a list of the header fields in its value. E.g., ### response.end([data], [encoding]) + +縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝ｬ繧ｹ繝昴Φ繧ｹ縺ｮ蜈ｨ縺ｦ縺ｮ繝倥ャ繝縺ｨ繝懊ョ繧｣繧帝∽ｿ｡縺励◆縺薙→繧偵し繝ｼ繝舌↓莨昴∴縺ｾ縺; +繧ｵ繝ｼ繝舌ｯ繝｡繝繧ｻ繝ｼ繧ｸ縺檎ｵゆｺ縺励◆縺ｨ閠縺医ｋ縺ｹ縺阪〒縺吶 +縺薙ｮ `response.end()` 繝｡繧ｽ繝繝峨ｯ蜷繝ｬ繧ｹ繝昴Φ繧ｹ縺斐→縺ｫ蜻ｼ縺ｳ蜃ｺ縺輔↑縺代ｌ縺ｰ*縺ｪ繧翫∪縺帙ｓ*縲 + +`data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医 +`response.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `response.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 ## http.Client + +HTTP 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ蠑墓焚縺ｨ縺励※貂｡縺輔ｌ繧九し繝ｼ繝舌い繝峨Ξ繧ｹ縺ｫ繧医▲縺ｦ讒狗ｯ峨＆繧後 +謌ｻ繧雁､縺ｮ繝上Φ繝峨Ν縺ｯ荳縺､縺ｾ縺溘ｯ縺昴ｌ莉･荳翫ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ逋ｺ陦後☆繧九ｮ縺ｫ菴ｿ繧上ｌ縺ｾ縺吶 +謗･邯壹＆繧後◆繧ｵ繝ｼ繝舌↓蠢懊§縺ｦ縲√け繝ｩ繧､繧｢繝ｳ繝医ｯ繝代う繝励Λ繧､繝ｳ蛹悶＆繧後◆繝ｪ繧ｯ繧ｨ繧ｹ繝医∪縺溘ｯ縲 +縺昴ｌ縺槭ｌ縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｮ蠕後〒繧ｹ繝医Μ繝ｼ繝繧貞咲｢ｺ遶九☆繧九°繧ゅ＠繧後∪縺帙ｓ縲 +_迴ｾ蝨ｨ縺ｮ螳溯｣縺ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ繝代う繝励Λ繧､繝ｳ蛹悶＠縺ｾ縺帙ｓ縲_ + + +`google.com` 縺ｫ謗･邯壹☆繧倶ｾ: var http = require('http'); var google = http.createClient(80, 'www.google.com'); @@ -345,8 +601,12 @@ Example of connecting to `google.com`: }); }); + +蟆第焚縺ｮ迚ｹ蛻･縺ｪ繝倥ャ繝縺後≠繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 + +* 'Host' 繝倥ャ繝縺ｯ Node 縺ｫ繧医▲縺ｦ蜉縺医ｉ繧後∪縺帙ｓ縺後騾壼ｸｸ縺ｮ Web 繧ｵ繧､繝医↓蠢隕√→縺輔ｌ縺ｾ縺吶 + +* 'Connection: keep-alive' 繧帝∽ｿ｡縺吶ｋ縺薙→縺ｧ縲√し繝ｼ繝舌∈縺ｮ謗･邯壹ｒ谺｡縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医∪縺ｧ邯ｭ謖√☆繧九％縺ｨ繧 Node 縺ｫ騾夂衍縺励∪縺吶 + +* 'Content-length' 繝倥ャ繝繧帝∽ｿ｡縺吶ｋ縺薙→縺ｧ縲√ョ繝輔か繝ｫ繝医ｮ繝√Ε繝ｳ繧ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺檎┌蜉ｹ縺ｫ縺ｪ繧翫∪縺吶 + +* 'Expect' 繝倥ャ繝繧帝∽ｿ｡縺吶ｋ縺薙→縺ｧ縲√Μ繧ｯ繧ｨ繧ｹ繝医倥ャ繝繧堤峩縺｡縺ｫ騾∽ｿ｡縺励∪縺吶 +騾壼ｸｸ縲'Expect: 100-continue' 繧帝∽ｿ｡縺吶ｋ蝣ｴ蜷医√ち繧､繝繧｢繧ｦ繝医→ `continue` 繧､繝吶Φ繝医ｮ荳｡譁ｹ繧定ｨｭ螳壹＠縺ｾ縺吶 +繧医ｊ隧ｳ縺励￥縺ｯ RFC2616 縺ｮ 8.2.3 遽繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### Event: 'upgrade' `function (request, socket, head)` + +繧ｵ繝ｼ繝舌′繧｢繝繝励げ繝ｬ繝ｼ繝芽ｦ∵ｱゅ↓蠢懃ｭ斐☆繧句ｺｦ縺ｫ逕滓舌＆繧後∪縺吶 +縺薙ｮ繧､繝吶Φ繝医′逶｣隕悶＆繧後※縺縺ｪ縺蝣ｴ蜷医√け繝ｩ繧､繧｢繝ｳ繝医′繧｢繝繝励げ繝ｬ繝ｼ繝峨倥ャ繝繧貞女菫｡縺吶ｋ縺ｨ縺昴ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺ｾ縺吶 + +繧医ｊ隧ｳ縺励￥縺ｯ `http.Server` 縺ｮ `upgrade` 繧､繝吶Φ繝医ｮ隱ｬ譏弱ｒ蜿らｧ縺励※縺上□縺輔＞縲 ### Event: 'continue' `function ()` + +騾壼ｸｸ縲√Μ繧ｯ繧ｨ繧ｹ繝医′ 'Expect: 100-continue' 繧貞性繧薙〒縺縺溘％縺ｨ縺ｫ繧医ｊ縲 +繧ｵ繝ｼ繝舌′ '100 Continue' HTTP 繝ｬ繧ｹ繝昴Φ繧ｹ繧帝∽ｿ｡縺吶ｋ縺薙→縺ｧ逕滓舌＆繧後∪縺吶 +縺薙ｌ縺ｯ繧ｯ繝ｩ繧､繧｢繝ｳ繝医′繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧帝∽ｿ｡縺吶∋縺堺ｺ九ｒ遉ｺ縺励∪縺吶 ### http.createClient(port, host='localhost', secure=false, [credentials]) + +譁ｰ縺励＞ HTTP 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｒ讒狗ｯ峨＠縺ｾ縺吶 +`port` 縺ｨ `host` 縺ｯ謗･邯壼医→縺ｪ繧九し繝ｼ繝舌ｒ蜿らｧ縺励∪縺吶 +繝ｪ繧ｯ繧ｨ繧ｹ繝医′逋ｺ陦後＆繧後ｋ縺ｾ縺ｧ繧ｹ繝医Μ繝ｼ繝縺ｯ遒ｺ遶九＆繧後∪縺帙ｓ縲 + +繧ｪ繝励す繝ｧ繝ｳ縺ｮ`secure` 縺ｯ boolean 縺ｮ繝輔Λ繧ｰ縺ｧ HTTPS 繧ｵ繝昴ｼ繝医ｒ譛牙柑縺ｫ縺励 +繧ｪ繝励す繝ｧ繝ｳ縺ｮ`credentials` 縺ｯ證怜捷繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ隱崎ｨｼ諠蝣ｱ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縲 +繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ遘伜ｯ骰ｵ縲∬ｨｼ譏取嶌縲√◎縺励※菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌縺ｮ繝ｪ繧ｹ繝医ｒ蜷ｫ繧縺薙→縺後〒縺阪∪縺吶 + +繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺後そ繧ｭ繝･繧｢縺ｪ蝣ｴ蜷医∬ｨｼ譏取ュ蝣ｱ縺ｧ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌縺梧守､ｺ逧縺ｫ貂｡縺輔ｌ縺ｪ縺縺ｨ縲 +node.js 縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ繝ｪ繧ｹ繝医→縺励※ +http://mxr.mozilla.org/mozilla/source/security/nss/lib/ckfw/builtins/certdata.txt 繧剃ｸ弱∴縺ｾ縺吶 ### client.request(method='GET', path, [request_headers]) + +繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ逋ｺ陦後＠縺ｾ縺; 蠢隕√〒縺ゅｌ縺ｰ繧ｹ繝医Μ繝ｼ繝繧堤｢ｺ遶九＠縺ｾ縺吶 +`http.ClientRequest` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 + +`method` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縲∫怐逡･縺輔ｌ縺溷ｴ蜷医ｮ繝繝輔か繝ｫ繝医ｯ 'GET'縺ｧ縺吶 + +`request_headers` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 +Node 蜀驛ｨ縺ｧ莉伜刈逧縺ｪ繝ｪ繧ｯ繧ｨ繧ｹ繝医倥ャ繝縺悟刈縺医ｉ繧後ｋ縺薙→縺後≠繧翫∪縺吶 +`ClientRequest` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 + +繝懊ョ繧｣繧帝∽ｿ｡縺励ｈ縺縺ｨ縺励※縺繧句ｴ蜷医ｯ縲〜Content-Length` 繝倥ャ繝繧貞性繧√ｋ縺薙→繧貞ｿ倥ｌ縺ｪ縺縺ｧ縺上□縺輔＞縲 +繝懊ョ繧｣繧偵せ繝医Μ繝ｼ繝蛹悶☆繧句ｴ蜷医ｯ縲√♀縺昴ｉ縺 `Transfer-Encoding: chunked` 繧偵そ繝繝医＠縺ｦ縺上□縺輔＞縲 + +*豕ｨ諢*: 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｯ螳御ｺ縺励※縺縺ｾ縺帙ｓ縲ゅ％縺ｮ繝｡繧ｽ繝繝峨ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｮ繝倥ャ繝繧帝∽ｿ｡縺吶ｋ縺縺代〒縺吶 +繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ螳御ｺ縺励※繝ｬ繧ｹ繝昴Φ繧ｹ繧定ｪｭ縺ｿ蜃ｺ縺吶↓縺ｯ `request.end()` 繧貞他縺ｶ蠢隕√′縺ゅｊ縺ｾ縺吶 +(隍髮代↓諢溘§繧九°繧ゅ＠繧後∪縺帙ｓ縺後 +縺薙ｌ縺ｯ `request.write()` 縺ｧ繝懊ョ繧｣繧偵せ繝医Μ繝ｼ繝蛹悶☆繧九メ繝｣繝ｳ繧ｹ繧偵Θ繝ｼ繧ｶ縺ｫ謠蝉ｾ帙＠縺ｾ縺))縲 ### client.verifyPeer() + +謖螳壹＆繧後◆縲√≠繧九＞縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺輔ｌ縺溯ｪ崎ｨｼ螻縺ｮ險ｼ譏取嶌縺ｫ縺翫＞縺ｦ縲 +繧ｵ繝ｼ繝舌ｮ險ｼ譏取嶌縺ｮ螯･蠖捺ｧ縺ｫ蠢懊§縺ｦ true 縺ｾ縺溘ｯ false 繧定ｿ斐＠縺ｾ縺吶 ### client.getPeerCertificate() + +繧ｵ繝ｼ繝占ｨｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵'subject'縲'issuer'縲'valid_from' 縺昴＠縺ｦ +'valid_to' 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 ## http.ClientRequest + +縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ HTTP 繧ｵ繝ｼ繝仙驛ｨ縺ｧ菴懈舌＆繧後〜http.Client` 縺ｮ +`request()` 繝｡繧ｽ繝繝峨°繧芽ｿ斐＆繧後∪縺吶 +縺昴ｌ縺ｯ繝倥ャ繝縺碁∽ｿ｡縺輔ｌ縺 _騾ｲ陦御ｸｭ_ 縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ陦ｨ迴ｾ縺励∪縺吶 + +繝ｬ繧ｹ繝昴Φ繧ｹ繧貞叙蠕励☆繧九↓縺ｯ縲〜'response'` 逕ｨ縺ｮ繝ｪ繧ｹ繝翫ｼ繧偵Μ繧ｯ繧ｨ繧ｹ繝医が繝悶ず繧ｧ繧ｯ繝医↓蜉縺医∪縺吶 +`'response'` 繧､繝吶Φ繝医ｯ繝ｬ繧ｹ繝昴Φ繧ｹ繝倥ャ繝繧貞女菫｡縺吶ｋ縺ｨ繝ｪ繧ｯ繧ｨ繧ｹ繝医が繝悶ず繧ｧ繧ｯ繝医↓繧医▲縺ｦ逕滓舌＆繧後∪縺吶 +`'response'` 繧､繝吶Φ繝医ｯ `http.ClientResponse` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧貞髪荳縺ｮ蠑墓焚縺ｨ縺励※螳溯｡後＆繧後∪縺吶 + +`'response'` 繧､繝吶Φ繝医ｮ髢薙√Ξ繧ｹ繝昴Φ繧ｹ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓繝ｪ繧ｹ繝翫ｼ繧貞刈縺医ｋ縺薙→縺後〒縺阪∪縺; +縺ｨ繧翫ｏ縺 `'data'` 繧､繝吶Φ繝医ｮ繝ｪ繧ｹ繝翫ｼ縺ｧ縺吶 +`'response'` 繧､繝吶Φ繝医ｯ繝ｬ繧ｹ繝昴Φ繧ｹ繝懊ョ繧｣縺ｮ縺ｩ縺ｮ驛ｨ蛻繧貞女菫｡縺吶ｋ繧医ｊ繧ょ燕縺ｫ蜻ｼ縺ｳ蜃ｺ縺輔ｌ繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +縺昴ｮ縺溘ａ縲√懊ョ繧｣縺ｮ譛蛻昴ｮ驛ｨ蛻縺ｮ蜿嶺ｿ｡縺ｨ遶ｶ蜷医☆繧九％縺ｨ繧貞ｿ驟阪☆繧句ｿ隕√ｯ縺ゅｊ縺ｾ縺帙ｓ縲 +`'response'` 繧､繝吶Φ繝医ｮ髢薙↓ `'data'` 繧､繝吶Φ繝医ｮ繝ｪ繧ｹ繝翫ｼ縺悟刈縺医ｉ繧後ｋ髯舌ｊ縲 +繝懊ョ繧｣蜈ｨ菴薙ｒ蜿嶺ｿ｡縺吶ｋ縺薙→縺後〒縺阪∪縺吶 // Good @@ -453,100 +798,182 @@ event, the entire body will be caught. }, 10); }); + +縺薙ｌ縺ｯ `Writable Stream` 縺ｧ縺吶 + +縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺吶 ### Event 'response' `function (response) { }` + +縺薙ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医↓蟇ｾ縺吶ｋ繝ｬ繧ｹ繝昴Φ繧ｹ繧貞女菫｡縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 +縺薙ｮ繧､繝吶Φ繝医ｯ荳蝗槭□縺醍函謌舌＆繧後∪縺吶 +`response` 蠑墓焚縺ｯ `http.ClientResponse` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 ### request.write(chunk, encoding='utf8') + +繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ繧帝∽ｿ｡縺励∪縺吶 +縺薙ｮ繝｡繧ｽ繝繝峨ｒ菴募屓繧ょ他縺ｳ蜃ｺ縺吶→縲√し繝ｼ繝舌∈縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧偵せ繝医Μ繝ｼ繝蛹悶〒縺阪∪縺 ｼ +縺薙ｮ繧ｱ繝ｼ繧ｹ縺ｯ `['Transfer-Encoding', 'chunked']` 繝倥ャ繝縺ｧ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ逕滓舌＠縺溘％縺ｨ繧呈э蜻ｳ縺励∪縺吶 + +`chunk` 蠑墓焚縺ｯ謨ｴ謨ｰ縺ｮ驟榊励°譁蟄怜励↓縺ｪ繧翫∪縺吶 + +`encoding` 蠑墓焚縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縲〜chunk` 縺梧枚蟄怜励ｮ蝣ｴ蜷医□縺鷹←逕ｨ縺輔ｌ縺ｾ縺吶 ### request.end([data], [encoding]) + +繝ｪ繧ｯ繧ｨ繧ｹ繝医ｮ騾∽ｿ｡繧堤ｵゆｺ縺励∪縺吶 +繝懊ョ繧｣縺ｮ縺縺上▽縺九ｮ驛ｨ蛻縺後∪縺騾∽ｿ｡縺輔ｌ縺ｦ縺縺ｪ縺蝣ｴ蜷医√◎繧後ｯ繧ｹ繝医Μ繝ｼ繝縺ｫ繝輔Λ繝繧ｷ繝･縺輔ｌ縺ｾ縺吶 +繝ｪ繧ｯ繧ｨ繧ｹ繝医′繝√Ε繝ｳ繧ｯ蛹悶＆繧後※縺繧句ｴ蜷医√％繧後ｯ邨らｫｯ縺ｮ `'0\r\n\r\n'` 繧帝∽ｿ｡縺励∪縺吶 + +`data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医ｯ縲 +`request.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `request.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 ## http.ClientResponse + +縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ `http.Client` 縺ｫ繧医▲縺ｦ繝ｪ繧ｯ繧ｨ繧ｹ繝医→荳邱偵↓菴懈舌＆繧後∪縺吶 +縺薙ｌ縺ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医が繝悶ず繧ｧ繧ｯ繝医ｮ `'response'` 繧､繝吶Φ繝医↓貂｡縺輔ｌ縺ｾ縺吶 + +繝ｬ繧ｹ繝昴Φ繧ｹ縺ｯ `Readable Stream` 繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧貞ｮ溯｣縺励∪縺吶 ### Event: 'data' `function (chunk) {}` + +繝｡繝繧ｻ繝ｼ繧ｸ繝懊ョ繧｣縺ｮ譁ｭ迚繧貞女菫｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 + + 萓: 繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ縺ｯ荳縺､縺ｮ蠑墓焚縺ｨ縺励※荳弱∴繧峨ｌ縺ｾ縺吶 + 霆｢騾√お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ繝繧ｳ繝ｼ繝峨＆繧後∪縺吶 + 繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ縺ｯ譁蟄怜励〒縺吶 + 繝懊ョ繧｣繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ `response.setBodyEncoding()` 縺ｫ繧医▲縺ｦ險ｭ螳壹＆繧後∪縺吶 ### Event: 'end' `function () {}` + +繝｡繝繧ｻ繝ｼ繧ｸ縺斐→縺ｫ蜴ｳ蟇縺ｫ荳蝗槭□縺醍函謌舌＆繧後∪縺吶 +縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後◆蠕後√％縺ｮ繝ｬ繧ｹ繝昴Φ繧ｹ縺ｯ縺ｩ繧薙↑繧､繝吶Φ繝医ｂ逕滓舌＠縺ｾ縺帙ｓ縲 ### response.statusCode + +3 譯√ｮ謨ｰ蟄励↓繧医ｋ繝ｬ繧ｹ繝昴Φ繧ｹ縺ｮ繧ｹ繝繝ｼ繧ｿ繧ｹ繧ｳ繝ｼ繝峨〒縺吶ゆｾ九∴縺ｰ `404`縲 ### response.httpVersion + +謗･邯壹＠縺ｦ縺繧九し繝ｼ繝舌→縺ｮ HTTP 縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ縺吶 +縺翫◎繧峨￥ `'1.1'` 縺ｾ縺溘ｯ `'1.0'` 縺ｮ縺ｩ縺｡繧峨°縺ｧ縺吶 +蜷梧ｧ倥↓ `response.httpVersionMajor` 縺ｯ譛蛻昴ｮ謨ｴ謨ｰ縲 +`response.httpVersionMinor` 縺ｯ 2 逡ｪ逶ｮ縺ｮ謨ｴ謨ｰ縺ｧ縺吶 ### response.headers + +繝ｬ繧ｹ繝昴Φ繧ｹ繝倥ャ繝繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### response.trailers + +繝ｬ繧ｹ繝昴Φ繧ｹ縺ｮ繝医Ξ繝ｼ繝ｩ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 +'end' 繧､繝吶Φ繝医ｮ蠕後↓縺縺醍匱逕溘＠縺ｾ縺吶 ### response.setEncoding(encoding=null) + +繝ｬ繧ｹ繝昴Φ繧ｹ繝懊ョ繧｣縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧定ｨｭ螳壹＠縺ｾ縺吶 +`'utf8'`縲〜'ascii'`縲√≠繧九＞縺ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 +繝繝輔か繝ｫ繝医ｯ `null` 縺ｧ縲 +`'data'` 繧､繝吶Φ繝医′ `Buffer` 繧堤函謌舌☆繧九％縺ｨ繧呈э蜻ｳ縺励∪縺吶 ### response.pause() + +繧､繝吶Φ繝医ｮ逕滓舌↓繧医ｋ繝ｬ繧ｹ繝昴Φ繧ｹ繧剃ｸｭ譁ｭ縺励∪縺吶ゅム繧ｦ繝ｳ繝ｭ繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 ### response.resume() + +荳ｭ譁ｭ縺輔ｌ縺ｦ縺縺溘Ξ繧ｹ繝昴Φ繧ｹ繧貞埼幕縺励∪縺吶 ### response.client + +縺薙ｮ繝ｬ繧ｹ繝昴Φ繧ｹ繧呈園譛峨☆繧 `http.Client` 縺ｸ縺ｮ蜿らｧ縺ｧ縺吶 From 03256ccc02e1e3468044daae02d5d929d1f2de2d Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 17:46:36 +0900 Subject: [PATCH 16/40] translated modules --- doc/api/modules.markdown | 76 ++++++++++++++++++++++++++++++++++++++-- 1 file changed, 74 insertions(+), 2 deletions(-) diff --git a/doc/api/modules.markdown b/doc/api/modules.markdown index 89efa6e4ff00..8321aec59138 100644 --- a/doc/api/modules.markdown +++ b/doc/api/modules.markdown @@ -1,31 +1,57 @@ ## Standard Modules + +Node 縺ｫ縺ｯ繝励Ο繧ｻ繧ｹ蜀縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺輔ｌ縺溘＞縺上▽縺九ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺悟性縺ｾ繧後※縺翫ｊ縲 +縺昴ｮ縺ｻ縺ｨ繧薙←縺ｯ莉･荳九↓譁譖ｸ蛹悶＆繧後※縺縺ｾ縺吶 +縺薙ｌ繧峨ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ逕ｨ縺吶ｋ繧ゅ▲縺ｨ繧ゆｸ闊ｬ逧縺ｪ譁ｹ豕輔ｯ縲 +`require('name')` 縺ｮ謌ｻ繧雁､繧偵√Δ繧ｸ繝･繝ｼ繝ｫ縺ｨ蜷後§蜷榊燕縺ｮ繝ｭ繝ｼ繧ｫ繝ｫ螟画焚縺ｫ蜑ｲ繧雁ｽ薙※繧九％縺ｨ縺ｧ縺吶 + +萓: var util = require('util'); + +縺昴ｮ莉悶ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｧ node 繧呈僑蠑ｵ縺吶ｋ縺薙→繧ょ庄閭ｽ縺ｧ縺吶ゅ後Δ繧ｸ繝･繝ｼ繝ｫ縲阪ｒ蜿らｧ縺励※縺上□縺輔＞縲 ## Modules + +Node 縺ｯ CommonJS 縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧ｷ繧ｹ繝繝繧剃ｽｿ縺縺ｾ縺吶 + +Node 縺ｯ繧ｷ繝ｳ繝励Ν縺ｪ繝｢繧ｸ繝･繝ｼ繝ｫ繝ｭ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝繧呈戟縺｡縺ｾ縺吶 +Node 縺ｧ縺ｯ縲√ヵ繧｡繧､繝ｫ縺ｨ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯｼ大ｯｾｼ代↓蟇ｾ蠢懊＠縺ｾ縺吶 +萓九→縺励※縲 `foo.js` 縺ｯ縲∝酔縺倥ョ繧｣繝ｬ繧ｯ繝医Μ縺ｫ縺ゅｋ `circle.js` 繧偵Ο繝ｼ繝峨＠縺ｦ縺縺ｾ縺吶 + +`foo.js` 縺ｮ蜀螳ｹ: var circle = require('./circle'); console.log( 'The area of a circle of radius 4 is ' + circle.area(4)); + +`circle.js` 縺ｮ蜀螳ｹ: var PI = 3.14; @@ -37,6 +63,7 @@ The contents of `circle.js`: return 2 * PI * r; }; + +`circle.js` 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ `area()` 縺ｨ `circumference()` 繧偵お繧ｯ繧ｹ繝昴ｼ繝医＠縺ｦ縺縺ｾ縺吶 +繧ｨ繧ｯ繧ｹ繝昴ｼ繝医＆繧後◆繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ縲 `exports` 縺ｨ縺縺迚ｹ蛻･縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蜉縺医ｉ繧後∪縺 +(`exports` 縺ｮ莉｣繧上ｊ縺ｫ `this` 繧剃ｽｿ縺縺薙→繧ょｺ譚･縺ｾ縺)縲 +繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繝ｭ繝ｼ繧ｫ繝ｫ螟画焚縺ｯ繝励Λ繧､繝吶ｼ繝医〒縺吶 +縺薙ｮ萓九ｮ蝣ｴ蜷医∝､画焚 `PI` 縺ｯ `circle.js` 縺ｮ繝励Λ繧､繝吶ｼ繝亥､画焚縺ｧ縺吶 +髢｢謨ｰ `puts()` 縺ｯ 繝薙Ν繝医う繝ｳ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｧ縺ゅｋ `'sys'` 縺ｮ迚ｩ縺ｧ縺吶 +繝励Ξ繝輔ぅ繝繧ｯ繧ｹ `'./'` 縺ｮ縺ｪ縺繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ繝薙Ν繝医う繝ｳ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｧ縺吶りｩｳ邏ｰ縺ｯ莉･髯阪〒隱ｬ譏弱＠縺ｾ縺吶 ### Module Resolving + +繝励Ξ繝輔ぅ繝繧ｯ繧ｹ `'./'` 縺御ｻ倥¢繧峨ｌ縺溘Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ `require()` 繧貞他縺ｳ蜃ｺ縺励◆繝｢繧ｸ繝･繝ｼ繝ｫ縺九ｉ縺ｮ逶ｸ蟇ｾ繝代せ縺ｨ縺ｪ繧翫∪縺吶 +縺､縺ｾ繧 `circle.js` 縺ｯ `require('./circle')` 縺瑚ｦ九▽縺代ｉ繧後ｋ繧医≧縺ｫ `foo.js` 縺ｨ蜷後§繝繧｣繝ｬ繧ｯ繝医Μ縺ｫ縺ゅｋ蠢隕√′譛峨ｊ縺ｾ縺吶 + +蜈磯ｭ縺ｮ `'./'` 辟｡縺励〒縲∽ｾ九∴縺ｰ `require('assert')` 縺ｮ讒倥↓繝｢繧ｸ繝･繝ｼ繝ｫ繧呈欠螳壹＠縺溷ｴ蜷医 +繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ `require.paths` 縺ｮ驟榊怜縺ｮ蝣ｴ謇繧定ｵｷ轤ｹ縺ｫ讀懃ｴ｢縺輔ｌ縺ｾ縺吶 +遘√ｮ繧ｷ繧ｹ繝繝縺ｧ縺ｯ縲 `require.paths` 縺ｯ縺薙ｮ讒倥↓縺ｪ縺｣縺ｦ縺縺ｾ縺: `[ '/home/ryan/.node_modules' ]` + +縺薙ｌ縺ｫ繧医▲縺ｦ縲〜require('foo')` 縺悟他縺ｰ繧後ｋ縺ｨ Node 縺ｯ莉･荳九ｮ鬆縺ｧ繝｢繧ｸ繝･繝ｼ繝ｫ繧呈､懃ｴ｢縺励∪縺 * 1: `/home/ryan/.node_modules/foo` * 2: `/home/ryan/.node_modules/foo.js` @@ -65,10 +112,17 @@ That is, when `require('foo')` is called Node looks for: * 4: `/home/ryan/.node_modules/foo/index.js` * 5: `/home/ryan/.node_modules/foo/index.node` + +繝輔ぃ繧､繝ｫ縺瑚ｦ九▽縺九ｋ縺ｨ縲√◎縺ｮ譎らせ縺ｧ讀懃ｴ｢縺ｯ邨ゆｺ縺励∪縺吶 +繝輔ぃ繧､繝ｫ蜷阪′ `'.node'` 縺ｧ邨ゅｏ繧九ヵ繧｡繧､繝ｫ縺ｯ縲√ヰ繧､繝翫Μ蠖｢蠑上ｮ繧｢繝峨が繝ｳ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｧ縺吶 +隧ｳ邏ｰ縺ｯ縲後い繝峨が繝ｳ縲阪ｒ蜿らｧ縺励※縺上□縺輔＞縲 +`'index.js'` 縺ｯ縲√ョ繧｣繝ｬ繧ｯ繝医Μ繧偵Δ繧ｸ繝･繝ｼ繝ｫ縺ｨ縺励※荳縺､縺ｫ縺ｾ縺ｨ繧√ｋ縺薙→繧貞庄閭ｽ縺ｫ縺励∪縺吶 + +`require.paths` 縺ｯ縲驟榊励↓譁ｰ縺励＞繝代せ繧貞刈縺医ｋ縺九〜NODE_PATH` 迺ｰ蠅螟画焚縺ｨ蜈ｱ縺ｫ襍ｷ蜍輔☆繧九％縺ｨ縺ｧ螟画峩縺吶ｋ縺薙→縺悟ｺ譚･縺ｾ縺 +(縺薙ｮ蝣ｴ蜷医ｯ縲√さ繝ｭ繝ｳ縺ｧ蛹ｺ蛻繧峨ｌ縺溘ヱ繧ｹ縺ｮ繝ｪ繧ｹ繝医ｒ貂｡縺吝ｿ隕√′縺ゅｊ縺ｾ縺)縲 +蜉縺医※縲］ode 縺ｯ `node_modules` 縺ｨ蜻ｼ縺ｰ繧後ｋ繝繧｣繝ｬ繧ｯ繝医Μ繧 +(繝｢繧ｸ繝･繝ｼ繝ｫ縺 `require` 縺ｧ蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺)縲∫樟蝨ｨ縺ｮ繝繧｣繝ｬ繧ｯ繝医Μ縺九ｉ繝代ャ繧ｱ繝ｼ繧ｸ繝繝ｪ繝ｼ縺ｮ繝ｫ繝ｼ繝医∪縺ｧ縲 +荳贋ｽ阪↓蜷代°縺｣縺ｦ讀懃ｴ｢縺励∪縺吶 +縺薙ｮ讖溯ｽ縺ｯ縲∫焚縺ｪ縺｣縺溽腸蠅縺ｮ縺溘ａ縺ｫ逡ｰ縺ｪ縺｣縺溘ヰ繝ｼ繧ｸ繝ｧ繝ｳ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ縺縺薙→繧貞ｮｹ譏薙↓縺励∪縺吶 +髢狗匱迺ｰ蠅縺ｨ繝励Ο繝繧ｯ繧ｷ繝ｧ繝ｳ迺ｰ蠅縺ｧ逡ｰ縺ｪ縺｣縺溘ヰ繝ｼ繧ｸ繝ｧ繝ｳ縺ｮ `foo` 繝｢繧ｸ繝･繝ｼ繝ｫ: +`projects/x/development/node_modules/foo` 縺ｨ `projects/x/production/node_modules/foo` +繧剃ｽｿ縺迥ｶ豕√ｒ諠ｳ蜒上＠縺ｦ縺上□縺輔＞縲 + + + +`require('foo')` 縺ｮ 2 蠎ｦ逶ｮ縺ｮ蜻ｼ縺ｳ蜃ｺ縺励〒縺ｯ縲√ョ繧｣繧ｹ繧ｯ縺九ｉ蜀榊ｺｦ隱ｭ縺ｿ霎ｼ繧縺薙→縺ｯ縺励∪縺帙ｓ縲 +譌｢縺ｫ繝ｭ繝ｼ繝画ｸ医∩縺九ｒ隱ｿ縺ｹ繧九◆繧√↓ `require.cache` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繝√ぉ繝繧ｯ縺励∪縺吶 + +`require()` 縺悟他縺ｳ蜃ｺ縺輔ｌ繧九→縲∵ｭ｣遒ｺ縺ｪ繝輔ぃ繧､繝ｫ蜷阪ｒ蠕励ｋ縺溘ａ縺ｫ +`require.resolve()` 髢｢謨ｰ縺御ｽｿ繧上ｌ縺ｾ縺吶 From dd9b254381d1c0542b094d598fe70f2678cbc4a1 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:09:38 +0900 Subject: [PATCH 17/40] translated net --- doc/api/net.markdown | 245 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 244 insertions(+), 1 deletion(-) diff --git a/doc/api/net.markdown b/doc/api/net.markdown index 24d1e43edbdf..da55da7722b2 100644 --- a/doc/api/net.markdown +++ b/doc/api/net.markdown @@ -1,21 +1,39 @@ ## net + +`net` 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ髱槫酔譛溘↑繝阪ャ繝医Ρ繝ｼ繧ｯ縺ｮ繝ｩ繝繝代ｼ繧呈署萓帙＠縺ｾ縺吶 +縺昴ｌ縺ｯ繧ｵ繝ｼ繝舌→繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ荳｡譁ｹ (繧ｹ繝医Μ繝ｼ繝縺ｨ蜻ｼ縺ｰ繧後∪縺) 繧剃ｽ懈舌☆繧九◆繧√ｮ譁ｹ豕輔ｒ蜷ｫ縺ｿ縺ｾ縺吶 +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ`require("net");`縺ｫ繧医▲縺ｦ蜿悶ｊ霎ｼ繧縺薙→縺後〒縺阪∪縺吶 ### net.createServer(connectionListener) + +譁ｰ縺励＞ TCP 繧ｵ繝ｼ繝舌ｒ菴懈舌＠縺ｾ縺吶 +`connectionListener` 蠑墓焚縺ｯ `'connection'` +繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ縺ｨ縺励※閾ｪ蜍慕噪縺ｫ蜉縺医ｉ繧後∪縺吶 ### net.createConnection(arguments...) + +譁ｰ縺励＞繧ｹ繝医Μ繝ｼ繝繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ讒狗ｯ峨＠縲∽ｸ弱∴繧峨ｌ縺溘Ο繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺ｸ縺ｮ繧ｹ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励∪縺吶 +繧ｹ繝医Μ繝ｼ繝縺檎｢ｺ遶九＆繧後ｋ縺ｨ縲〜'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 + +縺薙ｮ繝｡繧ｽ繝繝峨ｮ蠑墓焚縺ｯ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ遞ｮ鬘槭↓繧医▲縺ｦ螟峨ｏ繧翫∪縺吶 + +* `net.createConnection(port, [host])` + + `host` 荳翫ｮ `port` 縺ｫ蟇ｾ縺吶ｋ TCP 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧剃ｽ懈舌＠縺ｾ縺吶 + `host` 縺檎怐逡･縺輔ｌ繧九→ `localhost` 縺御ｻｮ螳壹＆繧後∪縺吶 + +* `net.createConnection(path)` + + `path` 縺ｫ蟇ｾ縺吶ｋ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｒ菴懈舌＠縺ｾ縺吶 --- ### net.Server + +縺薙ｮ繧ｯ繝ｩ繧ｹ縺ｯ TCP 縺ｾ縺溘ｯ UNIX 繝峨Γ繧､繝ｳ縺ｮ繧ｵ繝ｼ繝舌ｒ菴懈舌☆繧九◆繧√↓菴ｿ繧上ｌ縺ｾ縺吶 + +8124 逡ｪ縺ｮ繝昴ｼ繝医∈縺ｮ謗･邯壹ｒ蠕縺｡蜿励¢繧九お繧ｳ繝ｼ繧ｵ繝ｼ繝舌ｮ萓: var net = require('net'); var server = net.createServer(function (stream) { @@ -50,49 +83,88 @@ on port 8124: }); server.listen(8124, 'localhost'); + +`'/tmp/echo.sock'` 縺ｸ縺ｮ繧ｽ繧ｱ繝繝医ｒ蠕縺｡蜿励¢繧九↓縺ｯ縲∵怙蠕後ｮ陦後ｒ縺薙ｮ繧医≧縺ｫ螟画峩縺励∪縺吶 server.listen('/tmp/echo.sock'); + +縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: #### server.listen(port, [host], [callback]) + +謖螳壹＆繧後◆ `port` 縺ｨ `host` 縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ蜿励¢蜈･繧後ｒ髢句ｧ九＠縺ｾ縺吶 +`host` 縺檎怐逡･縺輔ｌ繧九→縲√し繝ｼ繝舌ｯ縺ｩ繧薙↑ IPv4 繧｢繝峨Ξ繧ｹ縺ｸ縺ｮ謗･邯壹ｂ蜿励¢蜈･繧後∪縺 +(`INADDR_ANY`)縲 + +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶よ怙蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 #### server.listen(path, [callback]) + +荳弱∴繧峨ｌ縺 `path` 縺ｸ縺ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞ｾ縺｡蜿励¢繧九☆繧 UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｮ繧ｵ繝ｼ繝舌ｒ髢句ｧ九＠縺ｾ縺吶 + +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶 +譛蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 #### server.listenFD(fd) + +荳弱∴繧峨ｌ縺溘ヵ繧｡繧､繝ｫ險倩ｿｰ蟄蝉ｸ翫ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞ｾ縺｡蜿励¢繧九し繝ｼ繝舌ｒ髢句ｧ九＠縺ｾ縺吶 + +縺薙ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｯ譌｢縺ｫ `bind(2)` 縺翫ｈ縺ｳ +`listen(2)` 繧ｷ繧ｹ繝繝繧ｳ繝ｼ繝ｫ縺悟他縺ｳ蜃ｺ縺輔ｌ縺ｦ縺縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 #### server.close() + +繧ｵ繝ｼ繝舌′譁ｰ縺励＞繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺台ｻ倥¢繧九ｮ繧堤ｵゆｺ縺励∪縺吶 +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縲√し繝ｼ繝舌ｯ譛邨ら噪縺ｫ `'close'` 繧､繝吶Φ繝医ｒ逕滓舌＠縺滓凾縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺ｾ縺吶 #### server.address() + +繧ｪ繝壹Ξ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺ｫ繧医▲縺ｦ繧ｵ繝ｼ繝舌↓繝舌う繝ｳ繝峨＆繧後◆繧｢繝峨Ξ繧ｹ繧定ｿ斐＠縺ｾ縺吶 +OS縺ｫ繧医▲縺ｦ蜑ｲ繧雁ｽ薙※繧峨ｌ縺溘い繝峨Ξ繧ｹ縺梧ｸ｡縺輔ｌ縺滓凾縺ｫ縲√←縺ｮ繝昴ｼ繝医↓蜑ｲ繧雁ｽ薙※繧峨ｌ縺溘ｂ縺ｮ縺九ｒ隱ｿ縺ｹ繧九ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 + +萓: var server = net.createServer(function (socket) { socket.end("goodbye\n"); @@ -107,178 +179,318 @@ Example: #### server.maxConnections + +繧ｵ繝ｼ繝舌ｮ謗･邯壽焚縺悟､ｧ縺阪￥縺ｪ縺｣縺滓凾縺ｫ謗･邯壹ｒ諡貞凄縺吶ｋ縺溘ａ縺ｫ縺薙ｮ繝励Ο繝代ユ繧｣繧定ｨｭ螳壹＠縺ｾ縺吶 #### server.connections + +縺薙ｮ繧ｵ繝ｼ繝蝉ｸ翫ｮ荳ｦ陦後さ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ謨ｰ縺ｧ縺吶 #### Event: 'connection' `function (stream) {}` + +譁ｰ縺励＞繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺御ｽ懈舌＆繧後ｋ縺ｨ逕滓舌＆繧後∪縺吶 +`stream` 縺ｯ `net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 #### Event: 'close' `function () {}` + +繧ｵ繝ｼ繝舌′繧ｯ繝ｭ繝ｼ繧ｺ縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 --- ### net.Stream + +縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ TCP 縺ｾ縺溘ｯ UNIX 繝峨Γ繧､繝ｳ縺ｮ繧ｽ繧ｱ繝繝医ｒ謚ｽ雎｡蛹悶＠縺溘ｂ縺ｮ縺ｧ縺吶 +`net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ蜿梧婿蜷代ｮ繧ｹ繝医Μ繝ｼ繝繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧貞ｮ溯｣縺励∪縺吶 +縺昴ｌ繧峨ｯ繝ｦ繝ｼ繧ｶ縺ｫ繧医▲縺ｦ (`connect()` 縺ｫ繧医▲縺ｦ) 菴懈舌＆繧後※繧ｯ繝ｩ繧､繧｢繝ｳ繝医→縺励※菴ｿ繧上ｌ繧九°縲 +Node 縺ｫ繧医▲縺ｦ菴懈舌＆繧後※繧ｵ繝ｼ繝舌ｮ `'connection'` 繧､繝吶Φ繝医ｒ騾壹§縺ｦ繝ｦ繝ｼ繧ｶ縺ｫ貂｡縺輔ｌ縺ｾ縺吶 + +`net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ EventEmitter 縺ｧ縺: #### stream.connect(port, [host]) #### stream.connect(path) + +荳弱∴繧峨ｌ縺溘せ繝医Μ繝ｼ繝縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧偵が繝ｼ繝励Φ縺励∪縺吶 +`port` 縺ｨ `host` 縺御ｸ弱∴繧峨ｌ縺溷ｴ蜷医 +繧ｹ繝医Μ繝ｼ繝縺ｯ TCP 繧ｹ繝医Μ繝ｼ繝縺ｨ縺励※繧ｪ繝ｼ繝励Φ縺輔ｌ縺ｾ縺吶 +`host` 縺檎怐逡･縺輔ｌ縺溷ｴ蜷医ｯ `localhost` 縺御ｻｮ螳壹＆繧後∪縺吶 +`path` 縺御ｸ弱∴繧峨ｌ縺溷ｴ蜷医ｯ縲 +繧ｹ繝医Μ繝ｼ繝縺ｯ縺昴ｮ繝代せ縺ｸ縺ｮ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医→縺励※繧ｪ繝ｼ繝励Φ縺輔ｌ縺ｾ縺吶 + + +騾壼ｸｸ縺薙ｮ繝｡繧ｽ繝繝峨ｯ蠢隕√↑縺上〜net.createConnection` 縺ｧ繧ｹ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励∪縺吶 +縺薙ｌ繧剃ｽｿ縺縺ｮ縺ｯ縲√き繧ｹ繧ｿ繝槭う繧ｺ縺輔ｌ縺溘せ繝医Μ繝ｼ繝繧貞ｮ溯｣縺励※縺繧句ｴ蜷医ｄ縲 +繧ｹ繝医Μ繝ｼ繝縺後け繝ｭ繝ｼ繧ｺ縺輔ｌ縺溷ｾ後↓繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞榊茜逕ｨ縺励※蛻･縺ｮ繧ｵ繝ｼ繝舌↓謗･邯壹☆繧句ｴ蜷医□縺代〒縺吶 + +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶ゅせ繝医Μ繝ｼ繝縺檎｢ｺ遶九＆繧後ｋ縺ｨ `'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 +謗･邯壹〒蝠城｡後′縺ゅ▲縺溷ｴ蜷医ｯ `'connect'` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後★縲 +萓句､悶→縺ｨ繧ゅ↓ `'error'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 #### stream.setEncoding(encoding=null) + +蜿嶺ｿ｡縺励◆繝繝ｼ繧ｿ縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧定ｨｭ螳壹＠縺ｾ縺 (`'ascii'`縲〜'utf8'`縲 +縺ゅｋ縺縺ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺)縲 #### stream.setSecure([credentials]) + +遘伜ｯ骰ｵ縺ｨ繧ｵ繝ｼ繝占ｨｼ譏取嶌繧呈欠螳壹＠縺滓囓蜿ｷ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ隱崎ｨｼ諠蝣ｱ縺ｧ縲 +繧ｹ繝医Μ繝ｼ繝縺ｫ蟇ｾ縺励※ SSL 繧ｵ繝昴ｼ繝医ｒ譛牙柑縺ｫ縺励∪縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｧ隱崎ｨｼ螻縺ｧ險ｼ譏弱＆繧後◆逶ｸ謇句ｴ縺ｮ隱崎ｨｼ繧剃ｽｿ縺縺薙→繧ゅ〒縺阪∪縺吶 + +隱崎ｨｼ諠蝣ｱ縺御ｸ縺､莉･荳翫ｮ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌繧呈戟縺｣縺ｦ縺繧句ｴ蜷医 +繧ｹ繝医Μ繝ｼ繝縺ｯ SSL 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｫ縺翫¢繧九ワ繝ｳ繝峨す繧ｧ繝ｼ繧ｯ縺ｮ荳驛ｨ縺ｨ縺励※繧ｯ繝ｩ繧､繧｢繝ｳ繝郁ｨｼ譏取嶌繧帝√ｋ繧医≧逶ｸ謇九↓隕∵ｱゅ＠縺ｾ縺吶 +縺昴ｮ譛牙柑諤ｧ縺ｨ蜀螳ｹ縺ｯ縲〜verifyPeer()` 縺ｨ `getPeerCertificate()` 繧帝壹§縺ｦ繧｢繧ｯ繧ｻ繧ｹ縺ｧ縺阪∪縺吶 #### stream.verifyPeer() + +謖螳壹＆繧後◆縲√≠繧九＞縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺輔ｌ縺溯ｪ崎ｨｼ螻縺ｮ險ｼ譏取嶌縺ｫ縺翫＞縺ｦ縲 +逶ｸ謇九ｮ險ｼ譏取嶌縺ｮ螯･蠖捺ｧ縺ｫ蠢懊§縺ｦ true 縺ｾ縺溘ｯ false 繧定ｿ斐＠縺ｾ縺吶 #### stream.getPeerCertificate() + +逶ｸ謇九ｮ險ｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵'subject'縲'issuer'縲'valid_from' +縺昴＠縺ｦ 'valid_to' 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 #### stream.write(data, encoding='ascii') +繧ｹ繝医Μ繝ｼ繝縺ｫ繝繝ｼ繧ｿ繧帝∽ｿ｡縺励∪縺吶 +譁蟄怜励ｮ蝣ｴ蜷医∫ｬｬ 2 蠑墓焚縺ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧呈欠螳壹＠縺ｾ縺 ｼ UTF8 縺ｯ繧医ｊ驕縺縺溘ａ縲√ョ繝輔か繝ｫ繝医ｯ ASCII 縺ｧ縺吶 + +繝繝ｼ繧ｿ蜈ｨ菴薙ｮ繧ｫ繝ｼ繝阪Ν繝舌ャ繝輔ぃ縺ｸ縺ｮ繝輔Λ繝繧ｷ繝･縺梧仙粥縺吶ｋ縺ｨ `true` 繧定ｿ斐＠縺ｾ縺吶 +繝繝ｼ繧ｿ蜈ｨ菴薙∪縺溘ｯ荳驛ｨ縺後Θ繝ｼ繧ｶ繝｡繝｢繝ｪ蜀縺ｮ繧ｭ繝･繝ｼ縺ｫ蜈･繧後ｉ繧後◆蝣ｴ蜷医ｯ `false` 繧定ｿ斐＠縺ｾ縺吶 +蜀阪ｳ繝舌ャ繝輔ぃ縺檎ｩｺ縺縺溷ｴ蜷医ｯ `'drain'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 #### stream.end([data], [encoding]) + +繧ｹ繝医Μ繝ｼ繝繧偵ワ繝ｼ繝輔け繝ｭ繝ｼ繧ｺ縺励∪縺吶ゆｾ九∴縺ｰ FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励∪縺吶 +繧ｵ繝ｼ繝舌′繝繝ｼ繧ｿ繧帝√ｊ邯壹¢縺ｦ縺上ｋ縺薙→縺後≠繧雁ｾ励∪縺吶 +縺薙ｮ繝｡繧ｽ繝繝峨ｒ蜻ｼ縺ｳ蜃ｺ縺励◆蠕後ｮ `readyState` 縺ｯ `'readOnly'` 縺ｫ縺ｪ繧翫∪縺吶 + +`data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医ｯ縲 +`stream.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `stream.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 #### stream.destroy() + +縺薙ｮ繧ｹ繝医Μ繝ｼ繝荳翫〒縺ｩ繧薙↑ I/O 繧りｵｷ縺薙ｉ縺ｪ縺縺薙→繧剃ｿ晁ｨｼ縺励∪縺吶 +(繝代ｼ繧ｹ繧ｨ繝ｩ繝ｼ縺ｪ縺ｩ縺ｮ) 繧ｨ繝ｩ繝ｼ縺ｮ蝣ｴ蜷医↓縺縺大ｿ隕√〒縺吶 #### stream.pause() + +繝繝ｼ繧ｿ縺ｮ隱ｭ縺ｿ霎ｼ縺ｿ繧剃ｸｭ譁ｭ縺励∪縺吶ゅ▽縺ｾ繧翫〜'data'` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後∪縺帙ｓ縲 +繧｢繝繝励Ο繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶◆繧√↓萓ｿ蛻ｩ縺ｧ縺吶 #### stream.resume() + +`pause()` 繧貞他縺ｳ蜃ｺ縺励◆蠕後〒隱ｭ縺ｿ霎ｼ縺ｿ繧貞埼幕縺励∪縺吶 #### stream.setTimeout(timeout) + + +繧｢繧､繝峨Ν繧ｿ繧､繝繧｢繧ｦ繝医′蠑輔″襍ｷ縺薙＆繧後ｋ縺ｨ縲√せ繝医Μ繝ｼ繝縺ｯ `'timeout'` 繧､繝吶Φ繝医ｒ蜿嶺ｿ｡縺励∪縺吶′縲 +繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ蛻譁ｭ縺輔ｌ縺ｾ縺帙ｓ縲 +繝ｦ繝ｼ繧ｶ縺ｯ謇句虚縺ｧ `end()` 縺ｾ縺溘ｯ `destroy()` 繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺吶 + +`timeout` 縺 0 縺ｮ蝣ｴ蜷医√い繧､繝峨Ν繧ｿ繧､繝繧｢繧ｦ繝医ｯ辟｡蜉ｹ縺ｫ縺輔ｌ縺ｾ縺吶 #### stream.setNoDelay(noDelay=true) + +Nagle 繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝繧堤┌蜉ｹ縺ｫ縺励∪縺吶 +繝繝輔か繝ｫ繝医〒縺ｯ TCP 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ Nagle 繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝繧剃ｽｿ逕ｨ縺励√ョ繝ｼ繧ｿ繧帝∽ｿ｡縺吶ｋ蜑阪↓繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺励∪縺吶 +`noDelay` 縺ｫ險ｭ螳壹☆繧九→縲√ョ繝ｼ繧ｿ縺ｯ `stream.write()` 繧貞他縺ｳ蜃ｺ縺吝ｺｦ縺ｫ蜊ｳ蠎ｧ縺ｫ騾∽ｿ｡縺輔ｌ縺ｾ縺吶 #### stream.setKeepAlive(enable=false, [initialDelay]) + +繧ｭ繝ｼ繝励い繝ｩ繧､繝匁ｩ溯ｽ繧呈怏蜉ｹ/辟｡蜉ｹ縺ｫ縺励∪縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｧ譛蛻昴ｮ keepalive probe 縺後い繧､繝峨Ν繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺輔ｌ繧九∪縺ｧ縺ｮ蛻晄悄驕蟒ｶ繧定ｨｭ螳壹＠縺ｾ縺吶 +`initialDelay` (繝溘Μ遘) 縺瑚ｨｭ螳壹＆繧後ｋ縺ｨ縲 +譛蠕後↓繝繝ｼ繧ｿ繝代こ繝繝医ｒ蜿嶺ｿ｡縺励※縺九ｉ譛蛻昴ｮ keepalive probe 縺ｾ縺ｧ縺ｮ驕蟒ｶ縺瑚ｨｭ螳壹＆繧後∪縺吶 +蛻晄悄驕蟒ｶ縺ｫ 0 縺瑚ｨｭ螳壹＆繧後ｋ縺ｨ縲√ョ繝輔か繝ｫ繝郁ｨｭ螳壹°繧牙､繧貞､画峩縺輔ｌ縺ｪ縺繧医≧縺ｫ縺励∪縺吶 #### stream.remoteAddress + +繝ｪ繝｢繝ｼ繝医ｮ IP 繧｢繝峨Ξ繧ｹ繧定｡ｨ迴ｾ縺吶ｋ譁蟄怜励〒縺吶 +萓九∴縺ｰ縲〜'74.125.127.100'` 縺ゅｋ縺縺ｯ `'2001:4860:a005::68'`縲 + +縺薙ｮ繝｡繝ｳ繝舌ｯ繧ｵ繝ｼ繝舌し繧､繝峨ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｧ縺ｮ縺ｿ荳弱∴繧峨ｌ縺ｾ縺吶 #### stream.readyState + +`'closed'`縲〜'open'`縲〜'opening'`縲〜'readOnly'`縲 +縺ゅｋ縺縺ｯ `'writeOnly'` 縺ｮ縺縺壹ｌ縺九〒縺吶 #### Event: 'connect' `function () { }` + +繧ｹ繝医Μ繝ｼ繝繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ遒ｺ遶九′謌仙粥縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 +`connect()` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 #### Event: 'secure' `function () { }` + +繧ｹ繝医Μ繝ｼ繝繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｫ縺翫＞縺ｦ縲∵磁邯夂嶌謇九→縺ｮ SSL 繝上Φ繝峨す繧ｧ繝ｼ繧ｯ縺ｮ遒ｺ遶九′謌仙粥縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 #### Event: 'data' `function (data) { }` + +繝繝ｼ繧ｿ繧貞女菫｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 +`data` 蠑墓焚縺ｯ `Buffer` 縺ｾ縺溘ｯ `String` 縺ｧ縺吶 +繝繝ｼ繧ｿ縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ `stream.setEncoding()` 縺ｧ險ｭ螳壹＆繧後∪縺吶 +(繧医ｊ隧ｳ縺励＞諠蝣ｱ縺ｯ `Readable Stream` 繧貞盾辣ｧ縺励※縺上□縺輔＞)縲 #### Event: 'end' `function () { }` + +繧ｹ繝医Μ繝ｼ繝縺ｮ逶ｸ謇句ｴ縺 FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 + +繝繝輔か繝ｫ繝 (`allowHalfOpen == false`) 縺ｧ縺ｯ縲 +菫晉蕗縺輔ｌ縺ｦ縺縺滓嶌縺崎ｾｼ縺ｿ繧ｭ繝･繝ｼ縺悟ｺ蜉帙＆繧後ｋ縺ｨ繧ｹ繝医Μ繝ｼ繝縺ｯ繝輔ぃ繧､繝ｫ隴伜挨蟄舌ｒ遐ｴ譽縺励∪縺吶 +縺励°縺励〜allowHalfOpen == true` 縺瑚ｨｭ螳壹＆繧後※縺繧九→縲 +繝ｦ繝ｼ繧ｶ縺後ョ繝ｼ繧ｿ繧呈嶌縺崎ｾｼ繧√ｋ繧医≧縺ｫ縺励※縺翫￥縺溘ａ縺ｫ縲√せ繝医Μ繝ｼ繝縺ｯ閾ｪ蜍慕噪縺ｫ `end()` 繧貞他縺ｳ蜃ｺ縺輔↑縺縺ｮ縺ｧ縲 +繝ｦ繝ｼ繧ｶ縺 `end()` 繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺吶 +`allowHalfOpen == true` 縺ｮ繧ｱ繝ｼ繧ｹ縺ｧ縺ｯ縲 +`'end'` 縺檎函謌舌＆繧後◆蠕後ｮ `readyState` 縺ｯ `'writeOnly'` 縺ｨ縺ｪ繧翫∪縺吶 #### Event: 'timeout' `function () { }` + +繧ｹ繝医Μ繝ｼ繝縺後ち繧､繝繧｢繧ｦ繝医＠縺ｦ髱槭い繧ｯ繝繧｣繝悶↓縺ｪ縺｣縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 +縺薙ｌ縺ｯ繧ｹ繝医Μ繝ｼ繝縺後い繧､繝峨Ν縺ｫ縺ｪ縺｣縺溘％縺ｨ繧帝夂衍縺吶ｋ縺縺代〒縺吶 +蛻ｩ逕ｨ閠縺ｯ謇句虚縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧偵け繝ｭ繝ｼ繧ｺ縺吶ｋ蠢隕√′縺ゅｊ縺ｾ縺吶 See also: `stream.setTimeout()` @@ -302,22 +527,32 @@ See also: `stream.setTimeout()` `function () { }` + +譖ｸ縺崎ｾｼ縺ｿ繝舌ャ繝輔ぃ縺檎ｩｺ縺ｫ縺ｪ縺｣縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶ゅい繝繝励Ο繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶◆繧√↓菴ｿ縺縺薙→縺後〒縺阪∪縺吶 #### Event: 'error' `function (exception) { }` + +繧ｨ繝ｩ繝ｼ縺檎匱逕溘＠縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶Ａ'close'` 繧､繝吶Φ繝医ｯ縺薙ｮ繧､繝吶Φ繝医ｮ蠕後↓逶ｴ謗･蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 #### Event: 'close' `function (had_error) { }` + +繧ｹ繝医Μ繝ｼ繝縺悟ｮ悟ｨ縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 +蠑墓焚 `had_error` 縺ｯ boolean 縺ｧ縲√せ繝医Μ繝ｼ繝縺瑚ｻ｢騾√お繝ｩ繝ｼ縺ｧ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺溘ｮ縺九←縺縺九ｒ遉ｺ縺励∪縺吶 --- @@ -325,16 +560,24 @@ error. #### net.isIP(input) + #### net.isIPv4(input) + +input 縺 繝舌ｼ繧ｸ繝ｧ繝ｳ 4 縺ｮ IP 繧｢繝峨Ξ繧ｹ縺ｪ繧 true縲√◎縺縺ｧ縺ｪ縺代ｌ縺ｰ false 繧定ｿ斐＠縺ｾ縺吶 #### net.isIPv6(input) + +input 縺 繝舌ｼ繧ｸ繝ｧ繝ｳ 6 縺ｮ IP 繧｢繝峨Ξ繧ｹ縺ｪ繧 true縲√◎縺縺ｧ縺ｪ縺代ｌ縺ｰ false 繧定ｿ斐＠縺ｾ縺吶 From 52a2cc660dac1786e03b3f129570b029c35bb340 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:15:28 +0900 Subject: [PATCH 18/40] translated path --- doc/api/path.markdown | 45 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/doc/api/path.markdown b/doc/api/path.markdown index bf6bf38490be..7383f5a2807b 100644 --- a/doc/api/path.markdown +++ b/doc/api/path.markdown @@ -1,13 +1,24 @@ ## Path + +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ繝輔ぃ繧､繝ｫ繝代せ繧呈桶縺繝ｦ繝ｼ繝繧｣繝ｪ繝繧｣繧貞性縺ｿ縺ｾ縺吶 +蛻ｩ逕ｨ縺吶ｋ縺ｫ縺ｯ`require('path')`繧貞他縺ｳ蜃ｺ縺励※縺上□縺輔＞縲 +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ莉･荳九ｮ繝｡繧ｽ繝繝峨ｒ謠蝉ｾ帙＠縺ｾ縺吶 ### path.join([path1], [path2], [...]) + +蜈ｨ縺ｦ縺ｮ蠑墓焚繧剃ｸ縺､縺ｫ邨仙粋縺励∫ｵ先棡縺ｨ縺励※蠕励ｉ繧後ｋ繝代せ繧呈ｱｺ螳壹＠縺ｾ縺吶 + +萓: node> require('path').join( ... '/foo', 'bar', 'baz/asdf', 'quux', '..') @@ -15,9 +26,15 @@ Example: ### path.normalizeArray(arr) + +繝代せ縺ｮ隕∫ｴ縺ｮ驟榊励ｒ豁｣隕丞喧縺励∪縺吶Ａ'..'` 縺ｨ `'.'` 縺ｮ隕∫ｴ縺ｫ縺ｯ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 + +萓: path.normalizeArray(['', 'foo', 'bar', 'baz', 'asdf', 'quux', '..']) @@ -26,9 +43,15 @@ Example: ### path.normalize(p) + +譁蟄怜励↓繧医ｋ繝代せ繧呈ｭ｣隕丞喧縺励∪縺吶Ａ'..'` 縺ｨ `'.'` 縺ｮ隕∫ｴ縺ｫ縺ｯ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 + +萓: path.normalize('/foo/bar/baz/asdf/quux/..') // returns @@ -36,9 +59,14 @@ Example: ### path.dirname(p) + +繝代せ縺ｫ蜷ｫ縺ｾ繧後ｋ繝繧｣繝ｬ繧ｯ繝医Μ蜷阪ｒ霑斐＠縺ｾ縺吶６nix縺ｮ `dirname` 繧ｳ繝槭Φ繝峨→蜷梧ｧ倥〒縺吶 + path.dirname('/foo/bar/baz/asdf/quux') // returns @@ -46,9 +74,15 @@ Example: ### path.basename(p, [ext]) + +繝代せ縺ｮ譛蠕後ｮ隕∫ｴ繧定ｿ斐＠縺ｾ縺吶６nix縺ｮ `basename` 繧ｳ繝槭Φ繝峨→蜷梧ｧ倥〒縺吶 + +萓: path.basename('/foo/bar/baz/asdf/quux.html') // returns @@ -60,9 +94,15 @@ Example: ### path.extname(p) + +繝代せ縺ｮ諡｡蠑ｵ蟄舌ｒ霑斐＠縺ｾ縺吶 +繝代せ縺ｮ譛蠕後ｮ隕∫ｴ縺ｫ縺､縺縺ｦ縲∵怙蠕後ｮ '.' 縺九ｉ蠕後↓縺ゅｋ譁蟄怜励′蟇ｾ雎｡縺ｫ縺ｪ繧翫∪縺吶 +譛蠕後ｮ隕∫ｴ縺ｫ '.' 縺悟性縺ｾ繧後※縺縺ｪ縺九▲縺溷ｴ蜷医√ｂ縺励￥縺ｯ '.' 縺梧怙蛻昴ｮ譁蟄励□縺｣縺溷ｴ蜷医ｯ縲∫ｩｺ縺ｮ譁蟄怜励ｒ霑斐＠縺ｾ縺吶 +萓: path.extname('index.html') // returns @@ -74,7 +114,12 @@ the first character, then it returns an empty string. Examples: ### path.exists(p, [callback]) + +荳弱∴繧峨ｌ縺溘ヱ繧ｹ縺悟ｭ伜惠縺吶ｋ縺九←縺縺区､懈渊縺励∪縺吶 +縺昴＠縺ｦ蠑墓焚縺ｮ `callback` 繧堤悄縺句⊃縺区､懈渊縺ｮ邨先棡縺ｨ縺ｨ繧ゅ↓蜻ｼ縺ｳ蜃ｺ縺励∪縺吶 +萓: path.exists('/etc/passwd', function (exists) { util.debug(exists ? "it's there" : "no passwd!"); From 0a3c4438c29b0896174955df77008386114b28fb Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:34:21 +0900 Subject: [PATCH 19/40] translated process --- doc/api/process.markdown | 151 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 150 insertions(+), 1 deletion(-) diff --git a/doc/api/process.markdown b/doc/api/process.markdown index 8e538d58ab77..f6f8d153a717 100644 --- a/doc/api/process.markdown +++ b/doc/api/process.markdown @@ -1,19 +1,32 @@ ## process + +`process` 縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縲√←縺薙°繧峨〒繧ゅい繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 +縺昴ｌ縺ｯ `EventEmitter` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 ### Event: 'exit' `function () {}` + +繝励Ο繧ｻ繧ｹ縺檎ｵゆｺ縺励ｈ縺縺ｨ縺励※縺繧区凾縺ｫ逕滓舌＆繧後∪縺吶 +縺薙ｌ縺ｯ (繝ｦ繝九ャ繝医ユ繧ｹ繝医ｮ繧医≧縺ｫ) 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ迥ｶ諷九ｒ荳螳壹ｮ譎る俣縺ｧ繝√ぉ繝繧ｯ縺吶ｋ縺ｮ縺ｫ驕ｩ縺励◆繝輔ャ繧ｯ縺ｨ縺ｪ繧翫∪縺吶 +繝｡繧､繝ｳ縺ｮ繧､繝吶Φ繝医Ν繝ｼ繝励ｯ 'exit' 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺檎ｵゆｺ縺吶ｋ縺ｨ繧ゅｯ繧蜍穂ｽ懊＠縺ｪ縺縺ｮ縺ｧ縲 +繧ｿ繧､繝槭ｼ縺ｯ繧ｹ繧ｱ繧ｸ繝･繝ｼ繝ｫ縺輔ｌ縺ｪ縺縺九ｂ縺励ｌ縺ｾ縺帙ｓ縲 + +`exit` 繧堤屮隕悶☆繧倶ｾ: process.on('exit', function () { process.nextTick(function () { @@ -26,11 +39,19 @@ Example of listening for `exit`: `function (err) { }` + +逋ｺ逕溘＠縺滉ｾ句､悶′繧､繝吶Φ繝医Ν繝ｼ繝励∪縺ｧ縺溘←繧顔捩縺縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 +繧ゅ＠縺薙ｮ萓句､悶↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ縺悟刈縺医ｉ繧後※縺繧後ｰ縲 +繝繝輔か繝ｫ繝医ｮ蜍穂ｽ (縺昴ｌ縺ｯ繧ｹ繧ｿ繝繧ｯ繝医Ξ繝ｼ繧ｹ繧偵励Μ繝ｳ繝医＠縺ｦ邨ゆｺ縺励∪縺) 縺ｯ襍ｷ縺薙ｊ縺ｾ縺帙ｓ縲 + +`uncaughtException` 繧堤屮隕悶☆繧倶ｾ: process.on('uncaughtException', function (err) { console.log('Caught exception: ' + err); @@ -44,20 +65,33 @@ Example of listening for `uncaughtException`: nonexistentFunc(); console.log('This will not run.'); + +`uncaughtException` 縺ｯ萓句､悶ｒ謇ｱ縺縺ｨ縺ｦ繧り穀蜑翫ｊ縺ｪ繝｡繧ｫ繝九ぜ繝縺ｧ縺ゅｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +繝励Ο繧ｰ繝ｩ繝縺ｮ荳ｭ縺ｧ try / catch 繧剃ｽｿ縺医ｰ繧ゅ▲縺ｨ繝励Ο繧ｰ繝ｩ繝縺ｮ豬√ｌ繧偵≧縺ｾ縺丞宛蠕｡縺ｧ縺阪ｋ縺ｧ縺励ｇ縺縲 +迚ｹ縺ｫ繧ｵ繝ｼ繝舌励Ο繧ｰ繝ｩ繝縺ｯ縺縺､縺ｾ縺ｧ繧ょｮ溯｡後＠邯壹¢繧九ｈ縺縺ｫ險ｭ險医＆繧後ｋ縺ｮ縺ｧ縲 +`uncaughtException` 縺ｯ譛臥寢縺ｧ螳牙ｨ縺ｪ繝｡繧ｫ繝九ぜ繝縺ｫ縺ｪ繧雁ｾ励∪縺吶 ### Signal Events `function () {}` + +繝励Ο繧ｻ繧ｹ縺後す繧ｰ繝翫Ν繧貞女菫｡縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 +SIGINT縲ヾIGUSR1縲√◎縺ｮ莉悶ｮ POSIX 讓呎ｺ悶す繧ｰ繝翫Ν蜷阪ｮ荳隕ｧ縺ｫ縺､縺縺ｦ 縺ｯ sigaction(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 + +`SIGINT`繧堤屮隕悶☆繧倶ｾ: var stdin = process.openStdin(); @@ -65,15 +99,24 @@ Example of listening for `SIGINT`: console.log('Got SIGINT. Press Control-D to exit.'); }); + +螟壹￥縺ｮ遶ｯ譛ｫ繝励Ο繧ｰ繝ｩ繝縺ｧ邁｡蜊倥↓ `SIGINT` 繧帝√ｋ譁ｹ豕輔ｯ `Control-C` 繧呈款縺吶％縺ｨ縺ｧ縺吶 ### process.stdout + +`stdout` 縺ｫ蟇ｾ縺吶ｋ `Writable Stream` 縺ｧ縺吶 + +萓: `console.log` 縺ｮ螳夂ｾｩ console.log = function (d) { process.stdout.write(d + '\n'); @@ -82,9 +125,15 @@ Example: the definition of `console.log` ### process.openStdin() + +讓呎ｺ門･蜉帙せ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励〜Readable Stream` 繧定ｿ斐＠縺ｾ縺吶 + +讓呎ｺ門･蜉帙ｒ繧ｪ繝ｼ繝励Φ縺励※莠後▽縺ｮ繧､繝吶Φ繝医ｒ逶｣隕悶☆繧倶ｾ: var stdin = process.openStdin(); @@ -101,16 +150,24 @@ Example of opening standard input and listening for both events: ### process.argv + +繧ｳ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚繧貞性繧驟榊励〒縺吶 +譛蛻昴ｮ隕∫ｴ縺ｯ 'node'縲2 逡ｪ逶ｮ縺ｮ隕∫ｴ縺ｯ JavaScript 繝輔ぃ繧､繝ｫ縺ｮ蜷榊燕縺ｫ縺ｪ繧翫∪縺吶 +縺昴ｮ蠕後ｮ隕∫ｴ縺ｯ繧ｳ繝槭Φ繝峨Λ繧､繝ｳ縺ｮ霑ｽ蜉縺ｮ蠑墓焚縺ｫ縺ｪ繧翫∪縺吶 // print process.argv process.argv.forEach(function (val, index, array) { console.log(index + ': ' + val); }); + +縺薙ｮ繧医≧縺ｫ蜃ｺ蜉帙＆繧後∪縺: $ node process-2.js one two=three four 0: node @@ -122,16 +179,26 @@ This will generate: ### process.execPath + +繝励Ο繧ｻ繧ｹ縺ｫ繧医▲縺ｦ髢句ｧ九＆繧後◆螳溯｡悟庄閭ｽ繝輔ぃ繧､繝ｫ縺ｮ邨ｶ蟇ｾ繝代せ縺ｧ縺吶 + +萓: /usr/local/bin/node ### process.chdir(directory) + +繝励Ο繧ｻ繧ｹ縺ｮ繧ｫ繝ｬ繝ｳ繝医Ρ繝ｼ繧ｭ繝ｳ繧ｰ繝繧｣繝ｬ繧ｯ繝医Μ繧貞､画峩縺励∪縺吶 +繧ゅ＠螟ｱ謨励＠縺溷ｴ蜷医ｯ萓句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 console.log('Starting directory: ' + process.cwd()); try { @@ -146,38 +213,63 @@ Changes the current working directory of the process or throws an exception if t ### process.cwd() + +繝励Ο繧ｻ繧ｹ縺ｮ繧ｫ繝ｬ繝ｳ繝医Ρ繝ｼ繧ｭ繝ｳ繧ｰ繝繧｣繝ｬ繧ｯ繝医Μ繧定ｿ斐＠縺ｾ縺吶 console.log('Current directory: ' + process.cwd()); ### process.env + +繝ｦ繝ｼ繧ｶ縺ｮ迺ｰ蠅繧貞性繧繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶Ｆnviron(7) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### process.exit(code=0) + +謖螳壹ｮ `code` 縺ｧ繝励Ο繧ｻ繧ｹ繧堤ｵゆｺ縺励∪縺吶 +繧ゅ＠逵∫払縺輔ｌ繧九→縲√梧仙粥縲阪ｒ遉ｺ縺吶さ繝ｼ繝 `0` 繧剃ｽｿ縺｣縺ｦ邨ゆｺ縺励∪縺吶 + +縲悟､ｱ謨励阪ｒ遉ｺ縺吶さ繝ｼ繝峨〒邨ゆｺ縺吶ｋ萓: process.exit(1); + +node 繧貞ｮ溯｡後＠縺溘す繧ｧ繝ｫ縺ｧ邨ゆｺ繧ｳ繝ｼ繝峨′ 1 縺ｧ縺ゅｋ縺薙→繧定ｦ九ｋ縺薙→縺後〒縺阪ｋ縺ｧ縺励ｇ縺縲 ### process.getgid() + +繝励Ο繧ｻ繧ｹ縺ｮ繧ｰ繝ｫ繝ｼ繝苓ｭ伜挨蟄舌ｒ蜿門ｾ励＠縺ｾ縺 (getgid(2) 蜿らｧ)縲 +縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ繧ｰ繝ｫ繝ｼ繝 ID 縺ｧ縲√げ繝ｫ繝ｼ繝怜錐縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 console.log('Current gid: ' + process.getgid()); ### process.setgid(id) + +繝励Ο繧ｻ繧ｹ縺ｮ繧ｰ繝ｫ繝ｼ繝苓ｭ伜挨蟄舌ｒ險ｭ螳壹＠縺ｾ縺 (setgid(2) 蜿らｧ)縲 +縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ ID 繧ゅげ繝ｫ繝ｼ繝怜錐縺ｮ譁蟄怜励ｮ縺ｩ縺｡繧峨ｂ蜿励¢蜈･繧後∪縺吶 +繧ゅ＠繧ｰ繝ｫ繝ｼ繝怜錐縺梧欠螳壹＆繧後ｋ縺ｨ縲∵焚蛟､縺ｫ繧医ｋ ID 縺瑚ｧ｣豎ｺ縺ｧ縺阪ｋ縺ｾ縺ｧ縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝悶Ο繝繧ｯ縺励∪縺吶 console.log('Current gid: ' + process.getgid()); try { @@ -191,14 +283,23 @@ Sets the group identity of the process. (See setgid(2).) This accepts either a ### process.getuid() + +繝励Ο繧ｻ繧ｹ縺ｮ繝ｦ繝ｼ繧ｶ隴伜挨蟄舌ｒ蜿門ｾ励＠縺ｾ縺 (getuid(2) 蜿らｧ)縲 +縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ繝ｦ繝ｼ繧ｶ ID 縺ｧ縲√Θ繝ｼ繧ｶ蜷阪〒縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 console.log('Current uid: ' + process.getuid()); ### process.setuid(id) + +繝励Ο繧ｻ繧ｹ縺ｮ繝ｦ繝ｼ繧ｶ隴伜挨蟄舌ｒ險ｭ螳壹＠縺ｾ縺 (setuid(2) 蜿らｧ)縲 +縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ ID 繧ゅΘ繝ｼ繧ｶ蜷阪ｮ譁蟄怜励ｮ縺ｩ縺｡繧峨ｂ蜿励¢蜈･繧後∪縺吶 +繧ゅ＠繝ｦ繝ｼ繧ｶ蜷阪′謖螳壹＆繧後ｋ縺ｨ縲∵焚蛟､縺ｫ繧医ｋ ID 縺瑚ｧ｣豎ｺ縺ｧ縺阪ｋ縺ｾ縺ｧ縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝悶Ο繝繧ｯ縺励∪縺吶 console.log('Current uid: ' + process.getuid()); try { @@ -212,29 +313,50 @@ Sets the user identity of the process. (See setuid(2).) This accepts either a n ### process.version + +`NODE_VERSION` 繧呈署遉ｺ縺吶ｋ繧ｳ繝ｳ繝代う繝ｫ貂医∩繝励Ο繝代ユ繧｣縺ｧ縺吶 console.log('Version: ' + process.version); ### process.installPrefix +<-- A compiled-in property that exposes `NODE_PREFIX`. +--> +`NODE_PREFIX` 繧呈署遉ｺ縺吶ｋ繧ｳ繝ｳ繝代う繝ｫ貂医∩繝励Ο繝代ユ繧｣縺ｧ縺吶 console.log('Prefix: ' + process.installPrefix); ### process.kill(pid, signal='SIGINT') + +繝励Ο繧ｻ繧ｹ縺ｫ繧ｷ繧ｰ繝翫Ν繧帝√ｊ縺ｾ縺吶 +`pid` 縺ｯ繝励Ο繧ｻ繧ｹ ID 縺ｧ `signal` 縺ｯ騾∽ｿ｡縺輔ｌ繧九す繧ｰ繝翫Ν繧呈枚蟄怜励〒險倩ｿｰ縺励◆繧ゅｮ縺ｧ縺吶 +繧ｷ繧ｰ繝翫Ν縺ｮ蜷榊燕縺ｯ 'SIGINT' 繧 'SIGUSR1' 縺ｮ繧医≧縺ｪ譁蟄怜励〒縺吶 +逵∫払縺吶ｋ縺ｨ縲√す繧ｰ繝翫Ν縺ｯ 'SIGINT' 縺ｨ縺ｪ繧翫∪縺吶 +隧ｳ邏ｰ縺ｯ kill(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 + + +縺薙ｮ髢｢謨ｰ縺ｮ蜷榊燕縺 `process.kill` 縺ｧ縺ゅｋ縺ｨ縺翫ｊ縲 +縺薙ｌ縺ｯ `kill` 繧ｷ繧ｹ繝繝繧ｳ繝ｼ繝ｫ縺ｮ繧医≧縺ｫ譛ｬ蠖薙↓繧ｷ繧ｰ繝翫Ν繧帝∽ｿ｡縺吶ｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +蟇ｾ雎｡縺ｮ繝励Ο繧ｻ繧ｹ繧呈ｮｺ縺吶□縺代〒縺ｪ縺上∽ｻ悶ｮ繧ｷ繧ｰ繝翫Ν繧る∽ｿ｡縺輔ｌ縺ｾ縺吶 + +閾ｪ霄ｫ縺ｫ繧ｷ繧ｰ繝翫Ν繧帝∽ｿ｡縺吶ｋ萓: process.on('SIGHUP', function () { console.log('Got SIGHUP signal.'); @@ -250,31 +372,45 @@ Example of sending a signal to yourself: ### process.pid + console.log('This process is pid ' + process.pid); ### process.title + +'ps' 縺ｧ縺ｩ縺ｮ繧医≧陦ｨ遉ｺ縺輔ｌ繧九°繧定ｨｭ螳壹☆繧九◆繧√ｮ getter/setter 縺ｧ縺吶 ### process.platform + +縺ｩ縺ｮ繝励Λ繝繝医ヵ繧ｩ繝ｼ繝縺ｧ蜍輔＞縺ｦ縺繧九°縺ｧ縺吶Ａ'linux2'`縲〜'darwin'`縲√↑縺ｩ縲 console.log('This platform is ' + process.platform); ### process.memoryUsage() + +Node 繝励Ο繧ｻ繧ｹ縺ｮ繝｡繝｢繝ｪ菴ｿ逕ｨ迥ｶ豕√ｒ險倩ｿｰ縺励◆繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 var util = require('util'); console.log(util.inspect(process.memoryUsage())); + +縺薙ｮ繧医≧縺ｫ逕滓舌＆繧後∪縺: { rss: 4935680 , vsize: 41893888 @@ -282,14 +418,22 @@ This will generate: , heapUsed: 650472 } + +`heapTotal` 縺ｨ `heapUsed` 縺ｯ V8 縺ｮ繝｡繝｢繝ｪ菴ｿ逕ｨ迥ｶ豕√ｒ蜿らｧ縺励∪縺吶 ### process.nextTick(callback) + +繧､繝吶Φ繝医Ν繝ｼ繝励ｮ谺｡莉･髯阪ｮ繝ｫ繝ｼ繝励〒繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧貞他縺ｳ蜃ｺ縺励∪縺吶 +縺薙ｌ縺ｯ `setTimeout(fn, 0)` 縺ｮ蜊倡ｴ斐↑繧ｨ繧､繝ｪ繧｢繧ｹ*縺ｧ縺ｯ縺ｪ縺*縲 +縺ｯ繧九°縺ｫ蜉ｹ邇逧縺ｧ縺吶 process.nextTick(function () { console.log('nextTick callback'); @@ -298,9 +442,14 @@ efficient. ### process.umask([mask]) + +繝励Ο繧ｻ繧ｹ縺ｮ繝輔ぃ繧､繝ｫ繝｢繝ｼ繝我ｽ懈舌槭せ繧ｯ繧定ｨｭ螳壹∪縺溘ｯ隱ｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶 +蟄舌励Ο繧ｻ繧ｹ縺ｯ隕ｪ繝励Ο繧ｻ繧ｹ縺九ｉ繝槭せ繧ｯ繧堤ｶ呎価縺励∪縺吶 +`mask` 蠑墓焚縺御ｸ弱∴繧峨ｌ繧九→蜈縺ｮ繝槭せ繧ｯ縺瑚ｿ斐＆繧後√◎縺縺ｧ縺ｪ縺代ｌ縺ｰ迴ｾ蝨ｨ縺ｮ繝槭せ繧ｯ縺瑚ｿ斐＆繧後∪縺吶 var oldmask, newmask = 0644; From 892e86c17304fd51e77986e0da4d7669c1f86752 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:37:35 +0900 Subject: [PATCH 20/40] translated querystring --- doc/api/querystring.markdown | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/api/querystring.markdown b/doc/api/querystring.markdown index a9cc4ddc8644..c0992e15782f 100644 --- a/doc/api/querystring.markdown +++ b/doc/api/querystring.markdown @@ -1,12 +1,21 @@ ## Query String + +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ繧ｯ繧ｨ繝ｪ譁蟄怜励ｒ蜃ｦ逅縺吶ｋ繝ｦ繝ｼ繝繧｣繝ｪ繝繧｣繧呈署萓帙＠縺ｾ縺吶 莉･荳九ｮ繝｡繧ｽ繝繝峨°繧画舌ｊ縺ｾ縺: ### querystring.stringify(obj, sep='&', eq='=') + +繧ｯ繧ｨ繝ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ譁蟄怜励∈逶ｴ蛻怜喧縺励∪縺吶ゅが繝励す繝ｧ繝ｳ縺ｨ縺励※繝繝輔か繝ｫ繝医ｮ蛹ｺ蛻繧頑枚蟄励→莉｣蜈･譁蟄励ｒ荳頑嶌縺肴欠螳壹〒縺阪∪縺吶 + +萓: querystring.stringify({foo: 'bar'}) // returns @@ -18,9 +27,15 @@ Example: ### querystring.parse(str, sep='&', eq='=') + +繧ｯ繧ｨ繝ｪ譁蟄怜励ｒ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蠕ｩ蜈縺励∪縺吶ゅが繝励す繝ｧ繝ｳ縺ｨ縺励※繝繝輔か繝ｫ繝医ｮ蛹ｺ蛻繧頑枚蟄励→莉｣蜈･譁蟄励ｒ荳頑嶌縺肴欠螳壹〒縺阪∪縺吶 + +萓: querystring.parse('a=b&b=c') // returns @@ -30,8 +45,14 @@ Example: ### querystring.escape + +escape 髢｢謨ｰ縺ｯ `querystring.stringify` 縺ｧ菴ｿ逕ｨ縺輔ｌ縺ｦ縺縺ｦ縲∝ｿ隕√↑蝣ｴ蜷医↓繧ｪ繝ｼ繝舌ｼ繝ｩ繧､繝峨〒縺阪ｋ繧医≧謠蝉ｾ帙＆繧後※縺縺ｾ縺吶 ### querystring.unescape + +unescape髢｢謨ｰ縺ｯ `querystring.parse` 縺ｧ菴ｿ逕ｨ縺輔ｌ縺ｦ縺縺ｦ縲∝ｿ隕√↑蝣ｴ蜷医↓繧ｪ繝ｼ繝舌ｼ繝ｩ繧､繝峨〒縺阪ｋ繧医≧謠蝉ｾ帙＆繧後※縺縺ｾ縺吶 From 5444cbb14a60395d5a554771206105508f1b4a22 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:48:06 +0900 Subject: [PATCH 21/40] translated repl --- doc/api/repl.markdown | 61 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 60 insertions(+), 1 deletion(-) diff --git a/doc/api/repl.markdown b/doc/api/repl.markdown index 761626b48772..809236a1bb19 100644 --- a/doc/api/repl.markdown +++ b/doc/api/repl.markdown @@ -1,12 +1,21 @@ ## REPL + +Read-Eval-Print-Loop (REPL) 縺ｯ蜊倡峡縺ｮ繝励Ο繧ｰ繝ｩ繝縺ｨ縺励※繧ゆｻ悶ｮ繝励Ο繧ｰ繝ｩ繝縺ｫ謇玖ｻｽ縺ｫ蜿悶ｊ霎ｼ繧蠖｢縺ｧ繧ょ茜逕ｨ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 +REPL 縺ｯ蟇ｾ隧ｱ逧縺ｫ JavaScript 繧貞ｮ溯｡後＠縺ｦ邨先棡繧堤｢ｺ隱阪☆繧区焔谿ｵ繧呈署萓帙＠縺ｾ縺吶 +繝繝舌ャ繧ｰ繧繝繧ｹ繝医ｄ縺昴ｮ莉悶ｮ讒倥縺ｪ縺薙→繧定ｩｦ縺咏畑騾斐〒蛻ｩ逕ｨ縺輔ｌ縺ｾ縺吶 + +繧ｳ繝槭Φ繝峨Λ繧､繝ｳ縺九ｉ `node` 繧貞ｼ墓焚辟｡縺励〒螳溯｡後☆繧九％縺ｨ縺ｧ縲ヽEPL 繝励Ο繧ｰ繝ｩ繝縺ｫ蜈･繧翫∪縺吶 +REPL 縺ｯ Emacs 鬚ｨ縺ｮ邁｡譏薙↑陦檎ｷｨ髮讖溯ｽ繧貞ｙ縺医※縺縺ｾ縺吶 mjr:~$ node Type '.help' for options. @@ -19,24 +28,43 @@ dropped into the REPL. It has simplistic emacs line-editing. 2 3 + +繧医ｊ騾ｲ繧薙□陦檎ｷｨ髮繧定｡後≧縺ｫ縺ｯ縲∫腸蠅螟画焚縺ｫ `NODE_NO_READLINE=1` 繧定ｨｭ螳壹＠縺ｦnode繧定ｵｷ蜍輔＠縺ｦ縺上□縺輔＞縲 +縺薙ｌ縺ｫ繧医▲縺ｦ豁｣隕上ｮ遶ｯ譛ｫ險ｭ螳壹〒 REPL 繧定ｵｷ蜍輔＠縲〜rlwrap` 繧呈怏蜉ｹ縺ｫ縺励◆迥ｶ諷九〒REPL繧貞茜逕ｨ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 + +萓九→縺励※縲｜ashrc 繝輔ぃ繧､繝ｫ縺ｫ莉･荳九ｮ繧医≧縺ｫ險ｭ螳壹ｒ霑ｽ蜉縺励∪縺: alias node="env NODE_NO_READLINE=1 rlwrap node" ### repl.start(prompt='node> ', stream=process.openStdin()) + +`prompt` 縺ｧ繝励Ο繝ｳ繝励ヨ險伜捷繧偵 `stream` 縺ｧ I/O 繧貞ｼ墓焚縺ｫ蜿悶▲縺ｦ REPL 繧定ｵｷ蜍輔＠縺ｾ縺吶 +`prompt` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `node> ` 縺ｧ縺吶 +`stream` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `process.openStdin()`縺ｧ縺吶 + +隍謨ｰ縺ｮ REPL 繧定ｵｷ蜍輔＠縺溷ｴ蜷医∝酔荳縺ｮ node 繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺悟ｮ溯｡後＆繧後↑縺縺薙→縺後≠繧翫∪縺吶 +縺昴ｌ縺槭ｌ縺ｮ REPL 縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蜈ｱ譛峨＠縺ｾ縺吶′縲！/O 縺ｯ蝗ｺ譛峨ｮ繧ゅｮ繧呈戟縺｡縺ｾ縺吶 + +REPL 繧呈ｨ呎ｺ門･蜉帙ゞnix 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ゝCP 繧ｽ繧ｱ繝繝医ｮ繧ゅ→縺ｧ襍ｷ蜍輔☆繧倶ｾ九ｒ遉ｺ縺励∪縺: var net = require("net"), repl = require("repl"); @@ -55,20 +83,36 @@ Here is an example that starts a REPL on stdin, a Unix socket, and a TCP socket: repl.start("node via TCP socket> ", socket); }).listen(5001); + +縺薙ｮ繝励Ο繧ｰ繝ｩ繝繧偵さ繝槭Φ繝峨Λ繧､繝ｳ縺九ｉ螳溯｡後☆繧九→縲∵ｨ呎ｺ門･蜉帙ｮ繧ゅ→縺ｧ REPL 縺瑚ｵｷ蜍輔＠縺ｾ縺吶 +莉悶ｮ REPL 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ Unix 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医° TCP 繧ｽ繧ｱ繝繝医ｒ莉九＠縺ｦ謗･邯壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 +`telnet` 縺 TCP 繧ｽ繧ｱ繝繝医∈縺ｮ謗･邯壹↓萓ｿ蛻ｩ縺ｧ縺吶 +`socat` 縺ｯ Unix 繝峨Γ繧､繝ｳ /TCP 荳｡譁ｹ縺ｮ繧ｽ繧ｱ繝繝医∈縺ｮ謗･邯壹↓蛻ｩ逕ｨ縺ｧ縺阪∪縺吶 + +讓呎ｺ門･蜉帙ｮ莉｣繧上ｊ縺ｫ Unix 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｒ繝吶ｼ繧ｹ縺ｨ縺励◆繧ｵ繝ｼ繝舌°繧 REPL 繧定ｵｷ蜍輔☆繧九％縺ｨ縺ｫ繧医▲縺ｦ縲 +蜀崎ｵｷ蜍輔☆繧九％縺ｨ縺ｪ縺 node 縺ｮ蟶ｸ鬧舌励Ο繧ｻ繧ｹ縺ｸ謗･邯壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 ### REPL Features + +REPL 縺ｮ荳ｭ縺ｧ Control+D 繧貞ｮ溯｡後☆繧九→邨ゆｺ縺励∪縺吶り､謨ｰ陦後↓貂｡繧句ｼ上ｒ蜈･蜉帙→縺吶ｋ縺薙→縺後〒縺阪∪縺吶 + +迚ｹ蛻･縺ｪ螟画焚縺ｧ縺ゅｋ `_` (繧｢繝ｳ繝繝ｼ繧ｹ繧ｳ繧｢) 縺ｯ荳逡ｪ譛蠕後ｮ蠑上ｮ邨先棡繧剃ｿ晄戟縺励∪縺吶 node> [ "a", "b", "c" ] [ 'a', 'b', 'c' ] @@ -77,9 +121,14 @@ The special variable `_` (underscore) contains the result of the last expression node> _ += 1 4 + +REPL 縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｹ繧ｳ繝ｼ繝励↓蟄伜惠縺吶ｋ蜈ｨ縺ｦ縺ｮ螟画焚縺ｫ繧｢繧ｯ繧ｻ繧ｹ蜿ｯ閭ｽ縺ｧ縺吶 +縺昴ｌ縺槭ｌ縺ｮ `REPLServer` 縺ｫ邏舌▼縺 `context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医↓螟画焚繧剃ｻ倅ｸ弱☆繧九％縺ｨ縺ｧ縲 +譏守､ｺ逧縺ｫ螟画焚繧貞ｬ髢九＆縺帙ｋ縺薙→縺悟庄閭ｽ縺ｧ縺吶 萓: // repl_test.js var repl = require("repl"), @@ -87,17 +136,27 @@ to the REPL explicitly by assigning it to the `context` object associated with e repl.start().context.m = msg; + +`context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医↓險ｭ螳壹＆繧後◆螟画焚縺ｯ縲ヽEPL 縺ｮ荳ｭ縺ｧ縺ｯ繝ｭ繝ｼ繧ｫ繝ｫ縺ｪ螟画焚縺ｨ縺励※迴ｾ繧後∪縺: mjr:~$ node repl_test.js node> m 'message' + + +* `.break` - 隍謨ｰ陦後↓貂｡縺｣縺ｦ蠑上ｒ蜈･蜉帙＠縺ｦ縺繧矩俣縺ｫ縲騾比ｸｭ縺ｧ蛻縺九ｉ縺ｪ縺上↑縺｣縺溘ｊ螳御ｺ縺輔○縺ｪ縺上※繧り憶縺上↑繧九％縺ｨ縺後≠繧翫∪縺吶Ａ.break` 縺ｧ譛蛻昴°繧峨ｄ繧顔峩縺励∪縺吶 +* `.clear` - `context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ遨ｺ縺ｮ迥ｶ諷九↓繝ｪ繧ｻ繝繝医＠縲∬､謨ｰ陦後↓蜈･蜉帙＠縺ｦ縺繧句ｼ上ｒ繧ｯ繝ｪ繧｢縺励∪縺吶 +* `.exit` - I/O繧ｹ繝医Μ繝ｼ繝繧帝哩縺倥ヽEPL繧堤ｵゆｺ縺輔○縺ｾ縺吶 +* `.help` - 縺薙ｮ繧ｳ繝槭Φ繝峨ｮ荳隕ｧ繧定｡ｨ遉ｺ縺励∪縺吶 From cae1af688915ab189549e08d3ac9548b08663c65 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:55:16 +0900 Subject: [PATCH 22/40] translated streams --- doc/api/streams.markdown | 100 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 99 insertions(+), 1 deletion(-) diff --git a/doc/api/streams.markdown b/doc/api/streams.markdown index 8480a3475060..b17d703621b3 100644 --- a/doc/api/streams.markdown +++ b/doc/api/streams.markdown @@ -1,131 +1,229 @@ ## Streams + +繧ｹ繝医Μ繝ｼ繝縺ｯ Node 縺ｮ讒倥縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒螳溯｣縺輔ｌ繧区歓雎｡逧縺ｪ繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｧ縺吶 +萓九∴縺ｰ HTTP 繧ｵ繝ｼ繝舌∈縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｯ讓呎ｺ門ｺ蜉帙→蜷梧ｧ倥↓繧ｹ繝医Μ繝ｼ繝縺ｧ縺吶 +繧ｹ繝医Μ繝ｼ繝縺ｯ隱ｭ縺ｿ霎ｼ縺ｿ蜿ｯ閭ｽ縲∵嶌縺崎ｾｼ縺ｿ蜿ｯ閭ｽ縲√∪縺溘ｯ縺昴ｮ荳｡譁ｹ縺ｧ縺吶 +蜈ｨ縺ｦ縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｯ `EventEmitter` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 ## Readable Stream + +`Readable Stream` 縺ｫ縺ｯ莉･荳九ｮ繝｡繧ｽ繝繝峨√Γ繝ｳ繝舌ｼ縲√◎縺励※繧､繝吶Φ繝医′縺ゅｊ縺ｾ縺吶 ### Event: 'data' `function (data) { }` + +`'data'` 繧､繝吶Φ繝医ｯ `Buffer` (繝繝輔か繝ｫ繝) 縺ｾ縺溘ｯ縲 +`setEncoding()` 縺輔ｌ縺溷ｴ蜷医ｯ譁蟄怜励ｮ縺ｩ縺｡繧峨°繧堤函謌舌＠縺ｾ縺 ### Event: 'end' `function () { }` + +繧ｹ繝医Μ繝ｼ繝縺 EOF (TCP 逕ｨ隱槭〒縺ｯ FIN) 繧貞女菫｡縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 +`'data'` 繧､繝吶Φ繝医′繧ゅ≧逋ｺ逕溘＠縺ｪ縺縺薙→繧堤､ｺ縺励∪縺吶 +繧ｹ繝医Μ繝ｼ繝縺後ｂ縺玲嶌縺崎ｾｼ縺ｿ蜿ｯ閭ｽ縺ｧ繧ゅ≠繧九↑繧峨∵嶌縺崎ｾｼ縺ｿ繧堤ｶ壹¢繧九％縺ｨ縺ｯ蜿ｯ閭ｽ縺九ｂ縺励ｌ縺ｾ縺帙ｓ縲 ### Event: 'error' `function (exception) { }` + +繝繝ｼ繧ｿ蜿嶺ｿ｡縺ｧ繧ｨ繝ｩ繝ｼ縺後≠繧九→逕滓舌＆繧後∪縺吶 ### Event: 'close' `function () { }` + +荳句ｱ､縺ｧ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌′繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺滓凾縺ｫ逕滓舌＆繧後∪縺吶 +蜈ｨ縺ｦ縺ｮ繧ｹ繝医Μ繝ｼ繝縺後％縺ｮ繧､繝吶Φ繝医ｒ逋ｺ逕溘☆繧九ｏ縺代〒縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 +(萓九∴縺ｰ縲√う繝ｳ繧ｫ繝溘Φ繧ｰ縺ｮ HTTP 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｯ `'close'` 繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺帙ｓ縲) ### Event: 'fd' `function (fd) { }` + +繧ｹ繝医Μ繝ｼ繝縺ｫ髢｢縺吶ｋ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｒ蜿励¢蜿悶▲縺滓凾縺ｫ逕滓舌＆繧後∪縺吶 +UNIX 繧ｹ繝医Μ繝ｼ繝縺縺代′縺薙ｮ讖溯ｽ繧偵し繝昴ｼ繝医＠縺ｦ縺縺ｾ縺; +縺昴ｮ莉悶ｮ蜈ｨ縺ｦ縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｯ縺薙ｮ繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺帙ｓ縲 ### stream.readable + +繝繝輔か繝ｫ繝医〒縺ｯ `true` 縺ｧ縺吶′縲〜'error'` 縺檎匱逕溘＠縺溷ｾ後 +繧ｹ繝医Μ繝ｼ繝縺 `'end'` 縺ｫ驕斐＠縺溷ｾ後√∪縺溘ｯ `destroy()` 縺悟他縺ｰ繧後◆蠕後〒縲 +`false` 縺ｫ險ｭ螳壹＆繧後ｋ boolean 縺ｧ縺吶 ### stream.setEncoding(encoding) + +data 繧､繝吶Φ繝医′ `Buffer` 縺ｧ縺ｯ縺ｪ縺乗枚蟄怜励ｒ逕滓舌☆繧九ｈ縺縺ｫ縺励∪縺吶 +`encoding` 縺ｫ縺ｯ `'utf8'`縲〜'ascii'`縲 +縺ｾ縺溘ｯ `'base64'` 繧呈欠螳壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 ### stream.pause() + +`'data'` 繧､繝吶Φ繝医ｮ蛻ｰ逹繧剃ｸｭ譁ｭ縺励∪縺吶 ### stream.resume() + +`pause()` 縺ｮ蠕後〒 `'data'` 繧､繝吶Φ繝医ｮ蛻ｰ逹繧貞埼幕縺励∪縺吶 ### stream.destroy() + +荳句ｱ､縺ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺励∪縺吶ゅせ繝医Μ繝ｼ繝縺ｯ縺昴ｌ莉･荳翫う繝吶Φ繝医ｒ逕滓舌＠縺ｪ縺上↑繧翫∪縺吶 ## Writable Stream + +`Writable Stream` 縺ｫ縺ｯ莉･荳九ｮ繝｡繧ｽ繝繝峨√Γ繝ｳ繝舌ｼ縲√◎縺励※繧､繝吶Φ繝医′縺ゅｊ縺ｾ縺吶 ### Event: 'drain' `function () { }` + +蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺 `write()` 繝｡繧ｽ繝繝峨′ `false` 縺ｧ謌ｻ縺｣縺溷ｾ後↓逕滓舌＆繧後 +蜀阪ｳ螳牙ｨ縺ｫ譖ｸ縺崎ｾｼ繧縺薙→縺後〒縺阪ｋ繧医≧縺ｫ縺ｪ縺｣縺溘％縺ｨ繧堤､ｺ縺励∪縺吶 ### Event: 'error' `function (exception) { }` + +`exception`萓句､悶↓繧医ｋ繧ｨ繝ｩ繝ｼ縺ｫ縺､縺縺ｦ逕滓舌＆繧後∪縺吶 ### Event: 'close' `function () { }` + +荳句ｱ､縺ｧ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌′繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺滓凾縺ｫ逕滓舌＆繧後∪縺吶 ### stream.writeable + +繝繝輔か繝ｫ繝医〒縺ｯ `true` 縺ｧ縺吶′縲〜'error'` 縺檎匱逕溘＠縺溷ｾ後 +`end()` / `destroy()` 縺悟他縺ｰ繧後◆蠕後〒 `false` 縺ｫ險ｭ螳壹＆繧後ｋ boolean 縺ｧ縺吶 ### stream.write(string, encoding='utf8', [fd]) + +荳弱∴繧峨ｌ縺 `encoding` 縺ｧ `string` 繧呈嶌縺崎ｾｼ縺ｿ縺ｾ縺吶 +譁蟄怜励′繧ｫ繝ｼ繝阪Ν繝舌ャ繝輔ぃ縺ｫ繝輔Λ繝繧ｷ繝･縺輔ｌ縺溷ｴ蜷医ｯ `true` 縺瑚ｿ斐ｊ縺ｾ縺吶 +繧ｫ繝ｼ繝阪Ν繝舌ャ繝輔ぃ縺後＞縺｣縺ｱ縺縺ｮ蝣ｴ蜷医ｯ縲√ョ繝ｼ繧ｿ縺悟ｰ譚･繧ｫ繝ｼ繝阪Ν繝舌ャ繝輔ぃ縺ｫ騾√ｉ繧後ｋ縺薙→繧堤､ｺ縺吶◆繧√↓縲 +`false` 縺瑚ｿ斐ｊ縺ｾ縺吶 +`'drain'` 繧､繝吶Φ繝医′繧ｫ繝ｼ繝阪Ν繝舌ャ繝輔ぃ縺悟阪ｳ遨ｺ縺縺溘％縺ｨ繧堤､ｺ縺励∪縺吶 +`encoding` 縺ｮ繝繝輔か繝ｫ繝医ｯ `'utf8'` 縺ｧ縺吶 + + +繧ｪ繝励す繝ｧ繝ｳ縺ｮ `fd` 蠑墓焚縺梧欠螳壹＆繧後ｋ縺ｨ縲 +繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺吶ｋ縺溘ａ縺ｮ蝓ｺ遉弱→縺ｪ繧九ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌→縺励※隗｣驥医＆繧後∪縺吶 +縺薙ｌ縺ｯ UNIX 繧ｹ繝医Μ繝ｼ繝縺ｧ縺ｮ縺ｿ繧ｵ繝昴ｼ繝医＆繧後※縺翫ｊ縲√◎縺ｮ莉悶〒縺ｯ鮟吶▲縺ｦ辟｡隕悶＆繧後∪縺吶 +縺薙ｮ繧医≧縺ｫ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌↓譖ｸ縺崎ｾｼ繧蝣ｴ蜷医√せ繝医Μ繝ｼ繝縺梧ｵ√ｌ縺阪ｋ蜑阪↓繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺吶ｋ縺ｨ縲 +繝繝ｼ繧ｿ縺御ｸ肴ｭ｣縺ｪ (繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺) 繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌↓騾√ｉ繧後ｋ繝ｪ繧ｹ繧ｯ縺後≠繧翫∪縺吶 ### stream.write(buffer) + +逕溘ｮ繝舌ャ繝輔ぃ繧剃ｽｿ縺縺薙→莉･螟悶ｯ荳願ｨ倥→蜷後§縺ｧ縺吶 ### stream.end() + +繧ｹ繝医Μ繝ｼ繝繧 EOF 縺ｾ縺溘ｯ FIN 縺ｧ邨ゆｺ縺励∪縺吶 ### stream.end(string, encoding) + +荳弱∴繧峨ｌ縺 `encoding` 縺ｧ `string` 繧帝∽ｿ｡縺励※縺九ｉEOF縺ｾ縺溘ｯFIN縺ｧ繧ｹ繝医Μ繝ｼ繝繧堤ｵゆｺ縺励∪縺吶 +縺薙ｌ縺ｯ騾∽ｿ｡縺吶ｋ繝代こ繝繝医ｮ謨ｰ繧呈ｸ帙ｉ縺吶◆繧√↓萓ｿ蛻ｩ縺ｧ縺吶 ### stream.end(buffer) + +`buffer` 縺ｧ縺ゅｋ縺薙→莉･螟悶ｯ荳願ｨ倥→蜷後§縺ｧ縺吶 ### stream.destroy() + +荳句ｱ､縺ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺励∪縺吶ゅせ繝医Μ繝ｼ繝縺ｯ縺昴ｌ莉･荳翫う繝吶Φ繝医ｒ逕滓舌＠縺ｪ縺上↑繧翫∪縺吶 From 7896bdb74378d183ca993c92f149293efeffb8c1 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:57:18 +0900 Subject: [PATCH 23/40] translated synopsis --- doc/api/synopsis.markdown | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/api/synopsis.markdown b/doc/api/synopsis.markdown index 53efb86fa9b2..09b9cdcffe37 100644 --- a/doc/api/synopsis.markdown +++ b/doc/api/synopsis.markdown @@ -1,7 +1,10 @@ ## Synopsis + +'Hello World' 縺ｨ霑皮ｭ斐☆繧 Node 縺ｧ譖ｸ縺九ｌ縺欷eb繧ｵ繝ｼ繝舌ｮ萓: var http = require('http'); @@ -12,10 +15,17 @@ World': console.log('Server running at http://127.0.0.1:8124/'); + +縺薙ｮ繧ｵ繝ｼ繝舌ｒ螳溯｡後☆繧九↓縺ｯ縲√さ繝ｼ繝峨ｒ `example.js` 縺ｨ縺縺繝輔ぃ繧､繝ｫ縺ｫ菫晏ｭ倥＠縲 +node 繧ｳ繝槭Φ繝峨〒螳溯｡後＠縺ｦ縺上□縺輔＞縲 > node example.js Server running at http://127.0.0.1:8124/ + +縺薙ｮ繝峨く繝･繝｡繝ｳ繝医ｮ蜈ｨ縺ｦ縺ｮ繧ｵ繝ｳ繝励Ν縺ｯ蜷後§繧医≧縺ｫ螳溯｡後☆繧九％縺ｨ縺後〒縺阪∪縺吶 From b33fbdc47d718d8cc41d48e6e7ba77209ff52bf5 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 18:59:26 +0900 Subject: [PATCH 24/40] translated timers --- doc/api/timers.markdown | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/api/timers.markdown b/doc/api/timers.markdown index 2ac02369947b..7fd7f47a64fb 100644 --- a/doc/api/timers.markdown +++ b/doc/api/timers.markdown @@ -2,20 +2,36 @@ ### setTimeout(callback, delay, [arg], [...]) + +`delay` 繝溘Μ遘偵′邨碁℃縺励◆蠕後〒 `callback` 縺悟ｮ溯｡後＆繧後ｋ繧医≧縺ｫ繧ｹ繧ｱ繧ｸ繝･繝ｼ繝ｫ縺励∪縺吶 +`clearTimeout()` 縺ｧ菴ｿ縺縺薙→縺後〒縺阪ｋ `timeoutId` 繧定ｿ斐＠縺ｾ縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｨ縺励※縲√さ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｸ縺ｮ蠑墓焚繧呈ｸ｡縺吶％縺ｨ繧ゅ〒縺阪∪縺吶 ### clearTimeout(timeoutId) + +繧ｿ繧､繝繧｢繧ｦ繝医′繝医Μ繧ｬ繝ｼ縺輔ｌ繧九ｮ繧呈ｭ｢繧√∪縺吶 ### setInterval(callback, delay, [arg], [...]) + +`delay` 繝溘Μ遘偵′邨碁℃縺吶ｋ縺斐→縺ｫ郢ｰ繧願ｿ斐＠ `callback` 縺悟ｮ溯｡後＆繧後ｋ繧医≧縺ｫ繧ｹ繧ｱ繧ｸ繝･繝ｼ繝ｫ縺励∪縺吶 +`clearInterval()` 縺ｧ菴ｿ縺縺薙→縺後〒縺阪ｋ `intervalId` 繧定ｿ斐＠縺ｾ縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｨ縺励※縲√さ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｸ縺ｮ蠑墓焚繧呈ｸ｡縺吶％縺ｨ繧ゅ〒縺阪∪縺吶 ### clearInterval(intervalId) + +繧､繝ｳ繧ｿ繝ｼ繝舌Ν縺後ヨ繝ｪ繧ｬ繝ｼ縺輔ｌ繧九ｮ繧呈ｭ｢繧√∪縺吶 From 6b1fa86e5564376cd833a23e9c53bd8f3c8b32e4 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 19:09:48 +0900 Subject: [PATCH 25/40] translated url --- doc/api/url.markdown | 56 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/doc/api/url.markdown b/doc/api/url.markdown index d1e6123a3aca..8759448d2c29 100644 --- a/doc/api/url.markdown +++ b/doc/api/url.markdown @@ -1,14 +1,25 @@ ## URL + +縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯURL縺ｮ隗｣豎ｺ繧隗｣譫舌ｮ轤ｺ縺ｮ繝ｦ繝ｼ繝繧｣繝ｪ繝繧｣繧呈戟縺｡縺ｾ縺吶 +蛻ｩ逕ｨ縺吶ｋ縺ｫ縺ｯ `require('url')` 繧貞他縺ｳ蜃ｺ縺励※縺上□縺輔＞縲 + +隗｣譫舌＆繧後◆URL繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ縲ゞRL譁蟄怜励ｮ荳ｭ縺ｫ蟄伜惠縺吶ｋ縺九←縺縺九↓蠢懊§縺ｦ +谺｡縺ｫ遉ｺ縺吶ヵ繧｣繝ｼ繝ｫ繝峨ｒ縺縺上▽縺九ｂ縺励￥縺ｯ蜈ｨ縺ｦ繧呈戟縺｡縺ｾ縺吶 +URL譁蟄怜励↓蜷ｫ縺ｾ繧後↑縺繝輔ぅ繝ｼ繝ｫ繝峨ｯ隗｣譫千ｵ先棡縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蜷ｫ縺ｾ繧後∪縺帙ｓ縲 +谺｡縺ｮURL縺ｧ萓九ｒ遉ｺ縺励∪縺吶 `'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'` + +* `href`: 隗｣譫舌☆繧句燕縺ｮ螳悟ｨ縺ｪ URL縲 + + 萓: `'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'` +* `protocol`: 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｮ繝励Ο繝医さ繝ｫ縲 + + 萓: `'http:'` +* `host`: URL 縺ｮ螳悟ｨ縺ｪ繝帙せ繝域ュ蝣ｱ縲りｪ崎ｨｼ諠蝣ｱ繧貞性縺ｿ縺ｾ縺吶 + + 萓: `'user:pass@host.com:8080'` +* `auth`: URL 縺ｮ隱崎ｨｼ諠蝣ｱ縲 + + 萓: `'user:pass'` +* `hostname`: 繝帙せ繝域ュ蝣ｱ縺ｮ荳ｭ縺ｮ繝帙せ繝亥錐縲 + + 萓: `'host.com'` +* `port`: 繝帙せ繝域ュ蝣ｱ縺ｮ荳ｭ縺ｮ繝昴ｼ繝育分蜿ｷ縲 + + 萓: `'8080'` +* `pathname`: URL 縺ｮ繝代せ驛ｨ蛻縲ゅ帙せ繝域ュ蝣ｱ縺九ｉ繧ｯ繧ｨ繝ｪ縺ｾ縺ｧ縺ｮ髢薙↓菴咲ｽｮ縺励∵怙蛻昴↓繧ｹ繝ｩ繝繧ｷ繝･縺悟ｭ伜惠縺吶ｋ蝣ｴ蜷医ｯ縺昴ｌ繧ょ性縺ｿ縺ｾ縺吶 + + 萓: `'/p/a/t/h'` +* `search`: URL 縺ｮ繧ｯ繧ｨ繝ｪ譁蟄怜励ょ磯ｭ縺ｮ ? 繝槭ｼ繧ｯ繧ょ性縺ｿ縺ｾ縺吶 + + 萓: `'?query=string'` +* `query`: 繧ｯ繧ｨ繝ｪ縺ｮ螟画焚驛ｨ蛻縺ｮ譁蟄怜励√ｂ縺励￥縺ｯ繧ｯ繧ｨ繝ｪ譁蟄怜励ｒ隗｣譫舌＠縺溘が繝悶ず繧ｧ繧ｯ繝医 + + 萓: `'query=string'` or `{'query':'string'}` +* `hash`: URL 縺ｮ # 繝槭ｼ繧ｯ繧貞性繧驛ｨ蛻縲 + + 萓: `'#hash'` + +莉･荳九ｮ繝｡繧ｽ繝繝峨ｯURL繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧医ｊ謠蝉ｾ帙＆繧後∪縺: ### url.parse(urlStr, parseQueryString=false) + +URL譁蟄怜励ｒ蠑墓焚縺ｫ蜿悶ｊ縲∬ｧ｣譫千ｵ先棡縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 +`querystring` 繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ縺｣縺ｦ繧ｯ繧ｨ繝ｪ譁蟄怜励ｂ隗｣譫舌＠縺溘＞蝣ｴ蜷医ｯ縲 +隨ｬ 2 蠑墓焚縺ｫ `true` 繧呈ｸ｡縺励※縺上□縺輔＞縲 ### url.format(urlObj) + +URL 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蠑墓焚縺ｫ蜿悶ｊ縲√ヵ繧ｩ繝ｼ繝槭ャ繝医＠縺 URL 譁蟄怜励ｒ霑斐＠縺ｾ縺吶 ### url.resolve(from, to) + +繝吶ｼ繧ｹ縺ｨ縺ｪ繧 URL 縺ｨ逶ｸ蟇ｾ URL 繧貞ｼ墓焚縺ｫ蜿悶ｊ縲√ヶ繝ｩ繧ｦ繧ｶ縺後い繝ｳ繧ｫ繝ｼ繧ｿ繧ｰ縺ｫ蟇ｾ縺励※陦後≧縺ｮ縺ｨ蜷梧ｧ倥↓ URL 繧定ｧ｣豎ｺ縺励∪縺吶 From ca303f9df53a7c2726acd4bba5ab0716835e909d Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 19:13:33 +0900 Subject: [PATCH 26/40] translated util --- doc/api/util.markdown | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/doc/api/util.markdown b/doc/api/util.markdown index 1c077f6ef2b8..f611424028f0 100644 --- a/doc/api/util.markdown +++ b/doc/api/util.markdown @@ -1,38 +1,68 @@ ## util + +縺薙ｌ繧峨ｮ髢｢謨ｰ縺ｯ繝｢繧ｸ繝･繝ｼ繝ｫ `'util'` 蜀縺ｫ縺ゅｊ縺ｾ縺吶 +`require('util')` 繧剃ｽｿ縺縺薙→縺ｧ縺薙ｌ繧峨↓繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 ### util.debug(string) + +蜷梧悄逧縺ｪ蜃ｺ蜉幃未謨ｰ縺ｧ縺吶ゅ励Ο繧ｻ繧ｹ繧偵ヶ繝ｭ繝繧ｯ縺励※蜊ｳ蠎ｧ縺ｫ `string` 繧 `stderr` 縺ｫ蜃ｺ蜉帙＠縺ｾ縺吶 require('util').debug('message on stderr'); ### util.log(string) + +繧ｿ繧､繝繧ｹ繧ｿ繝ｳ繝励→縺ｨ繧ゅ↓ `stdout` 縺ｸ蜃ｺ蜉帙＠縺ｾ縺吶 require('util').log('Timestmaped message.'); ### util.inspect(object, showHidden=false, depth=2) + +繝繝舌ャ繧ｰ縺ｧ譛臥畑縺ｪ縲〜object` 縺ｮ譁蟄怜苓｡ｨ迴ｾ繧定ｿ斐＠縺ｾ縺吶 + +`showHidden` 縺 `true` 縺ｮ蝣ｴ蜷医 +繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ Enumerable 縺ｧ縺ｪ縺繝励Ο繝代ユ繧｣繧り｡ｨ遉ｺ縺輔ｌ縺ｾ縺吶 + +`depth` 縺御ｸ弱∴繧峨ｌ縺溷ｴ蜷医 +繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繝輔か繝ｼ繝槭ャ繝医☆繧九◆繧√↓菴募屓蜀榊ｸｰ縺吶ｋ縺九ｒ `inspect` 縺ｫ莨昴∴縺ｾ縺吶 +縺薙ｌ縺ｯ蟾ｨ螟ｧ縺ｧ隍髮代↑繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ隱ｿ譟ｻ縺吶ｋ蝣ｴ蜷医↓萓ｿ蛻ｩ縺ｧ縺吶 + +繝繝輔か繝ｫ繝医〒縺ｯ 2 蝗槭□縺大榊ｸｰ縺励∪縺吶 +辟｡髯舌↓蜀榊ｸｰ縺吶ｋ縺ｫ縺ｯ縲〜depth` 縺ｫ `null` 繧呈ｸ｡縺励∪縺吶 + + +`util` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ蜈ｨ縺ｦ縺ｮ繝励Ο繝代ユ繧｣繧定ｪｿ譟ｻ縺吶ｋ萓: var util = require('util'); @@ -41,10 +71,20 @@ Example of inspecting all properties of the `util` object: ### util.pump(readableStream, writeableStream, [callback]) + +螳滄ｨ鍋噪 + +`readableStream` 縺九ｉ繝繝ｼ繧ｿ繧定ｪｭ縺ｿ縲√◎繧 繧蛋writableStream` 縺ｫ騾√ｊ縺ｾ縺吶 +`writeableStream.write(data)` 縺 `false` 繧定ｿ斐☆蝣ｴ蜷医 +`writableStream` 縺 `drain` 繧､繝吶Φ繝医ｒ逕滓舌☆繧九∪縺ｧ縲 +`readableStream` 縺ｯ荳ｭ譁ｭ縺励∪縺吶 +`writableStream` 縺後け繝ｭ繝ｼ繧ｺ縺輔ｌ繧九°繧ｨ繝ｩ繝ｼ縺檎匱逕溘☆繧九→縲〜callback` 縺ｯ error 繧貞髪荳縺ｮ蠑墓焚縺ｨ縺励※蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 From 836f3c95ae0acb6b5b53f3e660f46089f880b07d Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 23 Nov 2010 19:41:10 +0900 Subject: [PATCH 27/40] translated vm --- doc/api/vm.markdown | 90 +++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 86 insertions(+), 4 deletions(-) diff --git a/doc/api/vm.markdown b/doc/api/vm.markdown index 3fff4ba8b5d0..6a1ea843dc57 100644 --- a/doc/api/vm.markdown +++ b/doc/api/vm.markdown @@ -1,18 +1,32 @@ ## Executing JavaScript + +谺｡縺ｮ繧医≧縺ｫ縺吶ｋ縺薙→縺ｧ縲√％縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪∪縺: var vm = require('vm'); + +JavaScript 繧ｳ繝ｼ繝峨ｯ縲√さ繝ｳ繝代う繝ｫ縺輔ｌ縺ｦ縺吶＄縺ｫ螳溯｡後＆繧後ｋ縺九√さ繝ｳ繝代う繝ｫ縺翫ｈ縺ｳ菫晏ｭ倥＆繧後※蠕後°繧牙ｮ溯｡後＆繧後∪縺吶 ### vm.runInThisContext(code, [filename]) + +`vm.runInThisContext()` 縺ｯ `code` 繧 `filename` 縺九ｉ繝ｭ繝ｼ繝峨＆繧後◆縺九ｮ繧医≧縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励 +縺昴ｌ繧貞ｮ溯｡後＠縺ｦ邨先棡繧定ｿ斐＠縺ｾ縺吶ょｮ溯｡後＆繧後ｋ繧ｳ繝ｼ繝峨ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺励∪縺帙ｓ縲 +`filename` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 + +`vm.runInThisContext` 縺ｨ `eval` 縺ｧ蜷後§繧ｳ繝ｼ繝峨ｒ螳溯｡後☆繧倶ｾ: var localVar = 123, usingscript, evaled, @@ -29,22 +43,41 @@ Example of using `vm.runInThisContext` and `eval` to run the same code: // localVar: 123, usingscript: 1 // localVar: 1, evaled: 1 + +`vm.runInThisContext` 縺ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺励↑縺縺ｮ縺ｧ縲〜localVar` 縺ｯ螟画峩縺輔ｌ縺ｾ縺帙ｓ縲 +`eval` 縺ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｮ縺ｧ縲〜localVar` 縺ｯ螟画峩縺輔ｌ縺ｾ縺吶 + +`code` 縺梧枚豕輔お繝ｩ繝ｼ縺ｨ縺ｪ繧九こ繝ｼ繧ｹ縺ｧ縺ｯ縲〜vm.runInThisContext` 縺ｯ讓呎ｺ悶お繝ｩ繝ｼ縺ｫ譁豕輔お繝ｩ繝ｼ繧貞ｺ蜉帙＠縲 +萓句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 ### vm.runInNewContext(code, [sandbox], [filename]) + +`vm.runInNewContext` 縺ｯ `code` 繧 `filename` 縺九ｉ繝ｭ繝ｼ繝峨＆繧後◆縺九ｮ繧医≧縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励 +縺昴ｌ繧 `sandbox` 縺ｮ荳ｭ縺ｧ螳溯｡後＠縺ｦ邨先棡繧定ｿ斐＠縺ｾ縺吶 +螳溯｡後＆繧後ｋ繧ｳ繝ｼ繝峨ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺帙★縲 +`sandbox` 縺 `code` 縺ｫ縺ｨ縺｣縺ｦ縺ｮ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｪ繝悶ず繧ｧ繧ｯ繝医→縺励※菴ｿ繧上ｌ縺ｾ縺吶 +`sandbox` 縺翫ｈ縺ｳ `filename` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 + + +萓: 繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚繧偵う繝ｳ繧ｯ繝ｪ繝｡繝ｳ繝医＠縺ｦ譁ｰ縺励＞蛟､繧偵そ繝繝医☆繧九さ繝ｼ繝峨ｒ繧ｳ繝ｳ繝代う繝ｫ縺翫ｈ縺ｳ螳溯｡後＠縺ｾ縺吶 +縺薙ｌ繧峨ｮ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺ｯ繧ｵ繝ｳ繝峨懊ャ繧ｯ繧ｹ縺ｫ蜷ｫ縺ｾ繧後∪縺吶 var util = require('util'), vm = require('vm'), @@ -58,34 +91,66 @@ These globals are contained in the sandbox. // { animal: 'cat', count: 3, name: 'kitty' } + +諷朱阪ｒ隕√☆繧九ン繧ｸ繝阪せ縺ｧ縺ｯ縲∽ｿ｡鬆ｼ縺ｧ縺阪↑縺繧ｳ繝ｼ繝峨ｮ螳溯｡後ｯ邏ｰ蠢縺ｮ豕ｨ諢上′豎ゅａ繧峨ｌ繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +蛛ｶ辟ｶ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺梧ｼ上ｌ縺ｦ縺励∪縺縺薙→繧帝亟縺舌◆繧√↓縲〜vm.runInNewContext` 縺ｯ縺ｨ縺ｦ繧ょｽｹ遶九■縺ｾ縺吶′縲 +菫｡鬆ｼ縺ｧ縺阪↑縺繧ｳ繝ｼ繝峨ｒ螳牙ｨ縺ｫ螳溯｡後☆繧九◆繧√↓蛻･縺ｮ繝励Ο繧ｻ繧ｹ繧定ｦ∵ｱゅ＠縺ｾ縺吶 + +`code` 縺梧枚豕輔お繝ｩ繝ｼ縺ｨ縺ｪ繧九こ繝ｼ繧ｹ縺ｧ縺ｯ縲 +`vm.runInThisContext` 縺ｯ讓呎ｺ悶お繝ｩ繝ｼ縺ｫ譁豕輔お繝ｩ繝ｼ繧貞ｺ蜉帙＠縲∽ｾ句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 ### vm.createScript(code, [filename]) + +`createScript` 縺ｯ `code` 繧 +`filename` 縺九ｉ繝ｭ繝ｼ繝峨＆繧後◆縺九ｮ繧医≧縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励∪縺吶′縲∝ｮ溯｡後ｯ縺励∪縺帙ｓ縲 +莉｣繧上ｊ縺ｫ縲√さ繝ｳ繝代う繝ｫ縺輔ｌ縺溘さ繝ｼ繝峨ｒ陦ｨ迴ｾ縺吶ｋ `vm.Script` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 +縺薙ｮ繧ｹ繧ｯ繝ｪ繝励ヨ縺ｯ蠕瑚ｿｰ縺ｮ繝｡繧ｽ繝繝峨ｒ菴ｿ縺｣縺ｦ蠕後°繧我ｽ募ｺｦ縺ｧ繧ょｮ溯｡後☆繧九％縺ｨ縺後〒縺阪∪縺吶 +霑斐＆繧後ｋ繧ｹ繧ｯ繝ｪ繝励ヨ縺ｯ縺ｩ縺ｮ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｪ繝悶ず繧ｧ繧ｯ繝医→繧らｵ舌ｳ縺､縺代ｉ繧後※縺縺ｾ縺帙ｓ縲 +縺昴ｌ縺槭ｌ縺ｮ螳溯｡悟燕縺ｫ邨舌ｳ縺､縺代ｋ縺薙→縺ｧ縲√◎縺ｮ縺ｨ縺翫ｊ縺ｫ螳溯｡後＆繧後∪縺吶 +`filename` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 + + +`code` 縺梧枚豕輔お繝ｩ繝ｼ縺ｨ縺ｪ繧九こ繝ｼ繧ｹ縺ｧ縺ｯ縲 +`createScript` 縺ｯ讓呎ｺ悶お繝ｩ繝ｼ縺ｫ譁豕輔お繝ｩ繝ｼ繧貞ｺ蜉帙＠縺ｦ萓句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 ### script.runInThisContext() + +`vm.runInThisContext` 縺ｨ蜷梧ｧ倥〒縺吶′縲 +縺薙■繧峨ｯ繝励Μ繧ｳ繝ｳ繝代う繝ｫ貂医∩縺ｮ `Script` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繝｡繧ｽ繝繝峨〒縺吶 +`script.runInThisContext` 縺ｯ `script` 縺ｮ繧ｳ繝ｼ繝峨ｒ螳溯｡後＠縺ｦ縺昴ｮ邨先棡繧定ｿ斐＠縺ｾ縺吶 +螳溯｡後＆繧後ｋ繧ｳ繝ｼ繝峨ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺励∪縺帙ｓ縺後 +`global` 繧ｪ繝悶ず繧ｧ繧ｯ繝 (v8: 螳滄圀縺ｮ繧ｳ繝ｳ繝繧ｭ繧ｹ繝) 縺ｫ縺ｯ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 + + +`script.runInThisContext` 繧剃ｽｿ縺｣縺ｦ繧ｳ繝ｼ繝峨ｒ荳蠎ｦ縺縺代さ繝ｳ繝代う繝ｫ縺励∬､謨ｰ蝗槫ｮ溯｡後☆繧倶ｾ: var vm = require('vm'); @@ -104,12 +169,24 @@ Example of using `script.runInThisContext` to compile code once and run it multi ### script.runInNewContext([sandbox]) + +`vm.runInNewContext` 縺ｨ蜷梧ｧ倥〒縺吶′縲 +縺薙■繧峨ｯ繝励Μ繧ｳ繝ｳ繝代う繝ｫ貂医∩縺ｮ `Script` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繝｡繧ｽ繝繝峨〒縺吶 +`script.runInNewContext` 縺ｯ `sandbox` 縺後げ繝ｭ繝ｼ繝舌Ν繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺ゅｋ縺九ｮ繧医≧縺ｫ +`script` 縺ｮ繧ｳ繝ｼ繝峨ｒ螳溯｡後＠縺ｦ縺昴ｮ邨先棡繧定ｿ斐＠縺ｾ縺吶 +螳溯｡後＆繧後ｋ繧ｳ繝ｼ繝峨ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺励∪縺帙ｓ縲 +`sandbox` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 + + +萓: 繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚繧偵う繝ｳ繧ｯ繝ｪ繝｡繝ｳ繝医＠縺ｦ繧ｻ繝繝医☆繧九さ繝ｼ繝峨ｒ繧ｳ繝ｳ繝代う繝ｫ縺励※縲√％縺ｮ繧ｳ繝ｼ繝峨ｒ隍謨ｰ蝗槫ｮ溯｡後＠縺ｾ縺吶 +縺薙ｌ繧峨ｮ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺ｯ繧ｵ繝ｳ繝峨懊ャ繧ｯ繧ｹ縺ｫ蜷ｫ縺ｾ繧後∪縺吶 var util = require('util'), vm = require('vm'), @@ -128,6 +205,11 @@ These globals are contained in the sandbox. // { animal: 'cat', count: 12, name: 'kitty' } + +諷朱阪ｒ隕√☆繧九ン繧ｸ繝阪せ縺ｧ縺ｯ縲∽ｿ｡鬆ｼ縺ｧ縺阪↑縺繧ｳ繝ｼ繝峨ｮ螳溯｡後ｯ邏ｰ蠢縺ｮ豕ｨ諢上′豎ゅａ繧峨ｌ繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +蛛ｶ辟ｶ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺梧ｼ上ｌ縺ｦ縺励∪縺縺薙→繧帝亟縺舌◆繧√↓縲〜script.runInNewContext` 縺ｯ縺ｨ縺ｦ繧ょｽｹ遶九■縺ｾ縺吶′縲 +菫｡鬆ｼ縺ｧ縺阪↑縺繧ｳ繝ｼ繝峨ｒ螳牙ｨ縺ｫ螳溯｡後☆繧九◆繧√↓蛻･縺ｮ繝励Ο繧ｻ繧ｹ繧定ｦ∵ｱゅ＠縺ｾ縺吶 From 4d148328912cb19f117254e0a60015104f7eeae2 Mon Sep 17 00:00:00 2001 From: Toshihiro Shimizu Date: Tue, 23 Nov 2010 22:35:06 +0900 Subject: [PATCH 28/40] add charset --- doc/template.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/template.html b/doc/template.html index 54ae672eac06..b0d5d6c27c49 100644 --- a/doc/template.html +++ b/doc/template.html @@ -2,6 +2,7 @@ {{section}}Node.js Manual & Documentation + @@ -21,4 +22,4 @@

Node.js Manual & Documentation

- \ No newline at end of file + From c39683ed4e8eafc6eb8e55a25cd7ff9133baa5b5 Mon Sep 17 00:00:00 2001 From: koichik Date: Sat, 18 Dec 2010 19:40:16 +0900 Subject: [PATCH 29/40] translated v0.3.2 --- doc/api/_toc.markdown | 4 +- doc/api/assert.markdown | 17 ++++-- doc/api/crypto.markdown | 26 ++++----- doc/api/fs.markdown | 2 + doc/api/globals.markdown | 4 +- doc/api/http.markdown | 6 +- doc/api/net.markdown | 39 ++++++++++--- doc/api/os.markdown | 6 ++ doc/api/repl.markdown | 10 ++-- doc/api/streams.markdown | 23 ++++++++ doc/api/tls.markdown | 119 ++++++++++++++++++++++++++++++++++++++- doc/api/tty.markdown | 25 ++++++++ doc/api/util.markdown | 10 ++++ 13 files changed, 254 insertions(+), 37 deletions(-) diff --git a/doc/api/_toc.markdown b/doc/api/_toc.markdown index 968c3089ed3f..e42f98f6dbe7 100644 --- a/doc/api/_toc.markdown +++ b/doc/api/_toc.markdown @@ -44,7 +44,7 @@ * [繝舌ャ繝輔ぃ](buffers.html) * [繧ｹ繝医Μ繝ｼ繝](streams.html) * [證怜捷蛹望(crypto.html) - * [螳牙ｨ縺ｪ繧ｹ繝医Μ繝ｼ繝](securepair.html) +* [TLS/SSL](tls.html) * [譁蟄怜励ョ繧ｳ繝ｼ繝](string_decoder.html) * [繝輔ぃ繧､繝ｫ繧ｷ繧ｹ繝繝](fs.html) * [繝代せ](path.html) @@ -59,6 +59,8 @@ * [VM](vm.html) * [蟄舌励Ο繧ｻ繧ｹ](child_processes.html) * [陦ｨ譏弱→繝繧ｹ繝繧｣繝ｳ繧ｰ](assert.html) +* [TTY](tty.html) +* [OS](os.html) * 莉倬鹸 * [莉倬鹸 1: 謗ｨ螂ｨ縺輔ｌ繧九し繝ｼ繝峨ヱ繝ｼ繝繧｣陬ｽ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ](appendix_1.html) * [莉倬鹸 2: 蟒豁｢縺輔ｌ縺 API](appendix_2.html) diff --git a/doc/api/assert.markdown b/doc/api/assert.markdown index 07185212cc6a..4c64d07bc5f7 100644 --- a/doc/api/assert.markdown +++ b/doc/api/assert.markdown @@ -67,14 +67,16 @@ Tests strict non-equality, as determined by the strict not equal operator ( `!== ### assert.throws(block, [error], [message]) -`block` 縺後お繝ｩ繝ｼ繧偵せ繝ｭ繝ｼ縺吶ｋ縺薙→繧呈悄蠕縺励∪縺吶 - Expects `block` to throw an error. `error` can be constructor, regexp or validation function. +--> +`block` 縺後お繝ｩ繝ｼ繧偵せ繝ｭ繝ｼ縺吶ｋ縺薙→繧呈悄蠕縺励∪縺吶 +`error` 縺ｯ繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ縲∵ｭ｣隕剰｡ｨ迴ｾ縲√∪縺溘ｯ讀懆ｨｼ髢｢謨ｰ縺ｫ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 + +繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ繧剃ｽｿ縺｣縺ｦ instanceof 縺ｧ讀懆ｨｼ: assert.throws( function() { @@ -83,7 +85,10 @@ Validate instanceof using constructor: Error ); + +豁｣隕剰｡ｨ迴ｾ繧剃ｽｿ縺｣縺ｦ繧ｨ繝ｩ繝ｼ繝｡繝繧ｻ繝ｼ繧ｸ繧呈､懆ｨｼ: assert.throws( function() { @@ -92,7 +97,10 @@ Validate error message using RegExp: /value/ ); + +迢ｬ閾ｪ縺ｮ繧ｨ繝ｩ繝ｼ讀懆ｨｼ: assert.throws( function() { @@ -112,6 +120,7 @@ Custom error validation: Expects `block` not to throw an error, see assert.throws for details. --> `block` 縺後お繝ｩ繝ｼ繧偵せ繝ｭ繝ｼ縺励↑縺縺薙→繧呈悄蠕縺励∪縺吶 +隧ｳ邏ｰ縺ｯ assert.throws 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### assert.ifError(value) diff --git a/doc/api/crypto.markdown b/doc/api/crypto.markdown index 3a8b423cbbaa..7dc593b201b6 100644 --- a/doc/api/crypto.markdown +++ b/doc/api/crypto.markdown @@ -40,7 +40,7 @@ If no 'ca' details are given, then node.js will use the default publicly trusted . --> 'ca' 縺ｮ隧ｳ邏ｰ縺御ｸ弱∴繧峨ｌ縺ｪ縺九▲縺溷ｴ蜷医］ode.js 縺ｯ繝繝輔か繝ｫ繝医→縺励※ -http://mxr.mozilla.org/mozilla/source/security/nss/lib/ckfw/builtins/certdata.txt + 縺ｧ荳弱∴繧峨ｌ繧九∽ｿ｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ蜈ｬ髢九＆繧後◆繝ｪ繧ｹ繝医ｒ菴ｿ逕ｨ縺励∪縺吶 @@ -60,7 +60,7 @@ On recent releases, `openssl list-message-digest-algorithms` will display the av --> `algorithm` 縺ｯ縲√励Λ繝繝医ヵ繧ｩ繝ｼ繝荳翫ｮ OpenSSL 縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ繧ｵ繝昴ｼ繝医＆繧後※縺繧句茜逕ｨ蜿ｯ閭ｽ縺ｪ繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ萓晏ｭ倥＠縺ｾ縺吶 -萓九∴縺ｰ sha1縲［d5縲《ha256縲《ha512縲√↑縺ｩ縺ｧ縺吶 +萓九∴縺ｰ `'sha1'`縲〜'md5'`縲〜'sha256'`縲〜'sha512'`縲√↑縺ｩ縺ｧ縺吶 譛霑代ｮ繝ｪ繝ｪ繝ｼ繧ｹ縺ｧ縺ｯ縲〜openssl list-message-digest-algorithms` 縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ繝繧､繧ｸ繧ｧ繧ｹ繝医い繝ｫ繧ｴ繝ｪ繧ｺ繝縺瑚｡ｨ遉ｺ縺輔ｌ縺ｾ縺吶 @@ -80,7 +80,7 @@ Calculates the digest of all of the passed data to be hashed. The `encoding` can be `'hex'`, `'binary'` or `'base64'`. --> 貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ繝繝ｼ繧ｿ縺後ワ繝繧ｷ繝･蛹悶＆繧後◆繝繧､繧ｸ繧ｧ繧ｹ繝医ｒ險育ｮ励＠縺ｾ縺吶 -`encoding` 縺ｯ 'hex'縲'binary'縲√∪縺溘ｯ 'base64' 縺ｮ縺縺壹ｌ縺九〒縺吶 +`encoding` 縺ｯ `'hex'`縲〜'binary'`縲√∪縺溘ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 ### crypto.createHmac(algorithm, key) @@ -113,7 +113,7 @@ Calculates the digest of all of the passed data to the hmac. The `encoding` can be `'hex'`, `'binary'` or `'base64'`. --> 貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ繝繝ｼ繧ｿ縺 HMAC 蛹悶＆繧後◆繝繧､繧ｸ繧ｧ繧ｹ繝医ｒ險育ｮ励＠縺ｾ縺吶 -`encoding` 縺ｯ 'hex'縲'binary'縲√∪縺溘ｯ 'base64' 縺ｮ縺縺壹ｌ縺九〒縺吶 +`encoding` 縺ｯ `'hex'`縲〜'binary'`縲√∪縺溘ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 ### crypto.createCipher(algorithm, key) @@ -127,7 +127,7 @@ Creates and returns a cipher object, with the given algorithm and key. `algorithm` is dependent on OpenSSL, examples are `'aes192'`, etc. On recent releases, `openssl list-cipher-algorithms` will display the available cipher algorithms. --> -`algorithm` 縺ｯ縲＾penSSL 縺ｫ萓晏ｭ倥＠縺ｾ縺吶ゆｾ九∴縺ｰ aes192 縺ｪ縺ｩ縺ｧ縺吶 +`algorithm` 縺ｯ縲＾penSSL 縺ｫ萓晏ｭ倥＠縺ｾ縺吶ゆｾ九∴縺ｰ `'aes192'` 縺ｪ縺ｩ縺ｧ縺吶 譛霑代ｮ繝ｪ繝ｪ繝ｼ繧ｹ縺ｧ縺ｯ縲〜openssl list-cipher-algorithms` 縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ證怜捷繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝縺瑚｡ｨ遉ｺ縺輔ｌ縺ｾ縺吶 @@ -139,9 +139,9 @@ and can be `'utf8'`, `'ascii'` or `'binary'`. The `output_encoding` specifies the output format of the enciphered data, and can be `'binary'`, `'base64'` or `'hex'`. --> `data` 縺ｧ證怜捷繧呈峩譁ｰ縺励∪縺吶 -`input_encoding` 縺ｧ荳弱∴繧峨ｌ繧九お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ 'utf8'縲'ascii'縲'binary' 縺ｮ縺縺壹ｌ縺九〒縺吶 +`input_encoding` 縺ｧ荳弱∴繧峨ｌ繧九お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ `'utf8'`縲〜'ascii'`縲〜'binary'` 縺ｮ縺縺壹ｌ縺九〒縺吶 `output_encoding` 縺ｯ證怜捷蛹悶＆繧後◆繝繝ｼ繧ｿ縺ｮ蜃ｺ蜉帙ヵ繧ｩ繝ｼ繝槭ャ繝医ｒ謖螳壹☆繧九ｂ縺ｮ縺ｧ縲 -'binary'縲'base64' 縺ｾ縺溘ｯ 'hex' 縺ｮ縺縺壹ｌ縺九〒縺吶 +`'utf8'`縲〜'ascii'` 縺ｾ縺溘ｯ `'binary'` 縺ｮ縺縺壹ｌ縺九〒縺吶 證怜捷蛹悶＆繧後◆繧ｳ繝ｳ繝繝ｳ繝縺ｮ谿九ｊ繧定ｿ斐＠縺ｾ縺吶 -`output_encoding` 縺ｯ谺｡縺ｮ縺縺壹ｌ縺九〒縺: 'binary'縲'base64' 縺ｾ縺溘ｯ 'hex' +`output_encoding` 縺ｯ谺｡縺ｮ縺縺壹ｌ縺九〒縺: `'binary'`縲〜'ascii'` 縺ｾ縺溘ｯ `'utf8'` ### crypto.createDecipher(algorithm, key) @@ -171,9 +171,9 @@ This is the mirror of the cipher object above. Updates the decipher with `data`, which is encoded in `'binary'`, `'base64'` or `'hex'`. The `output_decoding` specifies in what format to return the deciphered plaintext: `'binary'`, `'ascii'` or `'utf8'`. --> -'binary'縲'base64' 縺ｾ縺溘ｯ 'hex' 縺ｮ縺縺壹ｌ縺九〒繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆蠕ｩ蜿ｷ繧 `data` 縺ｧ譖ｴ譁ｰ縺励∪縺吶 +`'binary'`縲〜'base64'` 縺ｾ縺溘ｯ `'hex'` 縺ｮ縺縺壹ｌ縺九〒繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆蠕ｩ蜿ｷ繧 `data` 縺ｧ譖ｴ譁ｰ縺励∪縺吶 `output_decoding` 縺ｯ蠕ｩ蜿ｷ蛹悶＆繧後◆繝励Ξ繝ｼ繝ｳ繝繧ｭ繧ｹ繝医ｮ繝輔か繝ｼ繝槭ャ繝医ｒ謖螳壹☆繧九ｂ縺ｮ縺ｧ縲 -'binary'縲'ascii' 縺ゅｋ縺縺ｯ 'utf8' 縺ｮ縺縺壹ｌ縺九〒縺吶 +`'binary'`縲〜'ascii'` 縺ゅｋ縺縺ｯ `'utf8'` 縺ｮ縺縺壹ｌ縺九〒縺吶 ### decipher.final(output_encoding='binary') @@ -182,7 +182,7 @@ Returns any remaining plaintext which is deciphered, with `output_encoding' being one of: `'binary'`, `'ascii'` or `'utf8'`. --> 蠕ｩ蜿ｷ蛹悶＆繧後◆繝励Ξ繝ｼ繝ｳ繝繧ｭ繧ｹ繝医ｮ谿九ｊ繧定ｿ斐＠縺ｾ縺吶 -`output_decoding` 縺ｯ 'binary'縲'ascii' 縺ゅｋ縺縺ｯ 'utf8' 縺ｮ縺縺壹ｌ縺九〒縺吶 +`output_decoding` 縺ｯ `'binary'`縲〜'ascii'` 縺ゅｋ縺縺ｯ `'utf8'` 縺ｮ縺縺壹ｌ縺九〒縺吶 ### crypto.createSign(algorithm) @@ -217,7 +217,7 @@ Calculates the signature on all the updated data passed through the signer. -'binary'縲'hex'縲√≠繧九＞縺ｯ 'base64' 縺ｮ縺縺壹ｌ縺九ｒ謖螳壹＠縺 `output_format` 縺ｫ繧医ｋ鄂ｲ蜷阪ｒ霑斐＠縺ｾ縺吶 +`'binary'`縲〜'hex'`縲√≠繧九＞縺ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九ｒ謖螳壹＠縺 `output_format` 縺ｫ繧医ｋ鄂ｲ蜷阪ｒ霑斐＠縺ｾ縺吶 ### crypto.createVerify(algorithm) @@ -246,7 +246,7 @@ signature for the data, in the `signature_format` which can be `'binary'`, `'hex 鄂ｲ蜷阪＆繧後◆繝繝ｼ繧ｿ繧 `public_key` 縺ｨ `signature` 縺ｧ讀懆ｨｼ縺励∪縺吶 `public_key` 縺ｯ PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆蜈ｬ髢矩嵯繧貞性繧譁蟄怜励〒縺吶 `signature` 縺ｯ蜈医↓險育ｮ励＠縺溘ョ繝ｼ繧ｿ縺ｮ鄂ｲ蜷阪〒縲 -縺昴ｮ `signature_format` 縺ｯ 'binary'縲'hex'縲√∪縺溘ｯ 'base64' 縺ｮ縺縺壹ｌ縺九〒縺吶 +縺昴ｮ `signature_format` 縺ｯ `'binary'`縲〜'hex'`縲√∪縺溘ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 髱槫酔譛溘ｮ lstat(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, stats)`縺ｧ縲 `stats` 縺ｯ `fs.Stats` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 +lstat() 縺ｯ繝代せ縺後す繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ縺縺｣縺溷ｴ蜷医↓縲 +蜿らｧ蜈医ｮ繝輔ぃ繧､繝ｫ縺ｧ縺ｯ縺ｪ縺上◎縺ｮ繝ｪ繝ｳ繧ｯ閾ｪ霄ｫ縺瑚ｪｿ縺ｹ繧峨ｌ繧狗せ繧帝勁縺縺ｦ stat() 縺ｨ蜷後§縺吶 ### fs.fstat(fd, [callback]) diff --git a/doc/api/globals.markdown b/doc/api/globals.markdown index 4c6e8f627956..c6183147342b 100644 --- a/doc/api/globals.markdown +++ b/doc/api/globals.markdown @@ -92,6 +92,6 @@ A reference to the current module. In particular `module.exports` is the same as the `exports` object. See `src/node.js` for more information. --> -迴ｾ蝨ｨ縺ｮ (`process.Module` 蝙九〒縺ゅｋ) 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｸ縺ｮ蜿らｧ縺ｧ縺吶 +迴ｾ蝨ｨ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｸ縺ｮ蜿らｧ縺ｧ縺吶 迚ｹ縺ｫ `module.exports` 縺ｯ `exports` 繧ｪ繝悶ず繧ｧ繧ｯ繝医→蜷後§縺ｧ縺吶 -繧医ｊ隧ｳ縺励￥縺ｯ `src/process.js` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 +繧医ｊ隧ｳ縺励￥縺ｯ `src/node.js` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 diff --git a/doc/api/http.markdown b/doc/api/http.markdown index ea6cbf9a10d3..22a8aa16fbc1 100644 --- a/doc/api/http.markdown +++ b/doc/api/http.markdown @@ -669,7 +669,7 @@ of CA certificates, as given in 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺後そ繧ｭ繝･繧｢縺ｪ蝣ｴ蜷医∬ｨｼ譏取ュ蝣ｱ縺ｧ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌縺梧守､ｺ逧縺ｫ貂｡縺輔ｌ縺ｪ縺縺ｨ縲 node.js 縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ繝ｪ繧ｹ繝医→縺励※ -http://mxr.mozilla.org/mozilla/source/security/nss/lib/ckfw/builtins/certdata.txt 繧剃ｸ弱∴縺ｾ縺吶 + 繧剃ｸ弱∴縺ｾ縺吶 ### client.request(method='GET', path, [request_headers]) @@ -727,8 +727,8 @@ in the context of the defined or default list of trusted CA certificates. Returns a JSON structure detailing the server's certificate, containing a dictionary with keys for the certificate `'subject'`, `'issuer'`, `'valid_from'` and `'valid_to'`. --> -繧ｵ繝ｼ繝占ｨｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵'subject'縲'issuer'縲'valid_from' 縺昴＠縺ｦ -'valid_to' 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 +繧ｵ繝ｼ繝占ｨｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵〜'subject'`縲〜'issuer'`縲〜'valid_from'` 縺昴＠縺ｦ +`'valid_to'` 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 ## http.ClientRequest diff --git a/doc/api/net.markdown b/doc/api/net.markdown index 4e1def987380..d2b20e3dc81b 100644 --- a/doc/api/net.markdown +++ b/doc/api/net.markdown @@ -76,9 +76,12 @@ on port 8124: +`telnet` 繧剃ｽｿ縺｣縺ｦ繝繧ｹ繝医＠縺ｾ縺: telnet localhost 8124 + @@ -86,14 +89,17 @@ changed to server.listen('/tmp/echo.sock'); + +`nc` 繧剃ｽｿ縺｣縺ｦ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医し繝ｼ繝舌∈謗･邯壹＠縺ｾ縺: nc -U /tmp/echo.sock -縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: +`net.Server` 縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: #### server.listen(port, [host], [callback]) @@ -112,9 +118,15 @@ when the server has been bound. --> 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶よ怙蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 + +荳驛ｨ縺ｮ繝ｦ繝ｼ繧ｶ縺碁勍繧句撫鬘後ｮ荳縺､縺ｯ縲〜EADDRINUSE` 繧ｨ繝ｩ繝ｼ縺ｧ縺呻ｼ +縺薙ｌ縺ｯ縲∽ｻ悶ｮ繧ｵ繝ｼ繝舌′隕∵ｱゅ＆繧後◆繝昴ｼ繝医ｒ菴ｿ縺｣縺ｦ縺繧九→縺縺諢丞袖縺ｧ縺吶 +縺薙ｌ縺ｫ蟇ｾ辣ｧ縺吶ｋ譁ｹ豕輔ｮ荳縺､縺ｯ縲1遘貞ｾ讖溘＠縺ｦ繝ｪ繝医Λ繧､縺吶ｋ縺薙→縺ｧ縺吶 +縺薙ｌ縺ｯ谺｡縺ｮ繧医≧縺ｫ縺ｪ繧翫∪縺 server.on('error', function (e) { if (e.errno == require('constants').EADDRINUSE) { @@ -126,7 +138,10 @@ would be to wait a second and the try again. This can be done with } }); + +豕ｨ諢: Node 縺ｮ蜈ｨ縺ｦ縺ｮ繧ｽ繧ｱ繝繝医ｯ SO_REUSEADDR 縺瑚ｨｭ螳壹＆繧後∪縺) #### server.listen(path, [callback]) @@ -282,8 +297,11 @@ the exception. 謗･邯壹〒蝠城｡後′縺ゅ▲縺溷ｴ蜷医ｯ `'connect'` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後★縲 萓句､悶→縺ｨ繧ゅ↓ `'error'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 + +`callback` 蠑墓焚縺ｯ 'connect' 繧､繝吶Φ繝医ｮ繝ｪ繧ｹ繝翫↓蜉縺医ｉ繧後∪縺吶 #### stream.setEncoding(encoding=null) @@ -330,8 +348,8 @@ context of the defined or default list of trusted CA certificates. Returns a JSON structure detailing the peer's certificate, containing a dictionary with keys for the certificate `'subject'`, `'issuer'`, `'valid_from'` and `'valid_to'`. --> -逶ｸ謇九ｮ險ｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵'subject'縲'issuer'縲'valid_from' -縺昴＠縺ｦ 'valid_to' 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 +逶ｸ謇九ｮ險ｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵〜'subject'`縲〜'issuer'`縲〜'valid_from'` +縺昴＠縺ｦ `'valid_to'` 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 #### stream.write(data, [encoding], [callback]) @@ -339,7 +357,7 @@ with keys for the certificate `'subject'`, `'issuer'`, `'valid_from'` and `'vali Sends data on the stream. The second parameter specifies the encoding in the case of a string--it defaults to UTF8 encoding. -->繧ｹ繝医Μ繝ｼ繝縺ｫ繝繝ｼ繧ｿ繧帝∽ｿ｡縺励∪縺吶 -譁蟄怜励ｮ蝣ｴ蜷医∫ｬｬ 2 蠑墓焚縺ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧呈欠螳壹＠縺ｾ縺 ｼ UTF8 縺ｯ繧医ｊ驕縺縺溘ａ縲√ョ繝輔か繝ｫ繝医ｯ ASCII 縺ｧ縺吶 +譁蟄怜励ｮ蝣ｴ蜷医∫ｬｬ 2 蠑墓焚縺ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧呈欠螳壹＠縺ｾ縺 ｼ 繝繝輔か繝ｫ繝医ｯ UTF-8 縺ｧ縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｮ `callback` 蠑墓焚縺ｯ繝繝ｼ繧ｿ縺梧怙邨ら噪縺ｫ蜃ｺ蜉帙＆繧後◆譎ゅ↓螳溯｡後＆繧後∪縺 +ｼ 縺薙ｌ縺ｯ縺吶＄縺ｫ縺ｯ襍ｷ縺阪↑縺縺ｧ縺励ｇ縺縲 #### stream.write(data, [encoding], [fileDescriptor], [callback]) + +UNIX 繧ｽ繧ｱ繝繝医ｮ蝣ｴ蜷医√ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺吶ｋ縺薙→縺後〒縺阪∪縺吶 +蜊倡ｴ斐↓ `fileDescriptor` 蠑墓焚繧貞刈縺医ｋ縺薙→縺ｧ縲∫嶌謇句ｴ縺ｫ縺ｯ `'fd'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 #### stream.end([data], [encoding]) @@ -367,8 +393,7 @@ Half-closes the stream. I.E., it sends a FIN packet. It is possible the server will still send some data. --> 繧ｹ繝医Μ繝ｼ繝繧偵ワ繝ｼ繝輔け繝ｭ繝ｼ繧ｺ縺励∪縺吶ゆｾ九∴縺ｰ FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励∪縺吶 -繧ｵ繝ｼ繝舌′繝繝ｼ繧ｿ繧帝√ｊ邯壹¢縺ｦ縺上ｋ縺薙→縺後≠繧雁ｾ励∪縺吶 -縺薙ｮ繝｡繧ｽ繝繝峨ｒ蜻ｼ縺ｳ蜃ｺ縺励◆蠕後ｮ `readyState` 縺ｯ `'readOnly'` 縺ｫ縺ｪ繧翫∪縺吶 +繧ｵ繝ｼ繝舌ｯ縺ｾ縺繝繝ｼ繧ｿ繧帝√ｊ邯壹¢縺ｦ縺上ｋ縺薙→縺後〒縺阪∪縺吶 +`require('os')` 縺ｫ繧医▲縺ｦ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 ### os.getHostname() + +繧ｪ繝壹Ξ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺ｮ繝帙せ繝亥錐繧定ｿ斐＠縺ｾ縺吶 diff --git a/doc/api/repl.markdown b/doc/api/repl.markdown index dd23136cc314..ccf5baa595e0 100644 --- a/doc/api/repl.markdown +++ b/doc/api/repl.markdown @@ -51,7 +51,7 @@ is optional and defaults to `> `. `stream` is optional and defaults to `process.openStdin()`. --> `prompt` 縺ｧ繝励Ο繝ｳ繝励ヨ險伜捷繧偵 `stream` 縺ｧ I/O 繧貞ｼ墓焚縺ｫ蜿悶▲縺ｦ REPL 繧定ｵｷ蜍輔＠縺ｾ縺吶 -`prompt` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `node> ` 縺ｧ縺吶 +`prompt` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `> ` 縺ｧ縺吶 `stream` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `process.openStdin()`縺ｧ縺吶 -* `.break` - 隍謨ｰ陦後↓貂｡縺｣縺ｦ蠑上ｒ蜈･蜉帙＠縺ｦ縺繧矩俣縺ｫ縲騾比ｸｭ縺ｧ蛻縺九ｉ縺ｪ縺上↑縺｣縺溘ｊ螳御ｺ縺輔○縺ｪ縺上※繧り憶縺上↑繧九％縺ｨ縺後≠繧翫∪縺吶Ａ.break` 縺ｧ譛蛻昴°繧峨ｄ繧顔峩縺励∪縺吶 -* `.clear` - `context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ遨ｺ縺ｮ迥ｶ諷九↓繝ｪ繧ｻ繝繝医＠縲∬､謨ｰ陦後↓蜈･蜉帙＠縺ｦ縺繧句ｼ上ｒ繧ｯ繝ｪ繧｢縺励∪縺吶 -* `.exit` - I/O繧ｹ繝医Μ繝ｼ繝繧帝哩縺倥ヽEPL繧堤ｵゆｺ縺輔○縺ｾ縺吶 -* `.help` - 縺薙ｮ繧ｳ繝槭Φ繝峨ｮ荳隕ｧ繧定｡ｨ遉ｺ縺励∪縺吶 + - `.break` - 隍謨ｰ陦後↓貂｡縺｣縺ｦ蠑上ｒ蜈･蜉帙＠縺ｦ縺繧矩俣縺ｫ縲騾比ｸｭ縺ｧ蛻縺九ｉ縺ｪ縺上↑縺｣縺溘ｊ螳御ｺ縺輔○縺ｪ縺上※繧り憶縺上↑繧九％縺ｨ縺後≠繧翫∪縺吶Ａ.break` 縺ｧ譛蛻昴°繧峨ｄ繧顔峩縺励∪縺吶 + - `.clear` - `context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ遨ｺ縺ｮ迥ｶ諷九↓繝ｪ繧ｻ繝繝医＠縲∬､謨ｰ陦後↓蜈･蜉帙＠縺ｦ縺繧句ｼ上ｒ繧ｯ繝ｪ繧｢縺励∪縺吶 + - `.exit` - I/O繧ｹ繝医Μ繝ｼ繝繧帝哩縺倥ヽEPL繧堤ｵゆｺ縺輔○縺ｾ縺吶 + - `.help` - 縺薙ｮ繧ｳ繝槭Φ繝峨ｮ荳隕ｧ繧定｡ｨ遉ｺ縺励∪縺吶 diff --git a/doc/api/streams.markdown b/doc/api/streams.markdown index ec88d328f020..e5c2b00211f6 100644 --- a/doc/api/streams.markdown +++ b/doc/api/streams.markdown @@ -117,30 +117,53 @@ Closes the underlying file descriptor. Stream will not emit any more events. ### stream.pipe(destination, [options]) + +縺薙ｌ縺ｯ蜈ｨ縺ｦ縺ｮ `Stream` 縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ `Stream.prototype` 繝｡繧ｽ繝繝峨〒縺吶 + +隱ｭ縺ｿ霎ｼ縺ｿ繧ｹ繝医Μ繝ｼ繝繧 `destination` 縺ｮ譖ｸ縺崎ｾｼ縺ｿ繧ｹ繝医Μ繝ｼ繝縺ｫ謗･邯壹＠縺ｾ縺吶 +縺薙ｮ繧ｹ繝医Μ繝ｼ繝縺ｫ蜈･縺｣縺ｦ縺阪◆繝繝ｼ繧ｿ縺ｯ `destination` 縺ｫ譖ｸ縺崎ｾｼ縺ｾ繧後∪縺吶 +謗･邯壼医→謗･邯壼縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｯ縲∝ｿ隕√↓蠢懊§縺ｦ荳ｭ譁ｭ縺ｨ蜀埼幕縺吶ｋ縺薙→縺ｧ蜷梧悄繧剃ｿ昴■縺ｾ縺吶 + +Unix 縺ｮ `cat` 繧ｳ繝槭Φ繝峨ｮ繧ｨ繝溘Η繝ｬ繝ｼ繝: process.openStdin().pipe(process.stdout); + +繝繝輔か繝ｫ繝医〒縺ｯ謗･邯壼繧ｹ繝医Μ繝ｼ繝縺ｧ `end` 繧､繝吶Φ繝医′逕滓舌＆繧後ｋ縺ｨ縲 +謗･邯壼医ｮ `end()` 縺悟他縺ｰ繧後ｋ縺ｮ縺ｧ縲√ｂ縺譖ｸ縺崎ｾｼ縺ｿ縺ｯ縺ｧ縺阪∪縺帙ｓ縲 +`option` 縺ｫ `{ end: false }` 繧呈ｸ｡縺吶→謗･邯壼医ｯ繧ｹ繝医Μ繝ｼ繝縺ｯ繧ｪ繝ｼ繝励Φ縺輔ｌ縺溘∪縺ｾ縺ｨ縺ｪ繧翫∪縺吶 + +縺薙ｌ縺ｯ `process.stdout` 繧偵が繝ｼ繝励Φ縺励◆縺ｾ縺ｾ縺ｫ縺励※譛蠕後↓ "Goodbye" 縺ｨ蜃ｺ蜉帙＠縺ｾ縺吶 var stdin = process.openStdin(); stdin.pipe(process.stdout, { end: false }); stdin.on("end", function() { process.stdout.write("Goodbye\n"); }); + +豕ｨ諢: 繧ゅ＠謗･邯壼繧ｹ繝医Μ繝ｼ繝縺 `pauses()` 縺ｨ `resume()` 繧偵し繝昴ｼ繝医＠縺ｪ縺蝣ｴ蜷医 +縺薙ｮ髢｢謨ｰ縺ｯ蜊倥↓ `'pause'` 縺ｨ `'resume'` 繧､繝吶Φ繝医ｒ謗･邯壹ｂ縺ｨ繧ｹ繝医Μ繝ｼ繝縺ｧ逕滓舌＠縺ｾ縺吶 ## Writable Stream diff --git a/doc/api/tls.markdown b/doc/api/tls.markdown index d9aec2a73c79..35bbdc7ec159 100644 --- a/doc/api/tls.markdown +++ b/doc/api/tls.markdown @@ -1,37 +1,72 @@ ## TLS (SSL) + +`require('tls')` 縺ｧ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 + +`tls` 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ OpenSSL 繧剃ｽｿ逕ｨ縺吶ｋ縺薙→縺ｧ Transport Layer Security 縺翫ｈ縺ｳ +Secure Socket Layer: 證怜捷蛹悶＆繧後◆繧ｹ繝医Μ繝ｼ繝騾壻ｿ｡繧呈署萓帙＠縺ｾ縺吶 + +TLS/SSL 縺ｯ蜈ｬ髢具ｼ冗ｧ伜ｯ骰ｵ繧貞渕遉弱→縺励∪縺吶 +縺ｩ縺ｮ繧ｯ繝ｩ繧､繧｢繝ｳ繝医→繧ｵ繝ｼ繝舌ｂ遘伜ｯ骰ｵ縺悟ｿ隕√〒縺吶 +遘伜ｯ骰ｵ縺ｯ谺｡縺ｮ繧医≧縺ｫ菴懈舌＠縺ｾ縺 openssl genrsa -out ryans-key.pem 1024 + +蜈ｨ縺ｦ縺ｮ繧ｵ繝ｼ繝舌→荳驛ｨ縺ｮ繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ險ｼ譏取嶌繧貞ｿ隕√→縺励∪縺吶 +險ｼ譏取嶌縺ｯ隱崎ｨｼ螻縺ｮ蜈ｬ髢矩嵯縺ｾ縺溘ｯ閾ｪ霄ｫ縺ｫ繧医▲縺ｦ鄂ｲ蜷阪＆繧後∪縺吶 +險ｼ譏取嶌繧剃ｽ懈舌☆繧区怙蛻昴ｮ繧ｹ繝繝繝励ｯ縲瑚ｨｼ譏取嶌鄂ｲ蜷崎ｦ∵ｱ (CSR)縲阪ヵ繧｡繧､繝ｫ縺ｧ縺吶 +谺｡縺ｮ繧医≧縺ｫ縺励∪縺: openssl req -new -key ryans-key.pem -out ryans-csr.pem + +CSR 縺九ｉ閾ｪ蟾ｱ鄂ｲ蜷崎ｨｼ譏取嶌繧剃ｽ懈舌☆繧九↓縺ｯ谺｡縺ｮ繧医≧縺ｫ縺励∪縺: openssl x509 -req -in ryans-csr.pem -signkey ryans-key.pem -out ryans-cert.pem + +莉悶↓ CSR 繧定ｪ崎ｨｼ螻縺ｫ騾√▲縺ｦ鄂ｲ蜷阪＠縺ｦ繧ゅｉ縺縺薙→繧ゅ〒縺阪∪縺吶 + +(TODO: CA 繧剃ｽ懊ｋ繝峨く繝･繝｡繝ｳ繝医∫樟蝨ｨ縺ｯ闊亥袖縺ゅｋ繝ｦ繝ｼ繧ｶ縺ｯ Node 縺ｮ繧ｽ繝ｼ繧ｹ繧ｳ繝ｼ繝峨°繧 +`test/fixtures/keys/Makefile` 繧定ｦ九ｋ蠢隕√′縺ゅｋ) ### s = tls.connect(port, [host], [options], callback) + +荳弱∴繧峨ｌ縺 `port` 縺ｨ `host` 縺ｧ譁ｰ縺励＞繧ｯ繝ｩ繧､繧｢繝ｳ繝医さ繝阪け繧ｷ繝ｧ繝ｳ繧剃ｽ懈舌＠縺ｾ縺 +(`host` 縺ｮ繝繝輔か繝ｫ繝医ｯ `localhost` 縺ｧ縺)縲 +`options` 縺ｯ莉･荳九ｒ謖螳壹＠縺溘が繝悶ず繧ｧ繧ｯ繝医〒縺吶 + + + - `key`: PEM 繝輔か繝ｼ繝槭ャ繝医↓繧医ｋ繧ｵ繝ｼ繝舌ｮ遘伜ｯ骰ｵ繧呈戟縺､譁蟄怜励∪縺溘ｯ `Buffer` 縺ｧ縺 (蠢鬆)縲 + + - `cert`: PEM 繝輔か繝ｼ繝槭ャ繝医↓繧医ｋ險ｼ譏取嶌縺ｮ骰ｵ繧呈戟縺､譁蟄怜励∪縺溘ｯ `Buffer` 縺ｧ縺吶 + - `ca`: 菫｡鬆ｼ縺ｧ縺阪ｋ險ｼ譏取嶌縺ｮ譁蟄怜励∪縺溘ｯ `Buffer` 縺ｮ驟榊励〒縺吶 + 逵∫払縺輔ｌ縺溷ｴ蜷医√吶Μ繧ｵ繧､繝ｳ縺ｪ縺ｩ縺ｮ繧医￥遏･繧峨ｌ縺溘後Ν繝ｼ繝医崎ｪ崎ｨｼ螻縺御ｽｿ繧上ｌ縺ｾ縺吶 + 縺薙ｌ繧峨ｯ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ隱崎ｨｼ縺ｫ菴ｿ繧上ｌ縺ｾ縺吶 + + +`tls.connect()` 縺ｯ蟷ｳ譁縺ｮ `CryptoStream` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 + +TLS/SSL 繝上Φ繝峨す繧ｧ繝ｼ繧ｯ縺ｮ蠕後〒 `callback` 縺悟他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 +`callback` 縺ｯ險ｼ譏取嶌縺後し繝ｼ繝舌↓隱崎ｨｼ縺輔ｌ縺溘°縺ｩ縺縺九↓髢｢繧上ｉ縺壼他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 +繧ｵ繝ｼ繝占ｨｼ譏取嶌縺梧欠螳壹＠縺溯ｪ崎ｨｼ螻縺ｫ謇ｿ隱阪＆繧後◆縺九メ繧ｧ繝繧ｯ縺吶ｋ縺溘ａ縺ｫ +`s.authorized` 繧堤｢ｺ隱阪☆繧九°縺ｯ繝ｦ繝ｼ繧ｶ谺｡隨ｬ縺ｧ縺吶 +`s.authorized === false`縺ｮ蝣ｴ蜷医〜s.authorizationError` 縺九ｉ繧ｨ繝ｩ繝ｼ繧定ｦ九▽縺代ｋ縺薙→縺後〒縺阪∪縺吶 ### tls.Server + +縺薙ｮ繧ｯ繝ｩ繧ｹ縺ｯ `net.Server` 縺ｮ繧ｵ繝悶け繝ｩ繧ｹ縺ｧ縲∝酔縺倥Γ繧ｽ繝繝峨ｒ謖√▲縺ｦ縺縺ｾ縺吶 +逕溘ｮ TCP 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺大･繧後ｋ莉｣繧上ｊ縺ｫ縲 +TLS 縺ｾ縺溘ｯ SSL 繧剃ｽｿ縺｣縺滓囓蜿ｷ蛹悶＆繧後◆繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺台ｻ倥¢縺ｾ縺吶 + +縺薙ｌ縺ｯ繧ｷ繝ｳ繝励Ν縺ｪ繧ｨ繧ｳ繝ｼ繧ｵ繝ｼ繝舌ｮ萓九〒縺吶 var tls = require('tls'); var fs = require('fs'); @@ -73,7 +133,10 @@ Here is a simple example echo server: }).listen(8000); + +縺薙ｮ繧ｵ繝ｼ繝舌ｒ繝繧ｹ繝医☆繧九◆繧√↓ `openssl s_client` 縺ｧ謗･邯壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 openssl s_client -connect 127.0.0.1:8000 @@ -81,9 +144,14 @@ You can test this server by connecting to it with `openssl s_client`: #### tls.createServer(options, secureConnectionListener) + +`tls.Server` 繧ｯ繝ｩ繧ｹ縺ｮ繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ縺ｧ縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ莉･荳九ｒ謖√▽縺薙→縺後〒縺阪∪縺吶 + + - `key`: PEM 繝輔か繝ｼ繝槭ャ繝医↓繧医ｋ繧ｵ繝ｼ繝舌ｮ遘伜ｯ骰ｵ繧呈戟縺､譁蟄怜励∪縺溘ｯ `Buffer` 縺ｧ縺 (蠢鬆)縲 + + - `cert`: PEM 繝輔か繝ｼ繝槭ャ繝医↓繧医ｋ險ｼ譏取嶌縺ｮ骰ｵ繧呈戟縺､譁蟄怜励∪縺溘ｯ `Buffer` 縺ｧ縺 (蠢鬆)縲 + + - `ca`: 菫｡鬆ｼ縺ｧ縺阪ｋ險ｼ譏取嶌縺ｮ譁蟄怜励∪縺溘ｯ `Buffer` 縺ｮ驟榊励〒縺吶 + 逵∫払縺輔ｌ縺溷ｴ蜷医√吶Μ繧ｵ繧､繝ｳ縺ｪ縺ｩ縺ｮ繧医￥遏･繧峨ｌ縺溘後Ν繝ｼ繝医崎ｪ崎ｨｼ螻縺御ｽｿ繧上ｌ縺ｾ縺吶 + 縺薙ｌ繧峨ｯ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ隱崎ｨｼ縺ｫ菴ｿ繧上ｌ縺ｾ縺吶 + + - `requestCert`: `true` 縺ｮ蝣ｴ蜷医√し繝ｼ繝舌ｯ謗･邯壹＠繧医≧縺ｨ縺吶ｋ繧ｯ繝ｩ繧､繧｢繝ｳ繝医°繧峨ｮ險ｼ譏取嶌繧定ｦ∵ｱゅ＠縺ｾ縺 + 繝繝輔か繝ｫ繝医ｯ `false` 縺ｧ縺吶 + + - `rejectUnauthorized`: `true` 縺ｮ蝣ｴ蜷医 + 繧ｵ繝ｼ繝舌ｯ謠蝉ｾ帙＆繧後◆隱崎ｨｼ螻縺ｮ繝ｪ繧ｹ繝医↓繧医▲縺ｦ隱崎ｨｼ縺輔ｌ縺ｦ縺縺ｪ縺繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧堤ｴ譽縺励∪縺呻ｼ + 縺薙ｮ繧ｪ繝励す繝ｧ繝ｳ縺ｯ `requestCert` 縺 `true` 縺ｮ蝣ｴ蜷医□縺大柑譫懊′縺ゅｊ縺ｾ縺吶 + 繝繝輔か繝ｫ繝医ｯ `false` 縺ｧ縺吶 #### Event: 'secureConnection' `function (cleartextStream) {}` + +縺薙ｮ繧､繝吶Φ繝医ｯ縲∵眠縺励＞謗･邯壹ｮ繝上Φ繝峨す繧ｧ繝ｼ繧ｯ縺梧仙粥縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 +蠑墓焚縺ｯ `stream.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 +縺薙ｌ縺ｯ繧ｹ繝医Μ繝ｼ繝縺ｫ蜈ｱ騾壹☆繧句ｨ縺ｦ縺ｮ繝｡繧ｽ繝繝峨→繧､繝吶Φ繝医ｒ謖√▲縺ｦ縺縺ｾ縺吶 + +`cleartextStream.authorized` 縺ｯ謠蝉ｾ帙＆繧後◆隱崎ｨｼ螻縺ｮ縺縺壹ｌ縺九↓繧医▲縺ｦ隱崎ｨｼ縺輔ｌ縺溘°繧堤､ｺ縺 boolean 蛟､縺ｧ縺吶 +`cleartextStream.authorized` 縺 false 縺ｮ蝣ｴ蜷医 +`cleartextStream.authorizationError` 縺ｫ縺ｯ縺ｩ縺ｮ繧医≧縺ｫ隱崎ｨｼ縺悟､ｱ謨励＠縺溘ｮ縺九′險ｭ螳壹＆繧後∪縺吶 +證鈴ｻ咏噪縺ｧ縺吶′險蜿翫☆繧倶ｾ｡蛟､縺ｮ縺ゅｋ縺薙→: +TLS 繧ｵ繝ｼ繝舌ｮ險ｭ螳壹↓萓晏ｭ倥＠縺ｾ縺吶′縲∬ｪ崎ｨｼ縺輔ｌ縺ｦ縺縺ｪ縺繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧ょ女縺大･繧後ｉ繧後ｋ縺薙→縺後≠繧翫∪縺吶 #### server.listen(port, [host], [callback]) + +謖螳壹ｮ `port` 縺ｨ `host` 縺ｧ謗･邯壹ｮ蜿励¢蜈･繧後ｒ髢句ｧ九＠縺ｾ縺吶 +`host` 縺檎怐逡･縺輔ｌ繧九→縲√し繝ｼ繝舌ｯ縺ｩ繧薙↑ IPv4 繧｢繝峨Ξ繧ｹ縺九ｉ縺ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧ょ女縺大･繧後∪縺 (`INADDR_ANY`)縲 + +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶 +譛蠕後ｮ蠑墓焚 `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨＆繧後ｋ縺ｨ蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 + +繧医ｊ隧ｳ邏ｰ縺ｯ `net.Server` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 #### server.close() + +繧ｵ繝ｼ繝舌′譁ｰ縺励＞謗･邯壹ｒ蜿励¢蜈･繧後ｋ縺薙→繧堤ｵゆｺ縺励∪縺吶 +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縲√し繝ｼ繝舌′譛邨ら噪縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ繧九→繧ｵ繝ｼ繝舌ｯ `'close'` 繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺吶 #### server.maxConnections + +縺薙ｮ繝励Ο繝代ユ繧｣繧定ｨｭ螳壹☆繧九→縲√し繝ｼ繝舌ｮ謗･邯壽焚縺後％繧後ｒ雜翫∴縺溷ｴ蜷医↓謗･邯壹ｒ遐ｴ譽縺励∪縺吶 #### server.connections + +繧ｵ繝ｼ繝舌ｮ荳ｦ陦後さ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ謨ｰ縺ｧ縺吶 diff --git a/doc/api/tty.markdown b/doc/api/tty.markdown index 5a6ae7923a78..52cc6a12b643 100644 --- a/doc/api/tty.markdown +++ b/doc/api/tty.markdown @@ -1,36 +1,61 @@ ## TTY + +`require('tty')` 縺ｧ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 ### tty.open(path, args=[]) + +`path 縺ｧ謖螳壹＆繧後◆螳溯｡後ヵ繧｡繧､繝ｫ縺九ｉ譁ｰ縺励＞繝励Ο繧ｻ繧ｹ繧呈眠縺励＞逍台ｼｼ遶ｯ譛ｫ縺ｮ繧ｻ繝繧ｷ繝ｧ繝ｳ繝ｪ繝ｼ繝縺ｨ縺励※襍ｷ蜍輔＠縺ｾ縺吶 + +驟榊 `[slaveFD, childProcess]` 繧定ｿ斐＠縺ｾ縺吶 +`slaveFD` 縺ｯ逍台ｼｼ遶ｯ譛ｫ縺ｮ繧ｹ繝ｬ繝ｼ繝門ｴ縺ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌〒縺吶 +`childProcess` 縺ｯ蟄舌励Ο繧ｻ繧ｹ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### tty.isatty(fd) + +`fd` 縺檎ｫｯ譛ｫ縺ｫ髢｢騾｣縺･縺代ｉ繧後※縺繧九°縺ｩ縺縺九ｒ `true` 縺ｾ縺溘ｯ `false` 縺ｧ霑斐＠縺ｾ縺吶 ### tty.setRawMode(mode) + +`mode` 縺ｯ `true` 縺ｾ縺溘ｯ `false` 縺ｧ縺吶 +縺薙ｌ縺ｯ迴ｾ蝨ｨ縺ｮ繝励Ο繧ｻ繧ｹ縺ｮ讓呎ｺ門･蜉帙ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繝ｭ繝ｼ繝繝舌う繧ｹ縺ｾ縺溘ｯ繝繝輔か繝ｫ繝医↓謖ｯ繧玖槭≧繧医≧險ｭ螳壹＠縺ｾ縺吶 ### tty.getColumns() + +迴ｾ蝨ｨ縺ｮ繝励Ο繧ｻ繧ｹ縺ｫ髢｢騾｣縺･縺代ｉ繧後◆ TTY 縺ｮ繧ｫ繝ｩ繝謨ｰ繧定ｿ斐＠縺ｾ縺吶 + +縺薙ｮ謨ｰ縺ｯ繝励Ο繧ｻ繧ｹ縺 `SIGWINCH` 繧貞女菫｡縺吶ｋ蠎ｦ縺ｫ螟牙喧縺吶ｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +谺｡縺ｮ繧医≧縺ｫ繧ｭ繝｣繝繧ｷ繝･繧剃ｿ晄戟縺吶ｋ縺薙→縺後〒縺阪∪縺吶 var columns = tty.getColumns(); process.on('SIGWINCH', function() { diff --git a/doc/api/util.markdown b/doc/api/util.markdown index bdbf3623abe3..9199ecd5f14e 100644 --- a/doc/api/util.markdown +++ b/doc/api/util.markdown @@ -92,13 +92,23 @@ when an error occurs. ### util.inherits(constructor, superConstructor) + +縺ゅｋ +[繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Object/constructor) +縺九ｉ繝励Ο繝医ち繧､繝励Γ繧ｽ繝繝峨ｒ邯呎価縺励∪縺吶 +`constructor` 縺ｮ繝励Ο繝医ち繧､繝励ｯ `superConstructor` 縺九ｉ菴懊ｉ繧後◆繧ｪ繝悶ず繧ｧ繧ｯ繝医↓險ｭ螳壹＆繧後∪縺吶 + +縺輔ｉ縺ｪ繧句茜萓ｿ諤ｧ縺ｮ縺溘ａ縺ｫ縲〜superConstructor` 縺ｯ `constructor.super_` +繝励Ο繝代ユ繧｣繧帝壹§縺ｦ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪ｋ繧医≧縺ｫ縺ｪ繧翫∪縺吶 var util = require("util"); var events = require("events"); From f1d95470d85f961120d8c3748d6a56933e8c304b Mon Sep 17 00:00:00 2001 From: koichik Date: Sat, 18 Dec 2010 19:51:32 +0900 Subject: [PATCH 30/40] =?UTF-8?q?=E6=9C=AC=E5=AE=B6=E3=81=8B=E3=82=89?= =?UTF-8?q?=E3=83=9E=E3=83=BC=E3=82=B8=E3=81=99=E3=82=8B=E9=9A=9B=E3=81=AB?= =?UTF-8?q?=E3=82=B3=E3=83=B3=E3=83=95=E3=83=AA=E3=82=AF=E3=83=88=E3=81=97?= =?UTF-8?q?=E3=81=AB=E3=81=8F=E3=81=84=E3=82=88=E3=81=86=EF=BC=8C=E5=8E=9F?= =?UTF-8?q?=E6=96=87=E3=81=AE=E5=89=8D=E5=BE=8C=E3=81=AB=E7=A9=BA=E8=A1=8C?= =?UTF-8?q?=E3=82=92=E6=8C=BF=E5=85=A5=EF=BC=8E=E5=8A=B9=E6=9E=9C=E3=81=AF?= =?UTF-8?q?=E4=B8=8D=E6=98=8E=E3=81=A0=E3=81=91=E3=81=A9=EF=BC=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/api/_toc.markdown | 2 + doc/api/addons.markdown | 28 +++++ doc/api/appendix_1.markdown | 6 + doc/api/assert.markdown | 30 +++++ doc/api/buffers.markdown | 44 +++++++ doc/api/child_processes.markdown | 50 ++++++++ doc/api/crypto.markdown | 60 ++++++++++ doc/api/dgram.markdown | 40 +++++++ doc/api/dns.markdown | 36 ++++++ doc/api/events.markdown | 26 ++++ doc/api/fs.markdown | 156 ++++++++++++++++++++++++ doc/api/globals.markdown | 24 ++++ doc/api/http.markdown | 198 +++++++++++++++++++++++++++++++ doc/api/modules.markdown | 30 +++++ doc/api/net.markdown | 128 ++++++++++++++++++++ doc/api/os.markdown | 4 + doc/api/path.markdown | 26 ++++ doc/api/process.markdown | 79 ++++++++++++ doc/api/querystring.markdown | 14 +++ doc/api/repl.markdown | 30 +++++ doc/api/streams.markdown | 60 ++++++++++ doc/api/synopsis.markdown | 6 + doc/api/timers.markdown | 8 ++ doc/api/tls.markdown | 48 ++++++++ doc/api/tty.markdown | 14 +++ doc/api/url.markdown | 14 +++ doc/api/util.markdown | 24 ++++ doc/api/vm.markdown | 34 ++++++ 28 files changed, 1219 insertions(+) diff --git a/doc/api/_toc.markdown b/doc/api/_toc.markdown index e42f98f6dbe7..134f7ce81cd1 100644 --- a/doc/api/_toc.markdown +++ b/doc/api/_toc.markdown @@ -1,6 +1,7 @@ ## Table of Contents * [讎りｦ‐(synopsis.html) * [繧ｰ繝ｭ繝ｼ繝舌Ν](globals.html) diff --git a/doc/api/addons.markdown b/doc/api/addons.markdown index cf24f1bfd6a0..4d7d056536e2 100644 --- a/doc/api/addons.markdown +++ b/doc/api/addons.markdown @@ -1,18 +1,22 @@ ## Addons 繧｢繝峨が繝ｳ縺ｯ蜍慕噪縺ｫ蜈ｱ譛峨が繝悶ず繧ｧ繧ｯ繝医ｒ繝ｪ繝ｳ繧ｯ縺励∪縺吶 縺昴ｌ繧峨ｯ縲， 繧 C++ 縺ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｫ謗･蜷育せ繧呈署萓帙＠縺ｾ縺吶 API 縺ｯ縺縺上▽縺九ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｮ遏･隴倥′蠢隕√〒縲(迴ｾ譎らせ縺ｧ縺ｯ) 縺九↑繧願､髮代〒縺吶 - V8 JavaScript 縺ｯ C++ 縺ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｧ縺吶 JavaScript 縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝井ｽ懈舌ｄ髢｢謨ｰ蜻ｼ縺ｳ蜃ｺ縺礼ｭ峨ｮ繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｫ菴ｿ逕ｨ縺輔ｌ縺ｾ縺吶 @@ -20,11 +24,13 @@ API 縺ｯ縺縺上▽縺九ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｮ遏･隴倥′蠢隕√〒縲(迴ｾ譎らせ縺ｧ縺ｯ) (Node 縺ｮ繧ｽ繝ｼ繧ｹ繝繝ｪ繝ｼ縺ｮ荳ｭ縺ｮ `deps/v8/include/v8.h`) 縺ｫ險倥＆繧後※縺縺ｾ縺吶 - libev 縺ｯ C 縺ｮ event loop 繝ｩ繧､繝悶Λ繝ｪ縺ｧ縺吶 繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌′隱ｭ縺ｿ蜿悶ｊ蜿ｯ閭ｽ縺ｫ縺ｪ繧九ｮ繧貞ｾ縺､縺ｨ縺阪√ち繧､繝槭ｼ繧貞ｾ縺､縺ｨ縺阪√す繧ｰ繝翫Ν繧貞女菫｡縺吶ｋ縺ｮ繧貞ｾ縺､縺ｨ縺阪ｯ縺縺､縺ｧ繧ゅ @@ -34,10 +40,12 @@ API 縺ｯ縺縺上▽縺九ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｮ遏･隴倥′蠢隕√〒縲(迴ｾ譎らせ縺ｧ縺ｯ) 繝峨く繝･繝｡繝ｳ繝医ｯ縲ー縺薙■繧云(http:/cvs.schmorp.de/libev/ev.html) 縺ｫ縺ゅｊ縺ｾ縺吶 - libeio 縺ｯ C 縺ｮ繧ｹ繝ｬ繝繝峨励ｼ繝ｫ繝ｩ繧､繝悶Λ繝ｪ縺ｧ縺吶 繝悶Ο繝繧ｯ縺吶ｋ POSIX 繧ｷ繧ｹ繝繝繧ｳ繝ｼ繝ｫ繧帝撼蜷梧悄縺ｫ螳溯｡後☆繧九◆繧√↓菴ｿ逕ｨ縺輔ｌ縺ｾ縺吶 @@ -46,36 +54,46 @@ API 縺ｯ縺縺上▽縺九ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｮ遏･隴倥′蠢隕√〒縲(迴ｾ譎らせ縺ｧ縺ｯ) 蠢隕√↓縺ｪ縺｣縺溘ｉ縲〜deps/libeio/eio.h` 縺ｮ繝倥ャ繝繝輔ぃ繧､繝ｫ繧貞盾辣ｧ縺励※荳九＆縺縲 - Node 縺ｮ蜀驛ｨ繝ｩ繧､繝悶Λ繝ｪ縲 繧ゅ▲縺ｨ繧る崎ｦ√↑縺ｮ縺ｯ `node::ObjectWrap` 繧ｯ繝ｩ繧ｹ縺ｧ縲 縺薙ｮ繧ｯ繝ｩ繧ｹ縺九ｉ豢ｾ逕溘＆縺帙ｋ縺薙→縺悟､壹￥縺ｪ繧九〒縺励ｇ縺縲 - 縺昴ｮ莉悶ゅ←縺ｮ繧医≧縺ｪ迚ｩ縺悟茜逕ｨ縺ｧ縺阪ｋ縺九ｯ `deps/` 莉･荳九ｒ蜿らｧ縺励※縺輔＞縲 Node 縺ｯ蜈ｨ縺ｦ縺ｮ萓晏ｭ倥Λ繧､繝悶Λ繝ｪ繧貞ｮ溯｡後ヵ繧｡繧､繝ｫ縺ｫ髱咏噪縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励∪縺吶 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繧ｳ繝ｳ繝代う繝ｫ譎ゅ↓縺ｯ縲√◎繧後ｉ縺ｮ繝ｪ繝ｳ繧ｯ縺ｫ縺､縺縺ｦ荳蛻豌励↓縺吶ｋ蠢隕√ｯ譛峨ｊ縺ｾ縺帙ｓ縲 縺ｧ縺ｯ縲 C++ 縺ｧ莉･荳九ｮ讒倥↓蜍穂ｽ懊☆繧句ｰ上＆縺ｪ繧｢繝峨が繝ｳ繧剃ｽ懈舌＠縺ｦ縺ｿ縺ｾ縺励ｇ縺縲 exports.hello = 'world'; 縺ｾ縺 `hello.cc` 縺ｨ縺縺繝輔ぃ繧､繝ｫ繧剃ｽ懈舌＠縺ｾ縺: @@ -92,9 +110,11 @@ To get started we create a file `hello.cc`: } 縺薙ｮ繧ｽ繝ｼ繧ｹ繧ｳ繝ｼ繝峨ｯ縲〜hello.node` 縺ｨ縺縺繝舌う繝翫Μ繧｢繝峨が繝ｳ縺ｨ縺励※繝薙Ν繝峨＆繧後ｋ蠢隕√′譛峨ｊ縺ｾ縺吶 縺昴ｮ縺溘ａ縺ｫ `wscript` 縺ｨ蜻ｼ縺ｰ繧後ｋ莉･荳九ｮ繧医≧縺ｪ繧ｳ繝ｼ繝峨ｒ Python 縺ｧ譖ｸ縺阪∪縺励◆: @@ -116,28 +136,36 @@ like this: obj.source = 'hello.cc' `node-waf configure build` 繧貞ｮ溯｡後☆繧九→縲〜build/default/hello.node` 縺御ｽ懈舌＆繧後∪縺吶ゅ％繧後′菴懈舌＠縺溘い繝峨が繝ｳ縺ｧ縺吶 `node-waf` 縺ｯ [WAF](http://code.google.com/p/waf/) 縺ｫ縺ゅｋ Python 繝吶ｼ繧ｹ縺ｮ繝薙Ν繝峨す繧ｹ繝繝縺ｧ縺吶 `node-waf` 縺ｯ縲√Θ繝ｼ繧ｶ縺ｮ雋諡繧呈ｸ帙ｉ縺吶◆繧√↓謠蝉ｾ帙＆繧後※縺縺ｾ縺吶 蜈ｨ縺ｦ縺ｮ Node 繧｢繝峨が繝ｳ縺ｯ谺｡縺ｮ繧ｷ繧ｰ繝阪メ繝｣繧呈戟縺､ `init` 縺ｨ縺縺髢｢謨ｰ繧偵お繧ｯ繧ｹ繝昴ｼ繝医☆繧句ｿ隕√′譛峨ｊ縺ｾ縺: extern 'C' void init (Handle target) 迴ｾ譎らせ縺ｧ縺ｯ縲√い繝峨が繝ｳ縺ｮ繝峨く繝･繝｡繝ｳ繝医ｯ縺薙ｌ縺ｧ蜈ｨ縺ｦ縺ｧ縺吶 螳滄圀縺ｮ萓九ｯ縲 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 diff --git a/doc/api/appendix_1.markdown b/doc/api/appendix_1.markdown index 99a20d87ada1..7103b051e9a0 100644 --- a/doc/api/appendix_1.markdown +++ b/doc/api/appendix_1.markdown @@ -1,19 +1,23 @@ ## Appendix 1 - Third Party Modules Node 蜷代¢縺ｫ繧ｵ繝ｼ繝峨ヱ繝ｼ繝繧｣陬ｽ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺梧焚螟壹￥縺ゅｊ縺ｾ縺吶 蝓ｷ遲譎らせ (2010 蟷ｴ 8 譛) 縺ｧ縺ｯ縲√Δ繧ｸ繝･繝ｼ繝ｫ縺ｮ繝槭せ繧ｿ繝ｪ繝昴ず繝医Μ縺ｯ http://github.com/ry/node/wiki/modules[wiki 繝壹ｼ繧ｸ] 縺ｧ縺吶 縺薙ｮ莉倬鹸縺ｯ縲∬憶雉ｪ縺縺ｨ閠縺医ｉ繧後※縺繧九Δ繧ｸ繝･繝ｼ繝ｫ繧貞晏ｿ閠縺檎ｴ譌ｩ縺剰ｦ九▽縺代ｋ縺薙→繧呈焔蜉ｩ縺代☆繧九悟ｰ上＆縺ｪ縲阪ぎ繧､繝峨ｒ諢丞峙縺励※縺縺ｾ縺吶 縺薙ｌ縺ｯ螳悟ｨ縺ｪ繝ｪ繧ｹ繝医ｯ諢丞峙縺励※縺縺ｾ縺帙ｓ縲 @@ -52,6 +56,8 @@ elsewhere. [mjsunit.runner](http://github.com/tmpvar/mjsunit.runner) 縺薙ｮ繝ｪ繧ｹ繝医∈縺ｮ繝代ャ繝√ｒ豁楢ｿ弱＠縺ｾ縺吶 diff --git a/doc/api/assert.markdown b/doc/api/assert.markdown index 4c64d07bc5f7..e05e5551eafd 100644 --- a/doc/api/assert.markdown +++ b/doc/api/assert.markdown @@ -1,8 +1,10 @@ ## Assert 縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ繧｢繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺ｮ蜊倅ｽ薙ユ繧ｹ繝医ｒ險倩ｿｰ縺吶ｋ縺溘ａ縺ｫ菴ｿ逕ｨ縺輔ｌ縲 `require('assert')` 縺ｧ繧｢繧ｯ繧ｻ繧ｹ縺ｧ縺阪∪縺吶 @@ -10,14 +12,18 @@ access it with `require('assert')`. ### assert.fail(actual, expected, message, operator) `actual` 縺 `expected` 縺ｨ遲峨＠縺縺九∵署萓帙＆繧後◆貍皮ｮ怜ｭ舌ｒ菴ｿ縺｣縺ｦ繝繧ｹ繝医＠縺ｾ縺吶 ### assert.ok(value, [message]) `value` 縺 `true` 縺九ユ繧ｹ繝医＠縺ｾ縺吶 縺薙ｌ縺ｯ `assert.equal(true, value, message);` 縺ｨ遲我ｾ｡縺ｧ縺吶 @@ -25,56 +31,72 @@ Tests if value is a `true` value, it is equivalent to `assert.equal(true, value, ### assert.equal(actual, expected, [message]) `==` 貍皮ｮ怜ｭ舌ｒ蠑ｷ蛻ｶ縺励※豬縺蜷悟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.notEqual(actual, expected, [message]) `==` 貍皮ｮ怜ｭ舌ｒ蠑ｷ蛻ｶ縺励※豬縺髱槫酔蛟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.deepEqual(actual, expected, [message]) 豺ｱ縺蜷悟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.notDeepEqual(actual, expected, [message]) 豺ｱ縺髱槫酔蛟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.strictEqual(actual, expected, [message]) `===` 貍皮ｮ怜ｭ舌〒蜴ｳ蟇縺ｪ蜷悟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.notStrictEqual(actual, expected, [message]) `!==` 貍皮ｮ怜ｭ舌〒蜴ｳ蟇縺ｪ髱槫酔蛟､諤ｧ繧偵ユ繧ｹ繝医＠縺ｾ縺吶 ### assert.throws(block, [error], [message]) `block` 縺後お繝ｩ繝ｼ繧偵せ繝ｭ繝ｼ縺吶ｋ縺薙→繧呈悄蠕縺励∪縺吶 `error` 縺ｯ繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ縲∵ｭ｣隕剰｡ｨ迴ｾ縲√∪縺溘ｯ讀懆ｨｼ髢｢謨ｰ縺ｫ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ繧剃ｽｿ縺｣縺ｦ instanceof 縺ｧ讀懆ｨｼ: @@ -86,7 +108,9 @@ Validate instanceof using constructor: ); 豁｣隕剰｡ｨ迴ｾ繧剃ｽｿ縺｣縺ｦ繧ｨ繝ｩ繝ｼ繝｡繝繧ｻ繝ｼ繧ｸ繧呈､懆ｨｼ: @@ -98,7 +122,9 @@ Validate error message using RegExp: ); 迢ｬ閾ｪ縺ｮ繧ｨ繝ｩ繝ｼ讀懆ｨｼ: @@ -117,7 +143,9 @@ Custom error validation: ### assert.doesNotThrow(block, [error], [message]) `block` 縺後お繝ｩ繝ｼ繧偵せ繝ｭ繝ｼ縺励↑縺縺薙→繧呈悄蠕縺励∪縺吶 隧ｳ邏ｰ縺ｯ assert.throws 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 @@ -125,8 +153,10 @@ Expects `block` not to throw an error, see assert.throws for details. ### assert.ifError(value) `value` 縺 false 縺ｧ縺ｪ縺縺薙→繧偵ユ繧ｹ繝医＠縲》rue 縺縺｣縺溘ｉ縺昴ｌ繧偵せ繝ｭ繝ｼ縺励∪縺吶 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｮ隨ｬ 1 蠑墓焚縺ｧ縺ゅｋ `error` 繧偵ユ繧ｹ繝医☆繧九ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 diff --git a/doc/api/buffers.markdown b/doc/api/buffers.markdown index 5cefc46f91b1..0e60aaba378d 100644 --- a/doc/api/buffers.markdown +++ b/doc/api/buffers.markdown @@ -1,19 +1,23 @@ ## Buffers 邏皮ｲ九↑ JavaScript 縺ｯ Unicode 縺ｨ逶ｸ諤ｧ縺後＞縺繧ゅｮ縺ｮ縲√ヰ繧､繝翫Μ繝繝ｼ繧ｿ縺ｮ謇ｱ縺縺ｯ縺縺ｾ縺上≠繧翫∪縺帙ｓ縲 TCP 繧ｹ繝医Μ繝ｼ繝繧繝輔ぃ繧､繝ｫ繧ｷ繧ｹ繝繝繧呈桶縺蝣ｴ蜷医ｯ縲√が繧ｯ繝繝繝医せ繝医Μ繝ｼ繝繧貞ｦ逅縺吶ｋ蠢隕√′縺ゅｊ縺ｾ縺吶 Node 縺ｫ縺ｯ繧ｪ繧ｯ繝繝繝医せ繝医Μ繝ｼ繝繧呈桃菴懊∽ｽ懈舌∵ｶ郁ｲｻ縺吶ｋ縺溘ａ縺ｫ縺縺上▽縺九ｮ謌ｦ逡･縺後≠繧翫∪縺吶 逕溘ｮ繝繝ｼ繧ｿ縺ｯ `Buffer` 繧ｯ繝ｩ繧ｹ縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｫ菫晏ｭ倥＆繧後∪縺吶 `Buffer` 縺ｯ謨ｴ謨ｰ縺ｮ驟榊励→莨ｼ縺ｦ縺縺ｾ縺吶′縲 @@ -21,18 +25,23 @@ V8 繝偵ｼ繝励ｮ螟夜Κ縺ｫ蜑ｲ繧雁ｽ薙※繧峨ｌ縺溽函縺ｮ繝｡繝｢繝ｪ縺ｫ蟇ｾ蠢懊＠縺ｾ縺 `Buffer` 縺ｮ繧ｵ繧､繧ｺ繧貞､画峩縺吶ｋ縺薙→縺ｯ縺ｧ縺阪∪縺帙ｓ縲 `Buffer` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ繧ｰ繝ｭ繝ｼ繝舌Ν縺ｧ縺吶 繝舌ャ繝輔ぃ繧 JavaScript 譁蟄怜励が繝悶ず繧ｧ繧ｯ繝医→縺ｮ髢薙〒螟画鋤縺吶ｋ縺ｫ縺ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上ｒ譏守､ｺ縺吶ｋ蠢隕√′縺ゅｊ縺ｾ縺吶 縺縺上▽縺九ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上′縺ゅｊ縺ｾ縺吶 * `'ascii'` - 7bit 縺ｮ ASCII 繝繝ｼ繧ｿ蟆ら畑縺ｧ縺吶 縺薙ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ譁ｹ蠑上ｯ縺ｨ縺ｦ繧るｫ倬溘〒縲√ｂ縺嶺ｸ贋ｽ阪ン繝繝医′繧ｻ繝繝医＆繧後※縺繧後ｰ蜿悶ｊ髯､縺九ｌ縺ｾ縺吶 @@ -58,31 +68,39 @@ will be removed in future versions of Node. ### new Buffer(size) `size` 繧ｪ繧ｯ繝繝繝医ｮ譁ｰ縺励＞繝舌ャ繝輔ぃ繧貞牡繧雁ｽ薙※縺ｾ縺吶 ### new Buffer(array) 繧ｪ繧ｯ繝繝繝医ｮ `array` 繧剃ｽｿ逕ｨ縺吶ｋ譁ｰ縺励＞繝舌ャ繝輔ぃ繧貞牡繧雁ｽ薙※縺ｾ縺吶 ### new Buffer(str, encoding='utf8') 荳弱∴繧峨ｌ縺 `str` 繧貞螳ｹ縺ｨ縺吶ｋ譁ｰ縺励＞繝舌ャ繝輔ぃ繧貞牡繧雁ｽ薙※縺ｾ縺吶 ### buffer.write(string, offset=0, encoding='utf8') 荳弱∴繧峨ｌ縺溘お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧剃ｽｿ逕ｨ縺励※縲〜string` 繧偵ヰ繝繝輔ぃ縺ｮ `offset` 縺九ｉ譖ｸ縺崎ｾｼ縺ｿ縺ｾ縺吶 譖ｸ縺崎ｾｼ縺ｾ繧後◆繧ｪ繧ｯ繝繝繝域焚繧定ｿ斐＠縺ｾ縺吶 @@ -90,7 +108,9 @@ of `'utf8'` encoding, the method will not write partial characters. `'utf8'` 繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｮ蝣ｴ蜷医√％縺ｮ繝｡繧ｽ繝繝峨ｯ譁蟄励ｮ荳驛ｨ縺縺代ｒ譖ｸ縺崎ｾｼ繧縺薙→縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 萓: utf8 縺ｮ譁蟄怜励ｒ繝舌ャ繝輔ぃ縺ｫ譖ｸ縺崎ｾｼ縺ｿ縲√◎繧後ｒ繝励Μ繝ｳ繝医＠縺ｾ縺 @@ -104,14 +124,18 @@ Example: write a utf8 string into a buffer, then print it ### buffer.toString(encoding, start=0, end=buffer.length) `encoding` 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆繝舌ャ繝輔ぃ繝繝ｼ繧ｿ縺ｮ `start` 縺九ｉ `end` 縺ｾ縺ｧ繧偵ョ繧ｳ繝ｼ繝峨＠縺滓枚蟄怜励ｒ霑斐＠縺ｾ縺吶 荳翫ｮ `buffer.write()` 縺ｮ萓九ｒ蜿らｧ縺励※縺上□縺輔＞縲 @@ -119,15 +143,19 @@ See `buffer.write()` example, above. ### buffer[index] `index` 縺ｮ菴咲ｽｮ縺ｮ繧ｪ繧ｯ繝繝繝医ｒ蜿門ｾ励♀繧医ｳ險ｭ螳壹＠縺ｾ縺吶 縺昴ｮ蛟､縺ｯ蛟九縺ｮ繝舌う繝医ｒ蜿らｧ縺吶ｋ縺ｮ縺ｧ縲∝ｦ･蠖薙↑遽蝗ｲ縺ｯ 16 騾ｲ縺ｮ `0x00` 縺九ｉ `0xFF` 縺ｾ縺溘ｯ `0` 縺九ｉ`255`縺ｾ縺ｧ縺ｮ髢薙〒縺吶 萓: ASCII 譁蟄怜励ｒ 1 繝舌う繝医★縺､繝舌ャ繝輔ぃ縺ｫ繧ｳ繝斐ｼ縺励∪縺 @@ -146,15 +174,19 @@ Example: copy an ASCII string into a buffer, one byte at a time: ### Buffer.byteLength(string, encoding='utf8') 譁蟄怜励ｮ螳滄圀縺ｮ繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 縺薙ｌ縺ｯ譁蟄怜励ｮ*譁蟄*謨ｰ繧定ｿ斐☆ `String.prototype.length` 縺ｨ蜷後§縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 萓: @@ -169,9 +201,11 @@ Example: ### buffer.length 繝舌う繝域焚縺ｫ繧医ｋ繝舌ャ繝輔ぃ縺ｮ繧ｵ繧､繧ｺ縲 縺薙ｌ縺ｯ螳滄圀縺ｮ蜀螳ｹ縺ｮ繧ｵ繧､繧ｺ縺ｧ縺ｯ縺ｪ縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 @@ -189,13 +223,17 @@ buffer object. It does not change when the contents of the buffer are changed. ### buffer.copy(targetBuffer, targetStart=0, sourceStart=0, sourceEnd=buffer.length) 繝舌ャ繝輔ぃ髢薙〒 memcpy() 繧偵＠縺ｾ縺吶 萓: 繝舌ャ繝輔ぃ繧2蛟倶ｽ懈舌＠縲〜buf1` 縺ｮ 16 繝舌う繝育岼縺九ｉ 19 繝舌う繝育岼繧偵 `buf2` 縺ｮ 8 繝舌う繝育岼縺九ｉ蟋九∪繧倶ｽ咲ｽｮ縺ｸ繧ｳ繝斐ｼ縺励∪縺吶 @@ -217,21 +255,27 @@ into `buf2`, starting at the 8th byte in `buf2`. ### buffer.slice(start, end=buffer.length) 蜈縺ｮ繝舌ャ繝輔ぃ縺ｨ蜷後§繝｡繝｢繝ｪ繧貞盾辣ｧ縺励∪縺吶′縲〜start` 縺ｨ `end` 縺ｧ遉ｺ縺輔ｌ繧九が繝輔そ繝繝医〒蟋九∪繧顔洒縺上＆繧後◆譁ｰ縺励＞繝舌ャ繝輔ぃ繧定ｿ斐＠縺ｾ縺吶 **譁ｰ縺励＞繝舌ャ繝輔ぃ繧ｹ繝ｩ繧､繧ｹ縺ｮ螟画峩縺ｯ縲√が繝ｪ繧ｸ繝翫Ν繝舌ャ繝輔ぃ縺ｮ繝｡繝｢繝ｪ繧貞､画峩縺吶ｋ縺薙→縺ｫ縺ｪ繧翫∪縺呻ｼ** 萓: ASCII 縺ｮ繧｢繝ｫ繝輔ぃ繝吶ャ繝医〒繝舌ャ繝輔ぃ繧呈ｧ狗ｯ峨＠縺ｦ繧ｹ繝ｩ繧､繧ｹ縺励∝縺ｮ繝舌ャ繝輔ぃ縺ｧ 1 繝舌う繝医ｒ螟画峩縺励∪縺吶 diff --git a/doc/api/child_processes.markdown b/doc/api/child_processes.markdown index 2b79cd3c1d9d..b9ce1b15d09d 100644 --- a/doc/api/child_processes.markdown +++ b/doc/api/child_processes.markdown @@ -1,32 +1,42 @@ ## Child Processes Node縺ｯ `ChildProcess` 繧ｯ繝ｩ繧ｹ繧帝壹§縺ｦ 3 譁ｹ蜷代ｮ `popen(3)` 讖溯ｽ繧呈署萓帙＠縺ｾ縺吶 縺昴ｌ縺ｯ螳悟ｨ縺ｫ繝弱Φ繝悶Ο繝繧ｭ繝ｳ繧ｰ縺ｪ譁ｹ豕輔〒蟄舌励Ο繧ｻ繧ｹ縺ｮ `stdin`縲〜stdout`縲 縺昴＠縺ｦ `stderr` 繧帝壹§縺溘ョ繝ｼ繧ｿ繧ｹ繝医Μ繝ｼ繝繧貞ｮ溽樟縺励∪縺吶 蟄舌励Ο繧ｻ繧ｹ縺ｮ逕滓舌ｯ `require('child_process').spawn()` 繧剃ｽｿ縺縺ｾ縺吶 蟄舌励Ο繧ｻ繧ｹ縺ｯ蟶ｸ縺ｫ 3 譛ｬ縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｨ髢｢騾｣縺･縺代ｉ繧後※縺縺ｾ縺吶 `child.stdin`縲〜child.stdout`縲√◎縺励※ `child.stderr` 縺ｧ縺吶 `ChildProcess` 縺ｯ `EventEmitter` 縺ｧ縺吶 @@ -35,10 +45,12 @@ Child processes always have three streams associated with them. `child.stdin`, `function (code, signal) {}` 縺薙ｮ繧､繝吶Φ繝医ｯ蟄舌励Ο繧ｻ繧ｹ縺檎ｵゆｺ縺励◆蠕後〒逕滓舌＆繧後∪縺吶 繝励Ο繧ｻ繧ｹ縺梧勸騾壹↓邨ゆｺ縺励◆蝣ｴ蜷医〜code` 縺ｯ繝励Ο繧ｻ繧ｹ縺ｮ邨ゆｺ繧ｳ繝ｼ繝峨〒縺吶 @@ -47,15 +59,19 @@ of the signal, otherwise `null`. 縺昴ｌ莉･螟悶ｮ蝣ｴ蜷医ｯ `null` 縺ｧ縺吶 `waitpid(2)` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### child.stdin 蟄舌励Ο繧ｻ繧ｹ縺ｮ `stdin` 繧定｡ｨ迴ｾ縺吶ｋ `Writable Stream` 縺ｧ縺吶 螟壹￥縺ｮ蝣ｴ蜷医〜end()` 繧帝壹§縺ｦ縺薙ｮ繧ｹ繝医Μ繝ｼ繝繧帝哩縺倥ｋ縺ｨ蟄舌励Ο繧ｻ繧ｹ縺檎ｵゆｺ縺吶ｋ蜴溷屏縺ｨ縺ｪ繧翫∪縺吶 @@ -63,26 +79,34 @@ Closing this stream via `end()` often causes the child process to terminate. ### child.stdout 蟄舌励Ο繧ｻ繧ｹ縺ｮ `stdout` 繧定｡ｨ迴ｾ縺吶ｋ `Readable Stream` 縺ｧ縺吶 ### child.stderr 蟄舌励Ο繧ｻ繧ｹ縺ｮ `stderr` 繧定｡ｨ迴ｾ縺吶ｋ `Readable Stream` 縺ｧ縺吶 ### child.pid 蟄舌励Ο繧ｻ繧ｹ縺ｮ PID 縺ｧ縺吶 萓: @@ -96,14 +120,18 @@ Example: ### child_process.spawn(command, args=[], [options]) `args` 繧偵さ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚縺ｨ縺励※縲∽ｸ弱∴繧峨ｌ縺 `command` 縺ｧ譁ｰ縺励＞繝励Ο繧ｻ繧ｹ繧定ｵｷ蜍輔＠縺ｾ縺吶 `args` 縺檎怐逡･縺輔ｌ縺溷ｴ蜷医∫ｩｺ縺ｮ驟榊励′繝繝輔か繝ｫ繝医→縺ｪ繧翫∪縺吶 隨ｬ 3 蠑墓焚縺ｯ霑ｽ蜉縺ｮ繧ｪ繝励す繝ｧ繝ｳ繧呈欠螳壹☆繧九◆繧√↓菴ｿ繧上ｌ縲√◎縺ｮ繝繝輔か繝ｫ繝医ｯ: @@ -112,10 +140,12 @@ The third argument is used to specify additional options, which defaults to: customFds: [-1, -1, -1] } `cwd` 縺ｧ襍ｷ蜍輔＆繧後◆繝励Ο繧ｻ繧ｹ縺ｮ繝ｯ繝ｼ繧ｭ繝ｳ繧ｰ繝繧｣繝ｬ繧ｯ繝医Μ繧呈欠螳壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 `env` 縺ｯ譁ｰ縺励＞繝励Ο繧ｻ繧ｹ縺ｫ隕九∴繧狗腸蠅螟画焚繧呈欠螳壹☆繧九◆繧√↓菴ｿ縺縺ｾ縺吶 @@ -123,7 +153,9 @@ existing streams; `-1` means that a new stream should be created. `-1` 縺ｯ譁ｰ縺励＞繧ｹ繝医Μ繝ｼ繝縺御ｽ懊ｉ繧後↑縺代ｌ縺ｰ縺ｪ繧峨↑縺縺薙→繧呈э蜻ｳ縺励∪縺吶 `ls -lh /usr` 繧貞ｮ溯｡後＠縺ｦ `stdout`縲〜stderr`縲√♀繧医ｳ邨ゆｺ繧ｳ繝ｼ繝峨ｒ蜿門ｾ励☆繧倶ｾ: @@ -145,7 +177,9 @@ Example of running `ls -lh /usr`, capturing `stdout`, `stderr`, and the exit cod 縺ｨ縺ｦ繧よ焔縺ｮ霎ｼ繧薙□譁ｹ豕輔〒螳溯｡後☆繧 'ps ax | grep ssh' 縺ｮ萓: @@ -185,7 +219,9 @@ Example: A very elaborate way to run 'ps ax | grep ssh' exec 縺ｮ螟ｱ謨励ｒ繝√ぉ繝繧ｯ縺吶ｋ萓: @@ -200,15 +236,19 @@ exec 縺ｮ螟ｱ謨励ｒ繝√ぉ繝繧ｯ縺吶ｋ萓: 髢｢騾｣鬆逶ｮ: `child_process.exec()` ### child_process.exec(command, [options], callback) 繧ｳ繝槭Φ繝峨ｒ蟄舌励Ο繧ｻ繧ｹ縺ｨ縺励※螳溯｡後＠縲√◎縺ｮ蜃ｺ蜉帙ｒ闢縺医※縲√◎縺ｮ蜈ｨ縺ｦ繧偵さ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ貂｡縺咎ｫ俶ｰｴ貅悶ｮ譁ｹ豕輔〒縺吶 @@ -226,10 +266,12 @@ output, and return it all in a callback. }); 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(error, stdout, stderr)` 繧貞ｾ励∪縺吶 謌仙粥縺吶ｋ縺ｨ縲〜error` 縺ｯ `null` 縺ｫ縺ｪ繧翫∪縺吶 @@ -238,7 +280,9 @@ signal that terminated the process. `err.signal` 縺ｯ繝励Ο繧ｻ繧ｹ繧堤ｵゆｺ縺輔○縺溘す繧ｰ繝翫Ν縺ｨ縺ｪ繧翫∪縺吶 莉ｻ諢上ｮ隨ｬ 2 蠑墓焚縺ｧ縺縺上▽縺九ｮ繧ｪ繝励す繝ｧ繝ｳ繧呈欠螳壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｮ繝繝輔か繝ｫ繝医ｯ @@ -251,11 +295,13 @@ There is a second optional argument to specify several options. The default opti env: null } 繧ゅ＠ `timeout` 縺 0 繧医ｊ螟ｧ縺阪＞縺ｨ縲 蟄舌励Ο繧ｻ繧ｹ縺ｯ螳溯｡梧凾髢薙′ `timeout` 繝溘Μ遘偵ｈ繧翫ｂ髟ｷ縺上↑繧九→ kill 縺輔ｌ縺ｾ縺吶 @@ -266,8 +312,10 @@ the child process is killed. ### child.kill(signal='SIGTERM') 蟄舌励Ο繧ｻ繧ｹ縺ｫ繧ｷ繧ｰ繝翫Ν繧帝√ｊ縺ｾ縺吶 蠑墓焚縺御ｸ弱∴繧峨ｌ縺ｪ縺蝣ｴ蜷医∝ｭ舌励Ο繧ｻ繧ｹ縺ｫ縺ｯ `'SIGTERM'` 縺碁√ｉ繧後∪縺吶 @@ -284,8 +332,10 @@ be sent `'SIGTERM'`. See `signal(7)` for a list of available signals. grep.kill('SIGHUP'); 縺薙ｮ髢｢謨ｰ縺ｯ `kill` 縺ｨ蜻ｼ縺ｰ繧後ｋ繧ゅｮ縺ｮ縲 蟄舌励Ο繧ｻ繧ｹ縺ｫ螻翫¢繧峨ｌ繧九す繧ｰ繝翫Ν縺悟ｮ滄圀縺ｫ縺ｯ蟄舌励Ο繧ｻ繧ｹ繧呈ｮｺ縺輔↑縺縺九ｂ縺励ｌ縺ｪ縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 diff --git a/doc/api/crypto.markdown b/doc/api/crypto.markdown index 7dc593b201b6..de50463659ef 100644 --- a/doc/api/crypto.markdown +++ b/doc/api/crypto.markdown @@ -1,43 +1,55 @@ ## Crypto 縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｫ縺ｯ `require('crypto')` 繧剃ｽｿ逕ｨ縺励∪縺吶 證怜捷蛹悶Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ荳句ｱ､縺ｮ繝励Λ繝繝医ヵ繧ｩ繝ｼ繝縺ｧ OpenSSL 縺梧怏蜉ｹ縺ｧ縺ゅｋ縺薙→繧貞ｿ隕√→縺励∪縺吶 縺昴ｌ縺ｯ螳牙ｨ縺ｪ HTTPS 繝阪ャ繝医Ρ繝ｼ繧ｯ繧 http 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ荳驛ｨ縺ｨ縺励※菴ｿ繧上ｌ繧九 螳牙ｨ縺ｪ隱崎ｨｼ諠蝣ｱ繧偵き繝励そ繝ｫ蛹悶☆繧区婿豕輔ｒ謠蝉ｾ帙＠縺ｾ縺吶 蜷梧凾縺ｫ OpenSSL 縺ｮ繝上ャ繧ｷ繝･縲？MAC縲∵囓蜿ｷ縲∝ｾｩ蜿ｷ縲∫ｽｲ蜷阪√◎縺励※讀懆ｨｼ縺ｸ縺ｮ繝ｩ繝繝代ｼ繧剃ｸ蠑乗署萓帙＠縺ｾ縺吶 ### crypto.createCredentials(details) 隱崎ｨｼ諠蝣ｱ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｾ縺吶ゅが繝励す繝ｧ繝ｳ縺ｮ `details` 縺ｯ莉･荳九ｮ繧ｭ繝ｼ繧呈戟縺､霎樊嶌縺ｧ縺: * `key` : PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆遘伜ｯ骰ｵ繧剃ｿ晄戟縺吶ｋ譁蟄怜 * `cert` : PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆險ｼ譏取嶌繧剃ｿ晄戟縺吶ｋ譁蟄怜 * `ca` : 菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌縺 PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆譁蟄怜励∪縺溘ｯ譁蟄怜励ｮ驟榊 'ca' 縺ｮ隧ｳ邏ｰ縺御ｸ弱∴繧峨ｌ縺ｪ縺九▲縺溷ｴ蜷医］ode.js 縺ｯ繝繝輔か繝ｫ繝医→縺励※ @@ -47,16 +59,20 @@ If no 'ca' details are given, then node.js will use the default publicly trusted ### crypto.createHash(algorithm) 繝上ャ繧ｷ繝･繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ逕滓舌＠縺ｦ霑斐＠縺ｾ縺吶 荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ繧医ｋ證怜捷繝上ャ繧ｷ繝･髢｢謨ｰ縺ｯ繝繧､繧ｸ繧ｧ繧ｹ繝医ｮ逕滓舌↓菴ｿ繧上ｌ縺ｾ縺吶 `algorithm` 縺ｯ縲√励Λ繝繝医ヵ繧ｩ繝ｼ繝荳翫ｮ OpenSSL 縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ繧ｵ繝昴ｼ繝医＆繧後※縺繧句茜逕ｨ蜿ｯ閭ｽ縺ｪ繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ萓晏ｭ倥＠縺ｾ縺吶 @@ -67,8 +83,10 @@ On recent releases, `openssl list-message-digest-algorithms` will display the av ### hash.update(data) 荳弱∴繧峨ｌ縺 `data` 縺ｧ繝上ャ繧ｷ繝･縺ｮ蜀螳ｹ繧呈峩譁ｰ縺励∪縺吶 縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -76,8 +94,10 @@ This can be called many times with new data as it is streamed. ### hash.digest(encoding='binary') 貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ繝繝ｼ繧ｿ縺後ワ繝繧ｷ繝･蛹悶＆繧後◆繝繧､繧ｸ繧ｧ繧ｹ繝医ｒ險育ｮ励＠縺ｾ縺吶 `encoding` 縺ｯ `'hex'`縲〜'binary'`縲√∪縺溘ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 @@ -86,13 +106,17 @@ The `encoding` can be `'hex'`, `'binary'` or `'base64'`. ### crypto.createHmac(algorithm, key) 荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｨ繧ｭ繝ｼ縺ｧ HMAC 繧定ｨ育ｮ励☆繧九？MAC 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 `algorithm` 縺ｯ OpenSSL 縺ｧ繧ｵ繝昴ｼ繝医＆繧後※縺繧九い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ萓晏ｭ倥＠縺ｾ縺 ｼ 蜑崎ｿｰ縺ｮ `createHash` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 @@ -100,8 +124,10 @@ Creates and returns a hmac object, a cryptographic hmac with the given algorithm ### hmac.update(data) 荳弱∴繧峨ｌ縺 `data` 縺ｧ HMAC 縺ｮ蜀螳ｹ繧呈峩譁ｰ縺励∪縺吶 縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -109,8 +135,10 @@ This can be called many times with new data as it is streamed. ### hmac.digest(encoding='binary') 貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ繝繝ｼ繧ｿ縺 HMAC 蛹悶＆繧後◆繝繧､繧ｸ繧ｧ繧ｹ繝医ｒ險育ｮ励＠縺ｾ縺吶 `encoding` 縺ｯ `'hex'`縲〜'binary'`縲√∪縺溘ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 @@ -119,13 +147,17 @@ The `encoding` can be `'hex'`, `'binary'` or `'base64'`. ### crypto.createCipher(algorithm, key) 荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｨ繧ｭ繝ｼ繧剃ｽｿ逕ｨ縺吶ｋ證怜捷繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 `algorithm` 縺ｯ縲＾penSSL 縺ｫ萓晏ｭ倥＠縺ｾ縺吶ゆｾ九∴縺ｰ `'aes192'` 縺ｪ縺ｩ縺ｧ縺吶 譛霑代ｮ繝ｪ繝ｪ繝ｼ繧ｹ縺ｧ縺ｯ縲〜openssl list-cipher-algorithms` @@ -134,9 +166,11 @@ On recent releases, `openssl list-cipher-algorithms` will display the available ### cipher.update(data, input_encoding='binary', output_encoding='binary') `data` 縺ｧ證怜捷繧呈峩譁ｰ縺励∪縺吶 `input_encoding` 縺ｧ荳弱∴繧峨ｌ繧九お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ `'utf8'`縲〜'ascii'`縲〜'binary'` 縺ｮ縺縺壹ｌ縺九〒縺吶 @@ -144,14 +178,18 @@ the output format of the enciphered data, and can be `'binary'`, `'base64'` or ` `'utf8'`縲〜'ascii'` 縺ｾ縺溘ｯ `'binary'` 縺ｮ縺縺壹ｌ縺九〒縺吶 證怜捷蛹悶＆繧後◆繧ｳ繝ｳ繝繝ｳ繝縺瑚ｿ斐＆繧後∪縺吶ゅ％繧後ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### cipher.final(output_encoding='binary') 證怜捷蛹悶＆繧後◆繧ｳ繝ｳ繝繝ｳ繝縺ｮ谿九ｊ繧定ｿ斐＠縺ｾ縺吶 `output_encoding` 縺ｯ谺｡縺ｮ縺縺壹ｌ縺九〒縺: `'binary'`縲〜'ascii'` 縺ｾ縺溘ｯ `'utf8'` @@ -159,8 +197,10 @@ Returns any remaining enciphered contents, with `output_encoding` being one of: ### crypto.createDecipher(algorithm, key) 荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｨ繧ｭ繝ｼ繧剃ｽｿ逕ｨ縺吶ｋ蠕ｩ蜿ｷ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 縺薙ｌ縺ｯ蜑崎ｿｰ縺ｮ證怜捷繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ髀｡蜀吶＠縺ｧ縺吶 @@ -168,8 +208,10 @@ This is the mirror of the cipher object above. ### decipher.update(data, input_encoding='binary', output_encoding='binary') `'binary'`縲〜'base64'` 縺ｾ縺溘ｯ `'hex'` 縺ｮ縺縺壹ｌ縺九〒繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆蠕ｩ蜿ｷ繧 `data` 縺ｧ譖ｴ譁ｰ縺励∪縺吶 `output_decoding` 縺ｯ蠕ｩ蜿ｷ蛹悶＆繧後◆繝励Ξ繝ｼ繝ｳ繝繧ｭ繧ｹ繝医ｮ繝輔か繝ｼ繝槭ャ繝医ｒ謖螳壹☆繧九ｂ縺ｮ縺ｧ縲 @@ -178,8 +220,10 @@ The `output_decoding` specifies in what format to return the deciphered plaintex ### decipher.final(output_encoding='binary') 蠕ｩ蜿ｷ蛹悶＆繧後◆繝励Ξ繝ｼ繝ｳ繝繧ｭ繧ｹ繝医ｮ谿九ｊ繧定ｿ斐＠縺ｾ縺吶 `output_decoding` 縺ｯ `'binary'`縲〜'ascii'` 縺ゅｋ縺縺ｯ `'utf8'` 縺ｮ縺縺壹ｌ縺九〒縺吶 @@ -188,9 +232,11 @@ with `output_encoding' being one of: `'binary'`, `'ascii'` or `'utf8'`. ### crypto.createSign(algorithm) 荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｧ鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶 譛霑代ｮOpenSSL縺ｮ繝ｪ繝ｪ繝ｼ繧ｹ縺ｧ縺ｯ縲〜openssl list-public-key-algorithms` @@ -199,8 +245,10 @@ the available signing algorithms. Examples are `'RSA-SHA256'`. ### signer.update(data) 鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医ｒ繝繝ｼ繧ｿ縺ｧ譖ｴ譁ｰ縺励∪縺吶 縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -208,30 +256,38 @@ This can be called many times with new data as it is streamed. ### signer.sign(private_key, output_format='binary') 鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医↓貂｡縺輔ｌ縺溷ｨ縺ｦ縺ｮ譖ｴ譁ｰ繝繝ｼ繧ｿ縺ｧ鄂ｲ蜷阪ｒ險育ｮ励＠縺ｾ縺吶 `private_key` 縺ｯ PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆遘伜ｯ骰ｵ繧貞螳ｹ縺ｨ縺吶ｋ譁蟄怜励〒縺吶 `'binary'`縲〜'hex'`縲√≠繧九＞縺ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九ｒ謖螳壹＠縺 `output_format` 縺ｫ繧医ｋ鄂ｲ蜷阪ｒ霑斐＠縺ｾ縺吶 ### crypto.createVerify(algorithm) 荳弱∴繧峨ｌ縺溘い繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｧ讀懆ｨｼ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴懈舌＠縺ｦ霑斐＠縺ｾ縺吶ゅ％繧後ｯ蜑崎ｿｰ縺ｮ鄂ｲ蜷阪が繝悶ず繧ｧ繧ｯ繝医→髀｡蜀吶＠縺ｧ縺吶 ### verifier.update(data) 讀懆ｨｼ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繝繝ｼ繧ｿ縺ｧ譖ｴ譁ｰ縺励∪縺吶 縺薙ｌ縺ｯ譁ｰ縺励＞繝繝ｼ繧ｿ縺後せ繝医Μ繝ｼ繝縺ｫ豬√＆繧後ｋ髫帙↓菴募ｺｦ繧ょ他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -239,9 +295,11 @@ This can be called many times with new data as it is streamed. ### verifier.verify(public_key, signature, signature_format='binary') 鄂ｲ蜷阪＆繧後◆繝繝ｼ繧ｿ繧 `public_key` 縺ｨ `signature` 縺ｧ讀懆ｨｼ縺励∪縺吶 `public_key` 縺ｯ PEM 縺ｧ繧ｨ繝ｳ繧ｳ繝ｼ繝峨＆繧後◆蜈ｬ髢矩嵯繧貞性繧譁蟄怜励〒縺吶 @@ -249,6 +307,8 @@ signature for the data, in the `signature_format` which can be `'binary'`, `'hex 縺昴ｮ `signature_format` 縺ｯ `'binary'`縲〜'hex'`縲√∪縺溘ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 鄂ｲ蜷阪＆繧後◆繝繝ｼ繧ｿ縺ｨ蜈ｬ髢矩嵯縺ｫ繧医ｋ讀懆ｨｼ縺ｮ邨先棡縺ｫ繧医▲縺ｦ true 縺ｾ縺溘ｯ false 繧定ｿ斐＠縺ｾ縺吶 diff --git a/doc/api/dgram.markdown b/doc/api/dgram.markdown index 1e6d84266d72..45d38cf1ab4b 100644 --- a/doc/api/dgram.markdown +++ b/doc/api/dgram.markdown @@ -1,8 +1,10 @@ ## dgram 繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝医ｯ `require('dgram')` 縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｫ縺ｪ繧翫∪縺吶 繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｯ縺ｻ縺ｨ繧薙←縺ｮ蝣ｴ蜷 IP/UDP 繝｡繝繧ｻ繝ｼ繧ｸ縺ｧ謇ｱ繧上ｌ縺ｾ縺吶′縲ゞNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医〒繧ゆｽｿ逕ｨ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 @@ -12,8 +14,10 @@ handled as IP/UDP messages, but they can also be used over Unix domain sockets. `function (msg, rinfo) { }` 繧ｽ繧ｱ繝繝井ｸ翫〒譁ｰ縺励＞繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺悟芦逹縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶Ａmsg` 縺ｯ `Buffer` 縺ｧ縲 `rinfo` 縺ｯ騾∽ｿ｡閠縺ｮ繧｢繝峨Ξ繧ｹ諠蝣ｱ縺ｨ繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｮ繝舌う繝域焚繧呈戟縺｣縺溘が繝悶ず繧ｧ繧ｯ繝医〒縺吶 @@ -23,8 +27,10 @@ an object with the sender's address information and the number of bytes in the d `function () { }` 繧ｽ繧ｱ繝繝医〒繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｮ蠕縺｡蜿励¢繧帝幕蟋九☆繧九→逕滓舌＆繧後∪縺吶 縺薙ｌ縺ｯ UDP 繧ｽ繧ｱ繝繝医′菴懈舌＆繧後ｋ縺ｨ縺吶＄縺ｫ逋ｺ逕溘＠縺ｾ縺吶 @@ -35,8 +41,10 @@ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医〒縺ｯ `bind()` 繧貞他縺ｳ蜃ｺ縺吶∪縺ｧ蠕縺｡蜿励¢ `function () { }` `close()` 縺ｫ繧医▲縺ｦ繧ｽ繧ｱ繝繝医′繧ｯ繝ｭ繝ｼ繧ｺ縺吶ｋ縺ｨ逕滓舌＆繧後∪縺吶 縺薙ｮ繧ｽ繧ｱ繝繝医〒縺ｯ譁ｰ縺励＞ `message` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後↑縺上↑繧翫∪縺吶 @@ -44,25 +52,31 @@ on this socket. ### dgram.createSocket(type, [callback]) 謖螳壹＆繧後◆遞ｮ鬘槭ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝医ｒ菴懈舌＠縺ｾ縺吶 螯･蠖薙↑遞ｮ鬘槭ｯ: `udp4`縲〜udp6`縲√◎縺励※`unix_dgram` 縺ｧ縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｮ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ `message` 繧､繝吶Φ繝医ｮ繝ｪ繧ｹ繝翫ｼ縺ｨ縺励※蜉縺医ｉ繧後∪縺吶 ### dgram.send(buf, offset, length, path, [callback]) UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝育畑縺ｧ縺吶ら嶌謇句医ｮ繧｢繝峨Ξ繧ｹ縺ｯ繝輔ぃ繧､繝ｫ繧ｷ繧ｹ繝繝縺ｮ繝代せ蜷阪〒縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｮ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯOS縺ｫ繧医▲縺ｦ`sendto`縺ｮ蜻ｼ縺ｳ蜃ｺ縺励′螳御ｺ縺励◆蠕後↓襍ｷ蜍輔＆繧後ｋ縺溘ａ縺ｫ謠蝉ｾ帙＆繧後ｋ縺九ｂ縺励ｌ縺ｾ縺帙ｓ縲 @@ -71,7 +85,9 @@ UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝育畑縺ｧ縺吶ら嶌謇句医ｮ繧｢繝 縺薙ｮ繧ｽ繧ｱ繝繝医〒繝｡繝繧ｻ繝ｼ繧ｸ繧貞女菫｡縺吶ｋ縺薙→縺ｯ縺ｪ縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 UNIX繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝 `/var/run/syslog` 繧帝壹§縺ｦ OSX 荳翫ｮ syslogd 縺ｫ繝｡繝繧ｻ繝ｼ繧ｸ繧帝∽ｿ｡縺吶ｋ萓: @@ -89,12 +105,14 @@ UNIX繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝 `/var/run/syslog` 繧帝壹§縺ｦ OSX 荳翫ｮ syslogd ### dgram.send(buf, offset, length, port, address, [callback]) UDP 繧ｽ繧ｱ繝繝育畑縺ｧ縺吶ら嶌謇句医ｮ繝昴ｼ繝医→ IP 繧｢繝峨Ξ繧ｹ縺ｯ蠢縺壽欠螳壹＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 `address` 繝代Λ繝｡繝ｼ繧ｿ縺ｫ譁蟄怜励ｒ謠蝉ｾ帙☆繧九→縲√◎繧後ｯ DNS 縺ｫ繧医▲縺ｦ隗｣豎ｺ縺輔ｌ縺ｾ縺吶 @@ -103,7 +121,9 @@ DNS 繝ｫ繝繧ｯ繧｢繝繝励ｯ騾∽ｿ｡繧貞ｰ代↑縺上→繧よｬ｡縺ｮ讖滉ｼ壹∪縺ｧ驕繧峨○繧 騾∽ｿ｡縺瑚｡後ｏ繧後◆縺薙→繧堤｢ｺ螳溘↓遏･繧句髪荳縺ｮ謇区ｮｵ縺ｯ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧剃ｽｿ縺縺薙→縺ｧ縺吶 `localhost` 縺ｮ驕ｩ蠖薙↑繝昴ｼ繝医↓ UDP 繝代こ繝繝医ｒ騾∽ｿ｡縺吶ｋ萓; @@ -117,9 +137,11 @@ Example of sending a UDP packet to a random port on `localhost`; ### dgram.bind(path) UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝育畑縺ｧ縺吶 `path` 縺ｧ謖螳壹＆繧後◆繧ｽ繧ｱ繝繝井ｸ翫〒繝繝ｼ繧ｿ繧ｰ繝ｩ繝縺ｮ逹菫｡蠕縺｡蜿励¢繧帝幕蟋九＠縺ｾ縺吶 @@ -127,7 +149,9 @@ UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝育畑縺ｧ縺吶 `bind()` 縺励↑縺縺ｧ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧貞女菫｡縺吶ｋ縺薙→縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 蜿嶺ｿ｡縺励◆蜈ｨ縺ｦ縺ｮ繝｡繝繧ｻ繝ｼ繧ｸ繧偵お繧ｳ繝ｼ繝舌ャ繧ｯ縺吶ｋ UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｽ繧ｱ繝繝医し繝ｼ繝舌ｮ萓: @@ -147,7 +171,9 @@ Example of a Unix domain datagram server that echoes back all messages it receiv server.bind(serverPath); 縺薙ｮ繧ｵ繝ｼ繝舌→蟇ｾ隧ｱ縺吶ｋ UNIX 繝峨Γ繧､繝ｳ縺ｮ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ萓: @@ -173,14 +199,18 @@ Example of a Unix domain datagram client that talks to this server: ### dgram.bind(port, [address]) UDP 繧ｽ繧ｱ繝繝育畑縺ｧ縺吶Ａport` 縺ｨ繧ｪ繝励す繝ｧ繝ｳ縺ｮ `address` 縺ｧ繝繝ｼ繧ｿ繧ｰ繝ｩ繝繧貞ｾ縺｡蜿励¢縺ｾ縺吶 `address` 縺梧欠螳壹＆繧後↑縺代ｌ縺ｰ縲＾S 縺ｯ蜈ｨ縺ｦ縺ｮ繧｢繝峨Ξ繧ｹ縺九ｉ縺ｮ蠕縺｡蜿励¢繧定ｩｦ縺ｿ縺ｾ縺吶 41234 逡ｪ繝昴ｼ繝医ｒ蠕縺｡蜿励¢繧 UDP 繧ｵ繝ｼ繝舌ｮ萓: @@ -207,8 +237,10 @@ Example of a UDP server listening on port 41234: ### dgram.close() 荳句ｱ､縺ｮ繧ｽ繧ｱ繝繝医ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺励√ョ繝ｼ繧ｿ縺ｮ蠕縺｡蜿励¢繧堤ｵゆｺ縺励∪縺吶 `bind()` 縺悟他縺ｳ蜃ｺ縺輔ｌ縺ｦ縺縺ｪ縺縲∬ｪ蜍慕噪縺ｫ繝｡繝繧ｻ繝ｼ繧ｸ繧貞ｾ縺｡蜿励¢縺ｦ縺縺 UDP 繧ｽ繧ｱ繝繝医〒繧ょ酔縺倥〒縺吶 @@ -216,9 +248,11 @@ automatically listen for messages, even if they did not call `bind()`. ### dgram.address() 繧ｪ繝悶ず繧ｧ繧ｯ繝医′謖√▲縺ｦ縺繧九た繧ｱ繝繝医ｮ繧｢繝峨Ξ繧ｹ諠蝣ｱ繧定ｿ斐＠縺ｾ縺吶 UDP 繧ｽ繧ｱ繝繝医〒縺ｯ縲√％縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ `address` 縺ｨ `port` 繧呈戟縺｣縺ｦ縺縺ｾ縺吶 @@ -227,8 +261,10 @@ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医〒縺ｯ縲〜address` 縺縺代ｒ謖√▲縺ｦ縺縺ｾ縺吶 ### dgram.setBroadcast(flag) 繧ｽ繧ｱ繝繝医ｮ繧ｪ繝励す繝ｧ繝ｳ `SO_BROADCAST` 繧定ｨｭ螳壹∪縺溘ｯ繧ｯ繝ｪ繧｢縺励∪縺吶 縺薙ｮ繧ｪ繝励す繝ｧ繝ｳ縺瑚ｨｭ螳壹＆繧後ｋ縺ｨ縲ゞDP 繝代こ繝繝医ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｮ繝悶Ο繝ｼ繝峨く繝｣繧ｹ繝育畑繧｢繝峨Ξ繧ｹ縺ｫ騾∽ｿ｡縺輔ｌ縺ｾ縺吶 @@ -236,11 +272,13 @@ may be sent to a local interface's broadcast address. ### dgram.setTTL(ttl) 繧ｽ繧ｱ繝繝医が繝励す繝ｧ繝ｳ縺ｮ `IP_TTL` 繧定ｨｭ螳壹＠縺ｾ縺吶 TTL 縺ｯ縲檎函蟄俶悄髢薙阪ｒ陦ｨ縺励∪縺吶′縲√％縺ｮ繧ｳ繝ｳ繝繧ｭ繧ｹ繝医〒縺ｯ繝代こ繝繝医′騾夐℃繧定ｨｱ蜿ｯ縺輔ｌ繧 IP 縺ｮ繝帙ャ繝玲焚繧呈欠螳壹＠縺ｾ縺吶 @@ -249,8 +287,10 @@ TTL 縺ｯ縲檎函蟄俶悄髢薙阪ｒ陦ｨ縺励∪縺吶′縲√％縺ｮ繧ｳ繝ｳ繝繧ｭ繧ｹ繝医〒縺ｯ繝 TTL 蛟､縺ｮ螟画峩縺ｯ騾壼ｸｸ縲√ロ繝繝医Ρ繝ｼ繧ｯ縺ｮ隱ｿ譟ｻ繧繝槭Ν繝√く繝｣繧ｹ繝医〒菴ｿ繧上ｌ縺ｾ縺吶 `setTTL()` 縺ｮ蠑墓焚縺ｯ 1 縺九ｉ 255 縺ｮ繝帙ャ繝玲焚縺ｧ縺ｧ縺吶ゅ⊇縺ｨ繧薙←縺ｮ繧ｷ繧ｹ繝繝縺ｧ繝繝輔か繝ｫ繝医ｯ 64 縺ｧ縺吶 diff --git a/doc/api/dns.markdown b/doc/api/dns.markdown index 07d0e78e0e9d..c16724c8766d 100644 --- a/doc/api/dns.markdown +++ b/doc/api/dns.markdown @@ -1,13 +1,17 @@ ## DNS 縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｫ縺ｯ `require('dns')` 繧剃ｽｿ逕ｨ縺励∪縺吶 縺薙ｌ縺ｯ `'www.google.com'` 繧定ｧ｣豎ｺ縺励※縲∬ｿ斐＆繧後◆ IP 繧｢繝峨Ξ繧ｹ繧帝蠑輔″縺ｧ隗｣豎ｺ縺吶ｋ萓九〒縺吶 @@ -34,17 +38,21 @@ resolves the IP addresses which are returned. ### dns.lookup(domain, family=null, callback) 繝峨Γ繧､繝ｳ (萓 `'google.com'`) 繧定ｧ｣豎ｺ縺励※譛蛻昴↓隕九▽縺九▲縺 A (IPv4) 縺ｾ縺溘ｯ AAAA (IPv6) 繝ｬ繧ｳ繝ｼ繝峨↓縺励∪縺吶 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(err, address, family)` 繧呈戟縺｡縺ｾ縺吶 `address` 蠑墓焚縺ｯ IP v4 縺ｾ縺溘ｯ v6 繧｢繝峨Ξ繧ｹ繧定｡ｨ迴ｾ縺吶ｋ譁蟄怜励〒縺吶 @@ -55,10 +63,12 @@ neccessarily the value initially passed to `lookup`). ### dns.resolve(domain, rrtype='A', callback) 繝峨Γ繧､繝ｳ (萓 `'google.com'`) 繧定ｧ｣豎ｺ縺励※ `rrtype` 縺ｧ謖螳壹＆繧後◆繝ｬ繧ｳ繝ｼ繝峨ち繧､繝励ｮ驟榊励↓縺励∪縺吶 螯･蠖薙↑ `rrtype` 縺ｯ `A` (IPV4繧｢繝峨Ξ繧ｹ)縲〜AAAA` (IPV6繧｢繝峨Ξ繧ｹ)縲 @@ -66,18 +76,22 @@ records), and `PTR` (used for reverse IP lookups). `PTR` (IP 繧帝蠑輔″縺ｧ繝ｫ繝繧ｯ繧｢繝繝励☆繧九◆繧√↓菴ｿ繧上ｌ繧) 縺ｧ縺吶 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(err, addresses)` 繧呈戟縺｡縺ｾ縺吶 `addresses` 縺ｮ蜷隕∫ｴ縺ｮ遞ｮ鬘槭ｯ繝ｬ繧ｳ繝ｼ繝峨ｮ遞ｮ鬘槭↓繧医▲縺ｦ豎ｺ縺ｾ繧翫 蟇ｾ蠢懊☆繧句ｾ瑚ｿｰ縺ｮ繝ｫ繝繧ｯ繧｢繝繝励Γ繧ｽ繝繝峨〒險倩ｿｰ縺輔ｌ縺ｾ縺吶 繧ｨ繝ｩ繝ｼ逋ｺ逕滓凾縲〜err` 縺ｯ `Error` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺ゅｊ縲 `err.errno` 縺ｯ蠕瑚ｿｰ縺吶ｋ繧ｨ繝ｩ繝ｼ繧ｳ繝ｼ繝峨ｮ縺縺壹ｌ縺九 @@ -87,9 +101,11 @@ the error in English. ### dns.resolve4(domain, callback) `dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲！Pv4 繧｢繝峨Ξ繧ｹ (`A` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 `addresses` 縺ｯ IPv4 繧｢繝峨Ξ繧ｹ縺ｮ驟榊励〒縺 (萓
@@ -98,7 +114,9 @@ The same as `dns.resolve()`, but only for IPv4 queries (`A` records). ### dns.resolve6(domain, callback) IPv6 (`AAAA` 繝ｬ繧ｳ繝ｼ繝) 繧貞撫縺蜷医ｏ縺帙ｋ縺薙→繧帝勁縺縺ｦ `dns.resolve4()` 縺ｨ蜷後§縺ｧ縺吶 @@ -106,13 +124,17 @@ IPv6 (`AAAA` 繝ｬ繧ｳ繝ｼ繝) 繧貞撫縺蜷医ｏ縺帙ｋ縺薙→繧帝勁縺縺ｦ `dns.resolve4 ### dns.resolveMx(domain, callback) `dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲［ail exchange (`MX` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 `addresses`縺ｯ MX 繝ｬ繧ｳ繝ｼ繝峨ｮ驟榊励〒縲√◎繧後◇繧後ｯ priority 縺ｨ exchange 縺ｮ螻樊ｧ繧呈戟縺｡縺ｾ縺 (萓 `[{'priority': 10, 'exchange': 'mx.example.com'},...]`)縲 @@ -120,9 +142,11 @@ attribute (e.g. `[{'priority': 10, 'exchange': 'mx.example.com'},...]`). ### dns.resolveTxt(domain, callback) `dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲√ユ繧ｭ繧ｹ繝 (`TXT` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 `addresses` 縺ｯ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ `domain` 縺ｮ繝繧ｭ繧ｹ繝医Ξ繧ｳ繝ｼ繝峨ｮ驟榊励〒縺吶 @@ -131,10 +155,12 @@ The same as `dns.resolve()`, but only for text queries (`TXT` records). ### dns.resolveSrv(domain, callback) `dns.resolve()` 縺ｨ蜷後§縺ｧ縺吶′縲√し繝ｼ繝薙せ繝ｬ繧ｳ繝ｼ繝 (`SRV` 繝ｬ繧ｳ繝ｼ繝) 縺縺代ｒ蝠上＞蜷医ｏ縺帙∪縺吶 `addresses` 縺ｯ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ `domain` 縺ｮ SRV 繝ｬ繧ｳ繝ｼ繝峨ｮ驟榊励〒縺吶 @@ -144,33 +170,43 @@ SRV 繝ｬ繧ｳ繝ｼ繝峨ｮ繝励Ο繝代ユ繧｣縺ｯ priority縲『eight縲｝ort縲√◎縺励※ name ### dns.reverse(ip, callback) IP 繧｢繝峨Ξ繧ｹ縺九ｉ繝峨Γ繧､繝ｳ蜷阪ｮ驟榊励∈騾蠑輔″縺ｧ隗｣豎ｺ縺励∪縺吶 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ蠑墓焚 `(err, domains)` 繧呈戟縺｡縺ｾ縺吶 繧ｨ繝ｩ繝ｼ縺後≠縺｣縺溷ｴ蜷医〜err` 縺ｯ髱 null 縺ｧ Error 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｨ縺ｪ繧翫∪縺吶 縺ｩ縺ｮ DNS 蝠上＞蜷医ｏ縺帙ｂ繧ｨ繝ｩ繝ｼ繧ｳ繝ｼ繝峨ｒ霑斐○縺ｾ縺吶 - `dns.TEMPFAIL`: 繧ｿ繧､繝繧｢繧ｦ繝医ヾERVFAIL 縺ゅｋ縺縺ｯ蜷梧ｧ倥ｮ繧ゅｮ縲 - `dns.PROTOCOL`: 蠢懃ｭ斐′荳肴ｭ｣縲 diff --git a/doc/api/events.markdown b/doc/api/events.markdown index ef4b0b5573a2..b056443900ac 100644 --- a/doc/api/events.markdown +++ b/doc/api/events.markdown @@ -1,10 +1,12 @@ ## Events Node 縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ螟壹￥縺ｯ繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺: `net.Server`縺ｯ逶ｸ謇九°繧画磁邯壹☆繧九◆縺ｳ縺ｫ繧､繝吶Φ繝医ｒ逕滓舌＠縲 @@ -13,15 +15,19 @@ Node 縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ螟壹￥縺ｯ繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺: 谺｡縺ｮ繧医≧縺ｫ縺吶ｋ縺薙→縺ｧ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺ｧ縺阪∪縺: `require("events");` 騾壼ｸｸ縲√う繝吶Φ繝亥錐縺ｯ繧ｭ繝｣繝｡繝ｫ險俶ｳ輔↓繧医ｋ譁蟄怜励〒陦ｨ迴ｾ縺輔ｌ縺ｾ縺吶′縲 蜴ｳ譬ｼ縺ｪ蛻ｶ髯舌〒縺ｯ縺ｪ縺上√←繧薙↑譁蟄怜励〒繧ょ女縺大･繧後ｉ繧後∪縺吶 髢｢謨ｰ繧偵が繝悶ず繧ｧ繧ｯ繝医↓繧｢繧ｿ繝繝√☆繧九％縺ｨ縺後〒縺阪√◎繧後ｯ繧､繝吶Φ繝医′逕滓舌＆繧後◆譎ゅ↓螳溯｡後＆繧後∪縺吶 縺薙ｌ繧峨ｮ髢｢謨ｰ縺ｯ*繝ｪ繧ｹ繝翫ｼ*縺ｨ蜻ｼ縺ｰ繧後∪縺吶 @@ -30,15 +36,19 @@ is emitted. These functions are called _listeners_. ### events.EventEmitter EventEmitter繧ｯ繝ｩ繧ｹ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｫ縺ｯ縲〜require('events').EventEmitter` 繧剃ｽｿ縺縺ｾ縺吶 `EventEmitter` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺後お繝ｩ繝ｼ縺ｫ驕ｭ驕縺励◆譎ゅ 蜈ｸ蝙狗噪縺ｪ蜍穂ｽ懊ｯ `'error'` 繧､繝吶Φ繝医ｒ逕滓舌☆繧九％縺ｨ縺ｧ縺吶 @@ -46,8 +56,10 @@ node 縺ｧ縺ｯ繧ｨ繝ｩ繝ｼ繧､繝吶Φ繝医ｯ迚ｹ蛻･縺ｫ謇ｱ繧上ｌ縺ｾ縺呻ｼ 繧ゅ＠縺昴ｮ繝ｪ繧ｹ繝翫ｼ縺後↑縺代ｌ縺ｰ縲√ョ繝輔か繝ｫ繝医ｮ蜍穂ｽ懊ｯ繧ｹ繧ｿ繝繧ｯ繝医Ξ繝ｼ繧ｹ繧貞ｺ蜉帙＠縺ｦ繝励Ο繧ｰ繝ｩ繝繧堤ｵゆｺ縺吶ｋ縺薙→縺ｧ縺吶 蜈ｨ縺ｦ縺ｮ EventEmitter 縺ｯ縲∵眠縺励＞繝ｪ繧ｹ繝翫ｼ縺悟刈縺医ｉ繧後ｋ縺ｨ繧､繝吶Φ繝 `'newListener'` 繧堤函謌舌＠縺ｾ縺吶 @@ -55,7 +67,9 @@ added. #### emitter.on(event, listener) 謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励ｮ譛蠕後↓繝ｪ繧ｹ繝翫ｼ繧定ｿｽ蜉縺励∪縺吶 @@ -66,9 +80,11 @@ Adds a listener to the end of the listeners array for the specified event. #### emitter.once(event, listener) **荳蝗樣剞繧**縺ｮ繝ｪ繧ｹ繝翫ｼ繧偵う繝吶Φ繝医↓霑ｽ蜉縺励∪縺吶 縺薙ｮ繝ｪ繧ｹ繝翫ｼ縺ｯ繧､繝吶Φ繝医′譛蛻昴↓逋ｺ逕溘＠縺滓凾縺ｫ髯舌ｊ襍ｷ蜍輔＆繧後√◎縺ｮ蠕後〒蜑企勁縺輔ｌ縺ｾ縺吶 @@ -80,8 +96,10 @@ it is removed. #### emitter.removeListener(event, listener) 謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励°繧峨Μ繧ｹ繝翫ｼ繧貞炎髯､縺励∪縺吶 **豕ｨ諢**: 繝ｪ繧ｹ繝翫ｼ縺ｮ閭悟ｾ後↓縺ゅｋ繝ｪ繧ｹ繝翫ｼ驟榊励ｮ繧､繝ｳ繝繝繧ｯ繧ｹ縺悟､牙喧縺励∪縺吶 @@ -97,7 +115,9 @@ Remove a listener from the listener array for the specified event. #### emitter.removeAllListeners(event) 謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励°繧牙ｨ縺ｦ縺ｮ繝ｪ繧ｹ繝翫ｼ繧貞炎髯､縺励∪縺吶 @@ -105,8 +125,10 @@ Removes all listeners from the listener array for the specified event. #### emitter.listeners(event) 謖螳壹＆繧後◆繧､繝吶Φ繝医↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ驟榊励ｒ霑斐＠縺ｾ縺吶 縺薙ｮ驟榊励ｯ螟画峩縺吶ｋ縺薙→縺後〒縺阪∪縺吶∽ｾ九∴縺ｰ繝ｪ繧ｹ繝翫ｼ繧貞炎髯､縺吶ｋ縺ｪ縺ｩ縲 @@ -119,7 +141,9 @@ manipulated, e.g. to remove listeners. #### emitter.emit(event, [arg1], [arg2], [...]) 謠蝉ｾ帙＆繧後◆蠑墓焚縺ｮ荳ｦ縺ｳ縺ｧ縺昴ｌ縺槭ｌ縺ｮ繝ｪ繧ｹ繝翫ｼ繧貞ｮ溯｡後＠縺ｾ縺吶 @@ -128,6 +152,8 @@ Execute each of the listeners in order with the supplied arguments. `function (event, listener) { }` 縺薙ｮ繧､繝吶Φ繝医ｯ隱ｰ縺九′譁ｰ縺励＞繝ｪ繧ｹ繝翫ｼ繧定ｿｽ蜉縺吶ｋ縺ｨ縺縺､縺ｧ繧ら函謌舌＆繧後∪縺吶 diff --git a/doc/api/fs.markdown b/doc/api/fs.markdown index 5df20ca22b14..57d5967783fc 100644 --- a/doc/api/fs.markdown +++ b/doc/api/fs.markdown @@ -1,19 +1,23 @@ ## File System File I/O 縺ｯ POSIX 讓呎ｺ悶ｮ髢｢謨ｰ縺ｫ蟇ｾ縺吶ｋ蜊倡ｴ斐↑繝ｩ繝繝代ｼ縺ｨ縺励※謠蝉ｾ帙＆繧後∪縺吶 縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ逕ｨ縺吶ｋ縺ｫ縺ｯ `require('fs')` 縺励※縺上□縺輔＞縲 蜈ｨ縺ｦ縺ｮ繝｡繧ｽ繝繝峨ｯ髱槫酔譛溘→蜷梧悄縺ｮ蠖｢蠑上′縺ゅｊ縺ｾ縺吶 髱槫酔譛溘ｮ蠖｢蠑上ｯ蟶ｸ縺ｫ譛蠕後ｮ蠑墓焚縺ｨ縺励※螳御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧貞女縺大叙繧翫∪縺吶 蠑墓焚縺ｨ縺励※貂｡縺輔ｌ繧句ｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ繝｡繧ｽ繝繝峨↓萓晏ｭ倥＠縺ｾ縺吶′縲 @@ -21,7 +25,9 @@ completed successfully, then the first argument will be `null` or `undefined`. 謫堺ｽ懊′謌仙粥縺ｧ螳御ｺ縺吶ｋ縺ｨ譛蛻昴ｮ蠑墓焚縺ｯ `null` 縺ｾ縺溘ｯ `undefined` 縺ｨ縺ｪ繧翫∪縺 髱槫酔譛溘ヰ繝ｼ繧ｸ繝ｧ繝ｳ縺ｮ萓九〒縺: @@ -33,7 +39,9 @@ Here is an example of the asynchronous version: }); 蜷梧悄繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ縺: @@ -43,8 +51,10 @@ Here is the synchronous version: console.log('successfully deleted /tmp/hello'); 髱槫酔譛溘Γ繧ｽ繝繝峨〒縺ｯ鬆蠎上ｮ菫晁ｨｼ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 莉･荳九ｮ繧医≧縺ｪ蛯ｾ蜷代ｮ繧ｨ繝ｩ繝ｼ縺後≠繧翫∪縺吶 @@ -59,8 +69,10 @@ following is prone to error: }); `fs.stat` 縺ｯ `fs.rename` 繧医ｊ蜈医↓螳溯｡後＆繧後ｋ蜿ｯ閭ｽ諤ｧ縺後≠繧較縺ｾ縺吶 豁｣縺励＞譁ｹ豕輔ｯ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧偵メ繧ｧ繝ｼ繝ｳ縺吶ｋ縺薙→縺ｧ縺吶 @@ -74,9 +86,11 @@ The correct way to do this is to chain the callbacks. }); 蠢吶＠縺繝励Ο繧ｻ繧ｹ縺ｧ縺ｯ縲√励Ο繧ｰ繝ｩ繝槭ｯ縺薙ｌ繧峨ｮ髱槫酔譛溘ヰ繝ｼ繧ｸ繝ｧ繝ｳ繧剃ｽｿ縺縺薙→縺*蠑ｷ縺乗耳螂ｨ*縺輔ｌ縺ｾ縺吶 蜷梧悄繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｯ縺昴ｌ縺悟ｮ御ｺ縺吶ｋ縺ｾ縺ｧ繝励Ο繧ｻ繧ｹ蜈ｨ菴薙ｒ繝悶Ο繝繧ｯ縺励∪縺 ｼ 蜈ｨ縺ｦ縺ｮ謗･邯壹ｒ蛛懈ｭ｢縺励∪縺吶 @@ -84,53 +98,67 @@ the entire process until they complete--halting all connections. ### fs.rename(path1, path2, [callback]) 髱槫酔譛溘ｮ rename(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.renameSync(path1, path2) 蜷梧悄縺ｮ rename(2)縲 ### fs.truncate(fd, len, [callback]) 髱槫酔譛溘ｮ ftruncate(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.truncateSync(fd, len) 蜷梧悄縺ｮ ftruncate(2)縲 ### fs.chmod(path, mode, [callback]) 髱槫酔譛溘ｮ chmod(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.chmodSync(path, mode) 蜷梧悄縺ｮ chmod(2)縲 ### fs.stat(path, [callback]) 髱槫酔譛溘ｮ stat(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, stats)`縺ｧ縲 `stats` 縺ｯ `fs.Stats` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶よｬ｡縺ｮ繧医≧縺ｫ縺ｪ繧翫∪縺吶 @@ -150,17 +178,21 @@ Asynchronous stat(2). The callback gets two arguments `(err, stats)` where ctime: '2009-06-29T11:11:40Z' } 繧医ｊ隧ｳ縺励￥縺ｯ蠕瑚ｿｰ縺ｮ `fs.Stats` 縺ｮ遽繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### fs.lstat(path, [callback]) 髱槫酔譛溘ｮ lstat(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, stats)`縺ｧ縲 `stats` 縺ｯ `fs.Stats` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 @@ -170,8 +202,10 @@ lstat() 縺ｯ繝代せ縺後す繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ縺縺｣縺溷ｴ蜷医↓縲 ### fs.fstat(fd, [callback]) 髱槫酔譛溘ｮ fstat(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, stats)` 縺ｧ縲 `stats` 縺ｯ `fs.Stats` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 @@ -179,135 +213,171 @@ Asynchronous fstat(2). The callback gets two arguments `(err, stats)` where ### fs.statSync(path) 蜷梧悄縺ｮ stat(2)縲Ａfs.Stats` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.lstatSync(path) 蜷梧悄縺ｮ lstat(2)縲Ａfs.Stats` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.fstatSync(fd) 蜷梧悄縺ｮ fstat(2)縲Ａfs.Stats` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.link(srcpath, dstpath, [callback]) 髱槫酔譛溘ｮ link(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.linkSync(dstpath, srcpath) 蜷梧悄縺ｮ link(2)縲 ### fs.symlink(linkdata, path, [callback]) 髱槫酔譛溘ｮ symlink(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.symlinkSync(linkdata, path) 蜷梧悄縺ｮ symlink(2)縲 ### fs.readlink(path, [callback]) 髱槫酔譛溘ｮ readlink(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, resolvedPath)`縺ｧ縺吶 ### fs.readlinkSync(path) 蜷梧悄縺ｮ readlink(2)縲りｧ｣豎ｺ縺輔ｌ縺溘ヱ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.realpath(path, [callback]) 髱槫酔譛溘ｮ realpath(2)縲ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, resolvedPath)`縺ｧ縺吶 ### fs.realpathSync(path) 蜷梧悄縺ｮ realpath(2)縲りｧ｣豎ｺ縺輔ｌ縺溘ヱ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### fs.unlink(path, [callback]) 髱槫酔譛溘ｮ unlink(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.unlinkSync(path) 蜷梧悄縺ｮ unlink(2)縲 ### fs.rmdir(path, [callback]) 髱槫酔譛溘ｮ rmdir(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.rmdirSync(path) 蜷梧悄縺ｮ rmdir(2)縲 ### fs.mkdir(path, mode, [callback]) 髱槫酔譛溘ｮ mkdir(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.mkdirSync(path, mode) 蜷梧悄縺ｮ mkdir(2)縲 ### fs.readdir(path, [callback]) 髱槫酔譛溘ｮ readdir(3)縲ゅョ繧｣繝ｬ繧ｯ繝医Μ縺ｮ蜀螳ｹ繧定ｪｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧 `(err, files)`縺ｧ縲 @@ -316,31 +386,39 @@ the names of the files in the directory excluding `'.'` and `'..'`. ### fs.readdirSync(path) 蜷梧悄縺ｮ readdir(3)縲Ａ'.'` 縺ｨ `'..'` 繧帝勁縺上ョ繧｣繝ｬ繧ｯ繝医Μ蜀縺ｮ繝輔ぃ繧､繝ｫ蜷阪ｮ驟榊励ｒ霑斐＠縺ｾ縺吶 ### fs.close(fd, [callback]) 髱槫酔譛溘ｮ close(2)縲ょｮ御ｺ繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｫ縺ｯ逋ｺ逕溘＠蠕励ｋ萓句､紋ｻ･螟悶↓蠑墓焚縺梧ｸ｡縺輔ｌ繧九％縺ｨ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 ### fs.closeSync(fd) 蜷梧悄縺ｮ close(2)縲 ### fs.open(path, flags, mode=0666, [callback]) 髱槫酔譛溘ｮ繝輔ぃ繧､繝ｫ繧ｪ繝ｼ繝励Φ縲Ｐpen(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 繝輔Λ繧ｰ縺ｯ 'r'縲'r+'縲'w'縲'w+'縲'a'縲√≠繧九＞縺ｯ 'a+' 縺ｧ縺吶 @@ -349,34 +427,44 @@ or 'a+'. The callback gets two arguments `(err, fd)`. ### fs.openSync(path, flags, mode=0666) 蜷梧悄縺ｮ open(2)縲 ### fs.write(fd, buffer, offset, length, position, [callback]) `fd` 縺ｧ謖螳壹＆繧後◆繝輔ぃ繧､繝ｫ縺ｫ `buffer` 繧呈嶌縺崎ｾｼ縺ｿ縺ｾ縺吶 `position` 縺ｯ繝繝ｼ繧ｿ縺梧嶌縺崎ｾｼ縺ｾ繧後ｋ菴咲ｽｮ繧偵ヵ繧｡繧､繝ｫ縺ｮ蜈磯ｭ縺九ｉ縺ｮ繧ｪ繝輔そ繝繝医〒遉ｺ縺励∪縺吶 `position` 縺 `null` 縺ｮ蝣ｴ蜷医√ョ繝ｼ繧ｿ縺ｯ迴ｾ蝨ｨ縺ｮ菴咲ｽｮ縺九ｉ譖ｸ縺崎ｾｼ縺ｾ繧後∪縺吶 pwrite(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚縺御ｸ弱∴繧峨ｌ繧 `(err, written)` 縺ｧ縲 `written` 縺ｯ譖ｸ縺崎ｾｼ縺ｾ繧後◆*繝舌う繝域焚*繧堤､ｺ縺励∪縺吶 @@ -384,73 +472,95 @@ specifies how many _bytes_ were written. ### fs.writeSync(fd, buffer, offset, length, position) 蜷梧悄迚医ｮ繝舌ャ繝輔ぃ縺ｫ蝓ｺ縺･縺 `fs.write()`縲よ嶌縺崎ｾｼ縺ｾ繧後◆繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 ### fs.writeSync(fd, str, position, encoding='utf8') 蜷梧悄迚医ｮ譁蟄怜励↓蝓ｺ縺･縺 `fs.write()`縲よ嶌縺崎ｾｼ縺ｾ繧後◆繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 ### fs.read(fd, buffer, offset, length, position, [callback]) `fd` 縺ｧ謖螳壹＆繧後◆繝輔ぃ繧､繝ｫ縺九ｉ繝繝ｼ繧ｿ繧定ｪｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶 `buffer` 縺ｯ繝繝ｼ繧ｿ縺梧嶌縺崎ｾｼ縺ｾ繧後ｋ繝舌ャ繝輔ぃ縺ｧ縺吶 `offset` 縺ｯ譖ｸ縺崎ｾｼ縺ｿ繧帝幕蟋九☆繧九ヰ繝繝輔ぃ蜀縺ｮ繧ｪ繝輔そ繝繝医〒縺吶 `length` 縺ｯ隱ｭ縺ｿ霎ｼ繧繝舌う繝域焚繧呈欠螳壹☆繧区紛謨ｰ縺ｧ縺吶 `position` 縺ｯ繝輔ぃ繧､繝ｫ縺ｮ隱ｭ縺ｿ霎ｼ縺ｿ繧帝幕蟋九☆繧倶ｽ咲ｽｮ繧呈欠螳壹☆繧区紛謨ｰ縺ｧ縺吶 `position` 縺 `null` 縺ｮ蝣ｴ蜷医√ョ繝ｼ繧ｿ縺ｯ迴ｾ蝨ｨ縺ｮ菴咲ｽｮ縺九ｉ隱ｭ縺ｿ霎ｼ縺ｾ繧後∪縺吶 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ2縺､縺ｮ蠑墓焚縺御ｸ弱∴繧峨ｌ繧 `(err, bytesRead)` 縺ｧ縺吶 ### fs.readSync(fd, buffer, offset, length, position) 蜷梧悄迚医ｮ繝舌ャ繝輔ぃ縺ｫ蝓ｺ縺･縺 `fs.read`縲ＡbytesRead` 縺ｮ謨ｰ繧定ｿ斐＠縺ｾ縺吶 ### fs.readSync(fd, length, position, encoding) 蜷梧悄迚医ｮ譁蟄怜励↓蝓ｺ縺･縺 `fs.read`縲ＡbytesRead` 縺ｮ謨ｰ繧定ｿ斐＠縺ｾ縺吶 ### fs.readFile(filename, [encoding], [callback]) 繝輔ぃ繧､繝ｫ蜈ｨ菴薙ｮ蜀螳ｹ繧帝撼蜷梧悄縺ｫ隱ｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶ゆｾ: @@ -460,13 +570,17 @@ Asynchronously reads the entire contents of a file. Example: }); 繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｯ 2 縺､縺ｮ蠑墓焚縺梧ｸ｡縺輔ｌ繧 `(err, data)` 縺ｧ縲〜data` 縺ｯ繝輔ぃ繧､繝ｫ縺ｮ蜀螳ｹ縺ｧ縺吶 繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺梧欠螳壹＆繧後↑縺代ｌ縺ｰ縲∫函縺ｮ繝舌ャ繝輔ぃ縺梧ｸ｡縺輔ｌ縺ｾ縺吶 @@ -474,13 +588,17 @@ If no encoding is specified, then the raw buffer is returned. ### fs.readFileSync(filename, [encoding]) 蜷梧悄迚医ｮ `fs.readFile`縲Ａfilename` 縺ｮ蜀螳ｹ繧定ｿ斐＠縺ｾ縺吶 `encoding` 縺梧欠螳壹＆繧後ｋ縺ｨ縺薙ｮ髢｢謨ｰ縺ｯ譁蟄怜励ｒ霑斐＠縺ｾ縺吶 縺昴≧縺ｧ縺ｪ縺代ｌ縺ｰ繝舌ャ繝輔ぃ繧定ｿ斐＠縺ｾ縺吶 @@ -489,12 +607,16 @@ returns a buffer. ### fs.writeFile(filename, data, encoding='utf8', [callback]) 髱槫酔譛溘↓繝繝ｼ繧ｿ繧偵ヵ繧｡繧､繝ｫ縺ｫ譖ｸ縺崎ｾｼ縺ｿ縺ｾ縺吶Ａdata` 縺ｯ譁蟄怜励∪縺溘ｯ繝舌ャ繝輔ぃ縺ｧ縺吶 萓: @@ -506,27 +628,35 @@ Example: ### fs.writeFileSync(filename, data, encoding='utf8') 蜷梧悄迚医ｮ `fs.writeFile`縲 ### fs.watchFile(filename, [options], listener) `filename` 縺ｮ螟画峩繧堤屮隕悶＠縺ｾ縺吶ゅさ繝ｼ繝ｫ繝舌ャ繧ｯ縺ｮ `listener` 縺ｯ繝輔ぃ繧､繝ｫ縺悟､画峩縺輔ｌ繧句ｺｦ縺ｫ蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 `listener` 縺ｯ迴ｾ蝨ｨ縺ｮ迥ｶ諷九が繝悶ず繧ｧ繧ｯ繝医→蜑阪ｮ迥ｶ諷九が繝悶ず繧ｧ繧ｯ繝医ｮ 2 縺､縺ｮ蠑墓焚繧貞女縺大叙繧翫∪縺: @@ -536,25 +666,32 @@ stat object: }); 縺薙ｌ繧峨ｮ迥ｶ諷九が繝悶ず繧ｧ繧ｯ繝医ｯ `fs.Stat` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 ### fs.unwatchFile(filename) `filename` 縺ｮ螟画峩縺ｫ蟇ｾ縺吶ｋ逶｣隕悶ｒ邨ゆｺ縺励∪縺吶 ## fs.Stats `fs.stat()` 縺ｨ `fs.lstat()` 縺九ｉ霑斐＆繧後ｋ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ縺薙ｮ蝙九〒縺吶 - `stats.isFile()` - `stats.isDirectory()` @@ -574,19 +712,25 @@ Objects returned from `fs.stat()` and `fs.lstat()` are of this type. ## fs.ReadStream `ReadStream` 縺ｯ `Readable Stream` 縺ｧ縺吶 ### fs.createReadStream(path, [options]) 譁ｰ縺励＞ ReadStream 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺 (`Readable Stream` 繧貞盾辣ｧ縺励※縺上□縺輔＞)縲 `options` 縺ｯ莉･荳九ｮ繝繝輔か繝ｫ繝亥､繧呈戟縺､繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺: @@ -596,9 +740,11 @@ Returns a new ReadStream object (See `Readable Stream`). bufferSize: 4096 } 繝輔ぃ繧､繝ｫ蜈ｨ菴薙ｒ隱ｭ縺ｿ霎ｼ繧莉｣繧上ｊ縺ｫ荳驛ｨ縺ｮ遽蝗ｲ繧定ｪｭ縺ｿ霎ｼ繧縺溘ａ縲 `options` 縺ｫ `start` 縺翫ｈ縺ｳ `end` 繧貞性繧√ｋ縺薙→縺後〒縺阪∪縺吶 @@ -606,7 +752,9 @@ start at 0. When used, both the limits must be specified always. 菴ｿ縺髫帙↓縺ｯ縺縺､縺ｧ繧ゅ∽ｸ｡譁ｹ繧貞酔譎ゅ↓謖螳壹＠縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 100 繝舌う繝医ｮ髟ｷ縺輔ｒ謖√▽繝輔ぃ繧､繝ｫ縺ｮ譛蠕後ｮ 10 繝舌う繝医ｒ隱ｭ縺ｿ霎ｼ繧萓: @@ -616,7 +764,9 @@ An example to read the last 10 bytes of a file which is 100 bytes long: ## fs.WriteStream `WriteStream` 縺ｯ `Writable Stream` 縺ｧ縺吶 @@ -625,19 +775,25 @@ An example to read the last 10 bytes of a file which is 100 bytes long: `function (fd) { }` `fd` 縺ｯ WriteStream 縺ｫ菴ｿ繧上ｌ縺ｦ縺繧九ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌〒縺吶 ### fs.createWriteStream(path, [options]) 譁ｰ縺励＞ WriteStream 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺 (`Writable Stream` 繧貞盾辣ｧ縺励※縺上□縺輔＞)縲 `options` 縺ｯ莉･荳九ｮ繝繝輔か繝ｫ繝亥､繧呈戟縺､繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺: diff --git a/doc/api/globals.markdown b/doc/api/globals.markdown index c6183147342b..41be2a8e81ef 100644 --- a/doc/api/globals.markdown +++ b/doc/api/globals.markdown @@ -1,36 +1,46 @@ ## Global Objects 縺薙ｌ繧峨ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｹ繧ｳ繝ｼ繝励〒譛牙柑縺ｧ縺ゅｊ縲√←縺薙°繧峨〒繧ゅい繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 ### global 繧ｰ繝ｭ繝ｼ繝舌Ν縺ｪ繝阪ｼ繝繧ｹ繝壹ｼ繧ｹ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### process 繝励Ο繧ｻ繧ｹ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶Ａ'process object'` 縺ｮ遽繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### require() require 繝｢繧ｸ繝･繝ｼ繝ｫ繧呈欠縺励∪縺吶Ａ'Modules'` 縺ｮ遽繧貞盾辣ｧ縺励※縺上□縺輔＞縲 ### require.resolve() `require()` 縺ｮ蜀驛ｨ縺ｧ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ菴咲ｽｮ繧呈､懃ｴ｢縺吶ｋ縺溘ａ縺ｫ菴ｿ繧上ｌ縺ｾ縺吶 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繝ｭ繝ｼ繝峨ｯ陦後ｏ縺壹√ヵ繧｡繧､繝ｫ蜷阪ｒ隗｣豎ｺ縺励※霑斐☆縺縺代〒縺吶 @@ -38,14 +48,18 @@ but rather than loading the module, just return the resolved filename. ### require.paths `require()` 縺ｮ縺溘ａ縺ｮ繧ｵ繝ｼ繝√ヱ繧ｹ縺ｮ驟榊励〒縺吶 縺薙ｮ驟榊励ｯ繧ｫ繧ｹ繧ｿ繝繝代せ繧定ｿｽ蜉縺吶ｋ縺溘ａ縺ｫ螟画峩縺吶ｋ縺薙→縺後〒縺阪∪縺吶 萓: 繧ｵ繝ｼ繝√Μ繧ｹ繝医ｮ蜈磯ｭ縺ｫ譁ｰ縺励＞繝代せ繧定ｿｽ蜉縺吶ｋ @@ -55,14 +69,18 @@ Example: add a new path to the beginning of the search list ### __filename 螳溯｡後＆繧後※縺繧九せ繧ｯ繝ｪ繝励ヨ縺ｮ繝輔ぃ繧､繝ｫ蜷阪〒縺吶ゅ％繧後ｯ邨ｶ蟇ｾ繝代せ縺ｧ縺ゅｊ縲 蠢縺壹＠繧ゅさ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚縺ｧ貂｡縺輔ｌ縺溘ヵ繧｡繧､繝ｫ蜷阪→蜷後§縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 萓: `node example.js` 繧 `/Users/mjr` 縺ｧ螳溯｡後☆繧 @@ -72,12 +90,16 @@ Example: running `node example.js` from `/Users/mjr` ### __dirname 繧ｹ繧ｯ繝ｪ繝励ヨ縺悟ｮ溯｡後＆繧後※縺繧九ョ繧｣繝ｬ繧ｯ繝医Μ蜷阪〒縺吶 萓: `node example.js` 繧 `/Users/mjr` 縺ｧ螳溯｡後☆繧 @@ -88,9 +110,11 @@ Example: running `node example.js` from `/Users/mjr` ### module 迴ｾ蝨ｨ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｸ縺ｮ蜿らｧ縺ｧ縺吶 迚ｹ縺ｫ `module.exports` 縺ｯ `exports` 繧ｪ繝悶ず繧ｧ繧ｯ繝医→蜷後§縺ｧ縺吶 diff --git a/doc/api/http.markdown b/doc/api/http.markdown index 22a8aa16fbc1..b7117ed031fb 100644 --- a/doc/api/http.markdown +++ b/doc/api/http.markdown @@ -1,16 +1,20 @@ ## HTTP HTTP 繧ｵ繝ｼ繝舌♀繧医ｳ繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｒ菴ｿ逕ｨ縺吶ｋ縺ｫ縺ｯ縺縺壹ｌ繧 `require('http')` 縺悟ｿ隕√〒縺吶 Node 縺ｮ HTTP 繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｯ縲 莨晉ｵｱ逧縺ｫ謇ｱ縺縺碁屮縺励°縺｣縺溘励Ο繝医さ繝ｫ縺ｮ螟壹￥縺ｮ讖溯ｽ繧偵し繝昴ｼ繝医☆繧九ｈ縺縺ｫ險ｭ險医＆繧後※縺縺ｾ縺吶 @@ -19,7 +23,9 @@ Node 縺ｮ HTTP 繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｯ縲 ｼ 蛻ｩ逕ｨ閠縺ｯ繧ｹ繝医Μ繝ｼ繝繝繝ｼ繧ｿ繧剃ｽｿ縺縺薙→縺後〒縺阪∪縺吶 HTTP 繝｡繝繧ｻ繝ｼ繧ｸ繝倥ャ繝縺ｯ縺薙ｮ繧医≧縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医→縺励※陦ｨ迴ｾ縺輔ｌ縺ｾ縺: @@ -29,29 +35,37 @@ HTTP 繝｡繝繧ｻ繝ｼ繧ｸ繝倥ャ繝縺ｯ縺薙ｮ繧医≧縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医→縺励※陦ｨ迴ｾ 'accept': '*/*' } 繧ｭ繝ｼ縺ｯ蟆乗枚蟄怜喧縺輔ｌ縺ｾ縺吶ょ､縺ｯ螟画峩縺輔ｌ縺ｾ縺帙ｓ縲 閠縺医ｉ繧後ｋ HTTP 繧｢繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ繧貞ｮ悟ｨ縺ｫ繧ｵ繝昴ｼ繝医☆繧九◆繧√↓縲 Node 縺ｮ HTTP API 縺ｯ縺ｨ縺ｦ繧ゆｽ取ｰｴ貅悶〒縺吶ゅ◎繧後ｯ繧ｹ繝医Μ繝ｼ繝縺ｮ繝上Φ繝峨Μ繝ｳ繧ｰ縺ｨ繝｡繝繧ｻ繝ｼ繧ｸ縺ｮ隗｣譫舌□縺代↓蟇ｾ蜃ｦ縺励∪縺吶 隗｣譫舌ｯ繝｡繝繧ｻ繝ｼ繧ｸ繧偵倥ャ繝縺ｨ繝懊ョ繧｣縺ｫ蛻縺代∪縺吶′縲∝ｮ滄圀縺ｮ繝倥ャ繝縺ｨ繝懊ョ繧｣縺ｯ隗｣譫舌＠縺ｾ縺帙ｓ縲 繝励Λ繝繝医ヵ繧ｩ繝ｼ繝縺ｧ OpenSSL 縺悟茜逕ｨ蜿ｯ閭ｽ縺ｧ縺ゅｌ縺ｰ HTTPS 縺後し繝昴ｼ繝医＆繧後∪縺吶 ## http.Server 縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: @@ -60,8 +74,10 @@ This is an `EventEmitter` with the following events: `function (request, response) { }` `request` 縺ｯ `http.ServerRequest` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縲 `response` 縺ｯ `http.ServerResponse` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 @@ -71,9 +87,11 @@ This is an `EventEmitter` with the following events: `function (stream) { }` 譁ｰ縺励＞ TCP 繧ｹ繝医Μ繝ｼ繝縺檎｢ｺ遶九＠縺滓凾縲 `stream` 縺ｯ `net.Stream` 蝙九ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 @@ -85,7 +103,9 @@ This is an `EventEmitter` with the following events: `function (errno) { }` 繧ｵ繝ｼ繝舌′繧ｯ繝ｭ繝ｼ繧ｺ縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 @@ -94,8 +114,10 @@ This is an `EventEmitter` with the following events: `function (request, response) {}` 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｮ蠎ｦ縺ｫ逕滓舌＆繧後∪縺吶ゅさ繝阪け繧ｷ繝ｧ繝ｳ縺斐→縺ｫ隍謨ｰ縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医′縺ゅｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞ (Keep Alive 縺ｪ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ蝣ｴ蜷)縲 @@ -105,18 +127,22 @@ per connection (in the case of keep-alive connections). `function (request, response) {}` http縺ｮ Expect: 100-continue 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ蜿嶺ｿ｡縺吶ｋ蠎ｦ縺ｫ逕滓舌＆繧後∪縺吶 縺薙ｮ繧､繝吶Φ繝医′逶｣隕悶＆繧後↑縺蝣ｴ蜷医√し繝ｼ繝舌ｯ閾ｪ蜍慕噪縺ｫ 100 Continue 繧貞ｿ懃ｭ斐＠縺ｾ縺吶 縺薙ｮ繧､繝吶Φ繝医ｒ蜃ｦ逅縺吶ｋ蝣ｴ蜷医√け繝ｩ繧､繧｢繝ｳ繝医′繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧帝∽ｿ｡縺礼ｶ壹¢繧九∋縺阪↑繧 `response.writeContinue` 繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺吶 @@ -124,8 +150,10 @@ request body. 驕ｩ蛻縺ｪ HTTP 繝ｬ繧ｹ繝昴Φ繧ｹ (萓九∴縺ｰ 400 Bad Request) 繧堤函謌舌＠縺ｾ縺吶 縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後※蜃ｦ逅縺輔ｌ縺溷ｴ蜷医〜request`繧､繝吶Φ繝医ｯ逕滓舌＆繧後↑縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 @@ -134,17 +162,21 @@ not be emitted. `function (request, socket, head)` 繧ｯ繝ｩ繧､繧｢繝ｳ繝医′ HTTP 縺ｮ繧｢繝繝励げ繝ｬ繝ｼ繝峨ｒ隕∵ｱゅ☆繧句ｺｦ縺ｫ逕滓舌＆繧後∪縺吶 縺薙ｮ繧､繝吶Φ繝医′逶｣隕悶＆繧後↑縺蝣ｴ蜷医√い繝繝励げ繝ｬ繝ｼ繝峨ｒ隕∵ｱゅ＠縺溘け繝ｩ繧､繧｢繝ｳ繝医ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺ｾ縺吶 * `request` 縺ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医う繝吶Φ繝医→蜷梧ｧ倥↓ HTTP 繝ｪ繧ｯ繧ｨ繧ｹ繝医∈縺ｮ蠑墓焚縺ｧ縺吶 * `socket` 縺ｯ繧ｵ繝ｼ繝舌→繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ髢薙ｮ繝阪ャ繝医Ρ繝ｼ繧ｯ繧ｽ繧ｱ繝繝医〒縺吶 @@ -152,9 +184,11 @@ closed. 遨ｺ縺ｮ蝣ｴ蜷医ｂ縺ゅｊ縺ｾ縺吶 縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後◆蠕後√Μ繧ｯ繧ｨ繧ｹ繝亥縺ｮ繧ｽ繧ｱ繝繝医ｯ繧ゅ≧ `data` 繧､繝吶Φ繝医Μ繧ｹ繝翫ｼ繧呈戟縺｡縺ｾ縺帙ｓ縲 縺薙ｮ繧ｽ繧ｱ繝繝医〒繧ｵ繝ｼ繝舌∈騾√ｉ繧後◆繝繝ｼ繧ｿ繧呈桶縺縺溘ａ縺ｫ縺昴ｌ繧偵ヰ繧､繝ｳ繝峨＠縺ｪ縺代ｌ縺ｰ縺ｪ繧峨↑縺縺薙→繧呈э蜻ｳ縺励∪縺吶 @@ -164,41 +198,53 @@ sent to the server on that socket. `function (exception) {}` 繧ｯ繝ｩ繧､繧｢繝ｳ繝医さ繝阪け繧ｷ繝ｧ繝ｳ縺 'error' 繧､繝吶Φ繝医ｒ逋ｺ縺励◆蝣ｴ蜷 ｼ 縺薙％縺ｫ霆｢騾√＆繧後∪縺吶 ### http.createServer(requestListener) 譁ｰ縺励＞ Web 繧ｵ繝ｼ繝舌が繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 `requestListener` 縺ｯ閾ｪ蜍慕噪縺ｫ `'request'` 繧､繝吶Φ繝医↓蜉縺医ｉ繧後ｋ髢｢謨ｰ縺ｧ縺吶 ### server.listen(port, [hostname], [callback]) 謖螳壹＆繧後◆繝昴ｼ繝医→繝帙せ繝亥錐縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ蜿励¢蜈･繧後ｒ髢句ｧ九＠縺ｾ縺吶 繝帙せ繝亥錐縺檎怐逡･縺輔ｌ繧九→縲√し繝ｼ繝舌ｯ縺ｩ繧薙↑ IPv4 繧｢繝峨Ξ繧ｹ縺ｸ縺ｮ謗･邯壹ｂ蜿励¢蜈･繧後∪縺 (`INADDR_ANY`)縲 UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｒ蠕縺｡蜿励¢繧句ｴ蜷医√昴ｼ繝医→繝帙せ繝亥錐縺ｧ縺ｯ縺ｪ縺上ヵ繧｡繧､繝ｫ蜷阪ｒ謠蝉ｾ帙＠縺ｾ縺吶 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶よ怙蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝昴ｼ繝医ｒ繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -206,13 +252,17 @@ when the server has been bound to the port. ### server.listen(path, [callback]) `path` 縺ｧ荳弱∴繧峨ｌ縺溘さ繝阪け繧ｷ繝ｧ繝ｳ繧貞ｾ縺｡蜿励¢繧 UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｮ繧ｵ繝ｼ繝舌ｒ髢句ｧ九＠縺ｾ縺吶 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶よ怙蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -220,7 +270,9 @@ when the server has been bound. ### server.close() 繧ｵ繝ｼ繝舌′譁ｰ縺励＞繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺台ｻ倥¢繧九ｮ繧堤ｵゆｺ縺励∪縺吶 @@ -228,14 +280,18 @@ Stops the server from accepting new connections. ## http.ServerRequest 縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ HTTP 繧ｵ繝ｼ繝仙驛ｨ ｼ 繝ｦ繝ｼ繧ｶ縺ｧ縺ｯ縺ｪ縺 ｼ 縺ｧ菴懈舌＆繧後 `'request'` 繝ｪ繧ｹ繝翫ｼ縺ｮ隨ｬ1蠑墓焚縺ｨ縺励※貂｡縺輔ｌ縺ｾ縺吶 縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: @@ -244,15 +300,19 @@ This is an `EventEmitter` with the following events: `function (chunk) { }` 繝｡繝繧ｻ繝ｼ繧ｸ繝懊ョ繧｣縺ｮ譁ｭ迚繧貞女菫｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 萓: 荳縺､縺ｮ蠑墓焚縺ｨ縺励※繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ縺御ｸ弱∴繧峨ｌ縺ｾ縺吶 霆｢騾√お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ繝繧ｳ繝ｼ繝峨＆繧後∪縺吶 @@ -264,8 +324,10 @@ body chunk is a string. The body encoding is set with `function () { }` 繝｡繝繧ｻ繝ｼ繧ｸ縺斐→縺ｫ蜴ｳ蟇縺ｫ荳蝗樒函謌舌＆繧後∪縺吶ょｼ墓焚縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後◆蠕後√％縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医〒逕滓舌＆繧後ｋ繧､繝吶Φ繝医ｯ縺ゅｊ縺ｾ縺帙ｓ縲 @@ -274,8 +336,10 @@ emitted no other events will be emitted on the request. ### request.method 繝ｪ繧ｯ繧ｨ繧ｹ繝医Γ繧ｽ繝繝峨ｒ陦ｨ縺呎枚蟄怜励〒縺吶ょ盾辣ｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺吶 萓: `'GET'`縲〜'DELETE'` @@ -284,8 +348,10 @@ The request method as a string. Read only. Example: ### request.url 繝ｪ繧ｯ繧ｨ繧ｹ繝 URL 繧定｡ｨ縺呎枚蟄怜励〒縺吶 縺薙ｌ縺ｯ螳滄圀縺ｮ HTTP 繝ｪ繧ｯ繧ｨ繧ｹ繝医↓蟄伜惠縺吶ｋ URL 縺縺代ｒ蜷ｫ縺ｿ縺ｾ縺吶 @@ -296,15 +362,19 @@ present in the actual HTTP request. If the request is: \r\n 縺薙ｮ蝣ｴ蜷医ｮ `request.url` 縺ｯ縺薙≧縺ｪ繧翫∪縺: '/status?name=ryan' URL 縺ｮ隕∫ｴ繧定ｧ｣譫舌＠縺溘＞蝣ｴ蜷医ｯ縲 `require('url').parse(request.url)` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲ゆｾ: @@ -316,9 +386,11 @@ URL 縺ｮ隕∫ｴ繧定ｧ｣譫舌＠縺溘＞蝣ｴ蜷医ｯ縲 pathname: '/status' } 蝠上＞蜷医ｏ縺帶枚蟄怜励°繧峨ヱ繝ｩ繝｡繝ｼ繧ｿ繧貞叙繧雁ｺ縺励◆縺蝣ｴ蜷医ｯ縲 `require('querystring').parse` 髢｢謨ｰ繧貞盾辣ｧ縺吶ｋ縺九 @@ -335,24 +407,30 @@ you can use the `require('querystring').parse` function, or pass ### request.headers 蜿らｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺吶 ### request.trailers 蜿らｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺; HTTP 縺ｮ繝医Ξ繝ｼ繝ｩ縺ｧ縺 (繧ゅ＠縺ゅｌ縺ｰ)縲'end' 繧､繝吶Φ繝医ｮ蠕後↓縺縺醍匱逕溘＠縺ｾ縺吶 ### request.httpVersion HTTP 繝励Ο繝医さ繝ｫ縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ繧定｡ｨ縺呎枚蟄怜励〒縺吶ょ盾辣ｧ縺ｮ縺ｿ蜿ｯ閭ｽ縺ｧ縺吶ゆｾ: `'1.1'`縲〜'1.0'`縲 @@ -363,8 +441,10 @@ HTTP 繝励Ο繝医さ繝ｫ縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ繧定｡ｨ縺呎枚蟄怜励〒縺吶ょ盾辣ｧ縺ｮ縺ｿ蜿ｯ ### request.setEncoding(encoding=null) 繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧定ｨｭ螳壹＠縺ｾ縺吶 `'utf8'` 縺ｾ縺溘ｯ `'binary'` 縺ｮ縺縺壹ｌ縺九〒縺吶 @@ -375,7 +455,9 @@ to `null`, which means that the `'data'` event will emit a `Buffer` object.. ### request.pause() 繝ｪ繧ｯ繧ｨ繧ｹ繝医↓繧医ｋ繧､繝吶Φ繝医ｮ逕滓舌ｒ荳ｭ譁ｭ縺励∪縺吶ゅい繝繝励Ο繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 @@ -383,22 +465,28 @@ Pauses request from emitting events. Useful to throttle back an upload. ### request.resume() 荳ｭ譁ｭ縺輔ｌ縺溘Μ繧ｯ繧ｨ繧ｹ繝医ｒ蜀埼幕縺励∪縺吶 ### request.connection 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｫ髢｢騾｣縺･縺代ｉ繧後◆ `net.Stream` 繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 HTTPS 縺ｧ縺ｯ `request.connection.verifyPeer()` 縺ｨ `request.connection.getPeerCertificate()` 縺ｧ @@ -409,8 +497,10 @@ HTTPS 縺ｧ縺ｯ `request.connection.verifyPeer()` 縺ｨ ## http.ServerResponse 縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ HTTP 繧ｵ繝ｼ繝仙驛ｨ ｼ 繝ｦ繝ｼ繧ｶ縺ｧ縺ｯ縺ｪ縺 ｼ 縺ｧ菴懈舌＆繧後∪縺吶 `'request'` 繝ｪ繧ｹ繝翫ｼ縺ｮ隨ｬ 2 蠑墓焚縺ｨ縺励※貂｡縺輔ｌ縺ｾ縺吶 @@ -419,9 +509,11 @@ passed as the second parameter to the `'request'` event. It is a `Writable Strea ### response.writeContinue() HTTP/1.1 縺ｮ 100 Continue 繝｡繝繧ｻ繝ｼ繧ｸ繧偵け繝ｩ繧､繧｢繝ｳ繝医↓騾∽ｿ｡縺励 繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧帝∽ｿ｡縺励※繧ゅｈ縺縺薙→繧堤､ｺ縺励∪縺吶 @@ -430,10 +522,12 @@ HTTP/1.1 縺ｮ 100 Continue 繝｡繝繧ｻ繝ｼ繧ｸ繧偵け繝ｩ繧､繧｢繝ｳ繝医↓騾∽ｿ｡縺励 ### response.writeHead(statusCode, [reasonPhrase], [headers]) 繝ｬ繧ｹ繝昴Φ繧ｹ繝倥ャ繝繧帝∽ｿ｡縺励∪縺吶 繧ｹ繝繝ｼ繧ｿ繧ｹ繧ｳ繝ｼ繝峨ｯ `404` 縺ｮ繧医≧縺ｪ 3 譯√ｮ謨ｰ蟄励↓繧医ｋ HTTP 繧ｹ繝繝ｼ繧ｿ繧ｹ繧ｳ繝ｼ繝峨〒縺吶 @@ -441,7 +535,9 @@ argument. 繧ｪ繝励す繝ｧ繝ｳ縺ｨ縺励※莠ｺ縺ｫ隱ｭ繧√ｋ蠖｢蠑上ｮ `reasonPhrase` 繧堤ｬｬ 2 蠑墓焚縺ｧ荳弱∴繧九％縺ｨ縺後〒縺阪∪縺吶 萓: @@ -451,8 +547,10 @@ Example: 'Content-Type': 'text/plain' }); 縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝｡繝繧ｻ繝ｼ繧ｸ縺斐→縺ｫ 1 蝗槭□縺大他縺ｳ蜃ｺ縺輔ｌ縺ｪ縺上※縺ｯ縺ｪ繧峨★縲 `response.end()` 縺ｮ蜑阪↓蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 @@ -460,36 +558,44 @@ be called before `response.end()` is called. ### response.write(chunk, encoding='utf8') 縺薙ｮ繝｡繧ｽ繝繝峨ｯ `writeHead` 縺ｮ蠕後↓蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 縺薙ｌ縺ｯ繝ｬ繧ｹ繝昴Φ繧ｹ繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ繧帝∽ｿ｡縺励∪縺吶 縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝懊ョ繧｣縺ｮ騾｣邯壹＠縺滄Κ蛻繧呈署萓帙☆繧九◆繧√↓隍謨ｰ蝗槫他縺ｳ蜃ｺ縺輔ｌ繧九°繧ゅ＠繧後∪縺帙ｓ縲 `chunk` 縺ｯ譁蟄怜励∪縺溘ｯ繝舌ャ繝輔ぃ縺ｫ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 `chunk` 縺梧枚蟄怜励ｮ蝣ｴ蜷医√←縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝峨〒繝舌う繝医せ繝医Μ繝ｼ繝縺ｫ縺吶ｋ縺九ｒ隨ｬ 2 蠑墓焚縺ｧ謖螳壹＠縺ｾ縺吶 繝繝輔か繝ｫ繝医ｮ `encoding` 縺ｯ `'utf8'` 縺ｧ縺吶 **豕ｨ諢**: 縺薙ｌ縺ｯ逕溘ｮ HTTP 繝懊ョ繧｣縺ｧ縲 鬮俶ｰｴ貅悶ｮ繝槭Ν繝√ヱ繝ｼ繝医懊ョ繧｣繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ菴ｿ繧上ｌ繧九ｂ縺ｮ縺ｨ縺ｯ辟｡髢｢菫ゅ〒縺吶 蛻昴ａ縺ｦ `response.write()` 縺悟他縺ｳ蜃ｺ縺輔ｌ繧九→縲 繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺輔ｌ縺ｦ縺縺溘倥ャ繝諠蝣ｱ縺ｨ譛蛻昴ｮ繝懊ョ繧｣縺後け繝ｩ繧､繧｢繝ｳ繝医↓騾∽ｿ｡縺輔ｌ縺ｾ縺吶 @@ -500,22 +606,28 @@ Node 縺ｯ繧ｹ繝医Μ繝ｼ繝溘Φ繧ｰ繝繝ｼ繧ｿ繧貞蜑ｲ縺励※騾∽ｿ｡縺励ｈ縺縺ｨ縺励※縺 ### response.addTrailers(headers) 縺薙ｮ繝｡繧ｽ繝繝峨ｯ HTTP 繝医Ξ繝ｼ繝ｩ繝倥ャ繝 (繝｡繝繧ｻ繝ｼ繧ｸ縺ｮ譛蠕後↓鄂ｮ縺九ｌ繧九倥ャ繝) 繧偵Ξ繧ｹ繝昴Φ繧ｹ縺ｫ霑ｽ蜉縺励∪縺吶 繝医Ξ繝ｼ繝ｩ縺ｯ繝ｬ繧ｹ繝昴Φ繧ｹ縺後メ繝｣繝ｳ繧ｯ蛹悶＆繧後◆繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ**縺ｮ縺ｿ**逕滓舌＆繧後∪縺; 縺昴≧縺ｧ縺ｪ縺代ｌ縺ｰ (萓九∴縺ｰ繝ｪ繧ｯ繧ｨ繧ｹ繝医′ HTTP/1.0)縲鮟吶▲縺ｦ遐ｴ譽縺輔ｌ縺ｾ縺吶 HTTP 縺ｯ縲√ヨ繝ｬ繝ｼ繝ｩ繧堤函謌舌☆繧九↑繧峨◎縺ｮ繝倥ャ繝繝輔ぅ繝ｼ繝ｫ繝峨ｮ繝ｪ繧ｹ繝医ｒ蛟､縺ｨ縺励※ `Trailer` 繝倥ャ繝繧帝∽ｿ｡縺吶ｋ縺薙→繧定ｦ∵ｱゅ＠縺ｦ縺繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 @@ -530,18 +642,22 @@ HTTP 縺ｯ縲√ヨ繝ｬ繝ｼ繝ｩ繧堤函謌舌☆繧九↑繧峨◎縺ｮ繝倥ャ繝繝輔ぅ繝ｼ繝ｫ繝峨ｮ繝ｪ ### response.end([data], [encoding]) 縺薙ｮ繝｡繧ｽ繝繝峨ｯ繝ｬ繧ｹ繝昴Φ繧ｹ縺ｮ蜈ｨ縺ｦ縺ｮ繝倥ャ繝縺ｨ繝懊ョ繧｣繧帝∽ｿ｡縺励◆縺薙→繧偵し繝ｼ繝舌↓莨昴∴縺ｾ縺; 繧ｵ繝ｼ繝舌ｯ繝｡繝繧ｻ繝ｼ繧ｸ縺檎ｵゆｺ縺励◆縺ｨ閠縺医ｋ縺ｹ縺阪〒縺吶 縺薙ｮ `response.end()` 繝｡繧ｽ繝繝峨ｯ蜷繝ｬ繧ｹ繝昴Φ繧ｹ縺斐→縺ｫ蜻ｼ縺ｳ蜃ｺ縺輔↑縺代ｌ縺ｰ*縺ｪ繧翫∪縺帙ｓ*縲 `data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医 `response.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `response.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 @@ -550,11 +666,13 @@ followed by `response.end()`. ## http.Client HTTP 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ蠑墓焚縺ｨ縺励※貂｡縺輔ｌ繧九し繝ｼ繝舌い繝峨Ξ繧ｹ縺ｫ繧医▲縺ｦ讒狗ｯ峨＆繧後 謌ｻ繧雁､縺ｮ繝上Φ繝峨Ν縺ｯ荳縺､縺ｾ縺溘ｯ縺昴ｌ莉･荳翫ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ逋ｺ陦後☆繧九ｮ縺ｫ菴ｿ繧上ｌ縺ｾ縺吶 @@ -563,7 +681,9 @@ HTTP 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ蠑墓焚縺ｨ縺励※貂｡縺輔ｌ繧九し繝ｼ繝舌い繝峨Ξ繧ｹ縺ｫ繧 _迴ｾ蝨ｨ縺ｮ螳溯｣縺ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ繝代う繝励Λ繧､繝ｳ蛹悶＠縺ｾ縺帙ｓ縲_ `google.com` 縺ｫ謗･邯壹☆繧倶ｾ: @@ -582,11 +702,14 @@ Example of connecting to `google.com`: }); 蟆第焚縺ｮ迚ｹ蛻･縺ｪ繝倥ャ繝縺後≠繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 * 'Host' 繝倥ャ繝縺ｯ Node 縺ｫ繧医▲縺ｦ蜉縺医ｉ繧後∪縺帙ｓ縺後騾壼ｸｸ縺ｮ Web 繧ｵ繧､繝医↓蠢隕√→縺輔ｌ縺ｾ縺吶 @@ -616,15 +740,19 @@ There are a few special headers that should be noted. `function (request, socket, head)` 繧ｵ繝ｼ繝舌′繧｢繝繝励げ繝ｬ繝ｼ繝芽ｦ∵ｱゅ↓蠢懃ｭ斐☆繧句ｺｦ縺ｫ逕滓舌＆繧後∪縺吶 縺薙ｮ繧､繝吶Φ繝医′逶｣隕悶＆繧後※縺縺ｪ縺蝣ｴ蜷医√け繝ｩ繧､繧｢繝ｳ繝医′繧｢繝繝励げ繝ｬ繝ｼ繝峨倥ャ繝繧貞女菫｡縺吶ｋ縺ｨ縺昴ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺ｾ縺吶 繧医ｊ隧ｳ縺励￥縺ｯ `http.Server` 縺ｮ `upgrade` 繧､繝吶Φ繝医ｮ隱ｬ譏弱ｒ蜿らｧ縺励※縺上□縺輔＞縲 @@ -633,9 +761,11 @@ See the description of the `upgrade` event for `http.Server` for further details `function ()` 騾壼ｸｸ縲√Μ繧ｯ繧ｨ繧ｹ繝医′ 'Expect: 100-continue' 繧貞性繧薙〒縺縺溘％縺ｨ縺ｫ繧医ｊ縲 繧ｵ繝ｼ繝舌′ '100 Continue' HTTP 繝ｬ繧ｹ繝昴Φ繧ｹ繧帝∽ｿ｡縺吶ｋ縺薙→縺ｧ逕滓舌＆繧後∪縺吶 @@ -645,27 +775,33 @@ the client should send the request body. ### http.createClient(port, host='localhost', secure=false, [credentials]) 譁ｰ縺励＞ HTTP 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｒ讒狗ｯ峨＠縺ｾ縺吶 `port` 縺ｨ `host` 縺ｯ謗･邯壼医→縺ｪ繧九し繝ｼ繝舌ｒ蜿らｧ縺励∪縺吶 繝ｪ繧ｯ繧ｨ繧ｹ繝医′逋ｺ陦後＆繧後ｋ縺ｾ縺ｧ繧ｹ繝医Μ繝ｼ繝縺ｯ遒ｺ遶九＆繧後∪縺帙ｓ縲 繧ｪ繝励す繝ｧ繝ｳ縺ｮ`secure` 縺ｯ boolean 縺ｮ繝輔Λ繧ｰ縺ｧ HTTPS 繧ｵ繝昴ｼ繝医ｒ譛牙柑縺ｫ縺励 繧ｪ繝励す繝ｧ繝ｳ縺ｮ`credentials` 縺ｯ證怜捷繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ隱崎ｨｼ諠蝣ｱ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縲 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ遘伜ｯ骰ｵ縲∬ｨｼ譏取嶌縲√◎縺励※菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌縺ｮ繝ｪ繧ｹ繝医ｒ蜷ｫ繧縺薙→縺後〒縺阪∪縺吶 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺後そ繧ｭ繝･繧｢縺ｪ蝣ｴ蜷医∬ｨｼ譏取ュ蝣ｱ縺ｧ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌縺梧守､ｺ逧縺ｫ貂｡縺輔ｌ縺ｪ縺縺ｨ縲 node.js 縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ繝ｪ繧ｹ繝医→縺励※ @@ -674,38 +810,48 @@ node.js 縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺ｧ縺阪ｋ隱崎ｨｼ螻縺ｮ繝ｪ繧ｹ繝医→縺励※ ### client.request(method='GET', path, [request_headers]) 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ逋ｺ陦後＠縺ｾ縺; 蠢隕√〒縺ゅｌ縺ｰ繧ｹ繝医Μ繝ｼ繝繧堤｢ｺ遶九＠縺ｾ縺吶 `http.ClientRequest` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧定ｿ斐＠縺ｾ縺吶 `method` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縲∫怐逡･縺輔ｌ縺溷ｴ蜷医ｮ繝繝輔か繝ｫ繝医ｯ 'GET'縺ｧ縺吶 `request_headers` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 Node 蜀驛ｨ縺ｧ莉伜刈逧縺ｪ繝ｪ繧ｯ繧ｨ繧ｹ繝医倥ャ繝縺悟刈縺医ｉ繧後ｋ縺薙→縺後≠繧翫∪縺吶 `ClientRequest` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 繝懊ョ繧｣繧帝∽ｿ｡縺励ｈ縺縺ｨ縺励※縺繧句ｴ蜷医ｯ縲〜Content-Length` 繝倥ャ繝繧貞性繧√ｋ縺薙→繧貞ｿ倥ｌ縺ｪ縺縺ｧ縺上□縺輔＞縲 繝懊ョ繧｣繧偵せ繝医Μ繝ｼ繝蛹悶☆繧句ｴ蜷医ｯ縲√♀縺昴ｉ縺 `Transfer-Encoding: chunked` 繧偵そ繝繝医＠縺ｦ縺上□縺輔＞縲 *豕ｨ諢*: 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｯ螳御ｺ縺励※縺縺ｾ縺帙ｓ縲ゅ％縺ｮ繝｡繧ｽ繝繝峨ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｮ繝倥ャ繝繧帝∽ｿ｡縺吶ｋ縺縺代〒縺吶 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ螳御ｺ縺励※繝ｬ繧ｹ繝昴Φ繧ｹ繧定ｪｭ縺ｿ蜃ｺ縺吶↓縺ｯ `request.end()` 繧貞他縺ｶ蠢隕√′縺ゅｊ縺ｾ縺吶 @@ -715,8 +861,10 @@ the user to stream a body to the server with `request.write()`.) ### client.verifyPeer() 謖螳壹＆繧後◆縲√≠繧九＞縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺輔ｌ縺溯ｪ崎ｨｼ螻縺ｮ險ｼ譏取嶌縺ｫ縺翫＞縺ｦ縲 繧ｵ繝ｼ繝舌ｮ險ｼ譏取嶌縺ｮ螯･蠖捺ｧ縺ｫ蠢懊§縺ｦ true 縺ｾ縺溘ｯ false 繧定ｿ斐＠縺ｾ縺吶 @@ -724,8 +872,10 @@ in the context of the defined or default list of trusted CA certificates. ### client.getPeerCertificate() 繧ｵ繝ｼ繝占ｨｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵〜'subject'`縲〜'issuer'`縲〜'valid_from'` 縺昴＠縺ｦ `'valid_to'` 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 @@ -734,31 +884,37 @@ with keys for the certificate `'subject'`, `'issuer'`, `'valid_from'` and `'vali ## http.ClientRequest 縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ HTTP 繧ｵ繝ｼ繝仙驛ｨ縺ｧ菴懈舌＆繧後〜http.Client` 縺ｮ `request()` 繝｡繧ｽ繝繝峨°繧芽ｿ斐＆繧後∪縺吶 縺昴ｌ縺ｯ繝倥ャ繝縺碁∽ｿ｡縺輔ｌ縺 _騾ｲ陦御ｸｭ_ 縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ陦ｨ迴ｾ縺励∪縺吶 繝ｬ繧ｹ繝昴Φ繧ｹ繧貞叙蠕励☆繧九↓縺ｯ縲〜'response'` 逕ｨ縺ｮ繝ｪ繧ｹ繝翫ｼ繧偵Μ繧ｯ繧ｨ繧ｹ繝医が繝悶ず繧ｧ繧ｯ繝医↓蜉縺医∪縺吶 `'response'` 繧､繝吶Φ繝医ｯ繝ｬ繧ｹ繝昴Φ繧ｹ繝倥ャ繝繧貞女菫｡縺吶ｋ縺ｨ繝ｪ繧ｯ繧ｨ繧ｹ繝医が繝悶ず繧ｧ繧ｯ繝医↓繧医▲縺ｦ逕滓舌＆繧後∪縺吶 `'response'` 繧､繝吶Φ繝医ｯ `http.ClientResponse` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ繧貞髪荳縺ｮ蠑墓焚縺ｨ縺励※螳溯｡後＆繧後∪縺吶 `'response'` 繧､繝吶Φ繝医ｮ髢薙√Ξ繧ｹ繝昴Φ繧ｹ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓繝ｪ繧ｹ繝翫ｼ繧貞刈縺医ｋ縺薙→縺後〒縺阪∪縺; 縺ｨ繧翫ｏ縺 `'data'` 繧､繝吶Φ繝医ｮ繝ｪ繧ｹ繝翫ｼ縺ｧ縺吶 @@ -785,12 +941,16 @@ event, the entire body will be caught. }); 縺薙ｌ縺ｯ `Writable Stream` 縺ｧ縺吶 縺薙ｌ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺吶 @@ -799,8 +959,10 @@ This is an `EventEmitter` with the following events: `function (response) { }` 縺薙ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医↓蟇ｾ縺吶ｋ繝ｬ繧ｹ繝昴Φ繧ｹ繧貞女菫｡縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 縺薙ｮ繧､繝吶Φ繝医ｯ荳蝗槭□縺醍函謌舌＆繧後∪縺吶 @@ -810,25 +972,31 @@ Emitted when a response is received to this request. This event is emitted only ### request.write(chunk, encoding='utf8') 繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ繧帝∽ｿ｡縺励∪縺吶 縺薙ｮ繝｡繧ｽ繝繝峨ｒ菴募屓繧ょ他縺ｳ蜃ｺ縺吶→縲√し繝ｼ繝舌∈縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医懊ョ繧｣繧偵せ繝医Μ繝ｼ繝蛹悶〒縺阪∪縺 ｼ 縺薙ｮ繧ｱ繝ｼ繧ｹ縺ｯ `['Transfer-Encoding', 'chunked']` 繝倥ャ繝縺ｧ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ逕滓舌＠縺溘％縺ｨ繧呈э蜻ｳ縺励∪縺吶 `chunk` 蠑墓焚縺ｯ謨ｴ謨ｰ縺ｮ驟榊励°譁蟄怜励↓縺ｪ繧翫∪縺吶 `encoding` 蠑墓焚縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縲〜chunk` 縺梧枚蟄怜励ｮ蝣ｴ蜷医□縺鷹←逕ｨ縺輔ｌ縺ｾ縺吶 @@ -836,17 +1004,21 @@ applies when `chunk` is a string. ### request.end([data], [encoding]) 繝ｪ繧ｯ繧ｨ繧ｹ繝医ｮ騾∽ｿ｡繧堤ｵゆｺ縺励∪縺吶 繝懊ョ繧｣縺ｮ縺縺上▽縺九ｮ驛ｨ蛻縺後∪縺騾∽ｿ｡縺輔ｌ縺ｦ縺縺ｪ縺蝣ｴ蜷医√◎繧後ｯ繧ｹ繝医Μ繝ｼ繝縺ｫ繝輔Λ繝繧ｷ繝･縺輔ｌ縺ｾ縺吶 繝ｪ繧ｯ繧ｨ繧ｹ繝医′繝√Ε繝ｳ繧ｯ蛹悶＆繧後※縺繧句ｴ蜷医√％繧後ｯ邨らｫｯ縺ｮ `'0\r\n\r\n'` 繧帝∽ｿ｡縺励∪縺吶 `data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医ｯ縲 `request.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `request.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 @@ -855,14 +1027,18 @@ followed by `request.end()`. ## http.ClientResponse 縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ `http.Client` 縺ｫ繧医▲縺ｦ繝ｪ繧ｯ繧ｨ繧ｹ繝医→荳邱偵↓菴懈舌＆繧後∪縺吶 縺薙ｌ縺ｯ繝ｪ繧ｯ繧ｨ繧ｹ繝医が繝悶ず繧ｧ繧ｯ繝医ｮ `'response'` 繧､繝吶Φ繝医↓貂｡縺輔ｌ縺ｾ縺吶 繝ｬ繧ｹ繝昴Φ繧ｹ縺ｯ `Readable Stream` 繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧貞ｮ溯｣縺励∪縺吶 @@ -871,15 +1047,19 @@ The response implements the `Readable Stream` interface. `function (chunk) {}` 繝｡繝繧ｻ繝ｼ繧ｸ繝懊ョ繧｣縺ｮ譁ｭ迚繧貞女菫｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 萓: 繝懊ョ繧｣縺ｮ繝√Ε繝ｳ繧ｯ縺ｯ荳縺､縺ｮ蠑墓焚縺ｨ縺励※荳弱∴繧峨ｌ縺ｾ縺吶 霆｢騾√お繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｧ繝繧ｳ繝ｼ繝峨＆繧後∪縺吶 @@ -891,8 +1071,10 @@ Emitted when a piece of the message body is received. `function () {}` 繝｡繝繧ｻ繝ｼ繧ｸ縺斐→縺ｫ蜴ｳ蟇縺ｫ荳蝗槭□縺醍函謌舌＆繧後∪縺吶 縺薙ｮ繧､繝吶Φ繝医′逕滓舌＆繧後◆蠕後√％縺ｮ繝ｬ繧ｹ繝昴Φ繧ｹ縺ｯ縺ｩ繧薙↑繧､繝吶Φ繝医ｂ逕滓舌＠縺ｾ縺帙ｓ縲 @@ -900,17 +1082,21 @@ emitted no other events will be emitted on the response. ### response.statusCode 3 譯√ｮ謨ｰ蟄励↓繧医ｋ繝ｬ繧ｹ繝昴Φ繧ｹ縺ｮ繧ｹ繝繝ｼ繧ｿ繧ｹ繧ｳ繝ｼ繝峨〒縺吶ゆｾ九∴縺ｰ `404`縲 ### response.httpVersion 謗･邯壹＠縺ｦ縺繧九し繝ｼ繝舌→縺ｮ HTTP 縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ縺吶 縺翫◎繧峨￥ `'1.1'` 縺ｾ縺溘ｯ `'1.0'` 縺ｮ縺ｩ縺｡繧峨°縺ｧ縺吶 @@ -920,14 +1106,18 @@ Also `response.httpVersionMajor` is the first integer and ### response.headers 繝ｬ繧ｹ繝昴Φ繧ｹ繝倥ャ繝繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 ### response.trailers 繝ｬ繧ｹ繝昴Φ繧ｹ縺ｮ繝医Ξ繝ｼ繝ｩ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶 'end' 繧､繝吶Φ繝医ｮ蠕後↓縺縺醍匱逕溘＠縺ｾ縺吶 @@ -935,8 +1125,10 @@ The response trailers object. Only populated after the 'end' event. ### response.setEncoding(encoding=null) 繝ｬ繧ｹ繝昴Φ繧ｹ繝懊ョ繧｣縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧定ｨｭ螳壹＠縺ｾ縺吶 `'utf8'`縲〜'ascii'`縲√≠繧九＞縺ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺吶 @@ -946,20 +1138,26 @@ Defaults to `null`, which means that the `'data'` event will emit a `Buffer` obj ### response.pause() 繧､繝吶Φ繝医ｮ逕滓舌↓繧医ｋ繝ｬ繧ｹ繝昴Φ繧ｹ繧剃ｸｭ譁ｭ縺励∪縺吶ゅム繧ｦ繝ｳ繝ｭ繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 ### response.resume() 荳ｭ譁ｭ縺輔ｌ縺ｦ縺縺溘Ξ繧ｹ繝昴Φ繧ｹ繧貞埼幕縺励∪縺吶 ### response.client 縺薙ｮ繝ｬ繧ｹ繝昴Φ繧ｹ繧呈園譛峨☆繧 `http.Client` 縺ｸ縺ｮ蜿らｧ縺ｧ縺吶 diff --git a/doc/api/modules.markdown b/doc/api/modules.markdown index d51d12e337cc..852d3f96411d 100644 --- a/doc/api/modules.markdown +++ b/doc/api/modules.markdown @@ -1,10 +1,12 @@ ## Standard Modules Node 縺ｫ縺ｯ繝励Ο繧ｻ繧ｹ蜀縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺輔ｌ縺溘＞縺上▽縺九ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺悟性縺ｾ繧後※縺翫ｊ縲 縺昴ｮ縺ｻ縺ｨ繧薙←縺ｯ莉･荳九↓譁譖ｸ蛹悶＆繧後※縺縺ｾ縺吶 @@ -12,35 +14,45 @@ Node 縺ｫ縺ｯ繝励Ο繧ｻ繧ｹ蜀縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺輔ｌ縺溘＞縺上▽縺九ｮ繝｢繧ｸ繝･繝ｼ `require('name')` 縺ｮ謌ｻ繧雁､繧偵√Δ繧ｸ繝･繝ｼ繝ｫ縺ｨ蜷後§蜷榊燕縺ｮ繝ｭ繝ｼ繧ｫ繝ｫ螟画焚縺ｫ蜑ｲ繧雁ｽ薙※繧九％縺ｨ縺ｧ縺吶 萓: var util = require('util'); 縺昴ｮ莉悶ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｧ node 繧呈僑蠑ｵ縺吶ｋ縺薙→繧ょ庄閭ｽ縺ｧ縺吶ゅ後Δ繧ｸ繝･繝ｼ繝ｫ縲阪ｒ蜿らｧ縺励※縺上□縺輔＞縲 ## Modules Node 縺ｯ CommonJS 縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧ｷ繧ｹ繝繝繧剃ｽｿ縺縺ｾ縺吶 Node 縺ｯ繧ｷ繝ｳ繝励Ν縺ｪ繝｢繧ｸ繝･繝ｼ繝ｫ繝ｭ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝繧呈戟縺｡縺ｾ縺吶 Node 縺ｧ縺ｯ縲√ヵ繧｡繧､繝ｫ縺ｨ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯｼ大ｯｾｼ代↓蟇ｾ蠢懊＠縺ｾ縺吶 萓九→縺励※縲 `foo.js` 縺ｯ縲∝酔縺倥ョ繧｣繝ｬ繧ｯ繝医Μ縺ｫ縺ゅｋ `circle.js` 繧偵Ο繝ｼ繝峨＠縺ｦ縺縺ｾ縺吶 `foo.js` 縺ｮ蜀螳ｹ: @@ -49,7 +61,9 @@ The contents of `foo.js`: + circle.area(4)); `circle.js` 縺ｮ蜀螳ｹ: @@ -64,6 +78,7 @@ The contents of `circle.js`: }; `circle.js` 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ `area()` 縺ｨ `circumference()` 繧偵お繧ｯ繧ｹ繝昴ｼ繝医＠縺ｦ縺縺ｾ縺吶 繧ｨ繧ｯ繧ｹ繝昴ｼ繝医＆繧後◆繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ縲 `exports` 縺ｨ縺縺迚ｹ蛻･縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蜉縺医ｉ繧後∪縺 @@ -83,17 +99,21 @@ built-in module--more about this later. ### Module Resolving 繝励Ξ繝輔ぅ繝繧ｯ繧ｹ `'./'` 縺御ｻ倥¢繧峨ｌ縺溘Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ `require()` 繧貞他縺ｳ蜃ｺ縺励◆繝｢繧ｸ繝･繝ｼ繝ｫ縺九ｉ縺ｮ逶ｸ蟇ｾ繝代せ縺ｨ縺ｪ繧翫∪縺吶 縺､縺ｾ繧 `circle.js` 縺ｯ `require('./circle')` 縺瑚ｦ九▽縺代ｉ繧後ｋ繧医≧縺ｫ `foo.js` 縺ｨ蜷後§繝繧｣繝ｬ繧ｯ繝医Μ縺ｫ縺ゅｋ蠢隕√′譛峨ｊ縺ｾ縺吶 蜈磯ｭ縺ｮ `'./'` 辟｡縺励〒縲∽ｾ九∴縺ｰ `require('assert')` 縺ｮ讒倥↓繝｢繧ｸ繝･繝ｼ繝ｫ繧呈欠螳壹＠縺溷ｴ蜷医 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ `require.paths` 縺ｮ驟榊怜縺ｮ蝣ｴ謇繧定ｵｷ轤ｹ縺ｫ讀懃ｴ｢縺輔ｌ縺ｾ縺吶 @@ -102,7 +122,9 @@ this: `[ '/home/ryan/.node_modules' ]` 縺薙ｌ縺ｫ繧医▲縺ｦ縲〜require('foo')` 縺悟他縺ｰ繧後ｋ縺ｨ Node 縺ｯ莉･荳九ｮ鬆縺ｧ繝｢繧ｸ繝･繝ｼ繝ｫ繧呈､懃ｴ｢縺励∪縺 @@ -113,9 +135,11 @@ That is, when `require('foo')` is called Node looks for: * 5: `/home/ryan/.node_modules/foo/index.node` 繝輔ぃ繧､繝ｫ縺瑚ｦ九▽縺九ｋ縺ｨ縲√◎縺ｮ譎らせ縺ｧ讀懃ｴ｢縺ｯ邨ゆｺ縺励∪縺吶 繝輔ぃ繧､繝ｫ蜷阪′ `'.node'` 縺ｧ邨ゅｏ繧九ヵ繧｡繧､繝ｫ縺ｯ縲√ヰ繧､繝翫Μ蠖｢蠑上ｮ繧｢繝峨が繝ｳ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｧ縺吶 @@ -123,6 +147,7 @@ a directory. `'index.js'` 縺ｯ縲√ョ繧｣繝ｬ繧ｯ繝医Μ繧偵Δ繧ｸ繝･繝ｼ繝ｫ縺ｨ縺励※荳縺､縺ｫ縺ｾ縺ｨ繧√ｋ縺薙→繧貞庄閭ｽ縺ｫ縺励∪縺吶 `require.paths` 縺ｯ縲驟榊励↓譁ｰ縺励＞繝代せ繧貞刈縺医ｋ縺九〜NODE_PATH` 迺ｰ蠅螟画焚縺ｨ蜈ｱ縺ｫ襍ｷ蜍輔☆繧九％縺ｨ縺ｧ螟画峩縺吶ｋ縺薙→縺悟ｺ譚･縺ｾ縺 (縺薙ｮ蝣ｴ蜷医ｯ縲√さ繝ｭ繝ｳ縺ｧ蛹ｺ蛻繧峨ｌ縺溘ヱ繧ｹ縺ｮ繝ｪ繧ｹ繝医ｒ貂｡縺吝ｿ隕√′縺ゅｊ縺ｾ縺)縲 @@ -147,16 +173,20 @@ module: `projects/x/development/node_modules/foo` and `require('foo')` 縺ｮ 2 蠎ｦ逶ｮ縺ｮ蜻ｼ縺ｳ蜃ｺ縺励〒縺ｯ縲√ョ繧｣繧ｹ繧ｯ縺九ｉ蜀榊ｺｦ隱ｭ縺ｿ霎ｼ繧縺薙→縺ｯ縺励∪縺帙ｓ縲 譌｢縺ｫ繝ｭ繝ｼ繝画ｸ医∩縺九ｒ隱ｿ縺ｹ繧九◆繧√↓ `require.cache` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繝√ぉ繝繧ｯ縺励∪縺吶 `require()` 縺悟他縺ｳ蜃ｺ縺輔ｌ繧九→縲∵ｭ｣遒ｺ縺ｪ繝輔ぃ繧､繝ｫ蜷阪ｒ蠕励ｋ縺溘ａ縺ｫ `require.resolve()` 髢｢謨ｰ縺御ｽｿ繧上ｌ縺ｾ縺吶 diff --git a/doc/api/net.markdown b/doc/api/net.markdown index d2b20e3dc81b..54e08f9ad0ec 100644 --- a/doc/api/net.markdown +++ b/doc/api/net.markdown @@ -1,9 +1,11 @@ ## net `net` 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ髱槫酔譛溘↑繝阪ャ繝医Ρ繝ｼ繧ｯ縺ｮ繝ｩ繝繝代ｼ繧呈署萓帙＠縺ｾ縺吶 縺昴ｌ縺ｯ繧ｵ繝ｼ繝舌→繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｮ荳｡譁ｹ (繧ｹ繝医Μ繝ｼ繝縺ｨ蜻ｼ縺ｰ繧後∪縺) 繧剃ｽ懈舌☆繧九◆繧√ｮ譁ｹ豕輔ｒ蜷ｫ縺ｿ縺ｾ縺吶 @@ -12,8 +14,10 @@ this module with `require("net");` ### net.createServer(connectionListener) 譁ｰ縺励＞ TCP 繧ｵ繝ｼ繝舌ｒ菴懈舌＠縺ｾ縺吶 `connectionListener` 蠑墓焚縺ｯ `'connection'` @@ -22,18 +26,23 @@ automatically set as a listener for the `'connection'` event. ### net.createConnection(arguments...) 譁ｰ縺励＞繧ｹ繝医Μ繝ｼ繝繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ讒狗ｯ峨＠縲∽ｸ弱∴繧峨ｌ縺溘Ο繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺ｸ縺ｮ繧ｹ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励∪縺吶 繧ｹ繝医Μ繝ｼ繝縺檎｢ｺ遶九＆繧後ｋ縺ｨ縲〜'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 縺薙ｮ繝｡繧ｽ繝繝峨ｮ蠑墓焚縺ｯ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ遞ｮ鬘槭↓繧医▲縺ｦ螟峨ｏ繧翫∪縺吶 * `net.createConnection(port, [host])` @@ -57,13 +67,17 @@ The arguments for this method change the type of connection: ### net.Server 縺薙ｮ繧ｯ繝ｩ繧ｹ縺ｯ TCP 縺ｾ縺溘ｯ UNIX 繝峨Γ繧､繝ｳ縺ｮ繧ｵ繝ｼ繝舌ｒ菴懈舌☆繧九◆繧√↓菴ｿ繧上ｌ縺ｾ縺吶 8124 逡ｪ縺ｮ繝昴ｼ繝医∈縺ｮ謗･邯壹ｒ蠕縺｡蜿励¢繧九お繧ｳ繝ｼ繧ｵ繝ｼ繝舌ｮ萓: @@ -75,53 +89,67 @@ on port 8124: server.listen(8124, 'localhost'); `telnet` 繧剃ｽｿ縺｣縺ｦ繝繧ｹ繝医＠縺ｾ縺: telnet localhost 8124 `'/tmp/echo.sock'` 縺ｸ縺ｮ繧ｽ繧ｱ繝繝医ｒ蠕縺｡蜿励¢繧九↓縺ｯ縲∵怙蠕後ｮ陦後ｒ縺薙ｮ繧医≧縺ｫ螟画峩縺励∪縺吶 server.listen('/tmp/echo.sock'); `nc` 繧剃ｽｿ縺｣縺ｦ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医し繝ｼ繝舌∈謗･邯壹＠縺ｾ縺: nc -U /tmp/echo.sock `net.Server` 縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ `EventEmitter` 縺ｧ縺: #### server.listen(port, [host], [callback]) 謖螳壹＆繧後◆ `port` 縺ｨ `host` 縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ蜿励¢蜈･繧後ｒ髢句ｧ九＠縺ｾ縺吶 `host` 縺檎怐逡･縺輔ｌ繧九→縲√し繝ｼ繝舌ｯ縺ｩ繧薙↑ IPv4 繧｢繝峨Ξ繧ｹ縺ｸ縺ｮ謗･邯壹ｂ蜿励¢蜈･繧後∪縺 (`INADDR_ANY`)縲 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶よ怙蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 荳驛ｨ縺ｮ繝ｦ繝ｼ繧ｶ縺碁勍繧句撫鬘後ｮ荳縺､縺ｯ縲〜EADDRINUSE` 繧ｨ繝ｩ繝ｼ縺ｧ縺呻ｼ 縺薙ｌ縺ｯ縲∽ｻ悶ｮ繧ｵ繝ｼ繝舌′隕∵ｱゅ＆繧後◆繝昴ｼ繝医ｒ菴ｿ縺｣縺ｦ縺繧九→縺縺諢丞袖縺ｧ縺吶 @@ -139,7 +167,9 @@ would be to wait a second and the try again. This can be done with }); 豕ｨ諢: Node 縺ｮ蜈ｨ縺ｦ縺ｮ繧ｽ繧ｱ繝繝医ｯ SO_REUSEADDR 縺瑚ｨｭ螳壹＆繧後∪縺) @@ -147,13 +177,17 @@ would be to wait a second and the try again. This can be done with #### server.listen(path, [callback]) 荳弱∴繧峨ｌ縺 `path` 縺ｸ縺ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞ｾ縺｡蜿励¢繧九☆繧 UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｮ繧ｵ繝ｼ繝舌ｒ髢句ｧ九＠縺ｾ縺吶 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶 譛蠕後ｮ蠑墓焚縺ｮ `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨☆繧九→蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -161,13 +195,17 @@ when the server has been bound. #### server.listenFD(fd) 荳弱∴繧峨ｌ縺溘ヵ繧｡繧､繝ｫ險倩ｿｰ蟄蝉ｸ翫ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞ｾ縺｡蜿励¢繧九し繝ｼ繝舌ｒ髢句ｧ九＠縺ｾ縺吶 縺薙ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｯ譌｢縺ｫ `bind(2)` 縺翫ｈ縺ｳ `listen(2)` 繧ｷ繧ｹ繝繝繧ｳ繝ｼ繝ｫ縺悟他縺ｳ蜃ｺ縺輔ｌ縺ｦ縺縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 @@ -175,9 +213,11 @@ calls invoked on it. #### server.close() 繧ｵ繝ｼ繝舌′譁ｰ縺励＞繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺台ｻ倥¢繧九ｮ繧堤ｵゆｺ縺励∪縺吶 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縲√し繝ｼ繝舌ｯ譛邨ら噪縺ｫ `'close'` 繧､繝吶Φ繝医ｒ逕滓舌＠縺滓凾縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺ｾ縺吶 @@ -186,14 +226,18 @@ event. #### server.address() 繧ｪ繝壹Ξ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺ｫ繧医▲縺ｦ繧ｵ繝ｼ繝舌↓繝舌う繝ｳ繝峨＆繧後◆繧｢繝峨Ξ繧ｹ繧定ｿ斐＠縺ｾ縺吶 OS縺ｫ繧医▲縺ｦ蜑ｲ繧雁ｽ薙※繧峨ｌ縺溘い繝峨Ξ繧ｹ縺梧ｸ｡縺輔ｌ縺滓凾縺ｫ縲√←縺ｮ繝昴ｼ繝医↓蜑ｲ繧雁ｽ薙※繧峨ｌ縺溘ｂ縺ｮ縺九ｒ隱ｿ縺ｹ繧九ｮ縺ｫ萓ｿ蛻ｩ縺ｧ縺吶 萓: @@ -211,14 +255,18 @@ Example: #### server.maxConnections 繧ｵ繝ｼ繝舌ｮ謗･邯壽焚縺悟､ｧ縺阪￥縺ｪ縺｣縺滓凾縺ｫ謗･邯壹ｒ諡貞凄縺吶ｋ縺溘ａ縺ｫ縺薙ｮ繝励Ο繝代ユ繧｣繧定ｨｭ螳壹＠縺ｾ縺吶 #### server.connections 縺薙ｮ繧ｵ繝ｼ繝蝉ｸ翫ｮ荳ｦ陦後さ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ謨ｰ縺ｧ縺吶 @@ -227,8 +275,10 @@ The number of concurrent connections on the server. `function (stream) {}` 譁ｰ縺励＞繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺御ｽ懈舌＆繧後ｋ縺ｨ逕滓舌＆繧後∪縺吶 `stream` 縺ｯ `net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 @@ -238,7 +288,9 @@ Emitted when a new connection is made. `stream` is an instance of `function () {}` 繧ｵ繝ｼ繝舌′繧ｯ繝ｭ繝ｼ繧ｺ縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 @@ -247,10 +299,12 @@ Emitted when the server closes. ### net.Stream 縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ TCP 縺ｾ縺溘ｯ UNIX 繝峨Γ繧､繝ｳ縺ｮ繧ｽ繧ｱ繝繝医ｒ謚ｽ雎｡蛹悶＠縺溘ｂ縺ｮ縺ｧ縺吶 `net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ蜿梧婿蜷代ｮ繧ｹ繝医Μ繝ｼ繝繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧貞ｮ溯｣縺励∪縺吶 @@ -258,7 +312,9 @@ and passed to the user through the `'connection'` event of a server. Node 縺ｫ繧医▲縺ｦ菴懈舌＆繧後※繧ｵ繝ｼ繝舌ｮ `'connection'` 繧､繝吶Φ繝医ｒ騾壹§縺ｦ繝ｦ繝ｼ繧ｶ縺ｫ貂｡縺輔ｌ縺ｾ縺吶 `net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ EventEmitter 縺ｧ縺: @@ -266,10 +322,12 @@ Node 縺ｫ繧医▲縺ｦ菴懈舌＆繧後※繧ｵ繝ｼ繝舌ｮ `'connection'` 繧､繝吶Φ繝医ｒ騾 #### stream.connect(path, [callback]) 荳弱∴繧峨ｌ縺溘せ繝医Μ繝ｼ繝縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧偵が繝ｼ繝励Φ縺励∪縺吶 `port` 縺ｨ `host` 縺御ｸ弱∴繧峨ｌ縺溷ｴ蜷医 @@ -279,27 +337,33 @@ opened as a unix socket to that path. 繧ｹ繝医Μ繝ｼ繝縺ｯ縺昴ｮ繝代せ縺ｸ縺ｮ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医→縺励※繧ｪ繝ｼ繝励Φ縺輔ｌ縺ｾ縺吶 騾壼ｸｸ縺薙ｮ繝｡繧ｽ繝繝峨ｯ蠢隕√↑縺上〜net.createConnection` 縺ｧ繧ｹ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励∪縺吶 縺薙ｌ繧剃ｽｿ縺縺ｮ縺ｯ縲√き繧ｹ繧ｿ繝槭う繧ｺ縺輔ｌ縺溘せ繝医Μ繝ｼ繝繧貞ｮ溯｣縺励※縺繧句ｴ蜷医ｄ縲 繧ｹ繝医Μ繝ｼ繝縺後け繝ｭ繝ｼ繧ｺ縺輔ｌ縺溷ｾ後↓繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞榊茜逕ｨ縺励※蛻･縺ｮ繧ｵ繝ｼ繝舌↓謗･邯壹☆繧句ｴ蜷医□縺代〒縺吶 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶ゅせ繝医Μ繝ｼ繝縺檎｢ｺ遶九＆繧後ｋ縺ｨ `'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 謗･邯壹〒蝠城｡後′縺ゅ▲縺溷ｴ蜷医ｯ `'connect'` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後★縲 萓句､悶→縺ｨ繧ゅ↓ `'error'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 `callback` 蠑墓焚縺ｯ 'connect' 繧､繝吶Φ繝医ｮ繝ｪ繧ｹ繝翫↓蜉縺医ｉ繧後∪縺吶 @@ -307,8 +371,10 @@ event. #### stream.setEncoding(encoding=null) 蜿嶺ｿ｡縺励◆繝繝ｼ繧ｿ縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧定ｨｭ螳壹＠縺ｾ縺 (`'ascii'`縲〜'utf8'`縲 縺ゅｋ縺縺ｯ `'base64'` 縺ｮ縺縺壹ｌ縺九〒縺)縲 @@ -316,18 +382,22 @@ received. #### stream.setSecure([credentials]) 遘伜ｯ骰ｵ縺ｨ繧ｵ繝ｼ繝占ｨｼ譏取嶌繧呈欠螳壹＠縺滓囓蜿ｷ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ隱崎ｨｼ諠蝣ｱ縺ｧ縲 繧ｹ繝医Μ繝ｼ繝縺ｫ蟇ｾ縺励※ SSL 繧ｵ繝昴ｼ繝医ｒ譛牙柑縺ｫ縺励∪縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｧ隱崎ｨｼ螻縺ｧ險ｼ譏弱＆繧後◆逶ｸ謇句ｴ縺ｮ隱崎ｨｼ繧剃ｽｿ縺縺薙→繧ゅ〒縺阪∪縺吶 隱崎ｨｼ諠蝣ｱ縺御ｸ縺､莉･荳翫ｮ隱崎ｨｼ螻縺ｮ險ｼ譏取嶌繧呈戟縺｣縺ｦ縺繧句ｴ蜷医 繧ｹ繝医Μ繝ｼ繝縺ｯ SSL 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｫ縺翫¢繧九ワ繝ｳ繝峨す繧ｧ繝ｼ繧ｯ縺ｮ荳驛ｨ縺ｨ縺励※繧ｯ繝ｩ繧､繧｢繝ｳ繝郁ｨｼ譏取嶌繧帝√ｋ繧医≧逶ｸ謇九↓隕∵ｱゅ＠縺ｾ縺吶 @@ -336,8 +406,10 @@ The validity and content of this can be accessed via `verifyPeer()` and `getPeer #### stream.verifyPeer() 謖螳壹＆繧後◆縲√≠繧九＞縺ｯ繝繝輔か繝ｫ繝医ｮ菫｡鬆ｼ縺輔ｌ縺溯ｪ崎ｨｼ螻縺ｮ險ｼ譏取嶌縺ｫ縺翫＞縺ｦ縲 逶ｸ謇九ｮ險ｼ譏取嶌縺ｮ螯･蠖捺ｧ縺ｫ蠢懊§縺ｦ true 縺ｾ縺溘ｯ false 繧定ｿ斐＠縺ｾ縺吶 @@ -345,8 +417,10 @@ context of the defined or default list of trusted CA certificates. #### stream.getPeerCertificate() 逶ｸ謇九ｮ險ｼ譏取嶌縺ｮ隧ｳ邏ｰ繧偵〜'subject'`縲〜'issuer'`縲〜'valid_from'` 縺昴＠縺ｦ `'valid_to'` 繧偵く繝ｼ縺ｨ縺吶ｋ險ｼ譏取嶌縺ｮ霎樊嶌繧貞性繧 JSON 蠖｢蠑上〒霑斐＠縺ｾ縺吶 @@ -354,23 +428,29 @@ with keys for the certificate `'subject'`, `'issuer'`, `'valid_from'` and `'vali #### stream.write(data, [encoding], [callback]) 繧ｹ繝医Μ繝ｼ繝縺ｫ繝繝ｼ繧ｿ繧帝∽ｿ｡縺励∪縺吶 譁蟄怜励ｮ蝣ｴ蜷医∫ｬｬ 2 蠑墓焚縺ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧呈欠螳壹＠縺ｾ縺 ｼ 繝繝輔か繝ｫ繝医ｯ UTF-8 縺ｧ縺吶 繝繝ｼ繧ｿ蜈ｨ菴薙ｮ繧ｫ繝ｼ繝阪Ν繝舌ャ繝輔ぃ縺ｸ縺ｮ繝輔Λ繝繧ｷ繝･縺梧仙粥縺吶ｋ縺ｨ `true` 繧定ｿ斐＠縺ｾ縺吶 繝繝ｼ繧ｿ蜈ｨ菴薙∪縺溘ｯ荳驛ｨ縺後Θ繝ｼ繧ｶ繝｡繝｢繝ｪ蜀縺ｮ繧ｭ繝･繝ｼ縺ｫ蜈･繧後ｉ繧後◆蝣ｴ蜷医ｯ `false` 繧定ｿ斐＠縺ｾ縺吶 蜀阪ｳ繝舌ャ繝輔ぃ縺檎ｩｺ縺縺溷ｴ蜷医ｯ `'drain'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｮ `callback` 蠑墓焚縺ｯ繝繝ｼ繧ｿ縺梧怙邨ら噪縺ｫ蜃ｺ蜉帙＆繧後◆譎ゅ↓螳溯｡後＆繧後∪縺 ｼ 縺薙ｌ縺ｯ縺吶＄縺ｫ縺ｯ襍ｷ縺阪↑縺縺ｧ縺励ｇ縺縲 @@ -378,9 +458,11 @@ written out - this may not be immediately. #### stream.write(data, [encoding], [fileDescriptor], [callback]) UNIX 繧ｽ繧ｱ繝繝医ｮ蝣ｴ蜷医√ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺吶ｋ縺薙→縺後〒縺阪∪縺吶 蜊倡ｴ斐↓ `fileDescriptor` 蠑墓焚繧貞刈縺医ｋ縺薙→縺ｧ縲∫嶌謇句ｴ縺ｫ縺ｯ `'fd'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 @@ -389,15 +471,19 @@ UNIX 繧ｽ繧ｱ繝繝医ｮ蝣ｴ蜷医√ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺 #### stream.end([data], [encoding]) 繧ｹ繝医Μ繝ｼ繝繧偵ワ繝ｼ繝輔け繝ｭ繝ｼ繧ｺ縺励∪縺吶ゆｾ九∴縺ｰ FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励∪縺吶 繧ｵ繝ｼ繝舌ｯ縺ｾ縺繝繝ｼ繧ｿ繧帝√ｊ邯壹¢縺ｦ縺上ｋ縺薙→縺後〒縺阪∪縺吶 `data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医ｯ縲 `stream.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `stream.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 @@ -405,8 +491,10 @@ followed by `stream.end()`. #### stream.destroy() 縺薙ｮ繧ｹ繝医Μ繝ｼ繝荳翫〒縺ｩ繧薙↑ I/O 繧りｵｷ縺薙ｉ縺ｪ縺縺薙→繧剃ｿ晁ｨｼ縺励∪縺吶 (繝代ｼ繧ｹ繧ｨ繝ｩ繝ｼ縺ｪ縺ｩ縺ｮ) 繧ｨ繝ｩ繝ｼ縺ｮ蝣ｴ蜷医↓縺縺大ｿ隕√〒縺吶 @@ -414,8 +502,10 @@ case of errors (parse error or so). #### stream.pause() 繝繝ｼ繧ｿ縺ｮ隱ｭ縺ｿ霎ｼ縺ｿ繧剃ｸｭ譁ｭ縺励∪縺吶ゅ▽縺ｾ繧翫〜'data'` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後∪縺帙ｓ縲 繧｢繝繝励Ο繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶◆繧√↓萓ｿ蛻ｩ縺ｧ縺吶 @@ -423,37 +513,47 @@ Useful to throttle back an upload. #### stream.resume() `pause()` 繧貞他縺ｳ蜃ｺ縺励◆蠕後〒隱ｭ縺ｿ霎ｼ縺ｿ繧貞埼幕縺励∪縺吶 #### stream.setTimeout(timeout) 繧｢繧､繝峨Ν繧ｿ繧､繝繧｢繧ｦ繝医′蠑輔″襍ｷ縺薙＆繧後ｋ縺ｨ縲√せ繝医Μ繝ｼ繝縺ｯ `'timeout'` 繧､繝吶Φ繝医ｒ蜿嶺ｿ｡縺励∪縺吶′縲 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ蛻譁ｭ縺輔ｌ縺ｾ縺帙ｓ縲 繝ｦ繝ｼ繧ｶ縺ｯ謇句虚縺ｧ `end()` 縺ｾ縺溘ｯ `destroy()` 繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺吶 `timeout` 縺 0 縺ｮ蝣ｴ蜷医√い繧､繝峨Ν繧ｿ繧､繝繧｢繧ｦ繝医ｯ辟｡蜉ｹ縺ｫ縺輔ｌ縺ｾ縺吶 #### stream.setNoDelay(noDelay=true) Nagle 繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝繧堤┌蜉ｹ縺ｫ縺励∪縺吶 繝繝輔か繝ｫ繝医〒縺ｯ TCP 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ Nagle 繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝繧剃ｽｿ逕ｨ縺励√ョ繝ｼ繧ｿ繧帝∽ｿ｡縺吶ｋ蜑阪↓繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺励∪縺吶 @@ -462,12 +562,14 @@ Nagle 繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝繧堤┌蜉ｹ縺ｫ縺励∪縺吶 #### stream.setKeepAlive(enable=false, [initialDelay]) 繧ｭ繝ｼ繝励い繝ｩ繧､繝匁ｩ溯ｽ繧呈怏蜉ｹ/辟｡蜉ｹ縺ｫ縺励∪縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｧ譛蛻昴ｮ keepalive probe 縺後い繧､繝峨Ν繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺輔ｌ繧九∪縺ｧ縺ｮ蛻晄悄驕蟒ｶ繧定ｨｭ螳壹＠縺ｾ縺吶 @@ -478,14 +580,18 @@ initialDelay will leave the value unchanged from the default #### stream.remoteAddress 繝ｪ繝｢繝ｼ繝医ｮ IP 繧｢繝峨Ξ繧ｹ繧定｡ｨ迴ｾ縺吶ｋ譁蟄怜励〒縺吶 萓九∴縺ｰ縲〜'74.125.127.100'` 縺ゅｋ縺縺ｯ `'2001:4860:a005::68'`縲 縺薙ｮ繝｡繝ｳ繝舌ｯ繧ｵ繝ｼ繝舌し繧､繝峨ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｧ縺ｮ縺ｿ荳弱∴繧峨ｌ縺ｾ縺吶 @@ -495,8 +601,10 @@ This member is only present in server-side connections. `function () { }` 繧ｹ繝医Μ繝ｼ繝繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ遒ｺ遶九′謌仙粥縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 `connect()` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 @@ -506,9 +614,11 @@ See `connect()`. `function (data) { }` 繝繝ｼ繧ｿ繧貞女菫｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 `data` 蠑墓焚縺ｯ `Buffer` 縺ｾ縺溘ｯ `String` 縺ｧ縺吶 @@ -520,16 +630,20 @@ Emitted when data is received. The argument `data` will be a `Buffer` or `function () { }` 繧ｹ繝医Μ繝ｼ繝縺ｮ逶ｸ謇句ｴ縺 FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 繝繝輔か繝ｫ繝 (`allowHalfOpen == false`) 縺ｧ縺ｯ縲 菫晉蕗縺輔ｌ縺ｦ縺縺滓嶌縺崎ｾｼ縺ｿ繧ｭ繝･繝ｼ縺悟ｺ蜉帙＆繧後ｋ縺ｨ繧ｹ繝医Μ繝ｼ繝縺ｯ繝輔ぃ繧､繝ｫ隴伜挨蟄舌ｒ遐ｴ譽縺励∪縺吶 @@ -543,8 +657,10 @@ caveat that the user is required to `end()` their side now. `function () { }` 繧ｹ繝医Μ繝ｼ繝縺後ち繧､繝繧｢繧ｦ繝医＠縺ｦ髱槭い繧ｯ繝繧｣繝悶↓縺ｪ縺｣縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 縺薙ｌ縺ｯ繧ｹ繝医Μ繝ｼ繝縺後い繧､繝峨Ν縺ｫ縺ｪ縺｣縺溘％縺ｨ繧帝夂衍縺吶ｋ縺縺代〒縺吶 @@ -558,7 +674,9 @@ See also: `stream.setTimeout()` `function () { }` 譖ｸ縺崎ｾｼ縺ｿ繝舌ャ繝輔ぃ縺檎ｩｺ縺ｫ縺ｪ縺｣縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶ゅい繝繝励Ο繝ｼ繝蛾溷ｺｦ繧定誠縺ｨ縺吶◆繧√↓菴ｿ縺縺薙→縺後〒縺阪∪縺吶 @@ -567,8 +685,10 @@ Emitted when the write buffer becomes empty. Can be used to throttle uploads. `function (exception) { }` 繧ｨ繝ｩ繝ｼ縺檎匱逕溘＠縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶Ａ'close'` 繧､繝吶Φ繝医ｯ縺薙ｮ繧､繝吶Φ繝医ｮ蠕後↓逶ｴ謗･蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -577,8 +697,10 @@ following this event. `function (had_error) { }` 繧ｹ繝医Μ繝ｼ繝縺悟ｮ悟ｨ縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 蠑墓焚 `had_error` 縺ｯ boolean 縺ｧ縲√せ繝医Μ繝ｼ繝縺瑚ｻ｢騾√お繝ｩ繝ｼ縺ｧ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺溘ｮ縺九←縺縺九ｒ遉ｺ縺励∪縺吶 @@ -590,15 +712,19 @@ which says if the stream was closed due to a transmission error. #### net.isIP(input) #### net.isIPv4(input) input 縺 繝舌ｼ繧ｸ繝ｧ繝ｳ 4 縺ｮ IP 繧｢繝峨Ξ繧ｹ縺ｪ繧 true縲√◎縺縺ｧ縺ｪ縺代ｌ縺ｰ false 繧定ｿ斐＠縺ｾ縺吶 @@ -606,7 +732,9 @@ input 縺 繝舌ｼ繧ｸ繝ｧ繝ｳ 4 縺ｮ IP 繧｢繝峨Ξ繧ｹ縺ｪ繧 true縲√◎縺縺ｧ縺ｪ縺代ｌ #### net.isIPv6(input) input 縺 繝舌ｼ繧ｸ繝ｧ繝ｳ 6 縺ｮ IP 繧｢繝峨Ξ繧ｹ縺ｪ繧 true縲√◎縺縺ｧ縺ｪ縺代ｌ縺ｰ false 繧定ｿ斐＠縺ｾ縺吶 diff --git a/doc/api/os.markdown b/doc/api/os.markdown index f278899333a2..1caf15e55cff 100644 --- a/doc/api/os.markdown +++ b/doc/api/os.markdown @@ -1,13 +1,17 @@ ## os Module `require('os')` 縺ｫ繧医▲縺ｦ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 ### os.getHostname() 繧ｪ繝壹Ξ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺ｮ繝帙せ繝亥錐繧定ｿ斐＠縺ｾ縺吶 diff --git a/doc/api/path.markdown b/doc/api/path.markdown index 49e09831f219..f29fafb49bde 100644 --- a/doc/api/path.markdown +++ b/doc/api/path.markdown @@ -1,8 +1,10 @@ ## Path 縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ繝輔ぃ繧､繝ｫ繝代せ繧呈桶縺繝ｦ繝ｼ繝繧｣繝ｪ繝繧｣繧貞性縺ｿ縺ｾ縺吶 蛻ｩ逕ｨ縺吶ｋ縺ｫ縺ｯ`require('path')`繧貞他縺ｳ蜃ｺ縺励※縺上□縺輔＞縲 @@ -11,12 +13,16 @@ This module contains utilities for dealing with file paths. Use ### path.join([path1], [path2], [...]) 蜈ｨ縺ｦ縺ｮ蠑墓焚繧剃ｸ縺､縺ｫ邨仙粋縺励∫ｵ先棡縺ｨ縺励※蠕励ｉ繧後ｋ繝代せ繧呈ｱｺ螳壹＠縺ｾ縺吶 萓: @@ -27,12 +33,16 @@ Example: ### path.normalizeArray(arr) 繝代せ縺ｮ隕∫ｴ縺ｮ驟榊励ｒ豁｣隕丞喧縺励∪縺吶Ａ'..'` 縺ｨ `'.'` 縺ｮ隕∫ｴ縺ｫ縺ｯ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 萓: @@ -44,12 +54,16 @@ Example: ### path.normalize(p) 譁蟄怜励↓繧医ｋ繝代せ繧呈ｭ｣隕丞喧縺励∪縺吶Ａ'..'` 縺ｨ `'.'` 縺ｮ隕∫ｴ縺ｫ縺ｯ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 萓: @@ -60,12 +74,16 @@ Example: ### path.dirname(p) 繝代せ縺ｫ蜷ｫ縺ｾ繧後ｋ繝繧｣繝ｬ繧ｯ繝医Μ蜷阪ｒ霑斐＠縺ｾ縺吶６nix縺ｮ `dirname` 繧ｳ繝槭Φ繝峨→蜷梧ｧ倥〒縺吶 path.dirname('/foo/bar/baz/asdf/quux') @@ -75,12 +93,16 @@ Example: ### path.basename(p, [ext]) 繝代せ縺ｮ譛蠕後ｮ隕∫ｴ繧定ｿ斐＠縺ｾ縺吶６nix縺ｮ `basename` 繧ｳ繝槭Φ繝峨→蜷梧ｧ倥〒縺吶 萓: @@ -95,9 +117,11 @@ Example: ### path.extname(p) 繝代せ縺ｮ諡｡蠑ｵ蟄舌ｒ霑斐＠縺ｾ縺吶 繝代せ縺ｮ譛蠕後ｮ隕∫ｴ縺ｫ縺､縺縺ｦ縲∵怙蠕後ｮ '.' 縺九ｉ蠕後↓縺ゅｋ譁蟄怜励′蟇ｾ雎｡縺ｫ縺ｪ繧翫∪縺吶 @@ -115,8 +139,10 @@ the first character, then it returns an empty string. Examples: ### path.exists(p, [callback]) 荳弱∴繧峨ｌ縺溘ヱ繧ｹ縺悟ｭ伜惠縺吶ｋ縺九←縺縺区､懈渊縺励∪縺吶 縺昴＠縺ｦ蠑墓焚縺ｮ `callback` 繧堤悄縺句⊃縺区､懈渊縺ｮ邨先棡縺ｨ縺ｨ繧ゅ↓蜻ｼ縺ｳ蜃ｺ縺励∪縺吶 diff --git a/doc/api/process.markdown b/doc/api/process.markdown index a3c9c084739e..f530c82f65fe 100644 --- a/doc/api/process.markdown +++ b/doc/api/process.markdown @@ -1,8 +1,10 @@ ## process `process` 縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縲√←縺薙°繧峨〒繧ゅい繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 縺昴ｌ縺ｯ `EventEmitter` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 @@ -13,10 +15,12 @@ It is an instance of `EventEmitter`. `function () {}` 繝励Ο繧ｻ繧ｹ縺檎ｵゆｺ縺励ｈ縺縺ｨ縺励※縺繧区凾縺ｫ逕滓舌＆繧後∪縺吶 縺薙ｌ縺ｯ (繝ｦ繝九ャ繝医ユ繧ｹ繝医ｮ繧医≧縺ｫ) 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ迥ｶ諷九ｒ荳螳壹ｮ譎る俣縺ｧ繝√ぉ繝繧ｯ縺吶ｋ縺ｮ縺ｫ驕ｩ縺励◆繝輔ャ繧ｯ縺ｨ縺ｪ繧翫∪縺吶 @@ -24,7 +28,9 @@ timers may not be scheduled. 繧ｿ繧､繝槭ｼ縺ｯ繧ｹ繧ｱ繧ｸ繝･繝ｼ繝ｫ縺輔ｌ縺ｪ縺縺九ｂ縺励ｌ縺ｾ縺帙ｓ縲 `exit` 繧堤屮隕悶☆繧倶ｾ: @@ -40,16 +46,20 @@ Example of listening for `exit`: `function (err) { }` 逋ｺ逕溘＠縺滉ｾ句､悶′繧､繝吶Φ繝医Ν繝ｼ繝励∪縺ｧ縺溘←繧顔捩縺縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 繧ゅ＠縺薙ｮ萓句､悶↓蟇ｾ縺吶ｋ繝ｪ繧ｹ繝翫ｼ縺悟刈縺医ｉ繧後※縺繧後ｰ縲 繝繝輔か繝ｫ繝医ｮ蜍穂ｽ (縺昴ｌ縺ｯ繧ｹ繧ｿ繝繧ｯ繝医Ξ繝ｼ繧ｹ繧偵励Μ繝ｳ繝医＠縺ｦ邨ゆｺ縺励∪縺) 縺ｯ襍ｷ縺薙ｊ縺ｾ縺帙ｓ縲 `uncaughtException` 繧堤屮隕悶☆繧倶ｾ: @@ -66,10 +76,12 @@ Example of listening for `uncaughtException`: console.log('This will not run.'); `uncaughtException` 縺ｯ萓句､悶ｒ謇ｱ縺縺ｨ縺ｦ繧り穀蜑翫ｊ縺ｪ繝｡繧ｫ繝九ぜ繝縺ｧ縺ゅｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 繝励Ο繧ｰ繝ｩ繝縺ｮ荳ｭ縺ｧ try / catch 繧剃ｽｿ縺医ｰ繧ゅ▲縺ｨ繝励Ο繧ｰ繝ｩ繝縺ｮ豬√ｌ繧偵≧縺ｾ縺丞宛蠕｡縺ｧ縺阪ｋ縺ｧ縺励ｇ縺縲 @@ -82,14 +94,18 @@ stay running forever, `uncaughtException` can be a useful safety mechanism. `function () {}` 繝励Ο繧ｻ繧ｹ縺後す繧ｰ繝翫Ν繧貞女菫｡縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 SIGINT縲ヾIGUSR1縲√◎縺ｮ莉悶ｮ POSIX 讓呎ｺ悶す繧ｰ繝翫Ν蜷阪ｮ荳隕ｧ縺ｫ縺､縺縺ｦ 縺ｯ sigaction(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 `SIGINT`繧堤屮隕悶☆繧倶ｾ: @@ -100,8 +116,10 @@ Example of listening for `SIGINT`: }); 螟壹￥縺ｮ遶ｯ譛ｫ繝励Ο繧ｰ繝ｩ繝縺ｧ邁｡蜊倥↓ `SIGINT` 繧帝√ｋ譁ｹ豕輔ｯ `Control-C` 繧呈款縺吶％縺ｨ縺ｧ縺吶 @@ -109,12 +127,16 @@ programs. ### process.stdout `stdout` 縺ｫ蟇ｾ縺吶ｋ `Writable Stream` 縺ｧ縺吶 萓: `console.log` 縺ｮ螳夂ｾｩ @@ -126,12 +148,16 @@ Example: the definition of `console.log` ### process.openStdin() 讓呎ｺ門･蜉帙せ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励〜Readable Stream` 繧定ｿ斐＠縺ｾ縺吶 讓呎ｺ門･蜉帙ｒ繧ｪ繝ｼ繝励Φ縺励※莠後▽縺ｮ繧､繝吶Φ繝医ｒ逶｣隕悶☆繧倶ｾ: @@ -151,9 +177,11 @@ Example of opening standard input and listening for both events: ### process.argv 繧ｳ繝槭Φ繝峨Λ繧､繝ｳ蠑墓焚繧貞性繧驟榊励〒縺吶 譛蛻昴ｮ隕∫ｴ縺ｯ 'node'縲2 逡ｪ逶ｮ縺ｮ隕∫ｴ縺ｯ JavaScript 繝輔ぃ繧､繝ｫ縺ｮ蜷榊燕縺ｫ縺ｪ繧翫∪縺吶 @@ -165,7 +193,9 @@ next elements will be any additional command line arguments. }); 縺薙ｮ繧医≧縺ｫ蜃ｺ蜉帙＆繧後∪縺: @@ -180,12 +210,16 @@ This will generate: ### process.execPath 繝励Ο繧ｻ繧ｹ縺ｫ繧医▲縺ｦ髢句ｧ九＆繧後◆螳溯｡悟庄閭ｽ繝輔ぃ繧､繝ｫ縺ｮ邨ｶ蟇ｾ繝代せ縺ｧ縺吶 萓: @@ -195,7 +229,9 @@ Example: ### process.chdir(directory) 繝励Ο繧ｻ繧ｹ縺ｮ繧ｫ繝ｬ繝ｳ繝医Ρ繝ｼ繧ｭ繝ｳ繧ｰ繝繧｣繝ｬ繧ｯ繝医Μ繧貞､画峩縺励∪縺吶 繧ゅ＠螟ｱ謨励＠縺溷ｴ蜷医ｯ萓句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 @@ -214,7 +250,9 @@ Changes the current working directory of the process or throws an exception if t ### process.cwd() 繝励Ο繧ｻ繧ｹ縺ｮ繧ｫ繝ｬ繝ｳ繝医Ρ繝ｼ繧ｭ繝ｳ繧ｰ繝繧｣繝ｬ繧ｯ繝医Μ繧定ｿ斐＠縺ｾ縺吶 @@ -224,7 +262,9 @@ Returns the current working directory of the process. ### process.env 繝ｦ繝ｼ繧ｶ縺ｮ迺ｰ蠅繧貞性繧繧ｪ繝悶ず繧ｧ繧ｯ繝医〒縺吶Ｆnviron(7) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 @@ -232,21 +272,27 @@ An object containing the user environment. See environ(7). ### process.exit(code=0) 謖螳壹ｮ `code` 縺ｧ繝励Ο繧ｻ繧ｹ繧堤ｵゆｺ縺励∪縺吶 繧ゅ＠逵∫払縺輔ｌ繧九→縲√梧仙粥縲阪ｒ遉ｺ縺吶さ繝ｼ繝 `0` 繧剃ｽｿ縺｣縺ｦ邨ゆｺ縺励∪縺吶 縲悟､ｱ謨励阪ｒ遉ｺ縺吶さ繝ｼ繝峨〒邨ゆｺ縺吶ｋ萓: process.exit(1); node 繧貞ｮ溯｡後＠縺溘す繧ｧ繝ｫ縺ｧ邨ゆｺ繧ｳ繝ｼ繝峨′ 1 縺ｧ縺ゅｋ縺薙→繧定ｦ九ｋ縺薙→縺後〒縺阪ｋ縺ｧ縺励ｇ縺縲 @@ -254,8 +300,10 @@ node 繧貞ｮ溯｡後＠縺溘す繧ｧ繝ｫ縺ｧ邨ゆｺ繧ｳ繝ｼ繝峨′ 1 縺ｧ縺ゅｋ縺薙→繧定ｦ九ｋ縺 ### process.getgid() 繝励Ο繧ｻ繧ｹ縺ｮ繧ｰ繝ｫ繝ｼ繝苓ｭ伜挨蟄舌ｒ蜿門ｾ励＠縺ｾ縺 (getgid(2) 蜿らｧ)縲 縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ繧ｰ繝ｫ繝ｼ繝 ID 縺ｧ縲√げ繝ｫ繝ｼ繝怜錐縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 @@ -266,9 +314,11 @@ This is the numerical group id, not the group name. ### process.setgid(id) 繝励Ο繧ｻ繧ｹ縺ｮ繧ｰ繝ｫ繝ｼ繝苓ｭ伜挨蟄舌ｒ險ｭ螳壹＠縺ｾ縺 (setgid(2) 蜿らｧ)縲 縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ ID 繧ゅげ繝ｫ繝ｼ繝怜錐縺ｮ譁蟄怜励ｮ縺ｩ縺｡繧峨ｂ蜿励¢蜈･繧後∪縺吶 @@ -287,8 +337,10 @@ blocks while resolving it to a numerical ID. ### process.getuid() 繝励Ο繧ｻ繧ｹ縺ｮ繝ｦ繝ｼ繧ｶ隴伜挨蟄舌ｒ蜿門ｾ励＠縺ｾ縺 (getuid(2) 蜿らｧ)縲 縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ繝ｦ繝ｼ繧ｶ ID 縺ｧ縲√Θ繝ｼ繧ｶ蜷阪〒縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 @@ -299,9 +351,11 @@ This is the numerical userid, not the username. ### process.setuid(id) 繝励Ο繧ｻ繧ｹ縺ｮ繝ｦ繝ｼ繧ｶ隴伜挨蟄舌ｒ險ｭ螳壹＠縺ｾ縺 (setuid(2) 蜿らｧ)縲 縺薙ｌ縺ｯ謨ｰ蛟､縺ｫ繧医ｋ ID 繧ゅΘ繝ｼ繧ｶ蜷阪ｮ譁蟄怜励ｮ縺ｩ縺｡繧峨ｂ蜿励¢蜈･繧後∪縺吶 @@ -320,7 +374,9 @@ blocks while resolving it to a numerical ID. ### process.version `NODE_VERSION` 繧呈署遉ｺ縺吶ｋ繧ｳ繝ｳ繝代う繝ｫ貂医∩繝励Ο繝代ユ繧｣縺ｧ縺吶 @@ -330,6 +386,7 @@ A compiled-in property that exposes `NODE_VERSION`. <-- A compiled-in property that exposes `NODE_PREFIX`. + --> `NODE_PREFIX` 繧呈署遉ｺ縺吶ｋ繧ｳ繝ｳ繝代う繝ｫ貂医∩繝励Ο繝代ユ繧｣縺ｧ縺吶 @@ -339,10 +396,12 @@ A compiled-in property that exposes `NODE_PREFIX`. ### process.kill(pid, signal='SIGINT') 繝励Ο繧ｻ繧ｹ縺ｫ繧ｷ繧ｰ繝翫Ν繧帝√ｊ縺ｾ縺吶 `pid` 縺ｯ繝励Ο繧ｻ繧ｹ ID 縺ｧ `signal` 縺ｯ騾∽ｿ｡縺輔ｌ繧九す繧ｰ繝翫Ν繧呈枚蟄怜励〒險倩ｿｰ縺励◆繧ゅｮ縺ｧ縺吶 @@ -351,16 +410,20 @@ See kill(2) for more information. 隧ｳ邏ｰ縺ｯ kill(2) 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 縺薙ｮ髢｢謨ｰ縺ｮ蜷榊燕縺 `process.kill` 縺ｧ縺ゅｋ縺ｨ縺翫ｊ縲 縺薙ｌ縺ｯ `kill` 繧ｷ繧ｹ繝繝繧ｳ繝ｼ繝ｫ縺ｮ繧医≧縺ｫ譛ｬ蠖薙↓繧ｷ繧ｰ繝翫Ν繧帝∽ｿ｡縺吶ｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 蟇ｾ雎｡縺ｮ繝励Ο繧ｻ繧ｹ繧呈ｮｺ縺吶□縺代〒縺ｪ縺上∽ｻ悶ｮ繧ｷ繧ｰ繝翫Ν繧る∽ｿ｡縺輔ｌ縺ｾ縺吶 閾ｪ霄ｫ縺ｫ繧ｷ繧ｰ繝翫Ν繧帝∽ｿ｡縺吶ｋ萓: @@ -379,7 +442,9 @@ Example of sending a signal to yourself: ### process.pid console.log('This process is pid ' + process.pid); @@ -387,7 +452,9 @@ The PID of the process. ### process.title 'ps' 縺ｧ縺ｩ縺ｮ繧医≧陦ｨ遉ｺ縺輔ｌ繧九°繧定ｨｭ螳壹☆繧九◆繧√ｮ getter/setter 縺ｧ縺吶 @@ -395,7 +462,9 @@ Getter/setter to set what is displayed in 'ps'. ### process.platform 縺ｩ縺ｮ繝励Λ繝繝医ヵ繧ｩ繝ｼ繝縺ｧ蜍輔＞縺ｦ縺繧九°縺ｧ縺吶Ａ'linux2'`縲〜'darwin'`縲√↑縺ｩ縲 @@ -405,7 +474,9 @@ What platform you're running on. `'linux2'`, `'darwin'`, etc. ### process.memoryUsage() Node 繝励Ο繧ｻ繧ｹ縺ｮ繝｡繝｢繝ｪ菴ｿ逕ｨ迥ｶ豕√ｒ險倩ｿｰ縺励◆繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 @@ -414,7 +485,9 @@ Node 繝励Ο繧ｻ繧ｹ縺ｮ繝｡繝｢繝ｪ菴ｿ逕ｨ迥ｶ豕√ｒ險倩ｿｰ縺励◆繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑 console.log(util.inspect(process.memoryUsage())); 縺薙ｮ繧医≧縺ｫ逕滓舌＆繧後∪縺: @@ -424,7 +497,9 @@ This will generate: heapUsed: 650472 } `heapTotal` 縺ｨ `heapUsed` 縺ｯ V8 縺ｮ繝｡繝｢繝ｪ菴ｿ逕ｨ迥ｶ豕√ｒ蜿らｧ縺励∪縺吶 @@ -432,9 +507,11 @@ This will generate: ### process.nextTick(callback) 繧､繝吶Φ繝医Ν繝ｼ繝励ｮ谺｡莉･髯阪ｮ繝ｫ繝ｼ繝励〒繧ｳ繝ｼ繝ｫ繝舌ャ繧ｯ繧貞他縺ｳ蜃ｺ縺励∪縺吶 縺薙ｌ縺ｯ `setTimeout(fn, 0)` 縺ｮ蜊倡ｴ斐↑繧ｨ繧､繝ｪ繧｢繧ｹ*縺ｧ縺ｯ縺ｪ縺*縲 @@ -448,9 +525,11 @@ efficient. ### process.umask([mask]) 繝励Ο繧ｻ繧ｹ縺ｮ繝輔ぃ繧､繝ｫ繝｢繝ｼ繝我ｽ懈舌槭せ繧ｯ繧定ｨｭ螳壹∪縺溘ｯ隱ｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶 蟄舌励Ο繧ｻ繧ｹ縺ｯ隕ｪ繝励Ο繧ｻ繧ｹ縺九ｉ繝槭せ繧ｯ繧堤ｶ呎価縺励∪縺吶 diff --git a/doc/api/querystring.markdown b/doc/api/querystring.markdown index 8e15805b1350..32bf12a91cd8 100644 --- a/doc/api/querystring.markdown +++ b/doc/api/querystring.markdown @@ -1,21 +1,27 @@ ## Query String 縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ繧ｯ繧ｨ繝ｪ譁蟄怜励ｒ蜃ｦ逅縺吶ｋ繝ｦ繝ｼ繝繧｣繝ｪ繝繧｣繧呈署萓帙＠縺ｾ縺吶 莉･荳九ｮ繝｡繧ｽ繝繝峨°繧画舌ｊ縺ｾ縺: ### querystring.stringify(obj, sep='&', eq='=') 繧ｯ繧ｨ繝ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ譁蟄怜励∈逶ｴ蛻怜喧縺励∪縺吶ゅが繝励す繝ｧ繝ｳ縺ｨ縺励※繝繝輔か繝ｫ繝医ｮ蛹ｺ蛻繧頑枚蟄励→莉｣蜈･譁蟄励ｒ荳頑嶌縺肴欠螳壹〒縺阪∪縺吶 萓: @@ -30,13 +36,17 @@ Example: ### querystring.parse(str, sep='&', eq='=') 繧ｯ繧ｨ繝ｪ譁蟄怜励ｒ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蠕ｩ蜈縺励∪縺吶ゅが繝励す繝ｧ繝ｳ縺ｨ縺励※繝繝輔か繝ｫ繝医ｮ蛹ｺ蛻繧頑枚蟄励→莉｣蜈･譁蟄励ｒ荳頑嶌縺肴欠螳壹〒縺阪∪縺吶 萓: @@ -47,15 +57,19 @@ Example: ### querystring.escape escape 髢｢謨ｰ縺ｯ `querystring.stringify` 縺ｧ菴ｿ逕ｨ縺輔ｌ縺ｦ縺縺ｦ縲∝ｿ隕√↑蝣ｴ蜷医↓繧ｪ繝ｼ繝舌ｼ繝ｩ繧､繝峨〒縺阪ｋ繧医≧謠蝉ｾ帙＆繧後※縺縺ｾ縺吶 ### querystring.unescape unescape髢｢謨ｰ縺ｯ `querystring.parse` 縺ｧ菴ｿ逕ｨ縺輔ｌ縺ｦ縺縺ｦ縲∝ｿ隕√↑蝣ｴ蜷医↓繧ｪ繝ｼ繝舌ｼ繝ｩ繧､繝峨〒縺阪ｋ繧医≧謠蝉ｾ帙＆繧後※縺縺ｾ縺吶 diff --git a/doc/api/repl.markdown b/doc/api/repl.markdown index ccf5baa595e0..33e089c541a9 100644 --- a/doc/api/repl.markdown +++ b/doc/api/repl.markdown @@ -1,18 +1,22 @@ ## REPL Read-Eval-Print-Loop (REPL) 縺ｯ蜊倡峡縺ｮ繝励Ο繧ｰ繝ｩ繝縺ｨ縺励※繧ゆｻ悶ｮ繝励Ο繧ｰ繝ｩ繝縺ｫ謇玖ｻｽ縺ｫ蜿悶ｊ霎ｼ繧蠖｢縺ｧ繧ょ茜逕ｨ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 REPL 縺ｯ蟇ｾ隧ｱ逧縺ｫ JavaScript 繧貞ｮ溯｡後＠縺ｦ邨先棡繧堤｢ｺ隱阪☆繧区焔谿ｵ繧呈署萓帙＠縺ｾ縺吶 繝繝舌ャ繧ｰ繧繝繧ｹ繝医ｄ縺昴ｮ莉悶ｮ讒倥縺ｪ縺薙→繧定ｩｦ縺咏畑騾斐〒蛻ｩ逕ｨ縺輔ｌ縺ｾ縺吶 繧ｳ繝槭Φ繝峨Λ繧､繝ｳ縺九ｉ `node` 繧貞ｼ墓焚辟｡縺励〒螳溯｡後☆繧九％縺ｨ縺ｧ縲ヽEPL 繝励Ο繧ｰ繝ｩ繝縺ｫ蜈･繧翫∪縺吶 REPL 縺ｯ Emacs 鬚ｨ縺ｮ邁｡譏薙↑陦檎ｷｨ髮讖溯ｽ繧貞ｙ縺医※縺縺ｾ縺吶 @@ -29,14 +33,18 @@ REPL 縺ｯ Emacs 鬚ｨ縺ｮ邁｡譏薙↑陦檎ｷｨ髮讖溯ｽ繧貞ｙ縺医※縺縺ｾ縺吶 3 繧医ｊ騾ｲ繧薙□陦檎ｷｨ髮繧定｡後≧縺ｫ縺ｯ縲∫腸蠅螟画焚縺ｫ `NODE_NO_READLINE=1` 繧定ｨｭ螳壹＠縺ｦnode繧定ｵｷ蜍輔＠縺ｦ縺上□縺輔＞縲 縺薙ｌ縺ｫ繧医▲縺ｦ豁｣隕上ｮ遶ｯ譛ｫ險ｭ螳壹〒 REPL 繧定ｵｷ蜍輔＠縲〜rlwrap` 繧呈怏蜉ｹ縺ｫ縺励◆迥ｶ諷九〒REPL繧貞茜逕ｨ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 萓九→縺励※縲｜ashrc 繝輔ぃ繧､繝ｫ縺ｫ莉･荳九ｮ繧医≧縺ｫ險ｭ螳壹ｒ霑ｽ蜉縺励∪縺: @@ -46,23 +54,29 @@ For example, you could add this to your bashrc file: ### repl.start(prompt='> ', stream=process.openStdin()) `prompt` 縺ｧ繝励Ο繝ｳ繝励ヨ險伜捷繧偵 `stream` 縺ｧ I/O 繧貞ｼ墓焚縺ｫ蜿悶▲縺ｦ REPL 繧定ｵｷ蜍輔＠縺ｾ縺吶 `prompt` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `> ` 縺ｧ縺吶 `stream` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `process.openStdin()`縺ｧ縺吶 隍謨ｰ縺ｮ REPL 繧定ｵｷ蜍輔＠縺溷ｴ蜷医∝酔荳縺ｮ node 繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺悟ｮ溯｡後＆繧後↑縺縺薙→縺後≠繧翫∪縺吶 縺昴ｌ縺槭ｌ縺ｮ REPL 縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蜈ｱ譛峨＠縺ｾ縺吶′縲！/O 縺ｯ蝗ｺ譛峨ｮ繧ゅｮ繧呈戟縺｡縺ｾ縺吶 REPL 繧呈ｨ呎ｺ門･蜉帙ゞnix 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ゝCP 繧ｽ繧ｱ繝繝医ｮ繧ゅ→縺ｧ襍ｷ蜍輔☆繧倶ｾ九ｒ遉ｺ縺励∪縺: @@ -84,10 +98,12 @@ REPL 繧呈ｨ呎ｺ門･蜉帙ゞnix 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ゝCP 繧ｽ繧ｱ繝繝医ｮ繧ゅ→ }).listen(5001); 縺薙ｮ繝励Ο繧ｰ繝ｩ繝繧偵さ繝槭Φ繝峨Λ繧､繝ｳ縺九ｉ螳溯｡後☆繧九→縲∵ｨ呎ｺ門･蜉帙ｮ繧ゅ→縺ｧ REPL 縺瑚ｵｷ蜍輔＠縺ｾ縺吶 莉悶ｮ REPL 繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ Unix 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医° TCP 繧ｽ繧ｱ繝繝医ｒ莉九＠縺ｦ謗･邯壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 @@ -95,8 +111,10 @@ TCP sockets. `socat` 縺ｯ Unix 繝峨Γ繧､繝ｳ /TCP 荳｡譁ｹ縺ｮ繧ｽ繧ｱ繝繝医∈縺ｮ謗･邯壹↓蛻ｩ逕ｨ縺ｧ縺阪∪縺吶 讓呎ｺ門･蜉帙ｮ莉｣繧上ｊ縺ｫ Unix 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医ｒ繝吶ｼ繧ｹ縺ｨ縺励◆繧ｵ繝ｼ繝舌°繧 REPL 繧定ｵｷ蜍輔☆繧九％縺ｨ縺ｫ繧医▲縺ｦ縲 蜀崎ｵｷ蜍輔☆繧九％縺ｨ縺ｪ縺 node 縺ｮ蟶ｸ鬧舌励Ο繧ｻ繧ｹ縺ｸ謗･邯壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 @@ -105,12 +123,16 @@ connect to a long-running node process without restarting it. ### REPL Features REPL 縺ｮ荳ｭ縺ｧ Control+D 繧貞ｮ溯｡後☆繧九→邨ゆｺ縺励∪縺吶り､謨ｰ陦後↓貂｡繧句ｼ上ｒ蜈･蜉帙→縺吶ｋ縺薙→縺後〒縺阪∪縺吶 迚ｹ蛻･縺ｪ螟画焚縺ｧ縺ゅｋ `_` (繧｢繝ｳ繝繝ｼ繧ｹ繧ｳ繧｢) 縺ｯ荳逡ｪ譛蠕後ｮ蠑上ｮ邨先棡繧剃ｿ晄戟縺励∪縺吶 @@ -122,9 +144,11 @@ The special variable `_` (underscore) contains the result of the last expression 4 REPL 縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｹ繧ｳ繝ｼ繝励↓蟄伜惠縺吶ｋ蜈ｨ縺ｦ縺ｮ螟画焚縺ｫ繧｢繧ｯ繧ｻ繧ｹ蜿ｯ閭ｽ縺ｧ縺吶 縺昴ｌ縺槭ｌ縺ｮ `REPLServer` 縺ｫ邏舌▼縺 `context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医↓螟画焚繧剃ｻ倅ｸ弱☆繧九％縺ｨ縺ｧ縲 @@ -137,7 +161,9 @@ REPL 縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν繧ｹ繧ｳ繝ｼ繝励↓蟄伜惠縺吶ｋ蜈ｨ縺ｦ縺ｮ螟画焚縺ｫ繧｢繧ｯ繧ｻ繧ｹ repl.start().context.m = msg; `context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医↓險ｭ螳壹＆繧後◆螟画焚縺ｯ縲ヽEPL 縺ｮ荳ｭ縺ｧ縺ｯ繝ｭ繝ｼ繧ｫ繝ｫ縺ｪ螟画焚縺ｨ縺励※迴ｾ繧後∪縺: @@ -146,15 +172,19 @@ Things in the `context` object appear as local within the REPL: 'message' - `.break` - 隍謨ｰ陦後↓貂｡縺｣縺ｦ蠑上ｒ蜈･蜉帙＠縺ｦ縺繧矩俣縺ｫ縲騾比ｸｭ縺ｧ蛻縺九ｉ縺ｪ縺上↑縺｣縺溘ｊ螳御ｺ縺輔○縺ｪ縺上※繧り憶縺上↑繧九％縺ｨ縺後≠繧翫∪縺吶Ａ.break` 縺ｧ譛蛻昴°繧峨ｄ繧顔峩縺励∪縺吶 - `.clear` - `context` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ遨ｺ縺ｮ迥ｶ諷九↓繝ｪ繧ｻ繝繝医＠縲∬､謨ｰ陦後↓蜈･蜉帙＠縺ｦ縺繧句ｼ上ｒ繧ｯ繝ｪ繧｢縺励∪縺吶 diff --git a/doc/api/streams.markdown b/doc/api/streams.markdown index e5c2b00211f6..2b80581d3a32 100644 --- a/doc/api/streams.markdown +++ b/doc/api/streams.markdown @@ -1,9 +1,11 @@ ## Streams 繧ｹ繝医Μ繝ｼ繝縺ｯ Node 縺ｮ讒倥縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医〒螳溯｣縺輔ｌ繧区歓雎｡逧縺ｪ繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ縺ｧ縺吶 萓九∴縺ｰ HTTP 繧ｵ繝ｼ繝舌∈縺ｮ繝ｪ繧ｯ繧ｨ繧ｹ繝医ｯ讓呎ｺ門ｺ蜉帙→蜷梧ｧ倥↓繧ｹ繝医Μ繝ｼ繝縺ｧ縺吶 @@ -13,7 +15,9 @@ are readable, writable, or both. All streams are instances of `EventEmitter`. ## Readable Stream `Readable Stream` 縺ｫ縺ｯ莉･荳九ｮ繝｡繧ｽ繝繝峨√Γ繝ｳ繝舌ｼ縲√◎縺励※繧､繝吶Φ繝医′縺ゅｊ縺ｾ縺吶 @@ -22,8 +26,10 @@ A `Readable Stream` has the following methods, members, and events. `function (data) { }` `'data'` 繧､繝吶Φ繝医ｯ `Buffer` (繝繝輔か繝ｫ繝) 縺ｾ縺溘ｯ縲 `setEncoding()` 縺輔ｌ縺溷ｴ蜷医ｯ譁蟄怜励ｮ縺ｩ縺｡繧峨°繧堤函謌舌＠縺ｾ縺 @@ -33,9 +39,11 @@ The `'data'` event emits either a `Buffer` (by default) or a string if `function () { }` 繧ｹ繝医Μ繝ｼ繝縺 EOF (TCP 逕ｨ隱槭〒縺ｯ FIN) 繧貞女菫｡縺励◆譎ゅ↓逕滓舌＆繧後∪縺吶 `'data'` 繧､繝吶Φ繝医′繧ゅ≧逋ｺ逕溘＠縺ｪ縺縺薙→繧堤､ｺ縺励∪縺吶 @@ -46,7 +54,9 @@ writable, it may be possible to continue writing. `function (exception) { }` 繝繝ｼ繧ｿ蜿嶺ｿ｡縺ｧ繧ｨ繝ｩ繝ｼ縺後≠繧九→逕滓舌＆繧後∪縺吶 @@ -55,9 +65,11 @@ Emitted if there was an error receiving data. `function () { }` 荳句ｱ､縺ｧ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌′繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺滓凾縺ｫ逕滓舌＆繧後∪縺吶 蜈ｨ縺ｦ縺ｮ繧ｹ繝医Μ繝ｼ繝縺後％縺ｮ繧､繝吶Φ繝医ｒ逋ｺ逕溘☆繧九ｏ縺代〒縺ｯ縺ゅｊ縺ｾ縺帙ｓ縲 @@ -68,8 +80,10 @@ will emit this. (For example, an incoming HTTP request will not emit `function (fd) { }` 繧ｹ繝医Μ繝ｼ繝縺ｫ髢｢縺吶ｋ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｒ蜿励¢蜿悶▲縺滓凾縺ｫ逕滓舌＆繧後∪縺吶 UNIX 繧ｹ繝医Μ繝ｼ繝縺縺代′縺薙ｮ讖溯ｽ繧偵し繝昴ｼ繝医＠縺ｦ縺縺ｾ縺; @@ -78,8 +92,10 @@ UNIX 繧ｹ繝医Μ繝ｼ繝縺縺代′縺薙ｮ讖溯ｽ繧偵し繝昴ｼ繝医＠縺ｦ縺縺ｾ縺; ### stream.readable 繝繝輔か繝ｫ繝医〒縺ｯ `true` 縺ｧ縺吶′縲〜'error'` 縺檎匱逕溘＠縺溷ｾ後 繧ｹ繝医Μ繝ｼ繝縺 `'end'` 縺ｫ驕斐＠縺溷ｾ後√∪縺溘ｯ `destroy()` 縺悟他縺ｰ繧後◆蠕後〒縲 @@ -87,8 +103,10 @@ occured, the stream came to an `'end'`, or `destroy()` was called. ### stream.setEncoding(encoding) data 繧､繝吶Φ繝医′ `Buffer` 縺ｧ縺ｯ縺ｪ縺乗枚蟄怜励ｒ逕滓舌☆繧九ｈ縺縺ｫ縺励∪縺吶 `encoding` 縺ｫ縺ｯ `'utf8'`縲〜'ascii'`縲 @@ -97,42 +115,54 @@ data 繧､繝吶Φ繝医′ `Buffer` 縺ｧ縺ｯ縺ｪ縺乗枚蟄怜励ｒ逕滓舌☆繧九ｈ縺縺ｫ縺 ### stream.pause() `'data'` 繧､繝吶Φ繝医ｮ蛻ｰ逹繧剃ｸｭ譁ｭ縺励∪縺吶 ### stream.resume() `pause()` 縺ｮ蠕後〒 `'data'` 繧､繝吶Φ繝医ｮ蛻ｰ逹繧貞埼幕縺励∪縺吶 ### stream.destroy() 荳句ｱ､縺ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺励∪縺吶ゅせ繝医Μ繝ｼ繝縺ｯ縺昴ｌ莉･荳翫う繝吶Φ繝医ｒ逕滓舌＠縺ｪ縺上↑繧翫∪縺吶 ### stream.pipe(destination, [options]) 縺薙ｌ縺ｯ蜈ｨ縺ｦ縺ｮ `Stream` 縺ｧ蛻ｩ逕ｨ蜿ｯ閭ｽ縺ｪ `Stream.prototype` 繝｡繧ｽ繝繝峨〒縺吶 隱ｭ縺ｿ霎ｼ縺ｿ繧ｹ繝医Μ繝ｼ繝繧 `destination` 縺ｮ譖ｸ縺崎ｾｼ縺ｿ繧ｹ繝医Μ繝ｼ繝縺ｫ謗･邯壹＠縺ｾ縺吶 縺薙ｮ繧ｹ繝医Μ繝ｼ繝縺ｫ蜈･縺｣縺ｦ縺阪◆繝繝ｼ繧ｿ縺ｯ `destination` 縺ｫ譖ｸ縺崎ｾｼ縺ｾ繧後∪縺吶 謗･邯壼医→謗･邯壼縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｯ縲∝ｿ隕√↓蠢懊§縺ｦ荳ｭ譁ｭ縺ｨ蜀埼幕縺吶ｋ縺薙→縺ｧ蜷梧悄繧剃ｿ昴■縺ｾ縺吶 Unix 縺ｮ `cat` 繧ｳ繝槭Φ繝峨ｮ繧ｨ繝溘Η繝ｬ繝ｼ繝: @@ -140,16 +170,20 @@ Unix 縺ｮ `cat` 繧ｳ繝槭Φ繝峨ｮ繧ｨ繝溘Η繝ｬ繝ｼ繝: 繝繝輔か繝ｫ繝医〒縺ｯ謗･邯壼繧ｹ繝医Μ繝ｼ繝縺ｧ `end` 繧､繝吶Φ繝医′逕滓舌＆繧後ｋ縺ｨ縲 謗･邯壼医ｮ `end()` 縺悟他縺ｰ繧後ｋ縺ｮ縺ｧ縲√ｂ縺譖ｸ縺崎ｾｼ縺ｿ縺ｯ縺ｧ縺阪∪縺帙ｓ縲 `option` 縺ｫ `{ end: false }` 繧呈ｸ｡縺吶→謗･邯壼医ｯ繧ｹ繝医Μ繝ｼ繝縺ｯ繧ｪ繝ｼ繝励Φ縺輔ｌ縺溘∪縺ｾ縺ｨ縺ｪ繧翫∪縺吶 縺薙ｌ縺ｯ `process.stdout` 繧偵が繝ｼ繝励Φ縺励◆縺ｾ縺ｾ縺ｫ縺励※譛蠕後↓ "Goodbye" 縺ｨ蜃ｺ蜉帙＠縺ｾ縺吶 @@ -158,9 +192,11 @@ This keeps `process.stdout` open so that "Goodbye" can be written at the end. stdin.on("end", function() { process.stdout.write("Goodbye\n"); }); 豕ｨ諢: 繧ゅ＠謗･邯壼繧ｹ繝医Μ繝ｼ繝縺 `pauses()` 縺ｨ `resume()` 繧偵し繝昴ｼ繝医＠縺ｪ縺蝣ｴ蜷医 縺薙ｮ髢｢謨ｰ縺ｯ蜊倥↓ `'pause'` 縺ｨ `'resume'` 繧､繝吶Φ繝医ｒ謗･邯壹ｂ縺ｨ繧ｹ繝医Μ繝ｼ繝縺ｧ逕滓舌＠縺ｾ縺吶 @@ -168,7 +204,9 @@ the source stream. ## Writable Stream `Writable Stream` 縺ｫ縺ｯ莉･荳九ｮ繝｡繧ｽ繝繝峨√Γ繝ｳ繝舌ｼ縲√◎縺励※繧､繝吶Φ繝医′縺ゅｊ縺ｾ縺吶 @@ -177,8 +215,10 @@ A `Writable Stream` has the following methods, members, and events. `function () { }` 蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺 `write()` 繝｡繧ｽ繝繝峨′ `false` 縺ｧ謌ｻ縺｣縺溷ｾ後↓逕滓舌＆繧後 蜀阪ｳ螳牙ｨ縺ｫ譖ｸ縺崎ｾｼ繧縺薙→縺後〒縺阪ｋ繧医≧縺ｫ縺ｪ縺｣縺溘％縺ｨ繧堤､ｺ縺励∪縺吶 @@ -188,7 +228,9 @@ indicate that it is safe to write again. `function (exception) { }` `exception`萓句､悶↓繧医ｋ繧ｨ繝ｩ繝ｼ縺ｫ縺､縺縺ｦ逕滓舌＆繧後∪縺吶 @@ -197,15 +239,19 @@ Emitted on error with the exception `exception`. `function () { }` 荳句ｱ､縺ｧ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌′繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺滓凾縺ｫ逕滓舌＆繧後∪縺吶 ### stream.writeable 繝繝輔か繝ｫ繝医〒縺ｯ `true` 縺ｧ縺吶′縲〜'error'` 縺檎匱逕溘＠縺溷ｾ後 `end()` / `destroy()` 縺悟他縺ｰ繧後◆蠕後〒 `false` 縺ｫ險ｭ螳壹＆繧後ｋ boolean 縺ｧ縺吶 @@ -213,11 +259,13 @@ occurred or `end()` / `destroy()` was called. ### stream.write(string, encoding='utf8', [fd]) 荳弱∴繧峨ｌ縺 `encoding` 縺ｧ `string` 繧呈嶌縺崎ｾｼ縺ｿ縺ｾ縺吶 譁蟄怜励′繧ｫ繝ｼ繝阪Ν繝舌ャ繝輔ぃ縺ｫ繝輔Λ繝繧ｷ繝･縺輔ｌ縺溷ｴ蜷医ｯ `true` 縺瑚ｿ斐ｊ縺ｾ縺吶 @@ -227,11 +275,13 @@ empty again. The `encoding` defaults to `'utf8'`. `encoding` 縺ｮ繝繝輔か繝ｫ繝医ｯ `'utf8'` 縺ｧ縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｮ `fd` 蠑墓焚縺梧欠螳壹＆繧後ｋ縺ｨ縲 繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺吶ｋ縺溘ａ縺ｮ蝓ｺ遉弱→縺ｪ繧九ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌→縺励※隗｣驥医＆繧後∪縺吶 @@ -242,22 +292,28 @@ invalid (closed) FD. ### stream.write(buffer) 逕溘ｮ繝舌ャ繝輔ぃ繧剃ｽｿ縺縺薙→莉･螟悶ｯ荳願ｨ倥→蜷後§縺ｧ縺吶 ### stream.end() 繧ｹ繝医Μ繝ｼ繝繧 EOF 縺ｾ縺溘ｯ FIN 縺ｧ邨ゆｺ縺励∪縺吶 ### stream.end(string, encoding) 荳弱∴繧峨ｌ縺 `encoding` 縺ｧ `string` 繧帝∽ｿ｡縺励※縺九ｉEOF縺ｾ縺溘ｯFIN縺ｧ繧ｹ繝医Μ繝ｼ繝繧堤ｵゆｺ縺励∪縺吶 縺薙ｌ縺ｯ騾∽ｿ｡縺吶ｋ繝代こ繝繝医ｮ謨ｰ繧呈ｸ帙ｉ縺吶◆繧√↓萓ｿ蛻ｩ縺ｧ縺吶 @@ -265,13 +321,17 @@ or FIN. This is useful to reduce the number of packets sent. ### stream.end(buffer) `buffer` 縺ｧ縺ゅｋ縺薙→莉･螟悶ｯ荳願ｨ倥→蜷後§縺ｧ縺吶 ### stream.destroy() 荳句ｱ､縺ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺励∪縺吶ゅせ繝医Μ繝ｼ繝縺ｯ縺昴ｌ莉･荳翫う繝吶Φ繝医ｒ逕滓舌＠縺ｪ縺上↑繧翫∪縺吶 diff --git a/doc/api/synopsis.markdown b/doc/api/synopsis.markdown index 09b9cdcffe37..0e138ef67980 100644 --- a/doc/api/synopsis.markdown +++ b/doc/api/synopsis.markdown @@ -1,8 +1,10 @@ ## Synopsis 'Hello World' 縺ｨ霑皮ｭ斐☆繧 Node 縺ｧ譖ｸ縺九ｌ縺欷eb繧ｵ繝ｼ繝舌ｮ萓: @@ -16,8 +18,10 @@ World': console.log('Server running at http://127.0.0.1:8124/'); 縺薙ｮ繧ｵ繝ｼ繝舌ｒ螳溯｡後☆繧九↓縺ｯ縲√さ繝ｼ繝峨ｒ `example.js` 縺ｨ縺縺繝輔ぃ繧､繝ｫ縺ｫ菫晏ｭ倥＠縲 node 繧ｳ繝槭Φ繝峨〒螳溯｡後＠縺ｦ縺上□縺輔＞縲 @@ -26,6 +30,8 @@ node 繧ｳ繝槭Φ繝峨〒螳溯｡後＠縺ｦ縺上□縺輔＞縲 Server running at http://127.0.0.1:8124/ 縺薙ｮ繝峨く繝･繝｡繝ｳ繝医ｮ蜈ｨ縺ｦ縺ｮ繧ｵ繝ｳ繝励Ν縺ｯ蜷後§繧医≧縺ｫ螳溯｡後☆繧九％縺ｨ縺後〒縺阪∪縺吶 diff --git a/doc/api/timers.markdown b/doc/api/timers.markdown index 7fd7f47a64fb..eb888782be81 100644 --- a/doc/api/timers.markdown +++ b/doc/api/timers.markdown @@ -3,9 +3,11 @@ ### setTimeout(callback, delay, [arg], [...]) `delay` 繝溘Μ遘偵′邨碁℃縺励◆蠕後〒 `callback` 縺悟ｮ溯｡後＆繧後ｋ繧医≧縺ｫ繧ｹ繧ｱ繧ｸ繝･繝ｼ繝ｫ縺励∪縺吶 `clearTimeout()` 縺ｧ菴ｿ縺縺薙→縺後〒縺阪ｋ `timeoutId` 繧定ｿ斐＠縺ｾ縺吶 @@ -14,16 +16,20 @@ also pass arguments to the callback. ### clearTimeout(timeoutId) 繧ｿ繧､繝繧｢繧ｦ繝医′繝医Μ繧ｬ繝ｼ縺輔ｌ繧九ｮ繧呈ｭ｢繧√∪縺吶 ### setInterval(callback, delay, [arg], [...]) `delay` 繝溘Μ遘偵′邨碁℃縺吶ｋ縺斐→縺ｫ郢ｰ繧願ｿ斐＠ `callback` 縺悟ｮ溯｡後＆繧後ｋ繧医≧縺ｫ繧ｹ繧ｱ繧ｸ繝･繝ｼ繝ｫ縺励∪縺吶 `clearInterval()` 縺ｧ菴ｿ縺縺薙→縺後〒縺阪ｋ `intervalId` 繧定ｿ斐＠縺ｾ縺吶 @@ -32,6 +38,8 @@ you can also pass arguments to the callback. ### clearInterval(intervalId) 繧､繝ｳ繧ｿ繝ｼ繝舌Ν縺後ヨ繝ｪ繧ｬ繝ｼ縺輔ｌ繧九ｮ繧呈ｭ｢繧√∪縺吶 diff --git a/doc/api/tls.markdown b/doc/api/tls.markdown index 35bbdc7ec159..7a0df52dac45 100644 --- a/doc/api/tls.markdown +++ b/doc/api/tls.markdown @@ -1,20 +1,26 @@ ## TLS (SSL) `require('tls')` 縺ｧ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 `tls` 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ OpenSSL 繧剃ｽｿ逕ｨ縺吶ｋ縺薙→縺ｧ Transport Layer Security 縺翫ｈ縺ｳ Secure Socket Layer: 證怜捷蛹悶＆繧後◆繧ｹ繝医Μ繝ｼ繝騾壻ｿ｡繧呈署萓帙＠縺ｾ縺吶 TLS/SSL 縺ｯ蜈ｬ髢具ｼ冗ｧ伜ｯ骰ｵ繧貞渕遉弱→縺励∪縺吶 縺ｩ縺ｮ繧ｯ繝ｩ繧､繧｢繝ｳ繝医→繧ｵ繝ｼ繝舌ｂ遘伜ｯ骰ｵ縺悟ｿ隕√〒縺吶 @@ -23,10 +29,12 @@ TLS/SSL 縺ｯ蜈ｬ髢具ｼ冗ｧ伜ｯ骰ｵ繧貞渕遉弱→縺励∪縺吶 openssl genrsa -out ryans-key.pem 1024 蜈ｨ縺ｦ縺ｮ繧ｵ繝ｼ繝舌→荳驛ｨ縺ｮ繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ險ｼ譏取嶌繧貞ｿ隕√→縺励∪縺吶 險ｼ譏取嶌縺ｯ隱崎ｨｼ螻縺ｮ蜈ｬ髢矩嵯縺ｾ縺溘ｯ閾ｪ霄ｫ縺ｫ繧医▲縺ｦ鄂ｲ蜷阪＆繧後∪縺吶 @@ -36,20 +44,26 @@ file. This is done with: openssl req -new -key ryans-key.pem -out ryans-csr.pem CSR 縺九ｉ閾ｪ蟾ｱ鄂ｲ蜷崎ｨｼ譏取嶌繧剃ｽ懈舌☆繧九↓縺ｯ谺｡縺ｮ繧医≧縺ｫ縺励∪縺: openssl x509 -req -in ryans-csr.pem -signkey ryans-key.pem -out ryans-cert.pem 莉悶↓ CSR 繧定ｪ崎ｨｼ螻縺ｫ騾√▲縺ｦ鄂ｲ蜷阪＠縺ｦ繧ゅｉ縺縺薙→繧ゅ〒縺阪∪縺吶 (TODO: CA 繧剃ｽ懊ｋ繝峨く繝･繝｡繝ｳ繝医∫樟蝨ｨ縺ｯ闊亥袖縺ゅｋ繝ｦ繝ｼ繧ｶ縺ｯ Node 縺ｮ繧ｽ繝ｼ繧ｹ繧ｳ繝ｼ繝峨°繧 `test/fixtures/keys/Makefile` 繧定ｦ九ｋ蠢隕√′縺ゅｋ) @@ -58,8 +72,10 @@ Alternatively you can send the CSR to a Certificate Authority for signing. ### s = tls.connect(port, [host], [options], callback) 荳弱∴繧峨ｌ縺 `port` 縺ｨ `host` 縺ｧ譁ｰ縺励＞繧ｯ繝ｩ繧､繧｢繝ｳ繝医さ繝阪け繧ｷ繝ｧ繝ｳ繧剃ｽ懈舌＠縺ｾ縺 (`host` 縺ｮ繝繝輔か繝ｫ繝医ｯ `localhost` 縺ｧ縺)縲 @@ -67,6 +83,7 @@ defaults to `localhost`.) `options` should be an object which specifies - `key`: PEM 繝輔か繝ｼ繝槭ャ繝医↓繧医ｋ繧ｵ繝ｼ繝舌ｮ遘伜ｯ骰ｵ繧呈戟縺､譁蟄怜励∪縺溘ｯ `Buffer` 縺ｧ縺 (蠢鬆)縲 @@ -86,16 +104,20 @@ defaults to `localhost`.) `options` should be an object which specifies 縺薙ｌ繧峨ｯ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ隱崎ｨｼ縺ｫ菴ｿ繧上ｌ縺ｾ縺吶 `tls.connect()` 縺ｯ蟷ｳ譁縺ｮ `CryptoStream` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 TLS/SSL 繝上Φ繝峨す繧ｧ繝ｼ繧ｯ縺ｮ蠕後〒 `callback` 縺悟他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 `callback` 縺ｯ險ｼ譏取嶌縺後し繝ｼ繝舌↓隱崎ｨｼ縺輔ｌ縺溘°縺ｩ縺縺九↓髢｢繧上ｉ縺壼他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 @@ -106,16 +128,20 @@ TLS/SSL 繝上Φ繝峨す繧ｧ繝ｼ繧ｯ縺ｮ蠕後〒 `callback` 縺悟他縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 ### tls.Server 縺薙ｮ繧ｯ繝ｩ繧ｹ縺ｯ `net.Server` 縺ｮ繧ｵ繝悶け繝ｩ繧ｹ縺ｧ縲∝酔縺倥Γ繧ｽ繝繝峨ｒ謖√▲縺ｦ縺縺ｾ縺吶 逕溘ｮ TCP 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺大･繧後ｋ莉｣繧上ｊ縺ｫ縲 TLS 縺ｾ縺溘ｯ SSL 繧剃ｽｿ縺｣縺滓囓蜿ｷ蛹悶＆繧後◆繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞女縺台ｻ倥¢縺ｾ縺吶 縺薙ｌ縺ｯ繧ｷ繝ｳ繝励Ν縺ｪ繧ｨ繧ｳ繝ｼ繧ｵ繝ｼ繝舌ｮ萓九〒縺吶 @@ -134,7 +160,9 @@ Here is a simple example echo server: 縺薙ｮ繧ｵ繝ｼ繝舌ｒ繝繧ｹ繝医☆繧九◆繧√↓ `openssl s_client` 縺ｧ謗･邯壹☆繧九％縺ｨ縺後〒縺阪∪縺吶 @@ -145,13 +173,16 @@ You can test this server by connecting to it with `openssl s_client`: #### tls.createServer(options, secureConnectionListener) `tls.Server` 繧ｯ繝ｩ繧ｹ縺ｮ繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ縺ｧ縺吶 繧ｪ繝励す繝ｧ繝ｳ縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ莉･荳九ｒ謖√▽縺薙→縺後〒縺阪∪縺吶 - `key`: PEM 繝輔か繝ｼ繝槭ャ繝医↓繧医ｋ繧ｵ繝ｼ繝舌ｮ遘伜ｯ骰ｵ繧呈戟縺､譁蟄怜励∪縺溘ｯ `Buffer` 縺ｧ縺 (蠢鬆)縲 @@ -192,21 +224,25 @@ has these possibilities: `function (cleartextStream) {}` 縺薙ｮ繧､繝吶Φ繝医ｯ縲∵眠縺励＞謗･邯壹ｮ繝上Φ繝峨す繧ｧ繝ｼ繧ｯ縺梧仙粥縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 蠑墓焚縺ｯ `stream.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 縺薙ｌ縺ｯ繧ｹ繝医Μ繝ｼ繝縺ｫ蜈ｱ騾壹☆繧句ｨ縺ｦ縺ｮ繝｡繧ｽ繝繝峨→繧､繝吶Φ繝医ｒ謖√▲縺ｦ縺縺ｾ縺吶 `cleartextStream.authorized` 縺ｯ謠蝉ｾ帙＆繧後◆隱崎ｨｼ螻縺ｮ縺縺壹ｌ縺九↓繧医▲縺ｦ隱崎ｨｼ縺輔ｌ縺溘°繧堤､ｺ縺 boolean 蛟､縺ｧ縺吶 `cleartextStream.authorized` 縺 false 縺ｮ蝣ｴ蜷医 @@ -218,22 +254,28 @@ TLS 繧ｵ繝ｼ繝舌ｮ險ｭ螳壹↓萓晏ｭ倥＠縺ｾ縺吶′縲∬ｪ崎ｨｼ縺輔ｌ縺ｦ縺縺ｪ縺繧ｳ繝阪け #### server.listen(port, [host], [callback]) 謖螳壹ｮ `port` 縺ｨ `host` 縺ｧ謗･邯壹ｮ蜿励¢蜈･繧後ｒ髢句ｧ九＠縺ｾ縺吶 `host` 縺檎怐逡･縺輔ｌ繧九→縲√し繝ｼ繝舌ｯ縺ｩ繧薙↑ IPv4 繧｢繝峨Ξ繧ｹ縺九ｉ縺ｮ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧ょ女縺大･繧後∪縺 (`INADDR_ANY`)縲 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶 譛蠕後ｮ蠑墓焚 `callback` 縺ｯ繧ｵ繝ｼ繝舌′繝舌う繝ｳ繝峨＆繧後ｋ縺ｨ蜻ｼ縺ｳ蜃ｺ縺輔ｌ縺ｾ縺吶 繧医ｊ隧ｳ邏ｰ縺ｯ `net.Server` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 @@ -241,9 +283,11 @@ See `net.Server` for more information. #### server.close() 繧ｵ繝ｼ繝舌′譁ｰ縺励＞謗･邯壹ｒ蜿励¢蜈･繧後ｋ縺薙→繧堤ｵゆｺ縺励∪縺吶 縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縲√し繝ｼ繝舌′譛邨ら噪縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ繧九→繧ｵ繝ｼ繝舌ｯ `'close'` 繧､繝吶Φ繝医ｒ逕滓舌＠縺ｾ縺吶 @@ -252,13 +296,17 @@ event. #### server.maxConnections 縺薙ｮ繝励Ο繝代ユ繧｣繧定ｨｭ螳壹☆繧九→縲√し繝ｼ繝舌ｮ謗･邯壽焚縺後％繧後ｒ雜翫∴縺溷ｴ蜷医↓謗･邯壹ｒ遐ｴ譽縺励∪縺吶 #### server.connections 繧ｵ繝ｼ繝舌ｮ荳ｦ陦後さ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ謨ｰ縺ｧ縺吶 diff --git a/doc/api/tty.markdown b/doc/api/tty.markdown index 52cc6a12b643..b5f298c8dd26 100644 --- a/doc/api/tty.markdown +++ b/doc/api/tty.markdown @@ -1,7 +1,9 @@ ## TTY `require('tty')` 縺ｧ縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 @@ -9,15 +11,19 @@ Use `require('tty')` to access this module. ### tty.open(path, args=[]) `path 縺ｧ謖螳壹＆繧後◆螳溯｡後ヵ繧｡繧､繝ｫ縺九ｉ譁ｰ縺励＞繝励Ο繧ｻ繧ｹ繧呈眠縺励＞逍台ｼｼ遶ｯ譛ｫ縺ｮ繧ｻ繝繧ｷ繝ｧ繝ｳ繝ｪ繝ｼ繝縺ｨ縺励※襍ｷ蜍輔＠縺ｾ縺吶 驟榊 `[slaveFD, childProcess]` 繧定ｿ斐＠縺ｾ縺吶 `slaveFD` 縺ｯ逍台ｼｼ遶ｯ譛ｫ縺ｮ繧ｹ繝ｬ繝ｼ繝門ｴ縺ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌〒縺吶 @@ -27,8 +33,10 @@ object. ### tty.isatty(fd) `fd` 縺檎ｫｯ譛ｫ縺ｫ髢｢騾｣縺･縺代ｉ繧後※縺繧九°縺ｩ縺縺九ｒ `true` 縺ｾ縺溘ｯ `false` 縺ｧ霑斐＠縺ｾ縺吶 @@ -36,8 +44,10 @@ terminal. ### tty.setRawMode(mode) `mode` 縺ｯ `true` 縺ｾ縺溘ｯ `false` 縺ｧ縺吶 縺薙ｌ縺ｯ迴ｾ蝨ｨ縺ｮ繝励Ο繧ｻ繧ｹ縺ｮ讓呎ｺ門･蜉帙ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繝ｭ繝ｼ繝繝舌う繧ｹ縺ｾ縺溘ｯ繝繝輔か繝ｫ繝医↓謖ｯ繧玖槭≧繧医≧險ｭ螳壹＠縺ｾ縺吶 @@ -46,13 +56,17 @@ process's stdin fd to act either as a raw device or default. ### tty.getColumns() 迴ｾ蝨ｨ縺ｮ繝励Ο繧ｻ繧ｹ縺ｫ髢｢騾｣縺･縺代ｉ繧後◆ TTY 縺ｮ繧ｫ繝ｩ繝謨ｰ繧定ｿ斐＠縺ｾ縺吶 縺薙ｮ謨ｰ縺ｯ繝励Ο繧ｻ繧ｹ縺 `SIGWINCH` 繧貞女菫｡縺吶ｋ蠎ｦ縺ｫ螟牙喧縺吶ｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 谺｡縺ｮ繧医≧縺ｫ繧ｭ繝｣繝繧ｷ繝･繧剃ｿ晄戟縺吶ｋ縺薙→縺後〒縺阪∪縺吶 diff --git a/doc/api/url.markdown b/doc/api/url.markdown index 3e0ba255033d..b855b85a2417 100644 --- a/doc/api/url.markdown +++ b/doc/api/url.markdown @@ -1,16 +1,20 @@ ## URL 縺薙ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯURL縺ｮ隗｣豎ｺ繧隗｣譫舌ｮ轤ｺ縺ｮ繝ｦ繝ｼ繝繧｣繝ｪ繝繧｣繧呈戟縺｡縺ｾ縺吶 蛻ｩ逕ｨ縺吶ｋ縺ｫ縺ｯ `require('url')` 繧貞他縺ｳ蜃ｺ縺励※縺上□縺輔＞縲 隗｣譫舌＆繧後◆URL繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ縲ゞRL譁蟄怜励ｮ荳ｭ縺ｫ蟄伜惠縺吶ｋ縺九←縺縺九↓蠢懊§縺ｦ 谺｡縺ｫ遉ｺ縺吶ヵ繧｣繝ｼ繝ｫ繝峨ｒ縺縺上▽縺九ｂ縺励￥縺ｯ蜈ｨ縺ｦ繧呈戟縺｡縺ｾ縺吶 @@ -20,6 +24,7 @@ URL譁蟄怜励↓蜷ｫ縺ｾ繧後↑縺繝輔ぅ繝ｼ繝ｫ繝峨ｯ隗｣譫千ｵ先棡縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ `'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'` * `href`: 隗｣譫舌☆繧句燕縺ｮ螳悟ｨ縺ｪ URL縲 @@ -83,15 +89,19 @@ URL譁蟄怜励↓蜷ｫ縺ｾ繧後↑縺繝輔ぅ繝ｼ繝ｫ繝峨ｯ隗｣譫千ｵ先棡縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ 萓: `'#hash'` 莉･荳九ｮ繝｡繧ｽ繝繝峨ｯURL繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧医ｊ謠蝉ｾ帙＆繧後∪縺: ### url.parse(urlStr, parseQueryString=false) URL譁蟄怜励ｒ蠑墓焚縺ｫ蜿悶ｊ縲∬ｧ｣譫千ｵ先棡縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ縺吶 `querystring` 繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ縺｣縺ｦ繧ｯ繧ｨ繝ｪ譁蟄怜励ｂ隗｣譫舌＠縺溘＞蝣ｴ蜷医ｯ縲 @@ -100,13 +110,17 @@ URL譁蟄怜励ｒ蠑墓焚縺ｫ蜿悶ｊ縲∬ｧ｣譫千ｵ先棡縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ霑斐＠縺ｾ ### url.format(urlObj) URL 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ蠑墓焚縺ｫ蜿悶ｊ縲√ヵ繧ｩ繝ｼ繝槭ャ繝医＠縺 URL 譁蟄怜励ｒ霑斐＠縺ｾ縺吶 ### url.resolve(from, to) 繝吶ｼ繧ｹ縺ｨ縺ｪ繧 URL 縺ｨ逶ｸ蟇ｾ URL 繧貞ｼ墓焚縺ｫ蜿悶ｊ縲√ヶ繝ｩ繧ｦ繧ｶ縺後い繝ｳ繧ｫ繝ｼ繧ｿ繧ｰ縺ｫ蟇ｾ縺励※陦後≧縺ｮ縺ｨ蜷梧ｧ倥↓ URL 繧定ｧ｣豎ｺ縺励∪縺吶 diff --git a/doc/api/util.markdown b/doc/api/util.markdown index 9199ecd5f14e..dba0bbd0e36b 100644 --- a/doc/api/util.markdown +++ b/doc/api/util.markdown @@ -1,8 +1,10 @@ ## util 縺薙ｌ繧峨ｮ髢｢謨ｰ縺ｯ繝｢繧ｸ繝･繝ｼ繝ｫ `'util'` 蜀縺ｫ縺ゅｊ縺ｾ縺吶 `require('util')` 繧剃ｽｿ縺縺薙→縺ｧ縺薙ｌ繧峨↓繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 @@ -11,8 +13,10 @@ them. ### util.debug(string) 蜷梧悄逧縺ｪ蜃ｺ蜉幃未謨ｰ縺ｧ縺吶ゅ励Ο繧ｻ繧ｹ繧偵ヶ繝ｭ繝繧ｯ縺励※蜊ｳ蠎ｧ縺ｫ `string` 繧 `stderr` 縺ｫ蜃ｺ蜉帙＠縺ｾ縺吶 @@ -22,7 +26,9 @@ output `string` immediately to `stderr`. ### util.log(string) 繧ｿ繧､繝繧ｹ繧ｿ繝ｳ繝励→縺ｨ繧ゅ↓ `stdout` 縺ｸ蜃ｺ蜉帙＠縺ｾ縺吶 @@ -32,35 +38,45 @@ Output with timestamp on `stdout`. ### util.inspect(object, showHidden=false, depth=2) 繝繝舌ャ繧ｰ縺ｧ譛臥畑縺ｪ縲〜object` 縺ｮ譁蟄怜苓｡ｨ迴ｾ繧定ｿ斐＠縺ｾ縺吶 `showHidden` 縺 `true` 縺ｮ蝣ｴ蜷医 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ Enumerable 縺ｧ縺ｪ縺繝励Ο繝代ユ繧｣繧り｡ｨ遉ｺ縺輔ｌ縺ｾ縺吶 `depth` 縺御ｸ弱∴繧峨ｌ縺溷ｴ蜷医 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繝輔か繝ｼ繝槭ャ繝医☆繧九◆繧√↓菴募屓蜀榊ｸｰ縺吶ｋ縺九ｒ `inspect` 縺ｫ莨昴∴縺ｾ縺吶 縺薙ｌ縺ｯ蟾ｨ螟ｧ縺ｧ隍髮代↑繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ隱ｿ譟ｻ縺吶ｋ蝣ｴ蜷医↓萓ｿ蛻ｩ縺ｧ縺吶 繝繝輔か繝ｫ繝医〒縺ｯ 2 蝗槭□縺大榊ｸｰ縺励∪縺吶 辟｡髯舌↓蜀榊ｸｰ縺吶ｋ縺ｫ縺ｯ縲〜depth` 縺ｫ `null` 繧呈ｸ｡縺励∪縺吶 `util` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ蜈ｨ縺ｦ縺ｮ繝励Ο繝代ユ繧｣繧定ｪｿ譟ｻ縺吶ｋ萓: @@ -72,16 +88,20 @@ Example of inspecting all properties of the `util` object: ### util.pump(readableStream, writeableStream, [callback]) 螳滄ｨ鍋噪 `readableStream` 縺九ｉ繝繝ｼ繧ｿ繧定ｪｭ縺ｿ縲√◎繧 繧蛋writableStream` 縺ｫ騾√ｊ縺ｾ縺吶 `writeableStream.write(data)` 縺 `false` 繧定ｿ斐☆蝣ｴ蜷医 @@ -93,10 +113,12 @@ when an error occurs. ### util.inherits(constructor, superConstructor) 縺ゅｋ [繧ｳ繝ｳ繧ｹ繝医Λ繧ｯ繧ｿ](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Object/constructor) @@ -104,8 +126,10 @@ object created from `superConstructor`. `constructor` 縺ｮ繝励Ο繝医ち繧､繝励ｯ `superConstructor` 縺九ｉ菴懊ｉ繧後◆繧ｪ繝悶ず繧ｧ繧ｯ繝医↓險ｭ螳壹＆繧後∪縺吶 縺輔ｉ縺ｪ繧句茜萓ｿ諤ｧ縺ｮ縺溘ａ縺ｫ縲〜superConstructor` 縺ｯ `constructor.super_` 繝励Ο繝代ユ繧｣繧帝壹§縺ｦ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪ｋ繧医≧縺ｫ縺ｪ繧翫∪縺吶 diff --git a/doc/api/vm.markdown b/doc/api/vm.markdown index 6a1ea843dc57..8db35e084efd 100644 --- a/doc/api/vm.markdown +++ b/doc/api/vm.markdown @@ -1,14 +1,18 @@ ## Executing JavaScript 谺｡縺ｮ繧医≧縺ｫ縺吶ｋ縺薙→縺ｧ縲√％縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺薙→縺後〒縺阪∪縺: var vm = require('vm'); JavaScript 繧ｳ繝ｼ繝峨ｯ縲√さ繝ｳ繝代う繝ｫ縺輔ｌ縺ｦ縺吶＄縺ｫ螳溯｡後＆繧後ｋ縺九√さ繝ｳ繝代う繝ｫ縺翫ｈ縺ｳ菫晏ｭ倥＆繧後※蠕後°繧牙ｮ溯｡後＆繧後∪縺吶 @@ -16,15 +20,19 @@ JavaScript 繧ｳ繝ｼ繝峨ｯ縲√さ繝ｳ繝代う繝ｫ縺輔ｌ縺ｦ縺吶＄縺ｫ螳溯｡後＆繧後ｋ縺九 ### vm.runInThisContext(code, [filename]) `vm.runInThisContext()` 縺ｯ `code` 繧 `filename` 縺九ｉ繝ｭ繝ｼ繝峨＆繧後◆縺九ｮ繧医≧縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励 縺昴ｌ繧貞ｮ溯｡後＠縺ｦ邨先棡繧定ｿ斐＠縺ｾ縺吶ょｮ溯｡後＆繧後ｋ繧ｳ繝ｼ繝峨ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺励∪縺帙ｓ縲 `filename` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 `vm.runInThisContext` 縺ｨ `eval` 縺ｧ蜷後§繧ｳ繝ｼ繝峨ｒ螳溯｡後☆繧倶ｾ: @@ -44,15 +52,19 @@ Example of using `vm.runInThisContext` and `eval` to run the same code: // localVar: 1, evaled: 1 `vm.runInThisContext` 縺ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺励↑縺縺ｮ縺ｧ縲〜localVar` 縺ｯ螟画峩縺輔ｌ縺ｾ縺帙ｓ縲 `eval` 縺ｯ繝ｭ繝ｼ繧ｫ繝ｫ繧ｹ繧ｳ繝ｼ繝励↓繧｢繧ｯ繧ｻ繧ｹ縺吶ｋ縺ｮ縺ｧ縲〜localVar` 縺ｯ螟画峩縺輔ｌ縺ｾ縺吶 `code` 縺梧枚豕輔お繝ｩ繝ｼ縺ｨ縺ｪ繧九こ繝ｼ繧ｹ縺ｧ縺ｯ縲〜vm.runInThisContext` 縺ｯ讓呎ｺ悶お繝ｩ繝ｼ縺ｫ譁豕輔お繝ｩ繝ｼ繧貞ｺ蜉帙＠縲 萓句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 @@ -61,10 +73,12 @@ and throws.an exception. ### vm.runInNewContext(code, [sandbox], [filename]) `vm.runInNewContext` 縺ｯ `code` 繧 `filename` 縺九ｉ繝ｭ繝ｼ繝峨＆繧後◆縺九ｮ繧医≧縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励 縺昴ｌ繧 `sandbox` 縺ｮ荳ｭ縺ｧ螳溯｡後＠縺ｦ邨先棡繧定ｿ斐＠縺ｾ縺吶 @@ -73,8 +87,10 @@ the object `sandbox` will be used as the global object for `code`. `sandbox` 縺翫ｈ縺ｳ `filename` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 萓: 繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚繧偵う繝ｳ繧ｯ繝ｪ繝｡繝ｳ繝医＠縺ｦ譁ｰ縺励＞蛟､繧偵そ繝繝医☆繧九さ繝ｼ繝峨ｒ繧ｳ繝ｳ繝代う繝ｫ縺翫ｈ縺ｳ螳溯｡後＠縺ｾ縺吶 縺薙ｌ繧峨ｮ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺ｯ繧ｵ繝ｳ繝峨懊ャ繧ｯ繧ｹ縺ｫ蜷ｫ縺ｾ繧後∪縺吶 @@ -92,17 +108,21 @@ These globals are contained in the sandbox. // { animal: 'cat', count: 3, name: 'kitty' } 諷朱阪ｒ隕√☆繧九ン繧ｸ繝阪せ縺ｧ縺ｯ縲∽ｿ｡鬆ｼ縺ｧ縺阪↑縺繧ｳ繝ｼ繝峨ｮ螳溯｡後ｯ邏ｰ蠢縺ｮ豕ｨ諢上′豎ゅａ繧峨ｌ繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 蛛ｶ辟ｶ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺梧ｼ上ｌ縺ｦ縺励∪縺縺薙→繧帝亟縺舌◆繧√↓縲〜vm.runInNewContext` 縺ｯ縺ｨ縺ｦ繧ょｽｹ遶九■縺ｾ縺吶′縲 菫｡鬆ｼ縺ｧ縺阪↑縺繧ｳ繝ｼ繝峨ｒ螳牙ｨ縺ｫ螳溯｡後☆繧九◆繧√↓蛻･縺ｮ繝励Ο繧ｻ繧ｹ繧定ｦ∵ｱゅ＠縺ｾ縺吶 `code` 縺梧枚豕輔お繝ｩ繝ｼ縺ｨ縺ｪ繧九こ繝ｼ繧ｹ縺ｧ縺ｯ縲 `vm.runInThisContext` 縺ｯ讓呎ｺ悶お繝ｩ繝ｼ縺ｫ譁豕輔お繝ｩ繝ｼ繧貞ｺ蜉帙＠縲∽ｾ句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 @@ -111,11 +131,13 @@ and throws an exception. ### vm.createScript(code, [filename]) `createScript` 縺ｯ `code` 繧 `filename` 縺九ｉ繝ｭ繝ｼ繝峨＆繧後◆縺九ｮ繧医≧縺ｫ繧ｳ繝ｳ繝代う繝ｫ縺励∪縺吶′縲∝ｮ溯｡後ｯ縺励∪縺帙ｓ縲 @@ -126,8 +148,10 @@ It is bound before each run, just for that run. `filename` is optional. `filename` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 `code` 縺梧枚豕輔お繝ｩ繝ｼ縺ｨ縺ｪ繧九こ繝ｼ繧ｹ縺ｧ縺ｯ縲 `createScript` 縺ｯ讓呎ｺ悶お繝ｩ繝ｼ縺ｫ譁豕輔お繝ｩ繝ｼ繧貞ｺ蜉帙＠縺ｦ萓句､悶ｒ繧ｹ繝ｭ繝ｼ縺励∪縺吶 @@ -136,10 +160,12 @@ and throws an exception. ### script.runInThisContext() `vm.runInThisContext` 縺ｨ蜷梧ｧ倥〒縺吶′縲 縺薙■繧峨ｯ繝励Μ繧ｳ繝ｳ繝代う繝ｫ貂医∩縺ｮ `Script` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繝｡繧ｽ繝繝峨〒縺吶 @@ -148,7 +174,9 @@ Running code does not have access to local scope, but does have access to the `g `global` 繧ｪ繝悶ず繧ｧ繧ｯ繝 (v8: 螳滄圀縺ｮ繧ｳ繝ｳ繝繧ｭ繧ｹ繝) 縺ｫ縺ｯ繧｢繧ｯ繧ｻ繧ｹ縺励∪縺吶 `script.runInThisContext` 繧剃ｽｿ縺｣縺ｦ繧ｳ繝ｼ繝峨ｒ荳蠎ｦ縺縺代さ繝ｳ繝代う繝ｫ縺励∬､謨ｰ蝗槫ｮ溯｡後☆繧倶ｾ: @@ -170,9 +198,11 @@ Example of using `script.runInThisContext` to compile code once and run it multi ### script.runInNewContext([sandbox]) `vm.runInNewContext` 縺ｨ蜷梧ｧ倥〒縺吶′縲 縺薙■繧峨ｯ繝励Μ繧ｳ繝ｳ繝代う繝ｫ貂医∩縺ｮ `Script` 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ繝｡繧ｽ繝繝峨〒縺吶 @@ -182,8 +212,10 @@ Running code does not have access to local scope. `sandbox` is optional. `sandbox` 縺ｯ繧ｪ繝励す繝ｧ繝ｳ縺ｧ縺吶 萓: 繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚繧偵う繝ｳ繧ｯ繝ｪ繝｡繝ｳ繝医＠縺ｦ繧ｻ繝繝医☆繧九さ繝ｼ繝峨ｒ繧ｳ繝ｳ繝代う繝ｫ縺励※縲√％縺ｮ繧ｳ繝ｼ繝峨ｒ隍謨ｰ蝗槫ｮ溯｡後＠縺ｾ縺吶 縺薙ｌ繧峨ｮ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺ｯ繧ｵ繝ｳ繝峨懊ャ繧ｯ繧ｹ縺ｫ蜷ｫ縺ｾ繧後∪縺吶 @@ -206,9 +238,11 @@ These globals are contained in the sandbox. // { animal: 'cat', count: 12, name: 'kitty' } 諷朱阪ｒ隕√☆繧九ン繧ｸ繝阪せ縺ｧ縺ｯ縲∽ｿ｡鬆ｼ縺ｧ縺阪↑縺繧ｳ繝ｼ繝峨ｮ螳溯｡後ｯ邏ｰ蠢縺ｮ豕ｨ諢上′豎ゅａ繧峨ｌ繧九％縺ｨ縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 蛛ｶ辟ｶ繧ｰ繝ｭ繝ｼ繝舌Ν螟画焚縺梧ｼ上ｌ縺ｦ縺励∪縺縺薙→繧帝亟縺舌◆繧√↓縲〜script.runInNewContext` 縺ｯ縺ｨ縺ｦ繧ょｽｹ遶九■縺ｾ縺吶′縲 From ec4a8fe49696f45358cd8540d16082d0da127abb Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 4 Jan 2011 16:06:34 +0900 Subject: [PATCH 31/40] =?UTF-8?q?os.markdown=20=E3=81=AB=E8=BF=BD=E5=8A=A0?= =?UTF-8?q?=E3=81=95=E3=82=8C=E3=81=9F=E9=83=A8=E5=88=86=E3=81=AE=E3=82=B3?= =?UTF-8?q?=E3=83=B3=E3=83=95=E3=83=AA=E3=82=AF=E3=83=88=E8=A7=A3=E6=B6=88?= =?UTF-8?q?=20&=20=E7=BF=BB=E8=A8=B3=E6=BC=8F=E3=82=8C=E3=82=92=E5=AF=BE?= =?UTF-8?q?=E5=BF=9C=EF=BC=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/api/os.markdown | 46 ++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 43 insertions(+), 3 deletions(-) diff --git a/doc/api/os.markdown b/doc/api/os.markdown index 616b9579df7f..b74ee5346400 100644 --- a/doc/api/os.markdown +++ b/doc/api/os.markdown @@ -13,40 +13,81 @@ Use `require('os')` to access this module. Returns the hostname of the operating system. -<<<<<<< HEAD --> 繧ｪ繝壹Ξ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺ｮ繝帙せ繝亥錐繧定ｿ斐＠縺ｾ縺吶 -======= + ### os.type() + +繧ｪ繝壹Ξ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺ｮ蜷榊燕繧定ｿ斐＠縺ｾ縺吶 + ### os.release() + + +繧ｷ繧ｹ繝繝縺瑚ｵｷ蜍輔＠縺ｦ縺九ｉ縺ｮ遘呈焚繧定ｿ斐＠縺ｾ縺吶 + ### os.loadavg() + +1 蛻縲5 蛻縲15 蛻髢薙ｮ繝ｭ繝ｼ繝峨い繝吶Ξ繝ｼ繧ｸ繧貞性繧薙□驟榊励ｒ霑斐＠縺ｾ縺吶 + ### os.totalmem() + +繧ｷ繧ｹ繝繝蜈ｨ菴薙′菴ｿ逕ｨ縺励※縺繧九Γ繝｢繝ｪ縺ｮ繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 + ### os.freemem() + +繧ｷ繧ｹ繝繝蜈ｨ菴薙〒遨ｺ縺縺ｦ縺繧九Γ繝｢繝ｪ縺ｮ繝舌う繝域焚繧定ｿ斐＠縺ｾ縺吶 + ### os.cpus() + +繧､繝ｳ繧ｹ繝医ｼ繝ｫ縺輔ｌ縺ｦ縺繧 CPU/ 繧ｳ繧｢縺斐→縺ｮ諠蝣ｱ繧貞性繧薙□繧ｪ繝悶ず繧ｧ繧ｯ繝医ｮ驟榊励ｒ霑斐＠縺ｾ縺吶 +諠蝣ｱ縺ｯ繝｢繝繝ｫ縲√せ繝斐ｼ繝 (MHz)縲√◎縺励※譎る俣 (CPU 縺御ｽｿ逕ｨ縺励◆ user, nice, sys, idle, irq 譎る俣繧貞性繧薙□繧ｪ繝悶ず繧ｧ繧ｯ繝) 縺ｧ縺吶 + + +os.cpus 縺ｮ萓: + [ { model: 'Intel(R) Core(TM) i7 CPU 860 @ 2.80GHz', speed: 2926, times: @@ -111,4 +152,3 @@ Example inspection of os.cpus: sys: 34920, idle: 1072572010, irq: 30 } } ] ->>>>>>> master From 7b7ac117602a34e36ebc0a57dd4b08efc969db96 Mon Sep 17 00:00:00 2001 From: koichik Date: Tue, 4 Jan 2011 22:08:22 +0900 Subject: [PATCH 32/40] =?UTF-8?q?=E7=BF=BB=E8=A8=B3=E6=BC=8F=E3=82=8C?= =?UTF-8?q?=EF=BC=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/api/appendix_1.markdown | 2 +- doc/api/repl.markdown | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/api/appendix_1.markdown b/doc/api/appendix_1.markdown index e9eec179651b..392786add327 100644 --- a/doc/api/appendix_1.markdown +++ b/doc/api/appendix_1.markdown @@ -9,7 +9,7 @@ There are many third party modules for Node. At the time of writing, August --> Node 蜷代¢縺ｫ繧ｵ繝ｼ繝峨ヱ繝ｼ繝繧｣陬ｽ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺梧焚螟壹￥縺ゅｊ縺ｾ縺吶 蝓ｷ遲譎らせ (2010 蟷ｴ 8 譛) 縺ｧ縺ｯ縲√Δ繧ｸ繝･繝ｼ繝ｫ縺ｮ繝槭せ繧ｿ繝ｪ繝昴ず繝医Μ縺ｯ -http://github.com/ry/node/wiki/modules[wiki 繝壹ｼ繧ｸ] 縺ｧ縺吶 +[wiki 繝壹ｼ繧ｸ](http://github.com/ry/node/wiki/modules) 縺ｧ縺吶 `prompt` 縺ｧ繝励Ο繝ｳ繝励ヨ險伜捷繧偵 `stream` 縺ｧ I/O 繧貞ｼ墓焚縺ｫ蜿悶▲縺ｦ REPL 繧定ｵｷ蜍輔＠縺ｾ縺吶 `prompt` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `> ` 縺ｧ縺吶 -`stream` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `process.openStdin()`縺ｧ縺吶 +`stream` 縺ｯ逵∫払蜿ｯ閭ｽ縺ｧ縲 繝繝輔か繝ｫ繝医ｯ `process.stdin` 縺ｧ縺吶 +V8縺ｯ螟夜Κ繝励Ο繧ｻ繧ｹ縺九ｉ [TCP 繝励Ο繝医さ繝ｫ](http://code.google.com/p/v8/wiki/DebuggerProtocol)邨檎罰縺ｧ謗･邯壼庄閭ｽ縺ｪ繝繝舌ャ繧ｬ繧貞ｙ縺医※縺縺ｾ縺吶 +Node 縺ｫ縺ｯ縺薙ｮ繝繝舌ャ繧ｬ縺ｸ縺ｮ繧ｯ繝ｩ繧､繧｢繝ｳ繝医′邨縺ｿ霎ｼ縺ｾ繧後※縺縺ｾ縺吶 +縺薙ｌ繧剃ｽｿ縺縺ｫ縺ｯ縲 `debug` 蠑墓焚繧呈欠螳壹＠縺ｦ Node 繧定ｵｷ蜍輔＠縺ｾ縺吶 +谺｡縺ｮ繧医≧縺ｫ縺ｪ繧翫∪縺: % node debug myscript.js debug> + +繝昴う繝ｳ繝医ｯｼ形myscript.js` 縺ｯ縺ｾ縺螳溯｡後＆繧後↑縺縺薙→縺ｧ縺吶 +繧ｹ繧ｯ繝ｪ繝励ヨ繧帝幕蟋九☆繧九↓縺ｯ縲〜run` 繧ｳ繝槭Φ繝峨ｒ蜈･蜉帙＠縺ｾ縺吶 +蜈ｨ縺ｦ縺後≧縺ｾ縺上＞縺代ｰ縲∝ｺ蜉帙ｯ縺薙ｮ繧医≧縺ｫ縺ｪ繧翫∪縺: % node debug myscript.js debug> run debugger listening on port 5858 connecting...ok + +Node 縺ｮ繝繝舌ャ繧ｬ繧ｯ繝ｩ繧､繧｢繝ｳ繝医ｯ縺ゅｉ繧繧九さ繝槭Φ繝峨ｒ螳悟ｨ縺ｫ繧ｵ繝昴ｼ繝医＠縺ｦ縺繧九ｏ縺代〒縺ｯ縺ゅｊ縺ｾ縺帙ｓ縺後 +蜊倡ｴ斐↑繧ｹ繝繝繝怜ｮ溯｡後ｄ繧､繝ｳ繧ｹ繝壹け繧ｷ繝ｧ繝ｳ縺悟庄閭ｽ縺ｧ縺吶 +繧ｹ繧ｯ繝ｪ繝励ヨ縺ｮ繧ｽ繝ｼ繧ｹ繧ｳ繝ｼ繝峨↓ `debugger;` 譁繧呈諺蜈･縺吶ｋ縺ｨ縲 +繝悶Ξ繝ｼ繧ｯ繝昴う繝ｳ繝医′譛牙柑縺ｫ縺ｪ繧翫∪縺吶 + +萓九∴縺ｰ縲〜myscript.js` 縺梧ｬ｡縺ｮ繧医≧縺縺ｨ縺励∪縺: // myscript.js x = 5; @@ -31,7 +51,10 @@ For example, suppose `myscript.js` looked like this: }, 1000); console.log("hello"); + +縺ｲ縺ｨ縺溘ｳ繝繝舌ャ繧ｬ繧貞ｮ溯｡後☆繧九→縲4陦檎岼縺ｧ荳ｭ譁ｭ縺励∪縺吶 % ./node debug myscript.js debug> run @@ -59,15 +82,23 @@ Then once the debugger is run, it will break on line 4. % + +``print`` 繧ｳ繝槭Φ繝峨ｯ螟画焚繧定ｩ穂ｾ｡縺励∪縺吶 +``next`` 繧ｳ繝槭Φ繝峨ｯ谺｡縺ｮ陦後↓繧ｹ繝繝繝励が繝ｼ繝舌ｼ縺励∪縺吶 +莉悶↓繧ゅ＞縺上▽縺九ｮ繧ｳ繝槭Φ繝峨ｒ蛻ｩ逕ｨ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 +縺昴ｌ繧峨↓縺､縺縺ｦ縺ｯ ``help`` 繧偵ち繧､繝励＠縺ｦ縺上□縺輔＞縲 ### Advanced Usage + +V8 繝繝舌ャ繧ｬ縺ｯ Node 繧偵さ繝槭Φ繝峨Λ繧､繝ｳ縺ｮ `--debug` 繝輔Λ繧ｰ縺ｧ襍ｷ蜍輔＠縺溘ｊ縲∬ｵｷ蜍墓ｸ医∩縺ｮ Node 繝励Ο繧ｻ繧ｹ縺ｫ `SIGUSR1` 繧ｷ繧ｰ繝翫Ν繧帝√ｋ縺薙→縺ｧ繧よ怏蜉ｹ縺ｫ縺ｧ縺阪∪縺吶 diff --git a/doc/api/net.markdown b/doc/api/net.markdown index 380906dceeb0..04a597b1c754 100644 --- a/doc/api/net.markdown +++ b/doc/api/net.markdown @@ -31,8 +31,8 @@ Construct a new socket object and opens a socket to the given location. When the socket is established the `'connect'` event will be emitted. --> -譁ｰ縺励＞繧ｹ繝医Μ繝ｼ繝繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ讒狗ｯ峨＠縲∽ｸ弱∴繧峨ｌ縺溘Ο繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺ｸ縺ｮ繧ｹ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励∪縺吶 -繧ｹ繝医Μ繝ｼ繝縺檎｢ｺ遶九＆繧後ｋ縺ｨ縲〜'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 +譁ｰ縺励＞繧ｽ繧ｱ繝繝医が繝悶ず繧ｧ繧ｯ繝医ｒ讒狗ｯ峨＠縲∽ｸ弱∴繧峨ｌ縺溘Ο繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺ｸ縺ｮ繧ｽ繧ｱ繝繝医ｒ繧ｪ繝ｼ繝励Φ縺励∪縺吶 +繧ｽ繧ｱ繝繝医′遒ｺ遶九＆繧後ｋ縺ｨ縲〜'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 譁ｰ縺励＞繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺御ｽ懈舌＆繧後ｋ縺ｨ逕滓舌＆繧後∪縺吶 -`stream` 縺ｯ `net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 +`socket` 縺ｯ `net.Socket` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｧ縺吶 #### Event: 'close' @@ -316,7 +316,7 @@ Node 縺ｫ繧医▲縺ｦ菴懈舌＆繧後※繧ｵ繝ｼ繝舌ｮ `'connection'` 繧､繝吶Φ繝医ｒ騾 `net.Socket` instances are EventEmitters with the following events: --> -`net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ EventEmitter 縺ｧ縺: +`net.Socket` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ莉･荳九ｮ繧､繝吶Φ繝医ｒ謖√▽ EventEmitter 縺ｧ縺: #### socket.connect(port, [host], [callback]) #### socket.connect(path, [callback]) @@ -329,12 +329,12 @@ then the socket will be opened as a TCP socket, if `host` is omitted, opened as a unix socket to that path. --> -荳弱∴繧峨ｌ縺溘せ繝医Μ繝ｼ繝縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧偵が繝ｼ繝励Φ縺励∪縺吶 +荳弱∴繧峨ｌ縺溘た繧ｱ繝繝医〒繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧偵が繝ｼ繝励Φ縺励∪縺吶 `port` 縺ｨ `host` 縺御ｸ弱∴繧峨ｌ縺溷ｴ蜷医 -繧ｹ繝医Μ繝ｼ繝縺ｯ TCP 繧ｹ繝医Μ繝ｼ繝縺ｨ縺励※繧ｪ繝ｼ繝励Φ縺輔ｌ縺ｾ縺吶 +繧ｽ繧ｱ繝繝医ｯ TCP 繧ｽ繧ｱ繝繝医→縺励※繧ｪ繝ｼ繝励Φ縺輔ｌ縺ｾ縺吶 `host` 縺檎怐逡･縺輔ｌ縺溷ｴ蜷医ｯ `localhost` 縺御ｻｮ螳壹＆繧後∪縺吶 `path` 縺御ｸ弱∴繧峨ｌ縺溷ｴ蜷医ｯ縲 -繧ｹ繝医Μ繝ｼ繝縺ｯ縺昴ｮ繝代せ縺ｸ縺ｮ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医→縺励※繧ｪ繝ｼ繝励Φ縺輔ｌ縺ｾ縺吶 +繧ｽ繧ｱ繝繝医ｯ縺昴ｮ繝代せ縺ｸ縺ｮ UNIX 繝峨Γ繧､繝ｳ繧ｽ繧ｱ繝繝医→縺励※繧ｪ繝ｼ繝励Φ縺輔ｌ縺ｾ縺吶 -騾壼ｸｸ縺薙ｮ繝｡繧ｽ繝繝峨ｯ蠢隕√↑縺上〜net.createConnection` 縺ｧ繧ｹ繝医Μ繝ｼ繝繧偵が繝ｼ繝励Φ縺励∪縺吶 -縺薙ｌ繧剃ｽｿ縺縺ｮ縺ｯ縲√き繧ｹ繧ｿ繝槭う繧ｺ縺輔ｌ縺溘せ繝医Μ繝ｼ繝繧貞ｮ溯｣縺励※縺繧句ｴ蜷医ｄ縲 -繧ｹ繝医Μ繝ｼ繝縺後け繝ｭ繝ｼ繧ｺ縺輔ｌ縺溷ｾ後↓繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞榊茜逕ｨ縺励※蛻･縺ｮ繧ｵ繝ｼ繝舌↓謗･邯壹☆繧句ｴ蜷医□縺代〒縺吶 +騾壼ｸｸ縺薙ｮ繝｡繧ｽ繝繝峨ｯ蠢隕√↑縺上〜net.createConnection` 縺ｧ繧ｽ繧ｱ繝繝医ｒ繧ｪ繝ｼ繝励Φ縺励∪縺吶 +縺薙ｌ繧剃ｽｿ縺縺ｮ縺ｯ縲√き繧ｹ繧ｿ繝槭う繧ｺ縺輔ｌ縺溘た繧ｱ繝繝医ｒ螳溯｣縺励※縺繧句ｴ蜷医ｄ縲 +繧ｽ繧ｱ繝繝医′繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺溷ｾ後↓繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧貞榊茜逕ｨ縺励※蛻･縺ｮ繧ｵ繝ｼ繝舌↓謗･邯壹☆繧句ｴ蜷医□縺代〒縺吶 -縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶ゅせ繝医Μ繝ｼ繝縺檎｢ｺ遶九＆繧後ｋ縺ｨ `'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 +縺薙ｮ髢｢謨ｰ縺ｯ髱槫酔譛溘〒縺吶ゅた繧ｱ繝繝医′遒ｺ遶九＆繧後ｋ縺ｨ `'connect'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 謗･邯壹〒蝠城｡後′縺ゅ▲縺溷ｴ蜷医ｯ `'connect'` 繧､繝吶Φ繝医ｯ逕滓舌＆繧後★縲 萓句､悶→縺ｨ繧ゅ↓ `'error'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 @@ -387,6 +387,9 @@ This function has been removed in v0.3. It used to upgrade the connection to SSL/TLS. See the TLS for the new API. --> +縺薙ｮ髢｢謨ｰ縺ｯ v0.3 縺ｧ蜑企勁縺輔ｌ縺ｾ縺励◆縲 +縺薙ｌ縺ｯ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧 SSL/TLS 縺ｫ繧｢繝繝励げ繝ｬ繝ｼ繝峨☆繧九◆繧√↓菴ｿ繧上ｌ縺ｦ縺縺ｾ縺励◆縲 +譁ｰ縺励＞ API 縺ｧ縺ゅｋ TLS 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 #### socket.write(data, [encoding], [callback]) @@ -395,7 +398,8 @@ SSL/TLS. See the TLS for the new API. Sends data on the socket. The second parameter specifies the encoding in the case of a string--it defaults to UTF8 encoding. --->繧ｹ繝医Μ繝ｼ繝縺ｫ繝繝ｼ繧ｿ繧帝∽ｿ｡縺励∪縺吶 +--> +繧ｽ繧ｱ繝繝医↓繝繝ｼ繧ｿ繧帝∽ｿ｡縺励∪縺吶 譁蟄怜励ｮ蝣ｴ蜷医∫ｬｬ 2 蠑墓焚縺ｯ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ繧呈欠螳壹＠縺ｾ縺 ｼ 繝繝輔か繝ｫ繝医ｯ UTF-8 縺ｧ縺吶 -UNIX 繧ｽ繧ｱ繝繝医ｮ蝣ｴ蜷医√ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺吶ｋ縺薙→縺後〒縺阪∪縺吶 +UNIX 繧ｽ繧ｱ繝繝医ｮ蝣ｴ蜷医√ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｽ繧ｱ繝繝医↓騾∽ｿ｡縺吶ｋ縺薙→縺後〒縺阪∪縺吶 蜊倡ｴ斐↓ `fileDescriptor` 蠑墓焚繧貞刈縺医ｋ縺薙→縺ｧ縲∫嶌謇句ｴ縺ｫ縺ｯ `'fd'` 繧､繝吶Φ繝医′逕滓舌＆繧後∪縺吶 @@ -439,7 +443,7 @@ Half-closes the socket. I.E., it sends a FIN packet. It is possible the server will still send some data. --> -繧ｹ繝医Μ繝ｼ繝繧偵ワ繝ｼ繝輔け繝ｭ繝ｼ繧ｺ縺励∪縺吶ゆｾ九∴縺ｰ FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励∪縺吶 +繧ｽ繧ｱ繝繝医ｒ繝上ｼ繝輔け繝ｭ繝ｼ繧ｺ縺励∪縺吶ゆｾ九∴縺ｰ FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励∪縺吶 繧ｵ繝ｼ繝舌ｯ縺ｾ縺繝繝ｼ繧ｿ繧帝√ｊ邯壹¢縺ｦ縺上ｋ縺薙→縺後〒縺阪∪縺吶 `data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医ｯ縲 -`stream.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `stream.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 +`socket.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `socket.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 #### socket.destroy() @@ -459,7 +463,7 @@ Ensures that no more I/O activity happens on this socket. Only necessary in case of errors (parse error or so). --> -縺薙ｮ繧ｹ繝医Μ繝ｼ繝荳翫〒縺ｩ繧薙↑ I/O 繧りｵｷ縺薙ｉ縺ｪ縺縺薙→繧剃ｿ晁ｨｼ縺励∪縺吶 +縺薙ｮ繧ｽ繧ｱ繝繝井ｸ翫〒縺ｩ繧薙↑ I/O 繧りｵｷ縺薙ｉ縺ｪ縺縺薙→繧剃ｿ晁ｨｼ縺励∪縺吶 (繝代ｼ繧ｹ繧ｨ繝ｩ繝ｼ縺ｪ縺ｩ縺ｮ) 繧ｨ繝ｩ繝ｼ縺ｮ蝣ｴ蜷医↓縺縺大ｿ隕√〒縺吶 #### socket.pause() @@ -498,7 +502,7 @@ event but the connection will not be severed. The user must manually `end()` or `destroy()` the socket. --> -繧｢繧､繝峨Ν繧ｿ繧､繝繧｢繧ｦ繝医′蠑輔″襍ｷ縺薙＆繧後ｋ縺ｨ縲√せ繝医Μ繝ｼ繝縺ｯ `'timeout'` 繧､繝吶Φ繝医ｒ蜿嶺ｿ｡縺励∪縺吶′縲 +繧｢繧､繝峨Ν繧ｿ繧､繝繧｢繧ｦ繝医′蠑輔″襍ｷ縺薙＆繧後ｋ縺ｨ縲√た繧ｱ繝繝医ｯ `'timeout'` 繧､繝吶Φ繝医ｒ蜿嶺ｿ｡縺励∪縺吶′縲 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ蛻譁ｭ縺輔ｌ縺ｾ縺帙ｓ縲 繝ｦ繝ｼ繧ｶ縺ｯ謇句虚縺ｧ `end()` 縺ｾ縺溘ｯ `destroy()` 繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺吶 @@ -520,7 +524,7 @@ immediately fire off data each time `socket.write()` is called. --> Nagle 繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝繧堤┌蜉ｹ縺ｫ縺励∪縺吶 繝繝輔か繝ｫ繝医〒縺ｯ TCP 繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｯ Nagle 繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝繧剃ｽｿ逕ｨ縺励√ョ繝ｼ繧ｿ繧帝∽ｿ｡縺吶ｋ蜑阪↓繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺励∪縺吶 -`noDelay` 縺ｫ險ｭ螳壹☆繧九→縲√ョ繝ｼ繧ｿ縺ｯ `stream.write()` 繧貞他縺ｳ蜃ｺ縺吝ｺｦ縺ｫ蜊ｳ蠎ｧ縺ｫ騾∽ｿ｡縺輔ｌ縺ｾ縺吶 +`noDelay` 縺ｫ險ｭ螳壹☆繧九→縲√ョ繝ｼ繧ｿ縺ｯ `socket.write()` 繧貞他縺ｳ蜃ｺ縺吝ｺｦ縺ｫ蜊ｳ蠎ｧ縺ｫ騾∽ｿ｡縺輔ｌ縺ｾ縺吶 #### socket.setKeepAlive(enable=false, [initialDelay]) @@ -535,7 +539,7 @@ initialDelay will leave the value unchanged from the default --> 繧ｭ繝ｼ繝励い繝ｩ繧､繝匁ｩ溯ｽ繧呈怏蜉ｹ/辟｡蜉ｹ縺ｫ縺励∪縺吶 -繧ｪ繝励す繝ｧ繝ｳ縺ｧ譛蛻昴ｮ keepalive probe 縺後い繧､繝峨Ν繧ｹ繝医Μ繝ｼ繝縺ｫ騾∽ｿ｡縺輔ｌ繧九∪縺ｧ縺ｮ蛻晄悄驕蟒ｶ繧定ｨｭ螳壹＠縺ｾ縺吶 +繧ｪ繝励す繝ｧ繝ｳ縺ｧ譛蛻昴ｮ keepalive probe 縺後い繧､繝峨Ν繧ｽ繧ｱ繝繝医↓騾∽ｿ｡縺輔ｌ繧九∪縺ｧ縺ｮ蛻晄悄驕蟒ｶ繧定ｨｭ螳壹＠縺ｾ縺吶 `initialDelay` (繝溘Μ遘) 縺瑚ｨｭ螳壹＆繧後ｋ縺ｨ縲 譛蠕後↓繝繝ｼ繧ｿ繝代こ繝繝医ｒ蜿嶺ｿ｡縺励※縺九ｉ譛蛻昴ｮ keepalive probe 縺ｾ縺ｧ縺ｮ驕蟒ｶ縺瑚ｨｭ螳壹＆繧後∪縺吶 蛻晄悄驕蟒ｶ縺ｫ 0 縺瑚ｨｭ螳壹＆繧後ｋ縺ｨ縲√ョ繝輔か繝ｫ繝郁ｨｭ螳壹°繧牙､繧貞､画峩縺輔ｌ縺ｪ縺繧医≧縺ｫ縺励∪縺吶 @@ -569,7 +573,7 @@ Emitted when a socket connection successfully is established. See `connect()`. --> -繧ｹ繝医Μ繝ｼ繝繧ｳ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ遒ｺ遶九′謌仙粥縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 +繧ｽ繧ｱ繝繝医さ繝阪け繧ｷ繝ｧ繝ｳ縺ｮ遒ｺ遶九′謌仙粥縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 `connect()` 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 #### Event: 'data' @@ -585,7 +589,7 @@ Emitted when data is received. The argument `data` will be a `Buffer` or --> 繝繝ｼ繧ｿ繧貞女菫｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 `data` 蠑墓焚縺ｯ `Buffer` 縺ｾ縺溘ｯ `String` 縺ｧ縺吶 -繝繝ｼ繧ｿ縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ `stream.setEncoding()` 縺ｧ險ｭ螳壹＆繧後∪縺吶 +繝繝ｼ繧ｿ縺ｮ繧ｨ繝ｳ繧ｳ繝ｼ繝繧｣繝ｳ繧ｰ縺ｯ `socket.setEncoding()` 縺ｧ險ｭ螳壹＆繧後∪縺吶 (繧医ｊ隧ｳ縺励＞諠蝣ｱ縺ｯ `Readable Stream` 繧貞盾辣ｧ縺励※縺上□縺輔＞)縲 #### Event: 'end' @@ -597,7 +601,7 @@ Emitted when data is received. The argument `data` will be a `Buffer` or Emitted when the other end of the socket sends a FIN packet. --> -繧ｹ繝医Μ繝ｼ繝縺ｮ逶ｸ謇句ｴ縺 FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 +繧ｽ繧ｱ繝繝医ｮ逶ｸ謇句ｴ縺 FIN 繝代こ繝繝医ｒ騾∽ｿ｡縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 繝繝輔か繝ｫ繝 (`allowHalfOpen == false`) 縺ｧ縺ｯ縲 -菫晉蕗縺輔ｌ縺ｦ縺縺滓嶌縺崎ｾｼ縺ｿ繧ｭ繝･繝ｼ縺悟ｺ蜉帙＆繧後ｋ縺ｨ繧ｹ繝医Μ繝ｼ繝縺ｯ繝輔ぃ繧､繝ｫ隴伜挨蟄舌ｒ遐ｴ譽縺励∪縺吶 +菫晉蕗縺輔ｌ縺ｦ縺縺滓嶌縺崎ｾｼ縺ｿ繧ｭ繝･繝ｼ縺悟ｺ蜉帙＆繧後ｋ縺ｨ繧ｽ繧ｱ繝繝医ｯ繝輔ぃ繧､繝ｫ隴伜挨蟄舌ｒ遐ｴ譽縺励∪縺吶 縺励°縺励〜allowHalfOpen == true` 縺瑚ｨｭ螳壹＆繧後※縺繧九→縲 -繝ｦ繝ｼ繧ｶ縺後ョ繝ｼ繧ｿ繧呈嶌縺崎ｾｼ繧√ｋ繧医≧縺ｫ縺励※縺翫￥縺溘ａ縺ｫ縲√せ繝医Μ繝ｼ繝縺ｯ閾ｪ蜍慕噪縺ｫ `end()` 繧貞他縺ｳ蜃ｺ縺輔↑縺縺ｮ縺ｧ縲 +繝ｦ繝ｼ繧ｶ縺後ョ繝ｼ繧ｿ繧呈嶌縺崎ｾｼ繧√ｋ繧医≧縺ｫ縺励※縺翫￥縺溘ａ縺ｫ縲√た繧ｱ繝繝医ｯ閾ｪ蜍慕噪縺ｫ `end()` 繧貞他縺ｳ蜃ｺ縺輔↑縺縺ｮ縺ｧ縲 繝ｦ繝ｼ繧ｶ縺 `end()` 繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺吶 @@ -625,8 +629,8 @@ Emitted if the socket times out from inactivity. This is only to notify that the socket has been idle. The user must manually close the connection. --> -繧ｹ繝医Μ繝ｼ繝縺後ち繧､繝繧｢繧ｦ繝医＠縺ｦ髱槭い繧ｯ繝繧｣繝悶↓縺ｪ縺｣縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 -縺薙ｌ縺ｯ繧ｹ繝医Μ繝ｼ繝縺後い繧､繝峨Ν縺ｫ縺ｪ縺｣縺溘％縺ｨ繧帝夂衍縺吶ｋ縺縺代〒縺吶 +繧ｽ繧ｱ繝繝医′繧ｿ繧､繝繧｢繧ｦ繝医＠縺ｦ髱槭い繧ｯ繝繧｣繝悶↓縺ｪ縺｣縺溷ｴ蜷医↓逕滓舌＆繧後∪縺吶 +縺薙ｌ縺ｯ繧ｽ繧ｱ繝繝医′繧｢繧､繝峨Ν縺ｫ縺ｪ縺｣縺溘％縺ｨ繧帝夂衍縺吶ｋ縺縺代〒縺吶 蛻ｩ逕ｨ閠縺ｯ謇句虚縺ｧ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧偵け繝ｭ繝ｼ繧ｺ縺吶ｋ蠢隕√′縺ゅｊ縺ｾ縺吶 See also: `socket.setTimeout()` @@ -665,8 +669,8 @@ Emitted once the socket is fully closed. The argument `had_error` is a boolean which says if the socket was closed due to a transmission error. --> -繧ｹ繝医Μ繝ｼ繝縺悟ｮ悟ｨ縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 -蠑墓焚 `had_error` 縺ｯ boolean 縺ｧ縲√せ繝医Μ繝ｼ繝縺瑚ｻ｢騾√お繝ｩ繝ｼ縺ｧ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺溘ｮ縺九←縺縺九ｒ遉ｺ縺励∪縺吶 +繧ｽ繧ｱ繝繝医′螳悟ｨ縺ｫ繧ｯ繝ｭ繝ｼ繧ｺ縺励◆蝣ｴ蜷医↓逕滓舌＆繧後∪縺吶 +蠑墓焚 `had_error` 縺ｯ boolean 縺ｧ縲√た繧ｱ繝繝医′霆｢騾√お繝ｩ繝ｼ縺ｧ繧ｯ繝ｭ繝ｼ繧ｺ縺輔ｌ縺溘ｮ縺九←縺縺九ｒ遉ｺ縺励∪縺吶 --- diff --git a/doc/api/os.markdown b/doc/api/os.markdown index 7b50d4a816e3..863c820cb43e 100644 --- a/doc/api/os.markdown +++ b/doc/api/os.markdown @@ -36,8 +36,13 @@ Returns the operating system release. ### os.isWindows + +Windows 縺ｧ縺ｯ true縲√◎縺ｮ莉悶〒縺ｯ false 縺ｧ縺吶 + ### os.uptime() 譁蟄怜励↓繧医ｋ繝代せ繧呈ｭ｣隕丞喧縺励∪縺吶Ａ'..'` 縺ｨ `'.'` 縺ｮ隕∫ｴ縺ｫ縺ｯ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 + +隍謨ｰ縺ｮ繧ｹ繝ｩ繝繧ｷ繝･縺瑚ｦ九▽縺九ｋ縺ｨ縲√◎繧後ｉ縺ｯ荳縺､縺ｫ鄂ｮ謠帙＆繧後∪縺; +繝代せ縺ｮ譛蠕後↓繧ｹ繝ｩ繝繧ｷ繝･縺悟性縺ｾ繧後※縺繧九→縲√◎繧後ｯ邯ｭ謖√＆繧後∪縺吶 +Windows 縺ｧ縺ｯ繝舌ャ繧ｯ繧ｹ繝ｩ繝繧ｷ繝･縺御ｽｿ繧上ｌ縺ｾ縺吶 + +`to` 縺ｮ邨ｶ蟇ｾ繝代せ繧定ｧ｣豎ｺ縺励※豁｣隕丞喧縺励∪縺吶 + + +繝代せ繧定ｧ｣豎ｺ縺吶ｋ髫帙ｮ蝓ｺ貅也せ繧呈欠螳壹☆繧九◆繧√↓荳縺､莉･荳翫ｮ `from` 蠑墓焚繧剃ｸ弱∴繧九％縺ｨ縺後〒縺阪∪縺吶 + `resolve()` 縺ｯ邨ｶ蟇ｾ繝代せ縺瑚ｦ九▽縺九ｋ縺ｾ縺ｧ `from` 蠑墓焚繧貞承縺九ｉ蟾ｦ縺ｸ蜈磯ｭ縺ｫ霑ｽ蜉縺励∪縺吶 +`from` 蠑墓焚縺梧欠螳壹＆繧後↑縺九▲縺溷ｴ蜷医ｄ縲∫ｵｶ蟇ｾ繝代せ縺瑚ｦ九▽縺九ｉ縺ｪ縺九▲縺溷ｴ蜷医ｯ縲 +譛邨ら噪縺ｫ迴ｾ蝨ｨ縺ｮ菴懈･ｭ繝繧｣繝ｬ繧ｯ繝医Μ繧貞磯ｭ縺ｫ霑ｽ蜉縺輔ｌ縺ｾ縺吶 + + +隗｣豎ｺ縺励◆邨先棡縺後Ν繝ｼ繝医ョ繧｣繝ｬ繧ｯ繝医Μ縺ｮ蝣ｴ蜷医ｒ髯､縺縺ｦ縲∵忰蟆ｾ縺ｮ繧ｹ繝ｩ繝繧ｷ繝･縺ｯ蜑企勁縺輔ｌ縺ｾ縺吶 + + +萓: + path.resolve('index.html') // returns '/home/tank/index.html' @@ -99,6 +127,7 @@ Return the directory name of a path. Similar to the Unix `dirname` command. Example: --> +萓: path.dirname('/foo/bar/baz/asdf/quux') // returns diff --git a/doc/api/streams.markdown b/doc/api/streams.markdown index 6fc3b868a6fe..bfb6eb6f142a 100644 --- a/doc/api/streams.markdown +++ b/doc/api/streams.markdown @@ -141,8 +141,13 @@ Closes the underlying file descriptor. Stream will not emit any more events. ### stream.destroySoon() + +譖ｸ縺崎ｾｼ縺ｿ繧ｭ繝･繝ｼ縺後°繧峨↓縺ｪ縺｣縺溷ｾ後√ヵ繧｡繧､繝ｫ險倩ｿｰ蟄舌ｒ繧ｯ繝ｭ繝ｼ繧ｺ縺励∪縺吶 + ### stream.pipe(destination, [options]) 縺薙ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医ｯ TCP 縺ｾ縺溘ｯ UNIX 繝峨Γ繧､繝ｳ縺ｮ繧ｽ繧ｱ繝繝医ｒ謚ｽ雎｡蛹悶＠縺溘ｂ縺ｮ縺ｧ縺吶 -`net.Stream` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ蜿梧婿蜷代ｮ繧ｹ繝医Μ繝ｼ繝繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧貞ｮ溯｣縺励∪縺吶 +`net.Socket` 縺ｮ繧､繝ｳ繧ｹ繧ｿ繝ｳ繧ｹ縺ｯ蜿梧婿蜷代ｮ繧ｹ繝医Μ繝ｼ繝繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧貞ｮ溯｣縺励∪縺吶 縺昴ｌ繧峨ｯ繝ｦ繝ｼ繧ｶ縺ｫ繧医▲縺ｦ (`connect()` 縺ｫ繧医▲縺ｦ) 菴懈舌＆繧後※繧ｯ繝ｩ繧､繧｢繝ｳ繝医→縺励※菴ｿ繧上ｌ繧九°縲 Node 縺ｫ繧医▲縺ｦ菴懈舌＆繧後※繧ｵ繝ｼ繝舌ｮ `'connection'` 繧､繝吶Φ繝医ｒ騾壹§縺ｦ繝ｦ繝ｼ繧ｶ縺ｫ貂｡縺輔ｌ縺ｾ縺吶 diff --git a/doc/api/os.markdown b/doc/api/os.markdown index 863c820cb43e..d8aa0a4877f3 100644 --- a/doc/api/os.markdown +++ b/doc/api/os.markdown @@ -31,7 +31,7 @@ Returns the operating system name. Returns the operating system release. --> +--> 繧ｪ繝壹Ξ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺ｮ繝ｪ繝ｪ繝ｼ繧ｹ繧定ｿ斐＠縺ｾ縺吶 ### os.isWindows diff --git a/doc/api/path.markdown b/doc/api/path.markdown index b1243ac1c3d8..a27b23188153 100644 --- a/doc/api/path.markdown +++ b/doc/api/path.markdown @@ -48,7 +48,7 @@ Example: Join all arguments together and normalize the resulting path. --> -蜈ｨ縺ｦ縺ｮ蠑墓焚繧剃ｸ縺､縺ｫ邨仙粋縺励∫ｵ先棡縺ｨ縺励※蠕励ｉ繧後ｋ繝代せ繧呈ｱｺ螳壹＠縺ｾ縺吶 +蜈ｨ縺ｦ縺ｮ蠑墓焚繧剃ｸ縺､縺ｫ邨仙粋縺励∫ｵ先棡縺ｨ縺励※蠕励ｉ繧後ｋ繝代せ繧呈ｭ｣隕丞喧縺励∪縺吶 繧ｽ繧ｱ繝繝医が繝励す繝ｧ繝ｳ縺ｮ `IP_TTL` 繧定ｨｭ螳壹＠縺ｾ縺吶 TTL 縺ｯ縲檎函蟄俶悄髢薙阪ｒ陦ｨ縺励∪縺吶′縲√％縺ｮ繧ｳ繝ｳ繝繧ｭ繧ｹ繝医〒縺ｯ繝代こ繝繝医′騾夐℃繧定ｨｱ蜿ｯ縺輔ｌ繧 IP 縺ｮ繝帙ャ繝玲焚繧呈欠螳壹＠縺ｾ縺吶 -蜷繝ｫ繝ｼ繧ｿ繝ｼ縺ｾ縺溘ｯ繧ｲ繝ｼ繝医え繧ｧ繧､縺ｯ繝代こ繝繝医ｒ騾∝ｺ縺吶ｋ髫 TTL 繧偵ョ繧ｯ繝ｪ繝｡繝ｳ繝医＠縺ｾ縺吶 +蜷繝ｫ繝ｼ繧ｿ縺ｾ縺溘ｯ繧ｲ繝ｼ繝医え繧ｧ繧､縺ｯ繝代こ繝繝医ｒ騾∝ｺ縺吶ｋ髫 TTL 繧偵ョ繧ｯ繝ｪ繝｡繝ｳ繝医＠縺ｾ縺吶 繝ｫ繝ｼ繧ｿ縺ｫ繧医▲縺ｦ TTL 縺後ョ繧ｯ繝ｪ繝｡繝ｳ繝医＆繧後※ 0 縺ｫ縺ｪ繧九→縺昴ｌ縺ｯ騾∝ｺ縺輔ｌ縺ｾ縺帙ｓ縲 TTL 蛟､縺ｮ螟画峩縺ｯ騾壼ｸｸ縲√ロ繝繝医Ρ繝ｼ繧ｯ縺ｮ隱ｿ譟ｻ繧繝槭Ν繝√く繝｣繧ｹ繝医〒菴ｿ繧上ｌ縺ｾ縺吶 @@ -336,6 +336,7 @@ interfaces. --> `IP_ADD_MEMBERSHIP` 繧ｽ繧ｱ繝繝医が繝励す繝ｧ繝ｳ繧定ｨｭ螳壹＠縲√槭Ν繝√く繝｣繧ｹ繝医げ繝ｫ繝ｼ繝励↓蜿ょ刈縺吶ｋ縺薙→繧偵き繝ｼ繝阪Ν縺ｫ莨昴∴縺ｾ縺吶 + `multicastAddress` 縺梧欠螳壹＆繧後↑縺九▲縺溷ｴ蜷医ｯ縲∝ｨ縺ｦ縺ｮ螯･蠖薙↑繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧偵Γ繝ｳ繝舌ｼ繧ｷ繝繝励↓蜉縺医ｈ縺縺ｨ縺励∪縺吶 ### dgram.dropMembership(multicastAddress, [multicastInterface]) @@ -354,4 +355,4 @@ interfaces. `addMembership` 縺ｮ蜿榊ｯｾ縺ｧ縺 - `IP_DROP_MEMBERSHIP` 繧ｽ繧ｱ繝繝医が繝励す繝ｧ繝ｳ縺ｫ繧医▲縺ｦ縲√槭Ν繝√く繝｣繧ｹ繝医げ繝ｫ繝ｼ繝励°繧画栢縺代ｋ縺薙→繧偵き繝ｼ繝阪Ν縺ｫ莨昴∴縺ｾ縺吶 縺薙ｌ縺ｯ繧ｽ繧ｱ繝繝医ｮ繧ｯ繝ｭ繝ｼ繧ｺ譎ゅｄ繝励Ο繧ｻ繧ｹ縺ｮ邨ゆｺ譎ゅ↓繧ｫ繝ｼ繝阪Ν縺ｫ繧医▲縺ｦ閾ｪ蜍慕噪縺ｫ蜻ｼ縺ｳ蜃ｺ縺輔ｌ繧九◆繧√√⊇縺ｨ繧薙←縺ｮ繧｢繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺ｯ縺薙ｌ繧貞他縺ｳ蜃ｺ縺吝ｿ隕√′縺ゅｊ縺ｾ縺帙ｓ縲 -`multicastAddress` 縺梧欠螳壹＆繧後↑縺九▲縺溷ｴ蜷医ｯ縲∝ｨ縺ｦ縺ｮ螯･蠖薙↑繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧偵Γ繝ｳ繝舌ｼ繧ｷ繝繝励°繧牙炎髯､縺励ｈ縺縺ｨ縺励∪縺吶 \ No newline at end of file +`multicastAddress` 縺梧欠螳壹＆繧後↑縺九▲縺溷ｴ蜷医ｯ縲∝ｨ縺ｦ縺ｮ螯･蠖薙↑繧､繝ｳ繧ｿ繝輔ぉ繝ｼ繧ｹ繧偵Γ繝ｳ繝舌ｼ繧ｷ繝繝励°繧牙炎髯､縺励ｈ縺縺ｨ縺励∪縺吶 diff --git a/doc/api/http.markdown b/doc/api/http.markdown index f6538e731de1..f2f06506b7db 100644 --- a/doc/api/http.markdown +++ b/doc/api/http.markdown @@ -1032,16 +1032,18 @@ chunked, this will send the terminating `'0\r\n\r\n'`. If `data` is specified, it is equivalent to calling `request.write(data, encoding)` followed by `request.end()`. -<<<<<<< HEAD --> `data` 縺梧欠螳壹＆繧後◆蝣ｴ蜷医ｯ縲 `request.write(data, encoding)` 縺ｫ邯壹¢縺ｦ `request.end()` 繧貞他縺ｳ蜃ｺ縺吶ｮ縺ｨ遲我ｾ｡縺ｧ縺吶 -======= + ### request.abort() + +繝ｪ繧ｯ繧ｨ繧ｹ繝医ｒ繧｢繝懊ｼ繝医＠縺ｾ縺 (v0.3.80 縺九ｉ縺ｮ譁ｰ讖溯ｽ) ## http.ClientResponse diff --git a/doc/api/net.markdown b/doc/api/net.markdown index fe3ae52ab988..73d544b488a4 100644 --- a/doc/api/net.markdown +++ b/doc/api/net.markdown @@ -391,7 +391,7 @@ Users who experience large or growing `bufferSize` should attempt to --> `net.Socket` 縺ｫ縺ｯ縲〜socket.write()` 縺ｨ蟶ｸ縺ｫ蜊碑ｪｿ縺吶ｋ繝励Ο繝代ユ繧｣縺後≠繧翫∪縺吶 縺薙ｌ縺ｯ繝ｦ繝ｼ繧ｶ縺悟ｮ溯｡碁溷ｺｦ繧貞髄荳翫＆縺帙ｋ謇句勧縺代↓縺ｪ繧翫∪縺吶 -繧ｳ繝ｳ繝斐Η繝ｼ繧ｿ縺ｯ繧ｽ繧ｱ繝繝医↓譖ｸ縺崎ｾｼ縺ｾ繧後ｋ繝繝ｼ繧ｿ驥上→蠢縺壹＠繧ょ酔縺倬溷ｺｦ縺ｧ騾ｲ繧繧上¢縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ ｼ 繝阪ャ繝医Ρ繝ｼ繧ｯ謗･邯壹ｯ縲∝腰邏斐↓驕縺吶℃縺ｾ縺吶 +繧ｳ繝ｳ繝斐Η繝ｼ繧ｿ縺ｯ繧ｽ繧ｱ繝繝医↓譖ｸ縺崎ｾｼ縺ｾ繧後ｋ繝繝ｼ繧ｿ驥上→蠢縺壹＠繧ょ酔縺倬溷ｺｦ縺ｧ騾ｲ繧繧上¢縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ - 繝阪ャ繝医Ρ繝ｼ繧ｯ謗･邯壹ｯ縲∝腰邏斐↓驕縺吶℃縺ｾ縺吶 Node 縺ｯ縲√た繧ｱ繝繝医↓譖ｸ縺崎ｾｼ縺ｾ繧後ｋ繝繝ｼ繧ｿ繧貞驛ｨ縺ｮ繧ｭ繝･繝ｼ縺ｫ蜈･繧後∝庄閭ｽ縺ｫ縺ｪ縺｣縺滓凾縺ｫ繝ｯ繧､繝､荳翫↓騾∽ｿ｡縺励∪縺 (蜀驛ｨ縺ｧ縺ｯ繧ｽ繧ｱ繝繝医ｮ繝輔ぃ繧､繝ｫ險倩ｿｰ蟄舌′譖ｸ縺崎ｾｼ縺ｿ蜿ｯ閭ｽ縺ｫ縺ｪ繧九ｮ繧偵昴ｼ繝ｪ繝ｳ繧ｰ縺励∪縺)縲 蜀驛ｨ逧縺ｪ繝舌ャ繝輔ぃ繝ｪ繝ｳ繧ｰ縺ｮ邨先棡縲√Γ繝｢繝ｪ豸郁ｲｻ縺悟｢怜､ｧ縺吶ｋ縺九ｂ縺励ｌ縺ｾ縺帙ｓ縲 From 1e3c94f70d362aa8da70c43ae2ee98e8546a255e Mon Sep 17 00:00:00 2001 From: koichik Date: Fri, 11 Feb 2011 14:53:56 +0900 Subject: [PATCH 36/40] updated v0.4.0 --- doc/api/crypto.markdown | 1 - doc/v0.4_announcement.html | 86 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 86 insertions(+), 1 deletion(-) diff --git a/doc/api/crypto.markdown b/doc/api/crypto.markdown index 2106f65f3e87..7f081b8b51fa 100644 --- a/doc/api/crypto.markdown +++ b/doc/api/crypto.markdown @@ -283,7 +283,6 @@ This is the mirror of the signing object above. ### verifier.update(data) -<<<<<<< HEAD +

Node縺ｮ2逡ｪ逶ｮ縺ｮ螳牙ｮ夂沿繝ｪ繝ｪ繝ｼ繧ｹ

+ + Wiki + 繝壹ｼ繧ｸ縺ｫ v0.2 縺九ｉ v0.4 縺ｮ髢薙ｮ API 縺ｮ螟画峩縺ｮ隧ｳ邏ｰ縺後≠繧翫∪縺吶

+ + v0.2 縺九ｉ縺ｮ荳ｻ縺ｪ螟画峩:

    + +
  • TLS/SSL 繧ｷ繧ｹ繝繝縺悟､ｧ縺阪￥繧ｪ繝ｼ繝舌ｼ繝帙ｼ繝ｫ縺輔ｌ縺ｾ縺励◆縲 + 蜑阪ｮOpenSSL縺ｸ縺ｮ繝舌う繝ｳ繝繧｣繝ｳ繧ｰ縺ｯ繧ｽ繧ｱ繝繝医ｮ繧ｳ繝ｼ繝峨↓豼縺励￥豺ｷ蜈･縺励※縺縺ｾ縺励◆縲 + 縺薙ｮ繝舌う繝ｳ繝繧｣繝ｳ繧ｰ縺ｯ繧ｳ繝阪け繧ｷ繝ｧ繝ｳ繧偵後せ繝医Μ繝ｼ繝縲阪ｮ繝壹い縺ｨ縺励※謠千､ｺ縺吶ｋ縺溘ａ縺ｫ菴懊ｊ譖ｿ縺医ｉ繧後∪縺励◆: + 蜿梧婿蜷代ｮ證怜捷蛹悶＆繧後◆繧ｹ繝医Μ繝ｼ繝縺ｨ蜿梧婿蜷代ｮ蟷ｳ譁縺ｮ繧ｹ繝医Μ繝ｼ繝縺ｧ縺吶 + 證怜捷蛹悶＆繧後◆繧ｹ繝医Μ繝ｼ繝縺ｯ縲∵ｱ守畑逶ｮ逧縺ｮ Stream.prototype.pipe() + 繝｡繧ｽ繝繝峨↓繧医▲縺ｦ逕溘ｮ TCP 繧ｽ繧ｱ繝繝医↓縺､縺ｪ縺後ｌ縺ｾ縺吶 + 讖溯ｽ縺ｯ諡｡蠑ｵ縺輔ｌ縺ｾ縺励◆縺後、PI縺ｯ蜊倡ｴ泌喧縺輔ｌ縺ｾ縺励◆縲 + +
  • 繧医ｊ菴弱さ繧ｹ繝医↑ Buffer 縺ｮ蜑ｲ繧雁ｽ薙※縲 + Node 縺ｯ螟壹￥縺ｮ蝣ｴ謇縺ｧ Buffer 繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ菴ｿ逕ｨ縺励∪縺 - + 縺昴ｌ縺ｯ蜑ｲ繧雁ｽ薙※縺檎嶌蟇ｾ逧縺ｫ驕縺上√ぎ繝ｼ繝吶ャ繧ｸ繧ｳ繝ｬ繧ｯ繧ｷ繝ｧ繝ｳ縺悟峅髮｣縺ｧ縺吶 + 螳溯｣繧 ObjectWrap 縺ｧ縺ｯ縺ｪ縺冗ｴ皮ｲ九↑ JavaScript + 繧ｪ繝悶ず繧ｧ繧ｯ繝医↓螟画峩縺励◆縺薙→縺ｧ縲√ヱ繝輔か繝ｼ繝槭Φ繧ｹ縺梧隼蝟縺励∪縺励◆縲 + +
  • 螟壹￥縺ｮ繧医＞遏･隕九↓繧医ｊ縲√ヱ繝繧ｱ繝ｼ繧ｸ繝槭ロ繝ｼ繧ｸ繝｣繧偵ｈ繧翫ｈ縺上し繝昴ｼ繝医☆繧九◆繧√↓ + 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繝ｭ繝ｼ繝繧｣繝ｳ繧ｰ繧ｷ繧ｹ繝繝縺悟､画峩縺輔ｌ縺ｾ縺励◆縲 + 迚ｹ縺ｫ NPM 縺ｯ縲∵ｷｱ縺繧ｷ繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ繧 require() + 縺ｫ谺縺代※縺縺滓ｩ溯ｽ縺ｫ蟇ｾ蜃ｦ縺吶ｋ縺溘ａ縺ｫ "shim" 繝｢繧ｸ繝･繝ｼ繝ｫ繧貞ｼｷ蛻ｶ縺輔ｌ縺ｦ縺縺ｾ縺励◆縲 + 荳ｻ縺ｪ螟画峩縺ｯ:
      + +
    1. require() 縺ｯ繝ｪ繧｢繝ｫ繝代せ縺ｧ蜻ｼ縺ｳ蜃ｺ縺励∪縺吶 + 縺昴ｌ縺ｯ繧ｷ繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ繧定ｧ｣豎ｺ縺励∪縺吶 + 縺薙ｌ縺ｯ繧ｷ繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ縺ｫ繧医ｋ繝｢繧ｸ繝･繝ｼ繝ｫ繧堤嶌蟇ｾ逧縺ｫ隕∵ｱゅ☆繧九％縺ｨ繧貞庄閭ｽ縺ｫ縺励∪縺吶 + +
    2. require() 縺ｯ莉翫ｄ譛菴朱剞縺ｮ package.json + 繧堤炊隗｣縺励∪縺吶 + 縺昴ｌ縺ｯ main 繧ｹ繧ｯ繝ｪ繝励ヨ繧定ｪ崎ｭ倥＠縺ｾ縺吶 + 縺薙ｌ縺ｧ require() 縺ｯ繝代ャ繧ｱ繝ｼ繧ｸ縺ｮ繝繧｣繝ｬ繧ｯ繝医Μ繧堤峩謗･謇ｱ縺医ｋ繧医≧縺ｫ縺ｪ繧翫∪縺励◆縲 + +
    3. 迚ｹ蛻･縺ｪ蜷榊燕縺ｮ繝繧｣繝ｬ繧ｯ繝医Μ node_modules/ 縺ｯ縲 + 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ迴ｾ蝨ｨ縺ｮ繝繧｣繝ｬ繧ｯ繝医Μ縺九ｉ謗｢縺輔ｌ縺ｾ縺吶 + 縺薙ｌ縺ｯ繧ｰ繝ｭ繝ｼ繝舌Ν縺ｪ蜷榊燕遨ｺ髢薙↓鬆ｼ繧九ｮ縺ｧ縺ｯ縺ｪ縺上√Δ繧ｸ繝･繝ｼ繝ｫ繧呈據縺ｫ縺吶ｋ縺薙→繧偵励Ο繧ｰ繝ｩ繝槭↓謗ｨ螂ｨ縺励∪縺吶
    + + 縺薙ｮ讖溯ｽ繧偵ｈ繧願ｩｳ縺励￥遏･繧九↓縺ｯ 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繝峨く繝･繝｡繝ｳ繝 + 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 + +
  • 縺ｾ縺譛ｪ螳梧舌〒縺吶′縲｀inGW 繧剃ｽｿ逕ｨ縺励◆繝阪う繝繧｣繝 Windows 繝薙Ν繝峨′ Bert Builder 縺ｫ繧医▲縺ｦ蟋九∪繧翫∪縺励◆縲 + 繝薙Ν繝画焔鬆縺ｯ Wiki + 縺ｫ縺ゅｊ縺ｾ縺吶 + +
  • Node 縺ｯ譛譁ｰ迚医ｮ V8 v3.1.2 縺ｫ繧｢繝繝励げ繝ｬ繝ｼ繝峨＠縺ｾ縺励◆縲 + 縺昴ｌ縺ｫ縺ｯ V8 縺ｮ譁ｰ縺励＞繧ｳ繝ｳ繝代う繝ｩ繝ｻ繧､繝ｳ繝輔Λ繧ｹ繝医Λ繧ｯ繝√Ε繧 Linux 縺ｧ縺ｮ GDB + 繝励Λ繧ｰ繧､繝ｳ縺悟性縺ｾ繧後※縺縺ｾ縺吶 + 螳悟ｨ縺ｪ V8 縺ｮ螟画峩螻･豁ｴ 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 + +
  • V8 繝繝舌ャ繧ｬ縺ｮ邨縺ｿ霎ｼ縺ｿ繧ｯ繝ｩ繧､繧｢繝ｳ繝医′ Node 縺ｫ霑ｽ蜉縺輔ｌ縺ｾ縺励◆縲 + 縺昴ｌ縺ｯ譛菴朱剞縺ｮ繧ゅｮ縺ｧ縺吶′縲√す繝ｳ繝励Ν縺ｪ菴懈･ｭ縺ｫ縺ｯ萓ｿ蛻ｩ縺ｧ縺吶 邏ｹ莉九ン繝繧ｪ + 繧 繝峨く繝･繝｡繝ｳ繝 + 繧貞盾辣ｧ縺励※縺上□縺輔＞縲 + + Brian White 縺ｫ繧医▲縺ｦ os 繝｢繧ｸ繝･繝ｼ繝ｫ縺悟渕譛ｬ逧縺ｪ縺後ｉ譛臥寢縺ｪ繧ｷ繧ｹ繝繝諠蝣ｱ繧呈署萓帙☆繧九ｈ縺縺ｫ縺ｪ繧翫∪縺励◆: + os.cpus(), os.freemem(), os.totalmem(), os.loadavg() + +
  • 縺昴＠縺ｦ繧ゅ■繧阪ｓ縲∝､壹￥縺ｮ繝舌げ縺御ｿｮ豁｣縺輔ｌ縺ｾ縺励◆縲 + 螳悟ｨ縺ｪ + 螟画峩螻･豁ｴ 繧貞盾辣ｧ縺励※縺上□縺輔＞縲
From 5c53d2c7d771c5ead4d6290ab844039d5489666e Mon Sep 17 00:00:00 2001 From: Toshihiro Shimizu Date: Fri, 11 Feb 2011 15:09:04 +0900 Subject: [PATCH 37/40] =?UTF-8?q?modules.markdown=E8=A8=B3=E3=81=97?= =?UTF-8?q?=E3=81=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/api/modules.markdown | 239 +++++++++++++++++++++++++++++++++++++-- 1 file changed, 230 insertions(+), 9 deletions(-) diff --git a/doc/api/modules.markdown b/doc/api/modules.markdown index bac3b5584901..e737f6fdd34f 100644 --- a/doc/api/modules.markdown +++ b/doc/api/modules.markdown @@ -1,3 +1,33 @@ +## Standard Modules + + +Node 縺ｯ螟壹￥縺ｮ繧ｳ繝ｳ繝代う繝ｫ貂医∩縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧貞ｙ縺医※縺縺ｾ縺吶 +縺昴ｮ縺縺｡縺ｮ螟壹￥縺ｯ莉･髯阪ｮ繝峨く繝･繝｡繝ｳ繝医↓險倩ｿｰ縺輔ｌ縺ｦ縺縺ｾ縺吶 +繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ逕ｨ縺吶ｋ繧ゅ▲縺ｨ繧ゆｸ闊ｬ逧縺ｪ譁ｹ豕輔ｯ縲 `require('name')` 繧貞他縺ｳ縺昴ｮ謌ｻ繧雁､繧偵Δ繧ｸ繝･繝ｼ繝ｫ縺ｨ蜷悟錐縺ｮ繝ｭ繝ｼ繧ｫ繝ｫ螟画焚縺ｫ莉｣蜈･縺吶ｋ縺薙→縺ｧ縺吶 + + +萓: + + var util = require('util'); + + +讓呎ｺ悶Δ繧ｸ繝･繝ｼ繝ｫ莉･螟悶ｮ繝｢繧ｸ繝･繝ｼ繝ｫ繧堤畑縺縺ｦ Node 繧呈僑蠑ｵ縺吶ｋ縺薙→縺後〒縺縺ｾ縺吶 `'Modules'` 繧偵＃隕ｧ縺上□縺輔＞縲 + ## Modules `circle.js` 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ `area()` 縺ｨ `circumference()` 繧偵お繧ｯ繧ｹ繝昴ｼ繝医＠縺ｦ縺縺ｾ縺吶 -繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繧ｨ繧ｯ繧ｹ繝昴ｼ繝医☆繧九↓縺ｯ縲 `exports` 縺ｨ縺縺迚ｹ蛻･縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蜉縺医∪縺 +繧ｪ繝悶ず繧ｧ繧ｯ繝医ｒ繧ｨ繧ｯ繧ｹ繝昴ｼ繝医☆繧九↓縺ｯ縲 `exports` 縺ｨ縺縺迚ｹ蛻･縺ｪ繧ｪ繝悶ず繧ｧ繧ｯ繝医↓蜉縺医∪縺吶 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ繝ｭ繝ｼ繧ｫ繝ｫ螟画焚縺ｯ繝励Λ繧､繝吶ｼ繝医〒縺吶 縺薙ｮ萓九ｮ蝣ｴ蜷医∝､画焚 `PI` 縺ｯ `circle.js` 縺ｮ繝励Λ繧､繝吶ｼ繝亥､画焚縺ｧ縺吶 ### Core Modules + +Node 縺ｫ縺ｯ繝舌う繝翫Μ縺ｫ繧ｳ繝ｳ繝代う繝ｫ貂医∩縺ｮ縺縺上▽縺九ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺後≠繧翫∪縺吶 +縺薙ｌ繧峨ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ縺､縺縺ｦ縺ｯ縲√％縺ｮ繝峨く繝･繝｡繝ｳ繝医ｮ莉悶ｮ蝣ｴ謇縺ｧ繧医ｊ隧ｳ縺励￥險倩ｿｰ縺輔ｌ縺ｦ縺縺ｾ縺吶 + +繧ｳ繧｢繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ縲 Node 縺ｮ繧ｽ繝ｼ繧ｹ縺ｮ `lib/` 繝輔か繝ｫ繝縺ｫ縺ｦ螳夂ｾｩ縺輔ｌ縺ｦ縺縺ｾ縺吶 + +`require()` 縺ｧ縺ｯ蟶ｸ縺ｫ繧ｳ繧｢繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ隴伜挨蜷阪ｒ蜆ｪ蜈育噪縺ｫ隗｣驥医＠縺ｾ縺吶 +萓九∴縺ｰ `require('http')` 縺ｯ縲∽ｾ九∴蜷悟錐縺ｮ繝輔ぃ繧､繝ｫ縺悟ｭ伜惠縺励※縺縺溘→縺励※繧ゅ∝ｸｸ縺ｫ繝薙Ν繝医う繧､繝ｳ縺ｮ HTTP 繝｢繧ｸ繝･繝ｼ繝ｫ繧定ｿ斐＠縺ｾ縺吶 + ### File Modules + -繝励Ξ繝輔ぅ繝繧ｯ繧ｹ `'./'` 縺御ｻ倥¢繧峨ｌ縺溘Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ `require()` 繧貞他縺ｳ蜃ｺ縺励◆繝｢繧ｸ繝･繝ｼ繝ｫ縺九ｉ縺ｮ逶ｸ蟇ｾ繝代せ縺ｨ縺ｪ繧翫∪縺吶 -縺､縺ｾ繧 `circle.js` 縺ｯ `require('./circle')` 縺瑚ｦ九▽縺代ｉ繧後ｋ繧医≧縺ｫ `foo.js` 縺ｨ蜷後§繝繧｣繝ｬ繧ｯ繝医Μ縺ｫ縺ゅｋ蠢隕√′譛峨ｊ縺ｾ縺吶 - Without a leading '/' or './' to indicate a file, the module is either a "core module" or is loaded from a `node_modules` folder. +--> +謖螳壹＆繧後◆蜷榊燕縺ｮ繝輔ぃ繧､繝ｫ縺瑚ｦ九▽縺九ｉ縺ｪ縺九▲縺溘ｉ縲 Node 縺ｯ謖螳壹＆繧後◆繝輔ぃ繧､繝ｫ蜷阪↓ `.js` 繧剃ｻ倥¢縺溘ｂ縺ｮ縺ｨ `.node` 繧剃ｻ倥¢縺溘ｂ縺ｮ繧定ｪｭ縺ｿ霎ｼ繧ゅ≧縺ｨ縺励∪縺吶 + +`.js` 繝輔ぃ繧､繝ｫ縺ｯ JavaScript 繝輔ぃ繧､繝ｫ縺ｨ縺励※隗｣驥医＆繧後∪縺吶 +荳譁ｹ `.node` 繝輔ぃ繧､繝ｫ縺ｯ繧ｳ繝ｳ繝代う繝ｫ貂医∩縺ｮ繧｢繝峨が繝ｳ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｨ縺励※隗｣驥医＆繧後 `dlopen` 繧剃ｽｿ縺｣縺ｦ隱ｭ縺ｿ霎ｼ縺ｾ繧後∪縺吶 + +`'/'` 縺九ｉ蟋九∪繧九Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ縲√ヵ繧｡繧､繝ｫ縺ｸ縺ｮ邨ｶ蟇ｾ繝代せ縺ｨ隕九↑縺輔ｌ縺ｾ縺吶 +萓九∴縺ｰ縲 `require('/home/marco/foo.js')` 縺ｯ `/home/macro/foo.js` 繧定ｪｭ縺ｿ霎ｼ縺ｿ縺ｾ縺吶 + +`'./'` 縺九ｉ蟋九∪繧九Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ縲 `require()` 繧貞他繧薙□繝輔ぃ繧､繝ｫ縺九ｉ縺ｮ逶ｸ蟇ｾ繝代せ縺ｫ縺ｪ繧翫∪縺吶 +縺吶↑繧上■縲 `foo.js` 縺九ｉ `require('./circle')` 縺ｫ繧医▲縺ｦ `circle.js` 繧定ｪｭ縺ｿ霎ｼ繧縺ｫ縺ｯ縲 `circle.js` 縺ｯ `foo.js` 縺ｨ蜷後§繝繧｣繝ｬ繧ｯ繝医Μ縺ｫ蟄伜惠縺励※縺縺ｪ縺代ｌ縺ｰ縺ｪ繧翫∪縺帙ｓ縲 + +'/' 繧 './' 縺悟磯ｭ縺ｫ縺ｪ縺代ｌ縺ｰ縲√Δ繧ｸ繝･繝ｼ繝ｫ縺ｯ "繧ｳ繧｢繝｢繧ｸ繝･繝ｼ繝ｫ" 縺ｧ縺ゅｋ縺九ｂ縺励￥縺ｯ `node_modules` 繝輔か繝ｫ繝縺九ｉ隱ｭ縺ｿ霎ｼ縺ｾ繧後ｋ縺薙→縺ｫ縺ｪ繧翫∪縺吶 + ### Loading from `node_modules` Folders + +繧ゅ＠ `require()` 縺ｫ貂｡縺輔ｌ縺溘Δ繧ｸ繝･繝ｼ繝ｫ隴伜挨蟄舌′繝阪う繝繧｣繝悶Δ繧ｸ繝･繝ｼ繝ｫ縺ｧ縺ｯ縺ｪ縺上√°縺､ `'/'` 繧 `'../'` 繧 `'./'` 縺九ｉ蟋九∪繧峨↑縺縺ｪ繧峨ｰ縲 Node 縺ｯ迴ｾ蝨ｨ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ隕ｪ繝繧｣繝ｬ繧ｯ繝医Μ縺ｫ `'/node_modules'` 繧剃ｻ倅ｸ弱＠縺ｦ縺昴％縺九ｉ繝｢繧ｸ繝･繝ｼ繝ｫ繧定ｪｭ縺ｿ霎ｼ繧ゅ≧縺ｨ縺励∪縺吶 + +縺昴％縺ｫ隕九▽縺九ｉ縺ｪ縺蝣ｴ蜷医ｯ縺輔ｉ縺ｫ隕ｪ繝繧｣繝ｬ繧ｯ繝医Μ縺ｫ遘ｻ蜍輔＠縲√Δ繧ｸ繝･繝ｼ繝ｫ縺瑚ｦ九▽縺九ｋ縺 root 繝繧｣繝ｬ繧ｯ繝医Μ縺ｫ蛻ｰ驕斐☆繧九∪縺ｧ蜷梧ｧ倥ｮ縺薙→繧堤ｹｰ繧願ｿ斐＠縺ｦ縺縺阪∪縺吶 + +萓九∴縺ｰ `'/home/ry/projects/foo.js'` 縺ｮ荳ｭ縺ｧ `require('bar.js')` 繧貞他繧薙〒縺縺溷ｴ蜷医 Node 縺ｯ荳玖ｨ倥ｮ菴咲ｽｮ繧剃ｸ翫°繧蛾逡ｪ縺ｫ隕九※縺縺阪∪縺吶 + * `/home/ry/projects/node_modules/bar.js` * `/home/ry/node_modules/bar.js` * `/home/node_modules/bar.js` * `/node_modules/bar.js` + +縺薙ｮ莉慕ｵ縺ｿ縺ｫ繧医▲縺ｦ縲√励Ο繧ｰ繝ｩ繝縺ｯ繧ｯ繝ｩ繝繧ｷ繝･繧帝∩縺代ｋ縺溘ａ縺ｫ萓晏ｭ倬未菫ゅｒ荳頑嶌縺阪☆繧九％縺ｨ縺後〒縺阪ｋ縺ｮ縺ｧ縺吶 + #### Optimizations to the `node_modules` Lookup Process + +繝阪せ繝医＠縺滉ｾ晏ｭ倬未菫ゅ↓縺ｯ讒倥縺ｪ豺ｱ縺輔′縺ゅｋ縺溘ａ縲√ヵ繧｡繧､繝ｫ繝繝ｪ繝ｼ縺後°縺ｪ繧企聞縺上↑縺｣縺ｦ縺励∪縺縺薙→縺後≠繧翫∪縺吶 +縺昴ｌ謨縲∵ｬ｡縺ｮ繧医≧縺ｪ譛驕ｩ蛹悶′陦後ｏ繧後※縺縺ｾ縺吶 + +縺ｾ縺壹 `/node_modules` 縺ｯ繝輔か繝ｫ繝蜷阪′ `node_modules` 縺ｧ邨ゅｏ縺｣縺ｦ縺繧句ｴ蜷医↓縺ｯ霑ｽ蜉縺輔ｌ縺ｾ縺帙ｓ縲 + +谺｡縺ｫ縲 `require()` 繧貞他縺ｳ蜃ｺ縺励※縺繧九ヵ繧｡繧､繝ｫ縺後☆縺ｧ縺ｫ `node_modules` 驟堺ｸ九ｮ繝輔か繝ｫ繝蜀縺ｫ蟄伜惠縺励※縺繧後ｰ縲∽ｸ逡ｪ荳翫↓蟄伜惠縺励※縺繧 `node_modules` 繝輔か繝ｫ繝縺梧､懃ｴ｢繝繝ｪ繝ｼ縺ｮroot縺ｨ縺励※謇ｱ繧上ｌ縺ｾ縺吶 + +萓九∴縺ｰ縲 `'/home/ry/projects/foo/node_modules/bar/node_modules/baz/quux.js'` 縺ｫ縺ゅｋ繝輔ぃ繧､繝ｫ縺 `require('asdf.js')` 繧貞他繧薙〒縺縺溷ｴ蜷医 Node 縺ｯ谺｡縺ｮ鬆逡ｪ縺ｧ謗｢縺励↓縺縺阪∪縺吶 + * `/home/ry/projects/foo/node_modules/bar/node_modules/baz/node_modules/asdf.js` * `/home/ry/projects/foo/node_modules/bar/node_modules/asdf.js` * `/home/ry/projects/foo/node_modules/asdf.js` ### Folders as Modules + +繝励Ο繧ｰ繝ｩ繝縺ｨ繝ｩ繧､繝悶Λ繝ｪ繧偵ョ繧｣繝ｬ繧ｯ繝医Μ蜀縺ｫ縺ｾ縺ｨ繧√※縲√◎縺ｮ繧ｨ繝ｳ繝医Μ繝昴う繝ｳ繝医ｒ謠千､ｺ縺吶ｋ縺ｨ縺縺萓ｿ蛻ｩ縺ｪ譁ｹ豕輔ｂ縺ゅｊ縺ｾ縺吶 +縺昴ｌ縺ｫ縺ｯ `require()` 縺ｫ蠑墓焚縺ｨ縺励※菴輔ｒ貂｡縺吶°縺ｫ繧医▲縺ｦ3騾壹ｊ縺ｮ譁ｹ豕輔′縺ゅｊ縺ｾ縺吶 + +1縺､逶ｮ縺ｯ縲 `package.json` 縺ｨ縺縺繝輔ぃ繧､繝ｫ繧偵ヵ繧ｩ繝ｫ繝逶ｴ荳九↓菴懈舌＠縲 `main` 繝｢繧ｸ繝･繝ｼ繝ｫ繧呈欠螳壹☆繧九→縺縺譁ｹ豕輔〒縺吶 +萓九∴縺ｰ縲 package.json 縺ｯ莉･荳九ｮ繧医≧縺ｪ繝輔ぃ繧､繝ｫ縺ｫ縺ｪ繧翫∪縺: + { "name" : "some-library", "main" : "./lib/some-library.js" } + +繧ゅ＠ `./some-library` 繝輔か繝ｫ繝蜀縺ｫ縺薙ｮ繝輔ぃ繧､繝ｫ縺後≠繧後ｰ縲 `require('./some-library')` 縺ｯ `./some-library/lib/some-library.js` 繧定ｪｭ縺ｿ縺ｫ縺縺阪∪縺吶 + +縺薙ｌ縺ｯ縲 Node 縺 package.json 縺ｮ蟄伜惠縺ｫ豌励▼縺上％縺ｨ縺ｫ繧医▲縺ｦ繧ゅ◆繧峨＆繧後∪縺吶 + +繧ゅ＠ package.json 縺後ョ繧｣繝ｬ繧ｯ繝医Μ縺ｫ蟄伜惠縺励※縺縺ｪ縺代ｌ縺ｰ縲 Node 縺ｯ縺昴ｮ繝繧｣繝ｬ繧ｯ繝医Μ縺ｧ `index.js` 繧ゅ＠縺上ｯ `index.node` 繧呈爾縺励∪縺吶 +萓九∴縺ｰ縲√ｂ縺嶺ｸ翫ｮ萓九〒 package.json 縺後＞繧九′蟄伜惠縺励↑縺縺ｨ縺吶ｋ縺ｨ縲 `require('./some-library')` 縺ｯ莉･荳九ｮ繝輔ぃ繧､繝ｫ繧定ｪｭ縺ｿ霎ｼ繧ゅ≧縺ｨ縺励∪縺: + * `./some-library/index.js` * `./some-library/index.node` ### Caching + +繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ蛻昴ａ縺ｦ隱ｭ縺ｿ霎ｼ縺ｾ繧後◆縺ｨ縺阪↓繧ｭ繝｣繝繧ｷ繝･縺輔ｌ縺ｾ縺吶 +縺吶↑繧上■ｼ井ｻ悶ｮ繧ｭ繝｣繝繧ｷ繝･縺ｨ蜷梧ｧ倥↓ｼ `require('foo')` 繧貞他縺ｶ縺溘ｳ縺ｫ縲√ｂ縺怜ｼ墓焚縺ｮ諢丞袖縺吶ｋ繧ゅｮ縺悟酔荳縺ｮ繝輔ぃ繧､繝ｫ縺ｧ縺ゅ▲縺溘↑繧牙ｨ縺丞酔荳縺ｮ繧ｪ繝悶ず繧ｧ繧ｯ繝医′霑斐＆繧後∪縺吶 + ### All Together... -`require()` 縺悟他縺ｳ蜃ｺ縺輔ｌ繧九→縲∵ｭ｣遒ｺ縺ｪ繝輔ぃ繧､繝ｫ蜷阪ｒ蠕励ｋ縺溘ａ縺ｫ -`require.resolve()` 髢｢謨ｰ縺御ｽｿ繧上ｌ縺ｾ縺吶 +`require()` 縺悟他縺ｳ蜃ｺ縺輔ｌ繧九→縲∵ｭ｣遒ｺ縺ｪ繝輔ぃ繧､繝ｫ蜷阪ｒ蠕励ｋ縺溘ａ縺ｫ `require.resolve()` 縺御ｽｿ繧上ｌ縺ｾ縺吶 + + +荳翫〒霑ｰ縺ｹ縺溘％縺ｨ繧偵∪縺ｨ繧√ｋ縺ｨ縲 require.resolve 縺ｯ莉･荳九ｮ謫ｬ莨ｼ繧ｳ繝ｼ繝峨〒險倩ｿｰ縺輔ｌ繧九ｈ縺縺ｪ繝上う繝ｬ繝吶Ν縺ｪ繧｢繝ｫ繧ｴ繝ｪ繧ｺ繝縺ｫ蜑縺｣縺ｦ縺縺ｾ縺: + require(X) 1. If X is a core module, a. return the core module @@ -232,19 +338,32 @@ in pseudocode of what require.resolve does: ### Loading from the `require.paths` Folders + +`require.paths` 縺ｯ縲∵欠螳壹＆繧後◆繝｢繧ｸ繝･繝ｼ繝ｫ蜷阪′ `'/'` 繧 `'./'` 繧 `'../'` 縺九ｉ蟋九∪縺｣縺ｦ縺縺ｪ縺縺ｨ縺阪↓繝｢繧ｸ繝･繝ｼ繝ｫ繧呈爾縺励↓縺縺上ヱ繧ｹ繧呈枚蟄怜励→縺励※菫晄戟縺励※縺繧矩榊励〒縺吶 +萓九∴縺ｰ縲〉equire.paths縺梧ｬ｡縺ｮ繧医≧縺ｫ險ｭ螳壹＆繧後※縺繧九→縺励∪縺: + [ '/home/micheil/.node_modules', '/usr/local/lib/node_modules' ] + +縺昴＠縺ｦ縲 `require('baz/baz.js')` 繧貞他縺ｶ縺ｨ谺｡縺ｮ蝣ｴ謇繧呈爾縺励↓縺縺阪∪縺: + * 1: `'/home/micheil/.node_modules/bar/baz.js'` * 2: `'/usr/local/lib/node_modules/bar/baz.js'` + +縺薙ｌ繧峨ｮ蜍穂ｽ懊ｒ菫ｮ豁｣縺吶ｋ縺薙→縺後〒縺阪ｋ繧医≧縲 `require.paths` 驟榊励ｯ螳溯｡梧凾縺ｫ螟画峩縺吶ｋ縺薙→縺後〒縺阪∪縺吶 + +`require.paths` 縺ｯ `NODE_PATH` 縺ｨ縺縺迺ｰ蠅螟画焚縺ｮ蛟､縺ｫ繧医▲縺ｦ蛻晄悄蛹悶＆繧後∪縺吶 +`NODE_PATH` 縺ｫ縺ｯ繧ｳ繝ｭ繝ｳ縺ｧ蛹ｺ蛻縺｣縺溯､謨ｰ縺ｮ繝代せ繧定ｨ倩ｿｰ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 +荳翫ｮ萓九〒縺ｯ縲 `NODE_PATH` 縺ｫ縺ｯ谺｡縺ｮ繧医≧縺ｪ蛟､縺後そ繝繝医＆繧後※縺縺溘ｂ縺ｮ縺ｨ閠縺医ｉ繧後∪縺: + /home/micheil/.node_modules:/usr/local/lib/node_modules #### **Note:** Please Avoid Modifying `require.paths` + +蠕梧婿莠呈鋤諤ｧ繧剃ｿ昴▽縺溘ａ縺ｫ `require.paths` 縺ｯ莉翫ｮ縺ｨ縺薙ｍ繝｢繧ｸ繝･繝ｼ繝ｫ繧呈爾縺咎℃遞九↓縺翫＞縺ｦ譛繧ょ━蜈医＆繧後∪縺吶 +縺励°縺励∝ｰ譚･縺ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｧ縺ｯ `require.paths` 縺ｯ辟｡縺上↑繧倶ｺ亥ｮ壹〒縺吶 + +螳溯｣蠖捺凾縺ｯ繧医＞繧｢繧､繝繧｢縺縺ｨ諤昴ｏ繧悟ｮ滄ｨ鍋噪縺ｫ菴ｿ縺蛻縺ｫ縺ｯ縺ｨ縺ｦ繧よ怏逕ｨ縺ｧ縺励◆縺後∝ｮ滄圀縺ｫ菴ｿ縺縺縺励※縺ｿ繧九→螟画峩蜿ｯ閭ｽ縺ｪ `require.paths` 縺ｮ繝ｪ繧ｹ繝医→縺縺繧ゅｮ縺ｯ繧縺｣縺九＞縺ｪ豺ｷ荵ｱ縺ｨ鬆ｭ逞帙ｮ遞ｮ縺ｫ縺ｪ繧九％縺ｨ縺後＠縺ｰ縺励ｰ縺ゅ▲縺溘ｮ縺ｧ縺吶 + ##### Setting `require.paths` to some other value does nothing. + +谺｡縺ｮ繧ｳ繝ｼ繝峨ｯ縲∝ｸ梧悍騾壹ｊ縺ｫ縺ｯ蜍輔″縺ｾ縺帙ｓ: + require.paths = [ '/usr/lib/node' ]; + +縺薙ｌ縺ｯ縲 *螳滄圀縺ｮ* Node 繝｢繧ｸ繝･繝ｼ繝ｫ縺ｸ縺ｮ蜿らｧ繝代せ繧呈ｶ域ｻ縺輔○縲∽ｽｿ繧上ｌ繧九％縺ｨ縺ｮ縺ｪ縺繝代せ縺ｫ蟇ｾ縺吶ｋ譁ｰ縺溘↑蜿らｧ繧剃ｽ懊ｊ蜃ｺ縺励※縺縺ｾ縺吶 + ##### Putting relative paths in `require.paths` is... weird. + +谺｡縺ｮ繧医≧縺ｫ縺吶ｋ縺ｨ縺励∪縺: + require.paths.push('./lib'); + +縺薙ｌ縺ｯ縲√ヵ繧｡繧､繝ｫ繧ｷ繧ｹ繝繝荳翫ｮ `./lib` 縺ｮ縺ゅｋ蝣ｴ謇縺ｸ縺ｮ邨ｶ蟇ｾ繝代せ繧定ｿｽ蜉縺吶ｋ *繧上¢縺ｧ縺ｯ縺ゅｊ縺ｾ縺帙ｓ* 縲 +莉｣繧上ｊ縺ｫ縲∵枚蟄鈴壹ｊ `'./lib'` 繧定ｿｽ蜉縺励∪縺吶 +縺吶↑繧上■縲√ｂ縺 `/a/b/x.js` 繝輔ぃ繧､繝ｫ蜀縺ｧ `require('y.js')` 縺励◆蝣ｴ蜷医 `/a/b/lib/y.js` 繧呈爾縺励↓縺縺阪∪縺吶 +蜷梧ｧ倥↓ `/l/m/n/o/p.js` 繝輔ぃ繧､繝ｫ蜀縺ｧ `require('y.js')` 縺励◆蝣ｴ蜷医ｯ縲 `/l/m/n/o/lib/y.js` 繧呈爾縺励↓縺縺阪∪縺吶 + + +螳滄圀縺ｫ縲√％繧後ｉ縺ｯ繧｢繝峨帙ャ繧ｯ縺ｪ萓晏ｭ俶ｧ繧偵ヰ繝ｳ繝峨Ν縺吶ｋ縺溘ａ縺ｫ逕ｨ縺繧峨ｌ縺ｦ縺縺ｾ縺吶 +縺励°縺励％繧後ｉ縺ｮ繝繧ｯ繝九ャ繧ｯ縺ｯ縺ｨ縺ｦ繧ゆｸ榊ｮ牙ｮ壹〒縺吶 + ##### Zero Isolation + +ｼ域ｮ句ｿｵ縺ｪ縺薙→縺ｫｼ峨◆縺｣縺滉ｸ縺､縺ｮ `require.paths` 驟榊励′蜈ｨ縺ｦ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｫ繧医▲縺ｦ菴ｿ繧上ｌ繧九→縺縺險ｭ險医↓縺ｪ縺｣縺ｦ縺縺ｾ縺吶 + +縺昴ｮ邨先棡縲√ｂ縺励≠繧 Node 繝励Ο繧ｰ繝ｩ繝縺御ｸ願ｨ倥ｮ謖吝虚繧定｡後▲縺ｦ縺縺溘ｉ縲∝酔縺倥励Ο繧ｻ繧ｹ荳翫↓縺繧倶ｻ悶ｮ蜈ｨ縺ｦ縺ｮ Node 繝励Ο繧ｰ繝ｩ繝縺ｮ蜍穂ｽ懊ｂ豌ｸ驕縺ｫ縺昴＠縺ｦ蠕ｮ螯吶↓螟牙喧縺輔○縺ｦ縺励∪縺縺ｾ縺吶 +繧｢繝励Μ繧ｱ繝ｼ繧ｷ繝ｧ繝ｳ縺梧宣聞縺吶ｋ縺ｫ縺､繧後∫ｧ√◆縺｡縺ｯ讖溯ｽ繧偵∪縺ｨ繧√※縺縺阪∪縺吶 +縺昴＠縺ｦ縺昴ｮ荳ｭ縺ｫ荳願ｨ倥ｮ繧医≧縺ｪ莉悶∈蠖ｱ髻ｿ繧貞所縺ｼ縺咏ｮ謇縺後≠繧九→縲√◎繧後ｯ縺ｨ縺ｦ繧ゆｺ域ｸｬ縺吶ｋ縺ｮ縺碁屮縺励＞蝠城｡後→縺ｪ縺｣縺ｦ縺励∪縺縺ｾ縺吶 + ## Addenda: Package Manager Tips + +Node 縺ｮ `require()` 縺ｯ譎ｮ騾壹ｮ繝繧｣繝ｬ繧ｯ繝医Μ讒矩繧偵し繝昴ｼ繝医〒縺阪ｋ繧医≧豎守畑逧縺ｫ險ｭ險医＆繧後※縺縺ｾ縺吶 +`dpkg` 繧 `rpm` 繧 `npm` 縺ｮ繧医≧縺ｪ繝代ャ繧ｱ繝ｼ繧ｸ邂｡逅繝励Ο繧ｰ繝ｩ繝縺ｯ菫ｮ豁｣縺ｪ縺励↓ Node 繝｢繧ｸ繝･繝ｼ繝ｫ縺九ｉ繝阪う繝繧｣繝悶ヱ繝繧ｱ繝ｼ繧ｸ繧堤ｵ縺ｿ遶九※繧九％縺ｨ縺後〒縺阪ｋ縺ｧ縺励ｇ縺縲 + + +謗ｨ螂ｨ縺吶ｋ繝繧｣繝ｬ繧ｯ繝医Μ讒矩縺ｯ谺｡縺ｮ繧医≧縺ｫ縺ｪ繧翫∪縺: + +萓九∴縺ｰ `/usr/lib/node//` 繝輔か繝ｫ繝縺ｫ縲√≠繧九ヱ繝繧ｱ繝ｼ繧ｸ縺ｮ迚ｹ螳壹ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ繧剃ｿ晄戟縺吶ｋ蠖｢蠑上〒縺吶 + + +繝代ャ繧ｱ繝ｼ繧ｸ縺ｯ逶ｸ莠偵↓萓晏ｭ倥＠縺ゅ≧縺薙→縺後≠繧翫∪縺吶 +`foo` 繝代ャ繧ｱ繝ｼ繧ｸ繧偵う繝ｳ繧ｹ繝医ｼ繝ｫ縺吶ｋ縺溘ａ縺ｫ縺ｯ縺ゅｋ迚ｹ螳壹ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ縺ｮ `bar` 繝代ャ繧ｱ繝ｼ繧ｸ繧偵う繝ｳ繧ｹ繝医ｼ繝ｫ縺吶ｋ蠢隕√′縺ゅｊ縺ｾ縺吶 +`bar` 繝代ャ繧ｱ繝ｼ繧ｸ閾ｪ霄ｫ繧ゆｾ晏ｭ倬未菫ゅｒ繧ゅ▲縺ｦ縺繧九ｮ縺ｧ縲√→縺阪↓縺ｯ萓晏ｭ倬未菫ゅ′陦晉ｪ√＠縺溘ｊ蠕ｪ迺ｰ縺励◆繧翫☆繧九％縺ｨ縺後≠繧翫∪縺吶 + + +Node 縺ｯ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｮ `realpath` ｼ医す繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ繧定ｧ｣驥医＠縺ｾ縺呻ｼ峨ｒ隱ｿ縺ｹ縲√◎縺ｮ萓晏ｭ倬未菫ゅｒ荳願ｿｰ縺ｮ `node_modules` 繝輔か繝ｫ繝縺ｮ莉慕ｵ縺ｿ縺ｧ謗｢縺励↓縺縺阪∪縺吶 +縺薙ｌ縺ｫ繧医▲縺ｦ谺｡縺ｮ繧医≧縺ｪ讒矩繧偵→縺ｦ繧ゅす繝ｳ繝励Ν縺ｫ隗｣驥医☆繧九％縺ｨ縺後〒縺阪∪縺吶 + + +* `/usr/lib/node/foo/1.2.3/` - `foo` 繝代ャ繧ｱ繝ｼ繧ｸ縺ｮ荳ｭ霄ｫ縲ゅヰ繝ｼ繧ｸ繝ｧ繝ｳ1.2.3縲 +* `/usr/lib/node/bar/4.3.2/` - `bar` 繝代ャ繧ｱ繝ｼ繧ｸ縺ｮ荳ｭ霄ｫ縲 `foo` 縺御ｾ晏ｭ倥＠縺ｦ縺繧九 +* `/usr/lib/node/foo/1.2.3/node_modules/bar` - `/usr/lib/node/bar/4.3.2/` 縺ｸ縺ｮ繧ｷ繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ縲 +* `/usr/lib/node/bar/4.3.2/node_modules/*` - `bar` 縺御ｾ晏ｭ倥＠縺ｦ縺繧九ヱ繝繧ｱ繝ｼ繧ｸ縺ｸ縺ｮ繧ｷ繝ｳ繝懊Μ繝繧ｯ繝ｪ繝ｳ繧ｯ縲 + + +縺薙ｮ繧医≧縺ｫ縺励※縲√ｂ縺嶺ｻｮ縺ｫ萓晏ｭ倬未菫ゅ↓蠕ｪ迺ｰ繧陦晉ｪ√′隕九▽縺九▲縺溘→縺励※繧ゅ∝ｨ縺ｦ縺ｮ繝｢繧ｸ繝･繝ｼ繝ｫ縺ｯ萓晏ｭ倥＠縺ｦ縺繧九ヱ繝繧ｱ繝ｼ繧ｸ縺ｮ迚ｹ螳壹ｮ繝舌ｼ繧ｸ繝ｧ繝ｳ繧貞叙蠕励☆繧九％縺ｨ縺後〒縺阪∪縺吶 + +`foo` 繝代ャ繧ｱ繝ｼ繧ｸ縺ｮ荳ｭ縺ｧ `require('bar')` 縺励◆繧峨 `/usr/lib/node/foo/1.2.3/node_modules/bar` 縺九ｉ繝ｪ繝ｳ繧ｯ縺輔ｌ縺ｦ縺繧九ヰ繝ｼ繧ｸ繝ｧ繝ｳ繧貞叙蠕励＠縺ｾ縺吶 +縺昴＠縺ｦ縲 `bar` 繝代ャ繧ｱ繝ｼ繧ｸ蜀縺ｧ `require('quux')` 繧貞他繧薙□繧峨 `/usr/lib/node/bar/4.3.2/node_modules/quux` 縺九ｉ繝ｪ繝ｳ繧ｯ縺輔ｌ縺ｦ縺繧九ヰ繝ｼ繧ｸ繝ｧ繝ｳ繧貞叙蠕励＠縺ｾ縺吶 + +縺輔ｉ縺ｫ縲√Δ繧ｸ繝･繝ｼ繝ｫ繧呈爾邏｢縺吶ｋ驕守ｨ九ｒ繧医ｊ譛驕ｩ蛹悶☆繧九◆繧√↓縲 `/usr/lib/node` 縺ｫ繝代ャ繧ｱ繝ｼ繧ｸ繧堤ｽｮ縺上ｈ繧翫ｂ `/usr/lib/node_modules//` 縺ｫ鄂ｮ縺上ｮ繧偵♀蜍ｧ繧√＠縺ｾ縺吶 +縺昴≧縺吶ｋ縺薙→縺ｧ Node 縺ｯ隕九▽縺九ｉ縺ｪ縺萓晏ｭ倥ヱ繝繧ｱ繝ｼ繧ｸ繧 `/usr/node_modules` 繧 `/node_modules` 縺ｫ謗｢縺励↓縺縺九↑縺上※繧ゅｈ縺縺ｪ繧翫∪縺吶 + +Node 縺ｮ REPL 縺ｧ繝｢繧ｸ繝･繝ｼ繝ｫ繧剃ｽｿ縺医ｋ繧医≧縺ｫ縺吶ｋ縺溘ａ縺ｫ縲 `/usr/lib/node_modules` 繝輔か繝ｫ繝繧 `$NODE_PATH` 迺ｰ蠅螟画焚縺ｫ霑ｽ蜉縺吶ｋ縺ｨ繧医＞縺ｧ縺励ｇ縺縲 +`node_modules` 繝輔か繝ｫ繝繧剃ｽｿ縺｣縺溘Δ繧ｸ繝･繝ｼ繝ｫ謗｢邏｢縺ｯ蜈ｨ縺ｦ逶ｸ蟇ｾ逧縺ｪ繧ゅｮ縺ｧ縺ゅｊ縲 `require()` 繧貞他縺ｳ蜃ｺ縺励◆繝輔ぃ繧､繝ｫ縺ｮ邨ｶ蟇ｾ繝代せ繧貞渕貅悶→縺励※縺繧九ｮ縺ｧ縲√ヱ繝繧ｱ繝ｼ繧ｸ閾ｪ菴薙ｯ縺ｩ縺薙↓縺ｧ繧る咲ｽｮ縺吶ｋ縺薙→縺後〒縺阪∪縺吶 + From ecb3569809972d03e8a32407413d0e73c9dc2836 Mon Sep 17 00:00:00 2001 From: Toshihiro Shimizu Date: Fri, 4 Mar 2011 13:00:50 +0900 Subject: [PATCH 38/40] fix typo --- doc/api/addons.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/api/addons.markdown b/doc/api/addons.markdown index 8b8a2b76bc8e..27f0bda80d96 100644 --- a/doc/api/addons.markdown +++ b/doc/api/addons.markdown @@ -50,7 +50,7 @@ API 縺ｯ縺縺上▽縺九ｮ繝ｩ繧､繝悶Λ繝ｪ縺ｮ遏･隴倥′蠢隕√〒縲(迴ｾ譎らせ縺ｧ縺ｯ) - libeio 縺ｯ C 縺ｮ繧ｹ繝ｬ繝繝峨励ｼ繝ｫ繝ｩ繧､繝悶Λ繝ｪ縺ｧ縺吶 繝悶Ο繝繧ｯ縺吶ｋ POSIX 繧ｷ繧ｹ繝繝繧ｳ繝ｼ繝ｫ繧帝撼蜷梧悄縺ｫ螳溯｡後☆繧九◆繧√↓菴ｿ逕ｨ縺輔ｌ縺ｾ縺吶 縺薙≧縺縺｣縺溷他縺ｳ蜃ｺ縺励ｮ縺溘ａ縺ｮ螟ｧ謚ｵ縺ｮ繝ｩ繝繝代ｼ縺ｯ縲∵里縺ｫ `src/file.cc` 縺ｫ逕ｨ諢上＆繧後※縺繧九ｮ縺ｧ縲 - 縺翫◎繧峨￥縺薙ｌ繧剃ｽｿ縺蠢隕√ｯ縺ｪ縺縺励ｇ縺縲 + 縺翫◎繧峨￥縺薙ｌ繧剃ｽｿ縺蠢隕√ｯ縺ｪ縺縺ｧ縺励ｇ縺縲 蠢隕√↓縺ｪ縺｣縺溘ｉ縲〜deps/libeio/eio.h` 縺ｮ繝倥ャ繝繝輔ぃ繧､繝ｫ繧貞盾辣ｧ縺励※荳九＆縺縲 縺吶〒縺ｫ繧ｭ繝･繝ｼ縺ｫ蜈･繧後ｉ繧後※縺繧九′譛ｪ騾∽ｿ｡縺ｮ繝倥ャ繝繧定ｪｭ縺ｿ荳翫£縺ｾ縺呻ｼ -蜷榊燕縺ｯ螟ｧ譁蟄怜ｰ乗枚蟄励ｒ蛹ｺ蛻･縺吶ｋ縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 +蜷榊燕縺ｯ螟ｧ譁蟄怜ｰ乗枚蟄励ｒ蛹ｺ蛻･縺励↑縺縺薙→縺ｫ豕ｨ諢上＠縺ｦ縺上□縺輔＞縲 縺薙ｌ縺ｯ繝倥ャ繝縺梧囓鮟咏噪縺ｫ繝輔Λ繝繧ｷ繝･縺輔ｌ繧句燕縺縺大他縺ｳ蜃ｺ縺吶％縺ｨ縺後〒縺阪∪縺吶 +
    -->