Node.js

JavaScript 런타임
{{{#!wiki style="margin: 0 -10px;" {{{#!folding [ 주요 런타임 ] {{{#!wiki style="margin-bottom: -15px;"

<colbgcolor=#ffffff,#1f2023><colcolor=#3E863D,#5DAD47> Node.js®
종류	JavaScript 런타임(실행 환경)
개발	Node.js contributors
버전	22.12.0 (LTS) 2024년 12월 3일 업데이트
	23.4.0 (Current) 2024년 12월 10일 업데이트
공개일	2009년 5월 27일
라이선스	MIT 라이선스
|

1. 개요

2. 사용해 보기

2.1. 설치

2.1.1. NVM을 이용한 설치

#!syntax sh
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
$ wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

#!syntax sh
$ nvm install 20.18.0 # 예시로 20.18.0 버전의 node와 그에 맞는 npm 설치
$ nvm use 20.18.0 # 해당 버전 활성화

2.1.2. 리눅스에서 패키지 매니저를 이용한 설치

#!syntax sh
$ curl -sL https://deb.nodesource.com/setup_[메이저 버전].x | sudo -E bash -
$ sudo apt-get install -y nodejs

#!syntax sh
$ curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
$ sudo apt-get install -y nodejs

2.2. Hello, World!

【HTTP(웹)로 Hello, World! 출력하기】

Node.js가 설치된 상태에서 아무 에디터나 띄우고 다음과 같이 코드를 붙여넣는다. 이때 주의할 점은 메모장을 쓴다면 저장 시 인코딩을 UTF-8로 저장해야 한다.[6]

#!syntax javascript
import http from 'http';

http.createServer((req, res) => {
  res.end('Hello, World!');
}).listen(8080, () => {
  console.log('서버 실행중.');
})

저장하고 터미널 등에서 'node filename'[7]이라고 입력해 주고 나서, 역시 아무 브라우저나 켜고 localhost:8080으로 들어가면 아마 ' Hello, world!'라고 뜰 것이다.

JavaScript에 익숙하지 않고 프로그래밍을 처음 시작하는 입문자의 경우 사실 Hello, World!부터 복잡해 보이긴 하다. 때문에 Hello, World! 예제를 조금 풀어서 설명해 보자면 다음과 같다.

• #!syntax javascript import http from 'http';Node의 대부분의 기능은 '모듈'이라고 하는 외부 애플리케이션 혹은 라이브러리를 통해 제공된다. 이 코드는 그런 모듈들 중 가장 기본적인 HTTP 모듈을 로드해서 로컬 상수에 할당하는 코드이다. 사실상 별도의 프레임워크를 사용하지 않는다면 대부분 이 코드로 시작하게 된다. 참고로 한번 할당하고 굳이 치환하지 않는 경우에는 var 대신 const 키워드를 쓴다. 변수 접근에 불필요한 인덱싱을 완화하기 위함이다.
• #!syntax javascript http.createServer((req, res) => { /* 함수 내용 */ })createServer 메소드로 새로운 서버를 생성하였으며 이때 매개 변수로 아무런 이름이 없는 익명 함수가 전달된다. 이 익명 함수에 전달되는 두 개의 매개 변수는 각각 서버 요청(req)과 서버 응답(res)를 의미한다. 0.x 버전을 사용 중인 경우 function(req, res) { ... } 를 사용해야 한다.
• #!syntax javascript res.end('Hello, World!\n');end 메서드로 통신의 종료를 알린다. end 메서드는 문자열뿐만 아니라 버퍼가 될 수 있는 데이터 청크도 넣을 수 있다. 또한 문자열의 경우 두 번째 매개 변수로 문자열의 인코딩을 지정할 수 있다. 기본값은 UTF-8이므로 이외의 인코딩을 써줘야 할 경우에만 입력하면 된다.
• #!syntax javascript /* http.createServer 함수의 반환값 */.listen(8080, '127.0.0.1');createServer와 이에 매개 변수로 전달된 익명 함수를 종결하고 listen 메서드로 해당 포트(8080)로 들어오는 연결들을 대기한다. 이때 listen 메서드는 반드시 생성된 서버 뒤에 붙어야 하며 포트를 명시해 줘야 한다. 두 번째 매개 변수인 호스트 네임(127.0.0.1)은 반드시 제공하지 않아도 되는데, 이 경우엔 http://0.0.0.0 으로 연결을 허용한다. 이 listen은 비동기로 동작하며, http 연결이 맺어지기 전까지 프로그램 실행을 차단하지 않는다.

위 예제는 콜백이라는 비동기 방식으로 Hello, World를 표시해 주는 개념이므로, 초심자들은 왜 저렇게 하는지 당장 모르겠어도 겁먹지 말고 생활코딩 등과 같은 Node.js 가이드를 찬찬히 보자.

【터미널(stdout)로 Hello, World! 출력하기】

Node.js도 Python, Lua와 마찬가지로 런타임 바이너리에서 자체 대화형 콘솔(REPL; Read-Eval-Print Loop)을 제공한다.
CMD 또는 터미널에서 아무런 매개 변수 없이 node를 입력하면 기본적으로 REPL 인터페이스가 나타난다. 해당 화면에서 아래 코드를 입력해보자.

#!syntax javascript
console.log("Hello, World!")

아래와 같이 뜨면 잘 실행이 된 것이다.

> console.log("Hello, World!")
Hello, World!
undefined

Hello, World!는 console.log 함수가 실행되면서 표준 출력 스트림으로 내보낸 버퍼이고, 아래에 붙는 undefined는 console.log 함수가 정상적으로 끝나면서 반환한 결괏값이다.

참고로 REPL에서 나가기 위해서는 <kbd>Ctrl(cmd)</kbd>+<kbd>D</kbd>를 눌러 EOL 문자를 입력하면 된다.

【텔넷 클라이언트로 Hello, World! 출력하기】

텔넷 서버를 지원하기 때문에 사설 BBS도 만들 수 있다.

#!syntax javascript
const net = require('net');
const telnet = net.createServer();

telnet.on('connection', client => {
    client.write('Hello, world!');
});

telnet.listen(23);

3. 특징

3.1. 비동기 이벤트

#!syntax javascript
const http = require('http');
const server = http.createServer(helloResponse);

function helloResponse(req, res) {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello World\n');
}

server.listen(8080, '127.0.0.1');
console.log('Server running at http://127.0.0.1:8080/');

3.2. 오류 처리

#!syntax javascript
const http = require("http");
const req = http.request( {host:"ip", path:"/"}, (res) => {
  let text = "";
  res.on("data", (chunk) => {
    text += chunk;
  });
  res.on("close", () => {
    console.log(text);
  });
  res.on("error", () => {
    //예를 들면 여기에 횟수 제한, 지연 대기, req.end(); 형태로 쓴다
  });
});
req.on("timeout", () => {
  //예를 들면 이러한 중복되는 재시도 기능을 특정 함수로 재사용한다.
});
req.on("error", (e) => {
  //예를 들면 이러한 중복되는 재시도 기능을 특정 함수로 재사용한다.
});
req.end();

3.3. 멀티 프로세싱

4. 패키지 매니저

4.1. npm

4.2. yarn

4.3. pnpm

5. 버전 관리자

5.1. Node Version Manager

5.2. Fast Node Manager

5.3. Volta

6. 여담

• JavaScript의 인식이 '쉬운 언어'이다 보니, JavaScript로 서버도 만들 수 있다는 말만 듣고 도전했다가 헬게이트를 경험하는 이들이 많다. 헌데 안타깝게도 JavaScript는 '복잡한' 언어는 아니지만 '난해한' 언어다. 다른 언어들이 그냥 에러를 내고 실행을 멈춰 버리는 버그를 JavaScript는 잘못된[9] 방법으로라도 어떻게든 실행해 버린다.[10][11] 특히 this 객체와 모듈 시스템은 카오스 그 자체인데 이 둘을 안 쓸 수도 없다. 요즘은 그나마 Nest.js같이 패턴이 다양한 디자인 패턴이 잘 정리된 프레임워크가 있으며 ESM 에 발전에 이어 Next.js같이 백엔드와 프론트를 같은 영역에서 동시에 개발하는 프레임워크도 발전 중이어서 그나마 개선되고 있다.
• 나무위키는 이 Node.js와 Node.js에서 가장 큰 규모의 웹 프레임워크인 Express.js로 개발되어 있다.
• 2016년 6.0 버전부터 ES6 문법이 대거 추가되면서 ES6 Promise를 사용 가능하게 되었다. ES7에서는 Promise 패턴을 더 간편하게 사용할 수 있는 async/await 문법을 추가했다. 특히 async/await는 키워드 하나 추가로 비동기 함수를 동기식으로 짤 수 있는 마법 같은 편의성을 제공한다.[12] 기존 Promise와의 조합도 물론 가능하다. 다만 VS Code 기준에서 디버깅을 할때 비동기 함수로 진입하려고 하는 경우 비주얼 스튜디오에서 C#과 같이 함수에 들어가지는 게 아니라 태스크 처리 모듈로 들어간다.
• 12.0 버전부터 ES Modules도 실험적으로 도입하기 시작했다. 다만 지금까지 CommonJS로 만들어진 패키지들이 많이 존재하므로 기본적인 모듈 시스템은 14.0 버전까지도 CommonJS이다.
• 6.0부터 Windows XP와 Vista를[13], 14.0부터 Windows 7을 지원하지 않는다. 따라서 Windows XP 등에서 최신 코드를 호스팅하고 싶다면 코드를 트랜스파일하거나[14] Windows 7 이상의 가상 머신을 활용해야 한다.
• 8.6.0 버전을 Windows XP용으로 포팅한 버전이 있다. #
• 현재 가장 최신 버전이 Windows 7과 큰 차이가 없는 Windows 8 초기 베타 버전에서 정상 동작한다.
• Windows 7을 지원하는 마지막 버전인 13.14.0이 Windows Vista와 크게 다르지 않은 Windows 7 마일스톤 3 베타 버전에서 정상 동작한다.
• 14.0.0 버전부터 윈도우 7 지원 중단한 지 얼마나 됐다고 Windows 7 지원을 중단했지만 OS 버전을 검사하지 않도록 한 경우 16.6.2 버전까지는 SP1 기준 정상 작동한다.
• 이와 비슷하게 6.0.0부터 XP 지원을 중단했지만 버전 검사를 하지 않도록 바이너리 패치만 하면 6.12.3까지는 정상 작동한다.
• 22.6.0 버전부터 TypeScript를 직접 실행할 수 있는 기능을 실험적으로 추가했다.

6.1. Node.js는 프레임워크?

6.2. 성능 이야기

7. 같이 보기

7.1. 참조 문서

• Node.js 공식 참조 문서
• 생활코딩

7.2. 프레임워크

• Socket.IO - Node.js의 비동기 범용 웹소켓 프레임워크
• Express.js # - Node.js 웹 애플리케이션 프레임워크
• NestJS - Node.js 웹 백엔드 프레임워크
• Electron # - Node.js와 HTML로 작성된 웹 애플리케이션을 데스크톱 애플리케이션으로 만들어주는 Wrapper 프레임워크.[16]
• AJAX - AJAX(Asynchronous JavaScript and XML)는 말 그대로 JavaScript와 XML을 이용한 비동기적 정보 교환 기법
• JSON - 서버에서 클라이언트로 데이터를 보낼 때 사용하는 자바스크립트 양식, XML보다 성능이 경량화되었다.
  

7.3. 쇼케이스

• the seed
• 끄투[17]

7.4. 기타

• Deno[18]