[노드 2] 3장. 노드 기능 알아보기 (1)

 

🌟3장(1) 키워드🌟

REPL

js 파일 실행하기

노드 모듈; CommonJS 모듈, ECMAScript 모듈

노드 내장 객체

 

 

3.1 REPL 사용하기

js는 스크립트 언어 (컴파일 불필요)
Read Eval Print Loop
입력한 코드를 읽고, 해석하고, 결과물을 반환하고, 종료할 때까지 반복한다

터미널에서 node 명령 입력 시
> 모양의 프롬프트
js 코드 입력 가능

 

 

3.2 JS 파일 실행하기

js 파일을 만들어 실행

function helloWorld() {
    console.log('Hello World');
    helloNode();
  }
  
  function helloNode() {
    console.log('Hello Node');
  }
  
  helloWorld();

 

node 명령어로 파일 실행(.js 확장자 생략 가능)

 

3.3 모듈로 만들기

모듈: 특정한 기능을 하는 함수나 변수들의 집합

• 모듈은 그 자체로도 하나의 프로그램이면서 다른 프로그램의 부품으로 사용/재사용 가능
• 보통 파일 하나 단위로 모듈 하나를 만듦

노드에서 사용하는 두 가지 모듈 형식

• CommonJS 모듈
• ECMAScript 모듈

1) CommonJS 모듈

• js 표준이 나오기 이전부터 사용됨. 이후로도 노드 생태계에서 가장 널리 쓰임.

// func.js

const { odd, even } = require('./var');

function checkOddOrEven(num) {
    if (num % 2) { // 홀수이면
        return odd;
    }
    return even;
}

module.exports = checkOddOrEven;

// index.js

const { odd, even } = require('./var');
const checkNumber = require('./func');

function checkStringOddOrEven(str) {
    if (str.length % 2) {  // 글자수가 홀수이면
        return odd;
    }
    return even;
}

console.log(checkNumber(10));
console.log(checkStringOddOrEven('hello'));

 

module 객체 대신 exports 객체 사용하기

• module.exports === exports 같은 객체를 참조하는 이름이다!

// var2.js
exports.odd = 'CommonJS 홀수입니다';
exports.even = 'CommonJS 짝수입니다';

 

유의사항

• 두 객체 간의 참조 관계가 깨지지 않도록 해야 함!
• module.exports에는 어떤 값이든 대입 가능
• exports에는 반드시 객체처럼 exports.속성명=속성값 형태로 대입 (다른 값 대입 시 참조 관계가 끊겨 더는 모듈로 기능하지 않음)

[Note] 노드에서의 this

• 최상위 스코프에 존재하는 this는 module.exports(또는 export 객체)를 가리킴
• 함수 선언문 내부의 this는 global 객체(3.4.1절)를 가리킴

require

• require는 함수이고, 함수는 객체이므로 (!!) require는 객체로서 속성을 몇 개 가지고 있음
• require.cache : 한 번 require한 파일이 저장되는 곳
• require.main : 노드 실행 시 첫 모듈을 가리킴.
• 아래 콘솔에서 node require 실행했으므로 require.js가 require.main이 됨

console.log('require가 가장 위에 오지 않아도 됩니다.');

module.exports = '저를 찾아보세요.';

require('./var');

console.log('require.cache입니다.');
console.log(require.cache);
console.log('require.main입니다.');
console.log(require.main === module);
console.log(require.main.filename);

 

모듈 사용 시 주의 - dep1과 dep2가 서로를 require한다면?

// dep1.js
const dep2 = require('./dep2');
console.log('require dep2', dep2);
module.exports = () => {
  console.log('dep2', dep2);
};

// dep2.js
const dep1 = require('./dep1');
console.log('require dep1', dep1);
module.exports = () => {
  console.log('dep1', dep1);
};

//dep-run.js
const dep1 = require('./dep1');
const dep2 = require('./dep2');

dep1();
dep2();

node dep-run 실행 결과

• 이처럼 순환 참조 발생 시 module.exports 함수가 비어있는 객체로 변함!
• 순환 참조가 일어나지 않도록 구조를 잘 잡는 것이 중요...

 

2) ECMAScript 모듈

• 공식적인 JS 모듈 형식

다른 부분

• require (함수) → import (문법)
• exports (객체) → export (문법)
• module.exports (객체) → export default (문법)

// var.mjs
export const odd = 'MJS 홀수입니다';
export const even = 'MJS 짝수입니다';

// func.mjs
import { odd, even } from './var.mjs';

function checkOddOrEven(num) {
  if (num % 2) { // 홀수면
    return odd;
  }
  return even;
}

export default checkOddOrEven;

// index.mjs
import { odd, even } from './var.mjs';
import checkNumber from './func.mjs';

function checkStringOddOrEven(str) {
  if (str.length % 2) { // 홀수면
    return odd;
  }
  return even;
}

console.log(checkNumber(10));
console.log(checkStringOddOrEven('hello'));

+) 다이내믹 임포트

• 조건부로 모듈을 불러오는 것
• CommonJS 모듈에서는 가능, ES 모듈에서는 불가능

