# Babel 노드 (Node.js) ✘

## @babel/node

[@babel/node](https://www.npmjs.com/package/@babel/node)는 Node.js 명령어 환경(CLI)과 동일하게 작동합니다. 다만 명령을 실행하기 전에 Babel 사전 설정(presets) 및 플러그인(plugins)을 사용해 컴파일 한 후, 코드를 실행한다는 점이 다릅니다.

{% hint style="warning" %}
Node.js 12 버전부터 ES 모듈을 (실험적으로) 지원 함에 따라 @babel/node 사용은 필요하지 않습니다.
{% endhint %}

## Node.js ES 모듈 <a href="#node-js-es-modules" id="node-js-es-modules"></a>

Node.js에서 ES 모듈을 사용하려면 파일 확장자를 `js` 대신 `mjs`를 사용하거나, `package.json` 파일에 `"type"`을 모듈(`module`)로 설정해 사용해야 합니다.

### mjs 확장자 <a href="#mjs-extension" id="mjs-extension"></a>

프로젝트에서 부분적으로 ES 모듈을 사용할 때 가장 쉽고 빠르게 적용할 수 있는 방법입니다.

```python
src/
├── ellipseText.mjs
└── index.mjs
```

{% tabs %}
{% tab title="src/index.mjs" %}

```javascript
import { ellipseText } from './ellipseText.mjs'

console.log(
  ellipseText(
    `Node.js 환경에서 ES 모듈을 사용하려면 mjs 확장자 또는 
     package.json에 type을 module로 설정해야 합니다.`
  )
)
```

{% endtab %}

{% tab title="src/ellipseText.mjs" %}

```javascript
export const ellipseText = (text, limit = 100) => `${text.slice(0, limit)}...`
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}

#### 모듈을 불러올 때 반드시 확장자 추가 필요

import 키워드로 모듈을 불러올 때 반드시 확장자까지 포함해서 경로를 명시를 해줘야 합니다. 이는 ES 표준 방식을 맞추기 위해 의도적으로 설계된 부분이기 때문입니다. (웹 브라우저도 동일하게 동작)
{% endhint %}

### module 타입 설정 <a href="#type-module" id="type-module"></a>

`package.json` 파일 설정을 통해 전체 파일에 적용하는 방법으로 모든 파일의 확장자를 일일이 `mjs`로 바꾸지 않고, 프로젝트 전체에 ES 모듈을 적용하고 싶을 때 적합한 방법입니다.

{% tabs %}
{% tab title="package.json" %}

```javascript
{
  "type": "module"
}
```

{% endtab %}
{% endtabs %}

`package.json` 타입 설정을 모듈로 변경하면 다시 `js` 확장자를 사용해 ES 모듈을 사용합니다.

{% tabs %}
{% tab title="src/index.js" %}

```javascript
import { ellipseText } from './ellipseText.js'

console.log(
  ellipseText(
    `Node.js 환경에서 ES 모듈을 사용하려면 mjs 확장자 또는 
     package.json에 type을 module로 설정해야 합니다.`
  )
)
```

{% endtab %}

{% tab title="src/ellipseText.js" %}

```javascript
export const ellipseText = (text, limit = 100) => `${text.slice(0, limit)}...`
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}

#### 실행 성공: 출력 메시지

(node:33561) ExperimentalWarning: The ESM module loader is experimental.&#x20;

Node.js 환경에서 ES 모듈을 사용하려면 mjs 확장자 또는 package.json에 type을 module로 설정...
{% endhint %}

{% hint style="danger" %}

#### 실행 실패: 출력 메시지

(node:32823) Warning: To load an **ES module, set "type": "module" in the package.json** or **use the .mjs extension.**

SyntaxError: Cannot use import statement outside a module
{% endhint %}

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

{% embed url="<https://babeljs.io/docs/en/babel-node>" %}


---

# 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://yamoo9.gitbook.io/webpack/babel/babel-node.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.