Merge pull request BonsaiDen#130 from Layzie/ja

improve translation on japanese and translate "delete operator"

Author: BonsaiDen

doc/ja/array/general.md

@@ -1,6 +1,6 @@
 ## 配列の繰り返しとプロパティ
 
-JavaScriptの配列もまたオブジェクトですので[`for in ループ`](#object.forinloop)を配列の繰り返しで使用するような理由はありません。実際、配列に`for in`を使用**しない**為の正当な理由はたくさんあります。
+JavaScriptの配列もまたオブジェクトですが、[`for in ループ`](#object.forinloop)を配列の繰り返し処理で使用することの良い理由は1つもありません。実際、配列に`for in`を使用**しない**為の正当な理由はたくさんあります。
 
 > **注意:** JavaScriptの配列は*連想配列*では**ありません**。JavaScriptは[objects](#object.general)だけがキーバリューをマッピングするものです。
 > また、連想配列は順序を**保持**しますが、オブジェクトは**保持しません**。
@@ -16,11 +16,11 @@ JavaScriptの配列もまたオブジェクトですので[`for in ループ`](#
         console.log(list[i]);
     }
 
-上記の例では一つ余分に変数がありますが、それは配列の長さを取るための`l = list.length`の部分です。
+上記の例では1つ追加の仕掛けがありますが、それは`l = list.length`によって配列の長さをキャッシュする部分です。
 
-また、`length`プロパティは配列自身に定義されていますが、ループのそれぞれの繰り返しで探索する為のオーバーヘッドがまだあります。最近のJavaScriptエンジンはこのような場合に最適化する**はず**です。新しいエンジンか古いエンジンで実行されるかどうかをコードが知る方法はありません。
+`length`プロパティは配列自身に定義されてはいますが、ループ中の繰り返しで毎回これを参照してしまうと、やはりオーバーヘッドが存在してしまいます。最近のJavaScriptエンジンはこのような場合に最適化する**はず**ですが、コードが新しいエンジンで実行されるかどうか、知る方法はありません。
 
-実際には、キャッシュを抜きにするとループの結果はキャッシュされたものに比べて、**半分だけ高速**になっています。
+実際には、キャッシュを抜きにするとループの結果はキャッシュされたものに比べてたった**半分の速度**にしかなりません。
 
 ### `length`プロパティ
 

doc/ja/core/delete.md

@@ -0,0 +1,75 @@
+## `delete`演算子
+
+端的に言って、JavaScriptの関数やその他の要素は`DontDelete`属性が設定されているので、グローバル変数を消去する事は*不可能*です。
+
+### グローバルコードと関数コード
+
+変数や、関数がグローバルまたは[関数スコープ](#function.scopes)で定義された時は、そのプロパティは有効なオブジェクトかグローバルオブジェクトになります。このようなプロパティは属性のセットを持っていますが、それらの内の1つが`DontDelete`になります。変数や関数がグローバルや関数コードで宣言されると、常に`DontDelete`属性を作るために、消去できません。
+
+    // グローバル変数:
+    var a = 1; // DontDelete属性が設定される
+    delete a; // false
+    a; // 1
+
+    // 通常関数:
+    function f() {} // DontDelete属性が設定される
+    delete f; // false
+    typeof f; // "function"
+
+    // 再代入も役に立たない:
+    f = 1;
+    delete f; // false
+    f; // 1
+
+### 明示的なプロパティ
+
+普通にプロパティを消去できる方法が存在します：プロパティを明示的に設定するのです。
+
+    // プロパティを明示的に設定する
+    var obj = {x: 1};
+    obj.y = 2;
+    delete obj.x; // true
+    delete obj.y; // true
+    obj.x; // undefined
+    obj.y; // undefined
+
+上記の例の中で、`obj.x`と`obj.y`はそれぞれ`DontDelete`属性が無い為に削除できます。これが下記の例でも動作する理由です。
+
+    // IE以外では、これも動作する
+    var GLOBAL_OBJECT = this;
+    GLOBAL_OBJECT.a = 1;
+    a === GLOBAL_OBJECT.a; // true - ただのグローバルのvar
+    delete GLOBAL_OBJECT.a; // true
+    GLOBAL_OBJECT.a; // undefined
+
+ここでは`a`. [`this`](#function.this)を消す為にグローバルオブジェクトと明示的に宣言した`a`をそのプロパティとして参照させて、消去する事を許可するトリックを使います。
+
+IE(最低でも6-8で)は多少のバグがある為に、上記のコードは動作しません。
+
+
+### 関数の引数と組み込み引数
+
+関数の通常の引数である、[`arguments` object](#function.arguments)と組み込みのプロパティもまた、`DontDelete`が設定されています。
+
+    // 関数の引数とプロパティ:
+    (function (x) {
+
+      delete arguments; // false
+      typeof arguments; // "object"
+
+      delete x; // false
+      x; // 1
+
+      function f(){}
+      delete f.length; // false
+      typeof f.length; // "number"
+
+    })(1);
+
+### ホストオブジェクト
+
+`delete`演算子の挙動はホストオブジェクトにとって予測不可能になりかねません。仕様によりホストオブジェクトは、あらゆる挙動の実行が許可されている為です。
+
+### 終わりに
+
+`delete`演算子は、しばしば予期せぬ挙動をします。唯一安全な仕様方法は通常のオブジェクトに明示的に設定されたプロパティを扱う場合だけです。

doc/ja/core/semicolon.md

@@ -77,9 +77,10 @@ JavaScriptはセミコロン無しの言語ではありません。実際に、
 
     })(window); //<- 挿入
 
-> **注意点:** JavaScriptパーサーは新しい行のreturn文を「正しく」返してはいないですが、
-> これは必要という訳では無いので自動セミコロン挿入の障害になります。
-> このお陰で不必要な副作用を無くす事にもなります。
+> **注意点:** JavaScriptパーサーは、すぐ後に改行が続く return文を正しく扱いません。
+> これは必ずしも自動セミコロン挿入の欠点によるものではありませんが、
+> それもまた望まない副作用となりえます。
+
 
 パーサーは上記のコードの振舞いを劇的に変化させます。あるケースにおいては、**間違っている事**にもなってしまいます。
 
@@ -98,4 +99,4 @@ JavaScriptはセミコロン無しの言語ではありません。実際に、
 
 ### 終わりに
 
-セミコロンを省略するのは**絶対**にお勧めしません。この事はまた括弧をその終端と一緒の行に書く事が推奨されてますし、1つの`if`や`else`文を絶対に省略してはなりません。これら両方の処理がコードの整合性を高めてくれる上、JavaScriptパーサーの振舞いを変えてしまうのを防いでくれるでしょう。
+セミコロンを省略するのは**絶対**にお勧めしません。括弧を対応する文と同じ行に記述すること、および一行の`if / else`文に対して括弧を省略しないことが推奨されています。これら両方の処理がコードの整合性を高めてくれるだけでなく、JavaScriptパーサーの振舞いを変えてしまうのを防いでくれるでしょう。

doc/ja/core/undefined.md

@@ -1,6 +1,6 @@
 ## `undefined`と`null`
 
-JavaScriptは`nothing`を表す2つの別個の値を持っています。`undefined`はこれら2つの内より便利な存在です。
+JavaScriptは`nothing`を表す2つの別個の値を持っています。これら2つの内で`undefined`はより便利な存在です。
 
 ### `undefined`の値
 
@@ -11,14 +11,14 @@ JavaScriptは`nothing`を表す2つの別個の値を持っています。`undef
 > **ES5での注意点:** ECMAScript 5での`undefined`は **もはや** strict modeでは *書き変えられない*
 > ようになっています。しかし、この名前は`undefined`という名前の関数の例に痕跡が見られるだけです。
 
-`undefined`が帰される時の例をいくつか挙げます。
+`undefined`が返される時の例をいくつか挙げます。
 
  - (未定義の)グローバル変数`undefined`にアクセスした時
  - `return`文が無い為に、暗黙のうちに関数が返された時
  - 何も返されない`return`がある時
  - 存在しないプロパティを探索する時
  - 関数のパラメーターで明示的な値が何も無い時
- - 全ての`undefined`が設定された値
+ - `undefined`が設定された全ての値
 
 ### `undefined`の値に変更する処理
 

doc/ja/function/arguments.md

@@ -3,7 +3,7 @@
 JavaScriptの全ての関数スコープは`arguments`と呼ばれる特別な変数にアクセスできます。この変数は関数が受け取った全ての引数を保持する変数です。
 
 > **注意:** `arguments`が既に`var`や正式なパラメーターにより
-> 関数のスコープが定義されている場合は
+> 関数のスコープ内部で定義されている場合は
 > `arguments`オブジェクトは作られません。
 
 `arguments`オブジェクトは`Array`では**ありません**。これは配列と同じような -`length`プロパティと名付けられています- 文法を持っていますが、`Array.prototype`を継承している訳では無いので、実際`Object`になります。

doc/ja/function/closures.md

@@ -1,6 +1,6 @@
 ## クロージャと参照
 
-JavaScriptの一番パワフルな特徴の一つとして*クロージャ*が使える事が挙げられます。これはスコープが**いつも**外部に定義されたスコープにアクセスできるという事です。JavaScriptの唯一のスコープは[関数スコープ](#function.scopes)ですが、全ての関数は標準でクロージャとして振る舞います。
+JavaScriptの一番パワフルな特徴の一つとして*クロージャ*が使える事が挙げられます。これはスコープが自身の定義されている外側のスコープに**いつでも**アクセスできるという事です。JavaScriptの唯一のスコープは[関数スコープ](#function.scopes)ですが、全ての関数は標準でクロージャとして振る舞います。
 
 ### プライベート変数をエミュレートする
 
@@ -32,7 +32,7 @@ JavaScriptでは、スコープ自体を参照・代入する事が出来無い
         count = 1337;
     };
 
-上記のコードは`Counter`のスコープ中にある変数`count`の値を変更する事は**ありません**。`foo.hack`は**その**スコープで定義されていないからです。これは*グローバル*変数`count`の作成 -またはオーバーライド- の代わりになるでしょう。
+上記のコードは`Counter`のスコープ中にある変数`count`の値を変更する事は**ありません**。`foo.hack`は**その**スコープで定義されていないからです。これは(`Counter`内の変数`count`の変更)の代わりに*グローバル*変数`count`の作成 -または上書き- する事になります。
 
 ### ループ中のクロージャ
 
@@ -64,9 +64,9 @@ JavaScriptでは、スコープ自体を参照・代入する事が出来無い
 
 外部の匿名関数は`i`を即座に第一引数として呼び出し、引数`e`を`i`の**値**のコピーとして受け取ります。
 
-`e`を参照している`setTimeout`を受け取った匿名関数はループによって値が変わる事が**ありません**。
+`e`を参照している`setTimeout`を受け取った匿名関数はループによって値が変わる事が**ありません。**
 
-他にこのような事を実現する方法があります。それは匿名ラッパーから関数を返してあげる事です。これは上記のコードと同じような効果があります。
+他にこのような事を実現する方法があります。それは匿名ラッパーから関数を返してあげる事です。これは上記のコードと同じ振る舞いをします。
 
     for(var i = 0; i < 10; i++) {
         setTimeout((function(e) {

doc/ja/function/constructors.md

@@ -2,7 +2,7 @@
 
 JavaScriptのコンストラクタは色々ある他のプログラム言語とは一味違います。`new`キーワードが付いているどんな関数呼び出しも、コンストラクタとして機能します。
 
-コンストラクタ内部では -呼び出された関数の事です- `this`の値は新規に生成された`Object`を参照しています。この**新規**のオブジェクトの[`prototype`](#object.prototype)は、コンストラクタとして起動した関数オブジェクトの`prototype`として設定されています。
+コンストラクタ内部では -呼び出された関数の事です- `this`の値は新規に生成された`Object`を参照しています。この**新規**のオブジェクトの[`prototype`](#object.prototype)は、コンストラクタとして起動した関数オブジェクトの`prototype`に設定されています。
 
 もし呼び出された関数が、`return`ステートメントを明示していない場合は、暗黙の了解で`this`の値を -新規のオブジェクトとして- 返します。
 
@@ -16,9 +16,9 @@ JavaScriptのコンストラクタは色々ある他のプログラム言語と
 
     var test = new Foo();
 
-上記で`Foo`はコンストラクタとして呼び出され、`Foo.prototype`として新規に生成された`prototype`を設定されています。
+上記は、`Foo`をコンストラクタとして呼び出し、新規に生成されたオブジェクトの`prototype`を`Foo.prototype`に設定しています。
 
-明示的に`return`ステートメントがある場合、`Object`の値を返す**だけでなく**関数はこのステートメントを返します。
+明示的に`return`ステートメントがある場合、関数は返り値が`Object`である場合に**限り**ステートメントで明示した値を返します。
 
     function Bar() {
         return 2;
@@ -41,7 +41,7 @@ JavaScriptのコンストラクタは色々ある他のプログラム言語と
     }
     Foo(); // undefinedが返る
 
-上記の例では、いくつかのケースでは動作するように見える場合があります。JavaScriptの[`this`](#function.this)の働きのせいで、*グローバルオブジェクト*が`this`の値として使用されるからです。
+JavaScriptの[`this`](#function.this)の働きのせいで、上記の例ではいくつかのケースでは動作するように見える場合がありますが、それは*グローバルオブジェクト*が`this`の値として使用されるからです。
 
 ### ファクトリー
 
@@ -64,16 +64,16 @@ JavaScriptのコンストラクタは色々ある他のプログラム言語と
 
 `Bar`で呼び出されたものは両方とも全く同じものものになります。これには、`method`と呼ばれるプロパティを持ったオブジェクトが新しく生成されますが、これは[クロージャ](#function.closures)です。
 
-また、注意する点として呼び出された`new Bar()`は返ってきたオブジェクトのプロトタイプに影響**しません**。プロトタイプが新しく生成されたオブジェクトにセットされるまで、`Bar`は絶対に新しいオブジェクトを返さないのです。
+また、注意する点として呼び出された`new Bar()`は返ってきたオブジェクトのプロトタイプに影響**しません**。プロトタイプは新しく生成されたオブジェクトにセットされはしますが、`Bar`は絶対にその新しいオブジェクトを返さないのです。
 
 上記の例では、`new`キーワードの使用の有無は機能的に違いがありません。
 
 
 ### ファクトリーとして新しくオブジェクトを作成する
 
-大半の場合に推奨されるのは、`new`の付け忘れによるバグを引き起こしやすいので使用**しない**事です。
+多くの場合に推奨される事として、`new`の付け忘れによるバグを引き起こしやすいので、`new`を使用**しない**ようにするという事があります。
 
-新しいオブジェクトを作成するためにファクトリーを使用するか、そのファクトリー内部に新しいオブジェクトを構築する必要があります。
+新しいオブジェクトを作成するためにファクトリーを使用して、そのファクトリー内部に新しいオブジェクトを作成すべきだという事です。
 
     function Foo() {
         var obj = {};
@@ -98,6 +98,6 @@ JavaScriptのコンストラクタは色々ある他のプログラム言語と
 
 ### 終わりに
 
-`new`キーワードが省略される事により、バグの可能性がもたらされますがプロトタイプを使わない確実な理由には**なりません**。最終的には、アプリケーションの必要性により、どちらの解決法がより良いかが決まってきます。特に大切なのは、オブジェクトの作成に特定のスタイルを選ぶ事、また**そのスタイルに固執する事**です。
+`new`キーワードが省略される事によりバグの可能性がもたらされますが、それによりプロトタイプを全く使わないという確かな理由には**なりません**。最終的には、アプリケーションの必要性により、どちらの解決法がより良いかが決まってきます。特に大切なのは、オブジェクトの作成に特定のスタイルを選ぶ事、また**そのスタイルに固執する事**です。
 
 

doc/ja/function/general.md

@@ -1,6 +1,6 @@
 ## 関数の宣言と式
 
-関数はJavaScriptの第一級オブジェクトです。この事は、その他の値と同じように渡す事が出来るという事です。この機能で良く使われる一つとして**匿名関数**を他のオジェクトにコールバックとして渡すというものがあり、これで非同期での実装が可能になります。
+関数はJavaScriptの第一級オブジェクトです。この事は、その他の値と同じように渡す事が出来るという事です。この機能で良く使われる一つとして**匿名関数**を他のオブジェクトにコールバックとして渡すというものがあり、これで非同期での実装が可能になります。
 
 ### `関数`宣言
 
@@ -25,14 +25,13 @@
 
 しかし、コードの実行時にのみこの割り当てがされるため、`foo`という変数は対応するコードが実行される前にデフォルト値である[undefined](#core.undefined)が代入されるのです。
 
-### 名前付き関数宣言
+### 名前付き関数式
 
-他に特殊なケースとして、命名関数があります。
+他に特殊なケースとして、名前付き関数があります。
 
     var foo = function bar() {
         bar(); // 動作する
     }
     bar(); // ReferenceError
 
-この場合の`bar`は`foo`に対して関数を割り当てるだけなので、外部スコープでは使用できません。しかし、`bar`は内部では使用できます。これはJavaScriptでは[名前解決](#function.scopes)による動作です。関数名は*いつも*関数自体のローカルスコープ内で有効になっています。
-
+この場合の`bar`は`foo`に対して関数を割り当てるだけなので、外部スコープでは使用できません。しかし、`bar`は内部では使用できます。これはJavaScriptの[名前解決](#function.scopes)の方法によるもので、関数名は*いつも*関数自身のローカルスコープ内で有効になっています。