Node.js 기초 · 내장 모듈 · npm과 패키지 · Express 기초

브라우저 환경: JavaScript → V8 엔진 → DOM/BOM API
Node.js 환경: JavaScript → V8 엔진 → Node.js API (fs, http, os …)

node --version    # v18 이상 권장
npm --version

$ node
> 1 + 2
3
> 'Hello' + ' World'
'Hello World'
> Math.max(3, 7, 1)
7
> .exit

// 내보내기
module.exports = { add, subtract };

// 가져오기
const { add } = require('./math');
const fs = require('fs');       // 내장 모듈
const dayjs = require('dayjs'); // npm 패키지

// 내보내기
export function add(a, b) { return a + b; }

// 가져오기
import { add } from './math.js';
import fs from 'fs';

node app.js                # 기본 실행
node app.js 홍길동          # 인수 전달
node app.js 10 + 20        # 여러 인수

process.argv       // 실행 인수 배열
process.env        // 환경 변수
process.cwd()      // 현재 작업 디렉토리
process.exit(0)    // 프로세스 종료
process.platform   // 'win32', 'darwin', 'linux'

node app.js 홍길동

console.log(process.argv);
// ['node경로', 'app.js경로', '홍길동']
const name = process.argv[2]; // '홍길동' (인수는 index 2부터)

const fs = require('fs');

const content = fs.readFileSync('data.txt', 'utf-8');
fs.writeFileSync('output.txt', '저장할 내용', 'utf-8');
const exists = fs.existsSync('data.txt');
const files = fs.readdirSync('./');

// 콜백
fs.readFile('data.txt', 'utf-8', (err, data) => {
  if (err) throw err;
  console.log(data);
});

// Promise
const fs = require('fs/promises');
const data = await fs.readFile('data.txt', 'utf-8');

const path = require('path');

path.join('/users', 'john', 'file.txt')  // '/users/john/file.txt'
path.resolve('data', 'output.txt')       // 절대 경로
path.dirname('/users/john/file.txt')     // '/users/john'
path.basename('/users/john/file.txt')    // 'file.txt'
path.extname('readme.md')                // '.md'

// __dirname: 현재 파일이 있는 디렉토리의 절대 경로
const fullPath = path.join(__dirname, 'data', 'input.txt');

const os = require('os');

os.platform()   // 'win32', 'darwin', 'linux'
os.homedir()    // 홈 디렉토리
os.hostname()   // 컴퓨터 이름
os.cpus()       // CPU 정보 배열
os.totalmem()   // 전체 메모리 (bytes)
os.freemem()    // 여유 메모리

const EventEmitter = require('events');
const emitter = new EventEmitter();

emitter.on('data', (message) => {
  console.log('데이터 수신:', message);
});

emitter.emit('data', '안녕하세요!');

// 한 번만 실행
emitter.once('connect', () => {
  console.log('최초 연결!');
});

{
  "name": "my-project",
  "version": "1.0.0",
  "description": "내 첫 Node.js 프로젝트",
  "main": "index.js",
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js",
    "test": "node test.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "dayjs": "^1.11.10"
  },
  "devDependencies": {
    "nodemon": "^3.0.1"
  }
}

# 초기화
npm init           # 질문에 답하며 생성
npm init -y        # 기본값 자동 생성

# 설치
npm install express              # 프로덕션 의존성
npm install --save-dev nodemon    # 개발 의존성
npm install -g typescript        # 전역 설치

# 목록
npm list
npm list --depth=0

# 제거
npm uninstall express

# 스크립트 실행
npm run dev
npm start          # start는 run 생략 가능

npx create-react-app my-app    # 설치 없이 바로 실행
npx cowsay "Hello, Node!"      # 일회성 실행

npm install --save-dev nodemon

{
  "scripts": {
    "dev": "nodemon server.js"
  }
}

npm run dev

npm install dayjs

const dayjs = require('dayjs');

dayjs()                                  // 현재 시각
dayjs('2025-01-15')                      // 특정 날짜

dayjs().format('YYYY-MM-DD')             // '2025-01-15'
dayjs().format('YYYY년 MM월 DD일')        // '2025년 01월 15일'

dayjs().add(7, 'day')                    // 7일 후
dayjs().subtract(1, 'month')             // 1달 전
dayjs().diff(dayjs('2000-01-01'), 'year') // 나이 계산

# .gitignore
node_modules/
.env
*.log

npm install express

const express = require('express');
const app = express();

app.listen(3000, () => {
  console.log('서버: http://localhost:3000');
});

app.get('/', (req, res) => {
  res.send('홈페이지입니다.');
});

app.post('/users', (req, res) => {
  res.send('유저 생성');
});

app.put('/users/:id', (req, res) => {
  res.send(`유저 ${req.params.id} 수정`);
});

app.delete('/users/:id', (req, res) => {
  res.send(`유저 ${req.params.id} 삭제`);
});

req.params    // URL 파라미터: /users/:id → req.params.id
req.query     // 쿼리스트링: /search?q=hello → req.query.q
req.body      // 바디 (express.json() 필요)
req.headers   // 헤더
req.method    // 'GET', 'POST'
req.url       // 요청 URL

res.send('텍스트 응답');
res.json({ key: 'value' });
res.sendFile('/path/to/file.html');
res.redirect('/other-page');
res.status(404).send('Not Found');
res.render('index');             // EJS 등 템플릿

// 모든 요청에 적용
app.use((req, res, next) => {
  console.log(`${req.method} ${req.url}`);
  next(); // 다음 미들웨어로 넘김
});

// JSON 바디 파서
app.use(express.json());

// URL 인코딩 (폼 데이터)
app.use(express.urlencoded({ extended: true }));

app.use(express.static('public'));

// http://localhost:3000/index.html → public/index.html
// http://localhost:3000/css/style.css → public/css/style.css

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`서버: http://localhost:${PORT}`);
});