# @types

[Definitely Typed](https://github.com/DefinitelyTyped/DefinitelyTyped) 는 타입스크립트의 가장 큰 장점 중 하나입니다. 커뮤니티는 효과적으로 자바스크립트 프로젝트의 거의 90%가 자연스럽게 진행되고 **문서화**되었습니다.

즉, 이러한 프로젝트를 상호적인 또는 탐색 방식으로 사용할 수 있으며 별도의 창에서 문서를 열 필요가 없으며 오타가 발생하지 않도록 해야 합니다.

## `@types` 사용

`npm`을 이용해서 꽤 간단하게 설치가 가능합니다. 예를 들어 `jquery`에 대한 타입 정의를 다음과 같이 간단히 할 수 있습니다.

```
npm install @types/jquery --save-dev
```

`@types`는 **전역** 과 **모듈** 타입 정의를 모두 지원합니다.

### 전역 `@types`

기본적으로 전역 소비를 지원하는 모든 정의가 자동으로 포함됩니다. 예: `jquery`의 경우 프로젝트 전역에서 `$`를 사용할 수 있어야 합니다.

그러나 `jquery`와 같은 라이브러리의 경우 일반적으로 모듈로 사용하는 걸 추천합니다.

### 모듈 `@types`

설치 후 특별한 구성이 필요하지 않습니다. 모듈처럼 사용하십시요. 아래 참고

```typescript
import * as $ from 'jquery'

// Use $ at will in this module :)
```

## 전역 통제

위에서 보듯이 전역 누출을 자동으로 허용하는 정의를 갖는 것은 일부 팀에게 문제가 될 수 있습니다. 따라서 **명쾌하게** 선택하면 `tsconfig.json` `compilerOptions.types` 를 사용하여 적합한 유형만 가져올 수 있습니다.

```javascript
{
    "compilerOptions": {
        "types": ["jquery"]
    }
}
```

위의 예제는 `jquery`만 사용할 수 있는 예제를 보여줍니다. 사용자가 `npm install @types/node`와 같은 다른 정의를 설치하더라도 (예: [`process`](https://nodejs.org/api/process.html)) 전역은 `tsconfig.json`에 types 옵션으로 추가할때 까지 코드에 누출되지 않습니다.


---

# Agent Instructions: 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:

```
GET https://radlohead.gitbook.io/typescript-deep-dive/type-system/types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.