From 5c51b6062543779cfa57c7564bd038750d906b2b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Thu, 26 Aug 2021 01:31:11 +0900 Subject: Web/JavaScript/Reference/Operators/Optional_chaining を更新 (#2116) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Markdown に変換 - 2021/08/03 時点の英語版に同期 --- .../operators/optional_chaining/index.html | 195 --------------------- .../reference/operators/optional_chaining/index.md | 195 +++++++++++++++++++++ 2 files changed, 195 insertions(+), 195 deletions(-) delete mode 100644 files/ja/web/javascript/reference/operators/optional_chaining/index.html create mode 100644 files/ja/web/javascript/reference/operators/optional_chaining/index.md (limited to 'files/ja/web/javascript/reference/operators') diff --git a/files/ja/web/javascript/reference/operators/optional_chaining/index.html b/files/ja/web/javascript/reference/operators/optional_chaining/index.html deleted file mode 100644 index b3eee3eb1f..0000000000 --- a/files/ja/web/javascript/reference/operators/optional_chaining/index.html +++ /dev/null @@ -1,195 +0,0 @@ ---- -title: Optional chaining (?.) -slug: Web/JavaScript/Reference/Operators/Optional_chaining -tags: - - Chaining - - JavaScript - - Language feature - - Operator - - Optional chaining - - Reference -translation_of: Web/JavaScript/Reference/Operators/Optional_chaining ---- -
{{JSSidebar("Operators")}}
- -

オプショナルチェイニング (optional chaining) 演算子 ?. は、接続されたオブジェクトチェーンの深くに位置するプロパティの値を、チェーン内の各参照が正しいかどうかを明示的に確認せずに読み込むことを可能にします。 ?. 演算子の機能は . チェーン演算子と似ていますが、参照が {{glossary("nullish")}} ({{JSxRef("null")}} または {{JSxRef("undefined")}}) の場合にエラーとなるのではなく、式が短絡され undefined が返されるところが異なります。 関数呼び出しで使用すると、与えられた関数が存在しない場合、 undefined を返します。

- -

これは、参照が失われた可能性のある連結されたプロパティにアクセスする時、結果的に短く単純な式になります。また、必要なプロパティの存在が保証されていない場合にオブジェクトのコンテンツを探索するのにも役立ちます。

- -

オプショナルチェイニングは、存在しないルートオブジェクトでは使用できません。if (typeof a == "undefined") のようなチェックを置き換えるものではありません。

- -
{{EmbedInteractiveExample("pages/js/expressions-optionalchainingoperator.html", "taller")}}
- - - -

構文

- -
obj?.prop
-obj?.[expr]
-arr?.[index]
-func?.(args)
-
- -

解説

- -

オプショナルチェイニング演算子は、参照や関数が undefined または null である可能性がある場合でも、接続されたオブジェクトの値に簡単にアクセスする手段を提供します。

- -

たとえば、入れ子構造を持つオブジェクト obj を考えましょう。オプショナルチェイニング演算子なしで深い入れ子になったサブプロパティにアクセスするには、次のように、各プロパティ間の参照を確認する必要があります:

- -
let nestedProp = obj.first && obj.first.second;
- -

obj.first.second の値にアクセスする前に、 obj.first の値が null または undefined でないことを確認します。これにより、 obj.first をテストせずに直接 obj.first.second にアクセスしたときに起きるエラーを防ぐことができます。

- -

しかし、オプショナルチェイニング演算子 (?.) を使えば、obj.first.second にアクセスしようとする前に obj.first の状態を明示的にテストする必要がなくなります:

- -
let nestedProp = obj.first?.second;
- -

?. を . の代わりに用いることで、 JavaScript が obj.first.second にアクセスしようとする前に obj.first が null または undefined でないことを暗黙的に確かめるようになります。obj.first が null または undefined であった場合、式が自動的に短絡され、 undefined が返ります。

- -

これは、一時的な変数が作成されないことを除き、次の式と等価です。

- -
let temp = obj.first;
-let nestedProp = ((temp === null || temp === undefined) ? undefined : temp.second);
-
- -

関数呼び出しでオプショナルチェイニング演算子を使う

- -

存在しない可能性がある関数の呼び出しを試行するときに、オプショナルチェイニングを使うことができます。これはたとえば、ユーザーのデバイス上で使えなかったり、実装が古かったりするために使えなかったりする可能性がある API を使うときに役立ちます。

- -

関数呼び出しでオプショナルチェイニング演算子を用いた場合、メソッドが見つからないときは自動的に undefined が返ります。例外はスローされません。

- -
let result = someInterface.customMethod?.();
- -
-

注意: 上記のようなプロパティの関数がない場合に、?. を使用すると {{JSxRef("TypeError")}} 例外が発生します (someInterface.customMethod is not a function)。

-
- -
-

注意: someInterface 自体が null または undefined の場合にも、{{JSxRef("TypeError")}} 例外が発生します (someInterface is null)。someInterface 自体が null または undefined の可能性がある場合は、次の位置にも ?. を使用しなければなりません。someInterface?.customMethod?.()

-
- -

省略可能なコールバックやイベントハンドラを扱う

- -

コールバックを使う場合や、オブジェクトからメソッドを分割代入を利用して取り出す場合に、存在しない値がある可能性があり、その存在を検証するまで関数として呼び出せません。その場合 ?. を利用することで、検証の必要性を回避できます。

- -
// Written as of ES2019
-function doSomething(onContent, onError) {
-  try {
-    // ... do something with the data
-  }
-  catch (err) {
-    if (onError) { // Testing if onError really exists
-      onError(err.message);
-    }
-  }
-}
-
- -
// Using optional chaining with function calls
-function doSomething(onContent, onError) {
-  try {
-   // ... do something with the data
-  }
-  catch (err) {
-    onError?.(err.message); // no exception if onError is undefined
-  }
-}
-
- -

オプショナルチェイニング演算子を式と組み合わせて使う

- -

ブラケット表記法とオプショナルチェイニング演算子を組み合わせることもできます。

- -
let nestedProp = obj?.['prop' + 'Name'];
-
- -

オプショナルチェイニング演算子は代入の左辺値では有効にならない

- -
let object = {};
-object?.property = 1; // Uncaught SyntaxError: Invalid left-hand side in assignment
- -

オプショナルチェイニングにより配列の要素にアクセス

- -
let arrayItem = arr?.[42];
- -

例

- -

基本的な例

- -

次の例では、マップに存在しない bar メンバの name プロパティを取得しようとしています。したがって、結果は undefined になります。

- -
let myMap = new Map();
-myMap.set("foo", {name: "baz", desc: "inga"});
-
-let nameBar = myMap.get("bar")?.name;
- -

短絡評価

- -

式と一緒にオプショナルチェイニング演算子を用いたとき、左側のオペランドが null または undefined である場合にその式は評価されなくなります。

- -
let potentiallyNullObj = null;
-let x = 0;
-let prop = potentiallyNullObj?.[x++];
-
-console.log(x); // 0 as x was not incremented
-
- -

オプショナルチェイニングをつなげて使う

- -

入れ子になったオブジェクトでは、オプショナルチェイニング演算子を何度でも使えます。

- -
let customer = {
-  name: "Carl",
-  details: {
-    age: 82,
-    location: "Paradise Falls" // detailed address is unknown
-  }
-};
-let customerCity = customer.details?.address?.city;
-
-// … this also works with optional chaining function call
-let duration = vacations.trip?.getTime?.();
-
- -

Null 合体演算子と共に使う

- -

{{JSxRef("Operators/Nullish_Coalescing_Operator", "Null 合体演算子", '', 1)}}はオプショナルチェイニングの後につけることで、存在しない値があった時、既定値をかわりに使うために利用できます。

- -
let customer = {
-  name: "Carl",
-  details: { age: 82 }
-};
-const customerCity = customer?.city ?? "Unknown city";
-console.log(customerCity); // Unknown city
- -

仕様

- - - - - - - - - - - - - - - - -
仕様書状態備考
"オプショナルチェイニング" 演算子の提案Stage 4
- -

ブラウザーの互換性

- -
-

{{Compat("javascript.operators.optional_chaining")}}

-
- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/operators/optional_chaining/index.md b/files/ja/web/javascript/reference/operators/optional_chaining/index.md new file mode 100644 index 0000000000..644624bfbb --- /dev/null +++ b/files/ja/web/javascript/reference/operators/optional_chaining/index.md @@ -0,0 +1,195 @@ +--- +title: オプショナルチェーン (?.) +slug: Web/JavaScript/Reference/Operators/Optional_chaining +tags: + - Chaining + - JavaScript + - Language feature + - Operator + - Optional chaining + - Reference +browser-compat: javascript.operators.optional_chaining +translation_of: Web/JavaScript/Reference/Operators/Optional_chaining +--- +{{JSSidebar("Operators")}} + +**オプショナルチェーン** (optional chaining) 演算子 (**`?.`**) は、接続されたオブジェクトチェーンの深くに位置するプロパティの値を、チェーン内の各参照が正しいかどうかを明示的に確認せずに読み込むことを可能にします。 + + `?.` 演算子の機能は `.` チェーン演算子と似ていますが、参照が [nullish](/ja/docs/Glossary/Nullish) ({{JSxRef("null")}} または {{JSxRef("undefined")}}) の場合にエラーとなるのではなく、式が短絡され `undefined` が返されるところが異なります。関数呼び出しで使用すると、与えられた関数が存在しない場合、 `undefined` を返します。 + +これは、参照が失われた可能性のある連結されたプロパティにアクセスする時、結果的に短く単純な式になります。また、必要なプロパティの存在が保証されていない場合にオブジェクトのコンテンツを探索するのにも役立ちます。 + +オプショナルチェーンは、宣言されていないルートオブジェクトでは使用できませんが、未定義のルートオブジェクトで使用できます。 + +{{EmbedInteractiveExample("pages/js/expressions-optionalchainingoperator.html", + "taller")}} + +## 構文 + +```js +obj.val?.prop +obj.val?.[expr] +obj.arr?.[index] +obj.func?.(args) +``` + +## 解説 + +オプショナルチェーン演算子は、参照や関数が `undefined` または `null` である可能性がある場合でも、接続されたオブジェクトの値に簡単にアクセスする手段を提供します。 + +たとえば、入れ子構造を持つオブジェクト `obj` を考えましょう。オプショナルチェーン演算子なしで深い入れ子になったサブプロパティにアクセスするには、次のように、各プロパティ間の参照を確認する必要があります。 + +```js +let nestedProp = obj.first && obj.first.second; +``` + +`obj.first.second` の値にアクセスする前に、 `obj.first` の値が `null` または `undefined` でないことを確認します。これにより、 `obj.first` をテストせず `obj.first.second` にアクセスしたときに起きるエラーを防ぐことができます。 + +しかし、オプショナルチェーン演算子 (`?.`) を使えば、`obj.first.second` にアクセスしようとする前に `obj.first` の状態を明示的にテストする必要がなくなります。

+ +```js +let nestedProp = obj.first?.second; +``` + +`?.` を `.` の代わりに用いることで、 JavaScript が `obj.first.second` にアクセスしようとする前に `obj.first` が `null` または `undefined` でないことを暗黙的に確かめるようになります。`obj.first` が `null` または `undefined` であった場合、式が自動的に短絡され、 `undefined` が返ります。 + +これは、一時的な変数が作成されないことを除き、次の式と等価です。 + +```js +let temp = obj.first; +let nestedProp = ((temp === null || temp === undefined) ? undefined : temp.second); +``` + +### 関数呼び出しにおけるオプショナルチェーン演算子 + +存在しない可能性がある関数の呼び出しを試行するときに、オプショナルチェーンを使うことができます。これはたとえば、ユーザーの端末上で使えなかったり、実装が古かったりするために使えなかったりする可能性がある API を使うときに役立ちます。 + +関数呼び出しでオプショナルチェーン演算子を用いた場合、メソッドが見つからないときは自動的に `undefined` が返り、例外は発生しません。 + +```js +let result = someInterface.customMethod?.(); +``` + +> **Note:** 関数ではない名前のプロパティがあった場合、 `?.` を使用すると {{JSxRef("TypeError")}} 例外が発生します +> (`someInterface.customMethod is not a function`)。 + +> **Note:** `someInterface` 自体が `null` または `undefined` である場合にも、 {{JSxRef("TypeError")}} 例外が発生します (`someInterface is null`)。 `someInterface` 自体が `null` または `undefined` である可能性がある場合は、この位置にも `?.` を使用して `someInterface?.customMethod?.()` のようにする必要があります。 + +#### 省略可能なコールバックやイベントハンドラーの扱い + +

コールバックを使う場合や、オブジェクトからメソッドを分割代入を利用して取り出す場合に、存在しない値がある可能性があり、その存在を検証するまで関数として呼び出せません。その場合 `?.` を利用することで、検証の必要性を回避できます。 + +```js +// Written as of ES2019 +function doSomething(onContent, onError) { + try { + // ... do something with the data + } + catch (err) { + if (onError) { // Testing if onError really exists + onError(err.message); + } + } +} +``` + +```js +// Using optional chaining with function calls +function doSomething(onContent, onError) { + try { + // ... do something with the data + } + catch (err) { + onError?.(err.message); // no exception if onError is undefined + } +} +``` + +### オプショナルチェーン演算子と式の組み合わせ + +[プロパティアクセサーのブラケット表記法](/ja/docs/Web/JavaScript/Reference/Operators/Property_Accessors#bracket_notation)を使用している式のプロパティにアクセスする際にも、オプショナルチェーン演算子を使用することができます。 + +```js +let nestedProp = obj?.['prop' + 'Name']; +``` + +### オプショナルチェーン演算子は代入の左辺値では使用できない + +```js +let object = {}; +object?.property = 1; // Uncaught SyntaxError: Invalid left-hand side in assignment +``` + +### オプショナルチェーンによる配列要素へのアクセス + +```js +let arrayItem = arr?.[42]; +``` + +## 例 + +### 基本的な例 + +次の例では、マップに存在しない `bar` メンバの `name` プロパティを取得しようとしています。したがって、結果は `undefined` になります。 + +```js +let myMap = new Map(); +myMap.set("foo", {name: "baz", desc: "inga"}); + +let nameBar = myMap.get("bar")?.name; +``` + +### 短絡評価 + +式と一緒にオプショナルチェーン演算子を用いたとき、左側のオペランドが `null` または `undefined` である場合、その式は評価されなくなります。 + +```js +let potentiallyNullObj = null; +let x = 0; +let prop = potentiallyNullObj?.[x++]; + +console.log(x); // 0 となる。 x は加算されていない +``` + +### オプショナルチェーンをつなげて使う + +入れ子になったオブジェクトでは、オプショナルチェーン演算子を何度でも使うことができます。 + +```js +let customer = { + name: "Carl", + details: { + age: 82, + location: "Paradise Falls" // 詳細な住所は不明 + } +}; +let customerCity = customer.details?.address?.city; + +// … これはオプショナルチェーンの関数呼び出しでも動作します +let customerName = customer.name?.getName?.(); // メソッドが存在しないので、 customerName は undefined +``` + +### Null 合体演算子と共に使う + +{{JSxRef("Operators/Nullish_Coalescing_Operator", "Null 合体演算子", '', 1)}}はオプショナルチェーンの後につけることで、値が存在しなかったときの既定値を指定することができます。 + +```js +let customer = { + name: "Carl", + details: { age: 82 } +}; +const customerCity = customer?.city ?? "Unknown city"; +console.log(customerCity); // Unknown city +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- {{JSxRef("Operators/Nullish_Coalescing_Operator", "Null 合体演算子", '', 1)}} -- cgit v1.2.3-54-g00ecf From 93b4dd6b26fbce6f5e0c88f102da5b38e0289200 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 30 Aug 2021 00:24:16 +0900 Subject: Web/JavaScript/Reference/Operators/function* を更新 (#2180) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Markdown化し、2021/08/21時点の英語版に同期 --- .../reference/operators/function_star_/index.html | 86 ---------------------- .../reference/operators/function_star_/index.md | 73 ++++++++++++++++++ 2 files changed, 73 insertions(+), 86 deletions(-) delete mode 100644 files/ja/web/javascript/reference/operators/function_star_/index.html create mode 100644 files/ja/web/javascript/reference/operators/function_star_/index.md (limited to 'files/ja/web/javascript/reference/operators') diff --git a/files/ja/web/javascript/reference/operators/function_star_/index.html b/files/ja/web/javascript/reference/operators/function_star_/index.html deleted file mode 100644 index 3518adf63b..0000000000 --- a/files/ja/web/javascript/reference/operators/function_star_/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: function* 式 -slug: Web/JavaScript/Reference/Operators/function* -tags: - - ECMAScript6 - - Function - - Iterator - - JavaScript - - Operator - - Primary Expression - - 演算子 - - 関数 -translation_of: Web/JavaScript/Reference/Operators/function* ---- -

{{jsSidebar("Operators")}}
- -

function* キーワードは、式の中でジェネレーター関数を定義するために使用することができます。

- -
{{EmbedInteractiveExample("pages/js/expressions-functionasteriskexpression.html", "taller")}}
- - - -

構文

- -
function* [name]([param1[, param2[, ..., paramN]]]) {
-   statements
-}
- -

引数

- -
-
name {{optional_inline}}
-
関数名。省略可。省略した場合、関数は無名関数として認識されます。名前は関数本体のみにローカルです。
-
paramN  {{optional_inline}}
-
関数に渡される引数の名前。関数は最大 255 の引数を持ち得ます。
-
statements
-
関数の本体を構成するステートメント。
-
- -

解説

- -

function* 式は {{jsxref('Statements/function*', 'function* 文', "", 1)}}ととてもよく似ており、構文もほとんど同じです。function* 式と function* 文の主な違いは、function* 式で無名ジェネレーター関数を生成するには関数名が省略できる点です。詳細は {{jsxref("Functions", "functions")}} をご覧ください。

- -

例

- -

function* を使用する

- -

次の例では、無名ジェネレーター関数を定義し、x に割り当てます。関数は引数の二乗をもたらします:

- -
let x = function*(y) {
-   yield y * y;
-};
-
- -

仕様

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-generator-function-definitions', 'function*')}}
- -

ブラウザーの互換性

- -

{{Compat("javascript.operators.function_star")}}

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/operators/function_star_/index.md b/files/ja/web/javascript/reference/operators/function_star_/index.md new file mode 100644 index 0000000000..19a8d1404b --- /dev/null +++ b/files/ja/web/javascript/reference/operators/function_star_/index.md @@ -0,0 +1,73 @@ +--- +title: function* 式 +slug: Web/JavaScript/Reference/Operators/function* +tags: + - ECMAScript 2015 + - Function + - Iterator + - JavaScript + - Language feature + - Operator + - Primary Expression +browser-compat: javascript.operators.generator_function +translation_of: Web/JavaScript/Reference/Operators/function* +--- +{{jsSidebar("Operators")}} + +**`function*`** キーワードは、式の中でジェネレーター関数を定義するために使用することができます。 + +{{EmbedInteractiveExample("pages/js/expressions-functionasteriskexpression.html", + "taller")}} + +## 構文 + +```js +function* [name]([param1[, param2[, ..., paramN]]]) { + statements +} +``` + +### 引数 + +- `name` {{optional_inline}} + - : 関数名。省略可。省略した場合、関数は*無名関数*として認識されます。名前は関数本体のみにローカルです。 +- `paramN` {{optional_inline}} + - : 関数に渡される引数の名前。関数は最大 255 個の引数を持つことができます。 +- `statements` + - : 関数の本体を構成する文。 + +## 解説 + +`function*` 式は {{jsxref('Statements/function*', 'function* 文', "", 1)}}ととてもよく似ており、構文もほとんど同じです。`function*` 式と `function*` 文の主な違いは、`function*` 式で*無名*ジェネレーター関数を生成する場合は*関数名*が省略できる点です。詳細は {{jsxref("Functions", "functions")}} をご覧ください。 + +## 例 + +### function* の使用 + +次の例では、無名ジェネレーター関数を定義し、`x` に代入します。関数は引数の二乗を生成します。 + +```js +let x = function*(y) { + yield y * y; +}; +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- {{jsxref("Statements/function*", "function*")}} 文 +- {{jsxref("GeneratorFunction")}} オブジェクト +- [反復プロトコル](/ja/docs/Web/JavaScript/Reference/Iteration_protocols) +- {{jsxref("Operators/yield", "yield")}} +- {{jsxref("Operators/yield*", "yield*")}} +- {{jsxref("Function")}} オブジェクト +- {{jsxref("Statements/function", "function")}} 文 +- {{jsxref("Operators/function", "function")}} 式 +- {{jsxref("Functions_and_function_scope", "関数と関数スコープ", "", 1)}} -- cgit v1.2.3-54-g00ecf