docs: 모듈

Next-by-Next · Jan 24, 2024 · dfda5bf · dfda5bf
1 parent 65ce9e5
commit dfda5bf
Showing 1 changed file with 187 additions and 0 deletions.
diff --git a/docs/48_모듈/문소희.md b/docs/48_모듈/문소희.md
@@ -0,0 +1,187 @@
+# 🚀 모듈
+
+## 🔎 1. 모듈의 일반적 의미
+
+> 모듈<sup>module</sup>이란 애플리케이션을 구성하는 개별적 요소로서 _재사용 가능한 코드 조각을 말한다._ 일반적으로 모듈은 기능을 기준으로 파일 단위로 분리하는데, 모듈이 성립하려면 모든 모듈은 자신만의 **파일 스코프<sup>모듈 스코프</sup>를** 가질 수 있어야 한다.
+
+자신만의 파일 스코프를 갖는 모듈의 모든 자산<sup>모듈에 포함되어 있는 변수, 함수, 객체 등</sup>은 캡슐화되어 다른 모듈에서 접근할 수 없다. 즉, _모듈은 개별적 존재로서 애플리케이션과 분리되어 존재한다._ 하지만 모듈은 애플리케이션이나 다른 모듈에 의해 재사용되어야 의미가 있으므로 **공개가 필요한 자산에 한정하여 명시적으로 선택적 공개가 가능하다. 이를 export라고 한다.**
+
+공개<sup>export</sup>된 모듈의 자산은 다른 모듈에서 재사용 가능하며, 이를 사용하는 모듈을 모듈 사용자<sup>module consumer</sup>라고 한다. **모듈 사용자는 모듈이 공개<sup>export</sup>한 자산 중 일부 또는 전체를 선택해 자신의 스코프 내로 불러들여 재사용할 수 있는데, 이를 import라 한다.**
+
+모듈을 사용하면 _코드 단위를 명확히 분리해 애플리케이션을 구성할_ 수 있으며 재사용성이 좋아 개발 효율성과 유지보수성을 높일 수 있다.
+
+## 🔎 2. 자바스크립트와 모듈
+
+> 클라이언트 사이드 자바스크립트는 script 태그를 사용해 외부의 자바스크립트 파일을 로드할 수는 있지만 _파일마다 독립적인 파일 스코프를 갖지 않는다._
+
+자바스크립트 파일을 여러 개의 파일로 분리해 script 태그로 로드해도 분리된 자바스크립트 파일들은 결국 하나의 자바스크립트 파일 내에 있는 것처럼 동작한다. _즉, 모든 자바스크립트 파일을 하나의 전역을 공유하기 때문에 분리된 자바스크립트 파일들의 전역 변수가 중복되는 등의 문제가 발생할 수 있어_ 이것으로는 모듈을 구현할 수 없다.
+
+자바스크립트를 클라이언트 사이드, 즉 브라우저 환경에 국한하지 않고 범용적으로 사용하려는 움직임이 생기면서 제안된 것이 CommonJS와 AMD<sup>Asynchronous Module Definition</sup>다.
+
+자바스크립트 런타임 환경인 `Node.js`는 모듈 시스템의 CommonJS를 채택해 완전히 동일하지는 않지만 기본적으로 CommonJS 사양을 따르고 있다. 즉, ECMAScript 표준 사양은 아니지만 모듈 시스템을 지원해 파일별로 독립적인 파일 스코프<sup>모듈 스코프</sup>를 가진다.
+
+## 🔎 3. ES6 모듈 (ESM)
+
+> ES6에서는 클라이언트 사이드 자바스크립트에서도 동작하는 모듈 기능을 추가했다. script 태그에 `type="module"` 어트리뷰트를 추가하면 로드된 자바스크립트 파일은 모듈로서 작동한다.
+
+일반적인 자바스크립트 파일이 아닌 ESM임을 명확히 하기 위해 파일 확장자는 mjs를 권장한다. ESM에는 클래스와 마찬가지로 기본적으로 strict mode가 적용된다.
+
+```html
+<script type="module" src="app.mjs"></script>
+```
+
+### 💬 1. 모듈 스코프
+
+> ESM은 독자적인 모듈 스코프를 갖는다.
+
+일반적인 자바스크립트 파일은 script 태그로 분리해서 로드해도 독자적인 모듈 스코프를 갖지 않는다. script 태그로 분리해서 로드된 2개의 자바스크립트 파일은 하나의 자바스크립트 파일 내에 있는 것처럼 동작해 하나의 전역을 공유한다. 즉, x 변수는 중복 선언되며 의도치 않게 덮어써지는 것이다. 🚨
+
+```javascript
+// foo.js
+var x = 'foo';
+console.log(window.x); // foo
+```
+
+```javascript
+// bar.js
+var x = 'bar';
+console.log(window.x); // bar (재할당)
+```
+
+```html
+<!doctype html>
+<html lang="ko">
+  <body>
+    <script src="foo.js"></script>
+    <script src="bar.js"></script>
+  </body>
+</html>
+```
+
+ESM은 파일 자체의 독자적인 모듈 스코프를 제공하므로 모듈 내에서 var 키워드로 선언한 변수는 더는 전역 변수가 아니며 window 객체의 프로퍼티도 아니다. 또한 모듈 내에서 선언한 식별자는 모듈 스코프가 다르기 때문에 모듈 외부에서 참조할 수 없다.
+
+```mjs
+// foo.mjs
+var x = 'foo';
+var y = 'test';
+
+console.log(x); // foo
+console.log(window.x); // undefined
+```
+
+```mjs
+// bar.mjs
+var x = 'bar'; // foo.mjs에서 선언한 x 변수와 스코프가 다른 변수
+
+console.log(x); // bar
+console.log(window.x); // undefined
+
+console.log(y); // ReferenceError: y is not defined
+```
+
+```html
+<!doctype html>
+<html lang="ko">
+  <body>
+    <script type="module" src="foo.mjs"></script>
+    <script type="module" src="bar.mjs"></script>
+  </body>
+</html>
+```
+
+### 💬 2. export 키워드
+
+> 모듈 내부에서 선언한 식별자를 외부에 공개하여 다른 모듈들이 재사용할 수 있게 하려면 export 키워드를 사용한다. 선언문 앞에 사용함으로써 변수, 함수, 클래스 등 모든 식별자를 export할 수 있다.
+
+```mjs
+// lib.mjs
+export const pi = Math.PI; // 변수의 공개
+
+// 함수의 공개
+export function square(x) {
+  return x * x;
+}
+
+// 클래스의 공개
+export class Person {
+  constructor(name) {
+    this.name = name;
+  }
+}
+```
+
+export할 대상을 하나의 객체로 구성하여 한 번에 export할 수도 있다.
+
+```mjs
+const pi = Math.PI;
+
+function square(x) {
+  return x * x;
+}
+
+class Person {
+  constructor(name) {
+    this.name = name;
+  }
+}
+
+export { pi, square, Person };
+```
+
+### 💬 3. import 키워드
+
+> 다른 모듈에서 공개한 식별자를 자신의 모듈 스코프 내부로 로드하려면 import 키워드를 사용한다. 다른 모듈이 export한 식별자 이름으로 import해야 하며 _ESM의 경우 파일 확장자를 생략할 수 없다._
+
+아래 예제의 `app.mjs`는 애플리케이션의 진입점이므로 반드시 script 태그로 로드해야 하지만, `lib.mjs`는 `app.mjs`의 import 문에 의해 로드되는 의존성이므로 script 태그로 로드하지 않아도 된다.
+
+```mjs
+import { pi, square, Person } from './lib.mjs';
+
+console.log(pi); // 3.141592653589793
+console.log(square(10)); // 100
+console.log(new Person('Lee')); // Person { name: "Lee" }
+```
+
+```html
+<!doctype html>
+<html lang="ko">
+  <body>
+    <script type="module" src="app.mjs"></script>
+  </body>
+</html>
+```
+
+하나의 이름으로 한 번에 import할 수도 있다. 이때 import되는 식별자는 as 뒤에 지정한 이름의 객체에 프로퍼티로 할당된다. 또한 모듈이 export한 식별자 이름을 변경해 import할 수도 있다.
+
+```mjs
+import * as lib from './lib.mjs';
+// import { pi as PI, square as sq, Person as P } from './lib.mjs';
+
+console.log(lib.pi); // 3.141592653589793
+console.log(lib.square(10)); // 100
+console.log(new lib.Person('Lee')); // Person { name: "Lee" }
+```
+
+모듈에서 하나의 값만 export한다면 default 키워드를 사용할 수 있으며, 사용하는 경우 기본적으로 이름 없이 하나의 값을 export한다. 단, default 키워드를 사용하는 경우 var, let, const 키워드는 사용할 수 없다.
+
+```mjs
+// lib.mjs
+export default (x) => x * x;
+
+export default const foo = () => {};
+// => SyntaxError: Unexpected token 'const'
+// export default () => {};
+```
+
+default 키워드와 함께 export한 모듈은 {} 없이 임의의 이름으로 import한다.
+
+```mjs
+// app.mjs
+import square from './lib.mjs';
+
+console.log(square(3)); // 9
+```
+
+## 👀 REFERENCE
+
+모던 자바스크립트 Deep Dive 48장 모듈