summaryrefslogtreecommitdiff
path: root/node_modules/babel-plugin-transform-undefined-to-void/README.md
blob: 58989c65addb7d46f3d3bd067da6a91f30db7060 (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
# babel-plugin-transform-undefined-to-void

Some JavaScript implementations allow undefined to be overwritten, this may lead to peculiar bugs that are extremely hard to track down.

This plugin transforms `undefined` into `void 0` which returns undefined regardless of if it's been reassigned.

## Example

**In**

```javascript
foo === undefined;
```

**Out**

```javascript
foo === void 0;
```

## Installation

```sh
npm install babel-plugin-transform-undefined-to-void --save-dev
```

## Usage

### Via `.babelrc` (Recommended)

**.babelrc**

```json
{
  "plugins": ["transform-undefined-to-void"]
}
```

### Via CLI

```sh
babel --plugins transform-undefined-to-void script.js
```

### Via Node API

```javascript
require("@babel/core").transform("code", {
  plugins: ["transform-undefined-to-void"]
});
```