> For the complete documentation index, see [llms.txt](https://yamoo9.gitbook.io/typescript/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yamoo9.gitbook.io/typescript/types/null-undefined.md).

# null / undefined 타입

## 설명 <a href="#desc" id="desc"></a>

JavaScript에서 **`null`, `undefined`는 데이터 타입 이자 하나의 값**입니다. **TypeScript에서도 하나의 타입**으로 처리 되며 다음과 같이 사용할 수 있습니다.

```typescript
let nullable:null = null;
let undefinedable:undefined = undefined;
```

하지만 `null`로 명시적 타입이 설정된 변수에 `null`이 아닌 값이 할당되면 다음과 같은 오류를 출력합니다.

```typescript
// [오류]
// [ts] 'undefined' 형식은 'null' 형식에 할당할 수 없습니다.
// let nullable: null
nullable = undefined;
```

이와 같이 엄격하게 오류를 출력하는 이유는 [`tsconfig.json`](/typescript/cli-env/tsconfig.md#tsconfig-json)에 다음과 같이 설정되어있기 때문입니다. 설정 값을 `false`로 설정할 경우 위와 같은 오류가 발생하지 않습니다.

```javascript
"strictNullChecks": true, /* 엄격한 null 검사 사용 */
```

참고로 `"strictNullChecks": true` 설정 시, 모든 데이터 타입은 `null`, `undefined`를 할당 받을 수 없습니다. 그러므로 아래와 같은 코드 구문은 오류를 출력합니다.

```typescript
// [오류]
// [ts] 'null' 형식은 'string' 형식에 할당할 수 없습니다.
// let assign_name: string
let assign_name:string = null;

if (!assign_name) {
  assign_name = '미네랄';
}
```

이 문제를 해결하려면 [애니](/typescript/types/any.md)(`any`) 또는 [유니온](/typescript/types/function-union-void.md)(`|`) 타입을 사용해야 합니다. 하지만 `any`를 사용하면 문자 타입으로 특정 짓는 것이 아니므로 유니온 타입을 사용하는 것이 보다 적절합니다.

```typescript
// let assign_name:any = null;
let assign_name:string|null = null;

if (!assign_name) {
  assign_name = '미네랄';
}
```

만약 아래와 같이 코드를 작성했을 때 `null`, `undefined`를 항상 서브 타입(Sub Type)으로 할당 가능하게 하려면, 즉 오류를 출력하지 않으려면 `tsconfig.json` 설정에서 `"strictNullChecks"` 값을 `false`로 설정하면 됩니다.

```javascript
// tsconfig.json
"strictNullChecks": false,
```

```typescript
// 오류가 출력되지 않습니다.
let assign_name:string = null;

if (!assign_name) {
  assign_name = '미네랄';
}
```

## 참고 <a href="#reference" id="reference"></a>

{% embed url="<https://www.typescriptlang.org/docs/handbook/basic-types.html#null-and-undefined>" %}
TypeScript - null / undefined 타입
{% endembed %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://yamoo9.gitbook.io/typescript/types/null-undefined.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.