blob: 768c773716ddbaf22abaa2bf4e3f83e403412bf4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
---
title: Null 合体代入 (??=)
slug: Web/JavaScript/Reference/Operators/Logical_nullish_assignment
tags:
- 代入演算子
- JavaScript
- 言語機能
- 論理演算子
- 演算子
- Reference
browser-compat: javascript.operators.logical_nullish_assignment
translation_of: Web/JavaScript/Reference/Operators/Logical_nullish_assignment
---
{{jsSidebar("Operators")}}
Null 合体代入 (`x ??= y`) 演算子は、`x` が {{Glossary("nullish")}} (`null` または `undefined`) である場合にのみ代入を行います。
{{EmbedInteractiveExample("pages/js/expressions-logical-nullish-assignment.html")}}
## 構文
```js
expr1 ??= expr2
```
## 解説
### 短絡評価 (ショートサーキット)
[Null 合体演算子](/ja/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing_operator)は左から右に評価され、次のルールを使って短絡評価の可能性があるかどうかテストされます。
`(null や undefined ではない式) ?? expr` は、左辺が `null` でも `undefined` でもないことが証明されたら、左辺の式が短絡評価されます。
短絡評価とは、上記の `expr` 部分が**評価されない**ことを意味します。したがって、評価された場合の副作用は発生しません (例えば、`expr` が関数呼び出しである場合、呼び出しは行われません)。
Null 合体代入も短絡評価されます。これは、`x ??= y` が以下と等価であることを意味します。
```js
x ?? (x = y);
```
そして、常に代入が行われる以下と等価ではありません。
```js example-bad
x = x ?? y;
```
## 例
### Null 合体代入演算子の使用
```js
function config(options) {
options.duration ??= 100;
options.speed ??= 25;
return options;
}
config({ duration: 125 }); // { duration: 125, speed: 25 }
config({}); // { duration: 100, speed: 25 }
```
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}
## See also
- [Null 合体演算子 (`??`)](/ja/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing_operator)
- {{Glossary("Nullish")}}
- {{Glossary("Truthy", "真値")}}
- {{Glossary("Falsy", "偽値")}}
|
