이 편에서 만드는 파일

todo-cli/
└── src/
    ├── index.js         (~)
    └── cli/
        └── parseArgs.js (+)

개념 정리

원시 타입 7종

JavaScript의 값은 원시(primitive) 타입 7종과 객체(object) 타입으로 나뉩니다. typeof 연산자로 확인합니다.

null의 typeof가 object로 나오는 것은 JavaScript 초기 구현의 버그가 표준으로 굳어진 결과입니다. 값이 없음을 표현할 때 null인지 undefined인지는 나중에 저장 로직(08편)에서 구분해 씁니다.

process.argv

Node.js는 터미널에서 받은 명령행 인자를 process.argv 배열로 제공합니다.

node src/index.js add "할일 내용" --tag study

앞의 두 항목은 항상 실행 정보라서 process.argv.slice(2)로 잘라내고 실제 인자만 다룹니다.

값은 모두 문자열이다

process.argv의 모든 원소는 문자열입니다. --due 2026-09-20을 받아도 값은 숫자가 아니라 문자열 '2026-09-20'입니다. 숫자로 써야 할 때는 Number()나 parseInt()로 직접 변환해야 합니다. 이 편에서는 값을 그대로 문자열로 저장하고, 실제 날짜 계산은 12편(Date·Intl)에서 다룹니다.

타입 변환 방법 비교

typeof NaN은 'number'입니다. NaN도 숫자 타입의 값이며, Number.isNaN()으로 확인해야 합니다.

실습

// src/cli/parseArgs.js
export function parseArgs(argv) {
  const [command, ...rest] = argv;
  const positional = [];
  const flags = {};
 
  for (let i = 0; i < rest.length; i += 1) {
    const token = rest[i];
    if (token.startsWith('--')) {
      const key = token.slice(2);
      const value = rest[i + 1];
      flags[key] = value;
      i += 1;
    } else {
      positional.push(token);
    }
  }
 
  return { command, positional, flags };
}

// src/index.js
import { parseArgs } from './cli/parseArgs.js';
 
const argv = process.argv.slice(2);
const parsed = parseArgs(argv);
 
console.log('명령:', parsed.command, typeof parsed.command);
console.log('위치 인자:', parsed.positional);
console.log('플래그:', parsed.flags);

node src/index.js add "할일 내용" --tag study --due 2026-09-20

• 아래처럼 출력되면 성공입니다.

명령: add string
위치 인자: [ '할일 내용' ]
플래그: { tag: 'study', due: '2026-09-20' }

• node src/index.js를 인자 없이 실행하면 명령: undefined undefined가 출력됩니다. typeof undefined가 문자열 "undefined"임을 확인합니다.

직접 해보기

1. --tag와 --due의 순서를 바꿔 실행해도 같은 결과가 나오는지 확인합니다.
2. node src/index.js list --page 2를 실행해 positional이 빈 배열이고 flags.page가 문자열 '2'(숫자 아님)임을 확인합니다.

자주 하는 실수

확인 문제

참고 자료

• Node.js Docs - process.argv 
• MDN - typeof