Node.js에서 npm 시작 스크립트 설정하고 변경하는 방법

Node.js 애플리케이션의 시작 스크립트(start script)는 특정 작업을 수행하기 위해 사용되는 명령어들의 집합입니다. Node.js 프로젝트를 처음 생성하거나 초기화할 때 애플리케이션을 실행하기 위한 여러 사전 정의된 스크립트가 자동으로 만들어지며, 이 스크립트들은 프로젝트의 필요에 따라 언제든지 자유롭게 수정할 수 있습니다.

스크립트 명령어는 Node.js와 React 모두에서 프로그램의 다양한 시작 스크립트를 구성할 때 널리 활용됩니다. 특히 npm start를 사용하면 긴 실행 명령어를 매번 직접 입력하지 않고도 시작 스크립트를 한 번에 간편하게 실행할 수 있다는 장점이 있습니다.

package.json 파일에서 시작 스크립트 정의하기

시작 스크립트는 프로젝트 루트 디렉터리의 package.json 파일 안에 정의합니다. 아래 예시에서는 진입점 파일 이름이 'index.js'이며, 이 이름은 프로젝트 상황에 맞게 얼마든지 변경할 수 있습니다.

"scripts": {
  "start": "node index.js" // 실행할 파일 이름
}

참고로 npm start는 npm run start의 축약형으로, scripts 객체에 정의된 'start' 항목을 찾아 실행합니다. 만약 'start' 스크립트가 정의되어 있지 않다면 Node.js는 기본적으로 server.js 파일을 찾게 됩니다.

예제 – Express 서버를 npm start로 실행하기

먼저 index.js라는 이름의 파일을 생성하고 아래 코드를 복사해 붙여넣습니다. 그런 다음 터미널에서 다음 명령어를 입력하면 코드가 실행됩니다.

npm start

index.js

// express 모듈 불러오기
const express = require('express');
const app = express();

// 응답으로 보낼 데이터를 문자열로 초기화
var data = "Welcome to TutorialsPoint !"

// '/' 경로에 대한 요청 처리
app.get('/', (req,res)=>{

    // 데이터를 응답으로 전송
    res.send(data);
})

// 3000번 포트에서 서버 실행
app.listen(3000, ()=>{
    console.log("server running");
});

실행 결과

C:\home\node>> npm start

위 명령어 하나만 입력하면 index.js 파일이 자동으로 실행됩니다. 즉, npm start가 곧바로 프로젝트의 메인 진입점을 구동해 주기 때문에 매번 node index.js처럼 파일 경로까지 일일이 입력할 필요가 없습니다.

서버가 정상적으로 실행되었다면 이제 브라우저 주소창에 다음 URL을 입력해 웹페이지에 접속해 보세요.

https://localhost:3000

브라우저 화면에 "Welcome to TutorialsPoint !"라는 문자열이 출력되면 시작 스크립트가 성공적으로 동작하고 있는 것입니다. 이처럼 package.json의 scripts 항목을 잘 활용하면 빌드, 테스트, 배포 등 반복적인 개발 작업도 손쉽게 자동화할 수 있습니다.