> For the complete documentation index, see [llms.txt](https://anjia1.gitbook.io/web/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anjia1.gitbook.io/web/js/data-type/primitive-value.md).

# 原始值

在 JavaScript 中，原始值是指不是对象也没有方法的数据。

* primitive value，原始值，ECMAScript 规范里出现的频次较高 \~ `data value`
* primitive data type，原始数据类型 \~ 原始类型，简称类型 \~ `data type`
* primitive 原语。大约是原始值和原始类型的统称，具体看上下文

## 7个原始值

JavaScript 有 7 个原始值，分别对应 7 个原始类型。其中，除了 Undefined 和 Null 之外，其它数据类型都有一个等价的对象包装器，包装器的 `valueOf()` 方法会返回原始值。

| Primitive Value | Primitive Type | Object  |
| --------------- | -------------- | ------- |
| undefined       | Undefined      | -       |
| null            | Null           | -       |
| Boolean         | Boolean        | Boolean |
| String          | String         | String  |
| Number          | Number         | Number  |
| BigInt          | BigInt         | BigInt  |
| Symbol          | Symbol         | Symbol  |

## 理解原始值

很多时候，在语言实现的最底层，原始值都是直接表示的。

### 不可变

所有的原始值都是不可变的——不能被改变。

> Primitive values are immutable.

```javascript
// 使用字符串方法，不会改变字符串本身
let foo = 'JavaScript';
console.log(foo);    // JavaScript
foo.toUpperCase();  // JAVASCRIPT
console.log(foo)    // JavaScript
```

### 原始值 vs 变量

在动态语言里，值是有类型的，但是变量没有（类型）。

切记，不要混淆原始值本身和分配了原始值的变量。变量是可以被重新分配新值的，而已经存在的原始值是不能被修改的。如下：

```javascript
// 给变量重新赋一个“新”值，而不是“突变/变异”值（mutated 生物学术语）
let foo = 'JavaScript';
foo = foo.toUpperCase();
console.log(foo);  // JAVASCRIPT
```

### 原始值 vs 对象

对象、数组和函数的值之所以能被修改，是因为它们不是原始值。

如前所述“原始值是指不是对象也没有方法的数据”。举个例子感受下原始值和对象的不同，如下：

```javascript
// 在 JavaScript 中，数组和函数都是对象
let bar = [];
console.log(bar);  // []
bar.push('JavaScript'); // push() 会改变数组本身
console.log(bar);  // ["JavaScript"]
```

## 总结

这部分列出了 JavaScript 里的 7 个原始值，并着重介绍了原始值的不可变性、原始值和变量的区别，以及原始值和对象的区别。

## 主要参考

* <https://developer.mozilla.org/en-US/docs/Glossary/primitive>
* <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures>
* <https://tc39.es/ecma262/multipage/ecmascript-data-types-and-values.html>