모듈의 일반적 의미

모듈이란 애플리케이션을 구성하는 개별적 요소로서 재사용 가능한 코드 조각을 말한다. 일반적으로 모듈은 기능을 기준으로 파일 단위로 분리한다. 이때 모듈이 성립하려면 모듈은 자신만의 파일 스코프(모듈 스코프)를 가질 수 있어야 한다.

자신만의 파일 스코프를 갖는 모듈의 자산(모듈에 포함되어 있는 변수, 함수, 객체 등)은 기본적으로 비공개 상태다. 다시 말해, 자신만의 파일 스코프를 갖는 모듈의 모든 자산은 캡슐화되어 다른 모듈에서 접근할 수 없다. 즉, 모듈은 개별적 존재로서 애플리케이션과 분리되어 존재한다.

하지만 애플리케이션과 완전히 분리되어 개별적으로 존재하는 모듈은 재사용이 불가능하므로 존재의 의미가 없다. 모듈은 애플리케이션이나 다른 모듈에 의해 재사용되어야 의미가 있다. 따라서 모듈은 공개가 필요한 자산에 한정하여 명시적으로 선택적 공개가 가능하다. 이를 export라 한다.

공개된 모듈의 자산은 다른 모듈에서 재상용할 수 있다. 이때 공개된 모듈의 자산을 사용하는 모듈을 모듈 사용자라 한다. 모듈 사용자는 모듈이 공개한 자산 중 일부 또는 전체를 선택해 자신의 스코프 내로 불러들여 재사용할 수 있다. 이를 import 라 한다.

자바스크립트와 모듈

자바스크립트는 웹페이지의 단순한 보조 기능을 처리하기 위한 제한적인 용도를 목적으로 태어났다. 그래서 한계가 있는것이 사실이다. 대표적인 것이 모듈 시스템을 지원하지 않는다는 것이다.

자바스크립트 파일을 여러 개의 파일로 분리하여 script 태그로 로드해도 분리된 자바스크립트 파일들은 결국 하나의 자바스크립트 파일 내에 있는 것처럼 동작하낟. 즉, 모든 자바스크립트 파일ㅇ느 하나의 전역을 공유하ㅓㄴ다.

자바스크립트를 브라우저 환경에 국한하지 않고 범용적으로 사용하려고 하면서 모듈 시스템을 만들게 되었다.

자바스크립트의 모듈 시스템은 크게 CommonJS와 AMD(Asynchronous Moudle Definition)으로 나뉘었다.

자바스크립트 런타임 환경인 Node.js는 모듈 시스템의 사실상 표준인 CommonJS를 채택했다. 즉, Node.js는 ECMAScript 표준 사양은 아니지만 모듈 시스템을 지원한다. 따라서 Node.js 환경에서는 파이별로 독립적인 파일 스코프를 갖는다.

ES6 모듈

일반적인 자바스크립트 파일이 아닌 ESM임을 명확히 하기 위해 ESM 파일 확장자는 mjs를 사용할 것을 권장한다.

export 키워드

모듈은 독자적인 모듈 스코프를 갖는다. 따라서 모듈 내부에서 선언한 모든 식별자는 기본적으로 해당 모듈 내부에서만 참조할 수 있다. 모듈 내부에서 선언한 식별자를 외부에 공개하여 다른 모듈들이 재사용할 수 있게 하려면 export 키워드를 사용한다.

export 키워드는 선언문 앞에 사용한다. 이로써 변수, 함수, 클래스 등 모든 식별자를 export 할 수 있다.

// lib.mjs
// 변수의 공개
export const pi = Math.PI;

// 함수의 공개
export funciton square(x) {
  return x * x;
}

// 클래스의 공개
export class Person {
  constructor(name) {
    this.name = name;
  }
}

선언문 앞에 export 키워드를 붙이는 것이 번거롭다면 export 할 대상을 하나의 객체로 구성하여 한번에 export 할 수도 있다.

// lib.mjs
const pi = Math.PI;


funciton square(x) {
  return x * x;
}

class Person {
  constructor(name) {
    this.name = name;
  }
}

export {pi, square, Person};

import 키워드

다른 모듈에서 공개한 식별자를 자신의 코듈 스코프 내부로 로드하려면 import 키워드를 사용한다. 다른 모듈이 export한 식별자 이름으로 import 해야하며 ESM의 경우 파일 확장자를 생략할 수 없다.

// app.mjs
// 같은 폴더 내의 lib.mjs 모듈이 export한 식별자 이름으로 import 한다
// ESM의 경우 파일 확장자를 생략할 수 없다.
import {pi, square, Person} from './lib.mjs';

console.log(pi); // 3.141592..
console.log(lib.square(10)); // 100
console.log(new lib.Person('Lee')); // Person {name: 'Lee'}

// app.mjs
import * from './lib.mjs';

console.log(pi); // 3.141592..
console.log(lib.square(10)); // 100
console.log(new lib.Person('Lee')); // Person {name: 'Lee'}

// app.mjs
// lib.mjs 모듈이 expor한 식별자 이름을 변경하여 import 한다. 
import {pi as PI, square as sq, Person as P} from './lib.mjs';

console.log(PI); // 3.141592..
console.log(sq(10)); // 100
console.log(new P('Lee')); // Person {name: 'Lee'}