// dynamic.js
const a = false;
if (a) {
    require('./func');  // 실행되지 않음
}
console.log('성공');

// dynamic.mjs
const a = false;
if (a) {
    import './func.mjs';  // ES 모듈은 if문 안에서 import 불가
}
console.log('성공');

• 다이내믹 임포트를 가능하게 하기 위해 다음과 같이 수정
• import 문법 대신 import() 함수 사용
• ES 모듈의 최상위 스코프에서는 async 함수 없이도 await 가능

// dynamic.mjs
const a = true;
if (a) {
    const m1 = await import('./func.mjs');
    console.log(m1);
    const m2 = await import('./var.mjs');
    console.log(m2);
}

+) __filename, __dirname

실행 시 현재 파일명, 현재 파일 경로로 바뀜

// filename.js
console.log(__filename);
console.log(__dirname);

• ES 모듈에서는 __filename, __dirname 사용 불가, 대신 import.meta.url로 경로 가져올 수 있음

// filename.mjs
console.log(import.meta.url);
console.log('__filename은 에러');
console.log(__filename);

 

3.4 노드 내장 객체 알아보기

1) global

• 브라우저의 window와 같은 전역 객체
• 매우 많은 속성을 포함함 (확인하려면 REPL(콘솔) 이용)

 

// globalA.js
module.exports = () => global.message;

// globalB.js
const A = require('./globalA');

global.message = '안녕하세요';
console.log(A());

globalB에서 넣은 global.message 값을 globalA에서도 접근 가능

 

2) console

로깅 함수 종류

• console.time(레이블) : console.timeEnd(레이블)과 대응되어 같은 레이블을 가진 time과 timeEnd 사이의 시간을 측정
• console.log(내용) : 평범한 로그를 콘솔에 표시. console.log(내용, 내용, ...) 처럼 여러 내용을 동시에 표시 가능
• console.error(에러 내용) : 에러를 콘솔에 표시
• console.table(배열) : 배열의 요소로 객체 리터럴을 넣으면, 객체의 속성들이 테이블 형식으로 표현됨
• console.dir(객체, 옵션) : 객체를 콘솔에 표시할 때 사용. 첫 번째 인수로 표시할 객체를 넣고, 두 번째 인수로 옵션을 넣음. colors=true로 하면 콘솔에 색이 추가됨, depth는 객체 안의 객체를 몇 단계까지 보여줄지 결정, 기본값은 2
• console.trace(레이블) : 에러가 어디에서 발생했는지 추적할 수 있게 함. 에러 발생 위치가 나오지 않는 경우 쓸만함!

const string = 'abc';
const number = 1;
const boolean = true;
const obj = {
  outside: {
    inside: {
      key: 'value',
    },
  },
};
console.time('전체시간');
console.log('평범한 로그입니다 쉼표로 구분해 여러 값을 찍을 수 있습니다');
console.log(string, number, boolean);
console.error('에러 메시지는 console.error에 담아주세요');

console.table([{ name: '제로', birth: 1994 }, { name: 'hero', birth: 1988}]);

console.dir(obj, { colors: false, depth: 2 });
console.dir(obj, { colors: true, depth: 1 });

console.time('시간측정');
for (let i = 0; i < 100000; i++) {}
console.timeEnd('시간측정');

function b() {
  console.trace('에러 위치 추적');
}
function a() {
  b();
}
a();

console.timeEnd('전체시간');

3) 타이머

타이머 설정 함수

• setTimeout(콜백함수, 밀리초) : 밀리초 후 콜백함수 실행
• setInterval(콜백함수, 밀리초) : 밀리초마다 콜백함수 반복 실행
• setImmediate(콜백함수) : 콜백함수 즉시실행

타이머 취소 함수

• clearTimeout(아이디)
• clearInterval(아이디)
• clearImmediate(아이디)

// timer.js

const timeout = setTimeout(() => {
  console.log('1.5초 후 실행');
}, 1500);

const interval = setInterval(() => {
  console.log('1초마다 실행');
}, 1000);

const timeout2 = setTimeout(() => {
  console.log('실행되지 않습니다');
}, 3000);

setTimeout(() => {
  clearTimeout(timeout2);
  clearInterval(interval);
}, 2500);

const immediate = setImmediate(() => {
  console.log('즉시 실행');
});

const immediate2 = setImmediate(() => {
  console.log('실행되지 않습니다');
});

clearImmediate(immediate2);

Promise 기반 타이머 (노드 내장 모듈)

• setInterval(밀리초, 시작값)은 for await of 문법과 함께 사용 가능

// timerPromise.js
import { setTimeout, setInterval } from 'timers/promises';

await setTimeout(3000);
console.log('3초뒤 실행');

for await (const startTime of setInterval(1000, Date.now())) {
    console.log('1초마다 실행', new Date(startTime));
}

4) process

process 객체: 현재 실행되고 있는 노드 프로세스에 대한 정보를 담고 있음
REPL에 입력해 확인 가능

process.env

