Merge pull request #244 from takefumi-yoshii/translate/ja-playground-exs-primitives-any

Translate primitives any of playground examples into japanese

Author: Orta

packages/playground-examples/copy/ja/TypeScript/Primitives/Any.ts

@@ -0,0 +1,50 @@
+// anyはTypeScriptのエスケープ句です。 
+// any型を利用することで、一区切りのコードを
+// JavaScriptの様に動的に扱ったり、
+// 型システムの制限を回避することができます。
+
+// any型が使用されている良い例はJSON.parseの結果です
+
+const myObject = JSON.parse("{}");
+
+// TypeScriptにおけるany宣言は、あなたがその値について詳しく知っていて
+// それが厳密に正しくないとしても、安全なものなので信じてくださいという宣言です。
+// 例えば、次のコードはクラッシュします。
+
+myObject.x.y.z;
+
+// any型を利用することで、型の安全性と引き換えに、
+// よりオリジナルに近いJavaScriptコードを書くことができます。
+
+// any型は、（neverを除いて）どんな型でも割り当て可能であり、
+// 一方の型をもう一方に割り当て可能にする「型のワイルドカード」
+// によく似ています。
+
+declare function debug(value: any);
+
+debug("a string");
+debug(23);
+debug({ color: "blue" });
+
+// いずれのdebug関数実行も、引数の型を
+// anyに置き換えることができるため許可されます。
+
+// TypeScriptはany型の位置を考慮します。
+// たとえば、この様なタプル型を利用した関数引数であってもです。
+
+declare function swap(x: [number, string]): [string, number];
+
+declare const pair: [any, any];
+swap(pair);
+
+// swap関数引数であるnumber型・string型のペアは、
+// any型のペアと置き換えることができるため、
+// この関数実行は許可されます。
+
+// タプル型が初見の場合、example:tuples を参照してください。
+
+// unknown型はany型の兄弟とも言うことができますが、
+// any型は「最善策を知っている」場合に利用する一方で、
+// unknown型は「最善策が分からないので、TSに型を伝える必要がある」
+// 場合に利用します。
+// 詳細は example:unknown-and-never を参照してください。