환경 변수 확인 명령
process.env에 환경 변수를 등록하는 방법은 6.2절 dotenv 사용법 참조

process.nextTick(콜백)

• 이벤트 루프가 다른 콜백 함수들보다 nextTick의 콜백 함수를 우선으로 처리하도록 만듦
• resolve된 Promise도 다른 콜백들보다 우선시 됨

// nextTick.js
setImmediate(() => {
  console.log('immediate');
});
process.nextTick(() => {
  console.log('nextTick');
});
setTimeout(() => {
  console.log('timeout');
}, 0);
Promise.resolve().then(() => console.log('promise'));

process.exit(코드)

실행 중인 노드 프로세스 종료

• process.exit() 정상 종료
• process.exit(0) 정상 종료
• process.exit(1) 비정상 종료

5) 기타 내장 객체

• URL, URLSearchParams : 3.5절
• AbortController, FormData, fetch, Headers, Request, Response, Event, EventTarget: 브라우저에서 사용하던 API가 노드에도 동일하게 있음
• TextDecoder : Buffer를 문자열로 바꿈
• TextEncoder: 문자열을 Buffer로 바꿈
• WebAssembly : 웹어셈블리 처리를 담당

---

Quiz.

빈칸 문제 (빈칸 드래그 시 정답 표시)

1. CommonJS 모듈 형식에서, module.exports와 (exports)는 동일한 객체를 가리킨다.
2. exports에는 반드시 (객체처럼 exports.속성명=속성값)형태로 대입하여 참조 관계가 끊기지 않도록 유의한다.
3. 노드에서의 this: 최상위 스코프에 존재하는 this는 module.exports를 가리킨다.
   함수 선언문 내부의 this는 (global 객체)를 가리킨다.
   https://www.zerocho.com/category/NodeJS/post/5b67e8607bbbd3001b43fd7b
4. 모듈 순환 참조가 발생하면 (module.exports 함수)가 (비어있는 객체)로 조용히 변한다. 순환 참조가 일어나지 않도록 구조를 잘 잡는 것이 중요하다.
5. ECMAScript 모듈은 공식적인 모듈 형식으로, CommonJS의 require, exports, module.exports 대신 (import, export, export default)를 사용한다. 모듈을 내보내고 불러오는 방식이 객체를 통한 방법에서 (문법)으로 바뀌었다는 차이가 있다.
6. 다이내믹 임포트는 기본적으로 (CJS)에서 사용 가능하고, (ES 모듈)에서는 불가능하다. (ES 모듈)에서 이를 가능하게 하려면 (import)대신 (import())를 사용해야 한다.
7. 이벤트 루프에서, (process.nextTick(콜백))과 (resolve된 Promise)는 다른 콜백 함수들보다 우선으로 처리된다.

코드 문제

 

1. 다음 CommonJS 모듈을 EMCAScript 모듈 형식으로 변경하세요.

 

// var.js

const odd = 'CommonJS 홀수입니다';
const even = 'CommonJS 짝수입니다';

module.exports = {
    odd,
    even,
};

// func.js

const { odd, even } = require('./var');

function checkOddOrEven(num) {
    if (num % 2) { // 홀수이면
        return odd;
    }
    return even;
}

module.exports = checkOddOrEven;

// index.js

const { odd, even } = require('./var');
const checkNumber = require('./func');

function checkStringOddOrEven(str) {
    if (str.length % 2) {  // 글자수가 홀수이면
        return odd;
    }
    return even;
}

console.log(checkNumber(10));
console.log(checkStringOddOrEven('hello'));

 

// var.mjs
export const odd = 'MJS 홀수입니다';
export const even = 'MJS 짝수입니다';

// func.mjs
import { odd, even } from './var.mjs';

function checkOddOrEven(num) {
  if (num % 2) { // 홀수면
    return odd;
  }
  return even;
}

export default checkOddOrEven;

// index.mjs
import { odd, even } from './var.mjs';
import checkNumber from './func.mjs';

function checkStringOddOrEven(str) {
  if (str.length % 2) { // 홀수면
    return odd;
  }
  return even;
}

console.log(checkNumber(10));
console.log(checkStringOddOrEven('hello'));

 

 

2. 다음 코드의 출력을 예상하세요.

// timer.js

const timeout = setTimeout(() => {
  console.log('1.5초 후 실행');
}, 1500);

const interval = setInterval(() => {
  console.log('1초마다 실행');
}, 1000);

const timeout2 = setTimeout(() => {
  console.log('실행되지 않습니다');
}, 3000);

setTimeout(() => {
  clearTimeout(timeout2);
  clearInterval(interval);
}, 2500);

const immediate = setImmediate(() => {
  console.log('즉시 실행');
});

const immediate2 = setImmediate(() => {
  console.log('실행되지 않습니다');
});

clearImmediate(immediate2);

즉시 실행

1초마다 실행

1.5초 후 실행

1초마다 실행

---

출처: 조현영, 『Node.js 교과서』 개정판 3판, 길벗(2022), 3-1~3-4장.

Node.js #2 

Editor : 유즈