[VS Code] Salesforce LWC 에서 Jest 사용 방법

molamola·2025년 4월 24일

VS Code

목록 보기
8/9

VS Code 에서 JS 파일을 테스트 하는 방법

우선 Node.js가 있어야 함.
Node.js 가 없다면 설치하고 오시오.

그 다음 npm으로 해당 프로젝트에 Jest 를 위한 라이브러리를 설치한다.


✅ 전체 명령어:

npm install --save-dev sfdx-lwc-jest

💡 해석:

npm install

sfdx-lwc-jest라는 npm 패키지를 설치하겠다

--save-dev

→ 이 패키지를 개발할 때만 필요한 도구(devDependency)로 설치하겠다


✅ 그럼 --save-dev는 왜 쓰는 건가?

📦 --save-dev로 설치한 패키지는:

  • package.json"devDependencies"에 등록됨
  • 배포할 때 포함되지 않음
  • 예: 테스트 도구, 빌드 도구, 린터, 번들러 등

✅ 반대로 --save는?

  • (요즘은 생략 가능)
  • "dependencies"에 등록됨
  • 실제 서비스 구동에도 필요한 라이브러리용
구분쓰임예시
--save-dev개발 전용 도구Jest, ESLint, Webpack 등
--save or 생략앱에서 직접 쓰는 라이브러리React, Axios 등

🔍 예시: package.json에 반영되는 모습

"devDependencies": {
  "sfdx-lwc-jest": "^12.0.0"
}

이렇게 되면 다른 개발자들도 npm install 한 번이면 자동 설치되니까 협업에도 좋아요.


🔧 요약 정리

명령어의미
npm install모듈 설치
--save-dev개발용으로만 쓰겠다는 뜻
sfdx-lwc-jestSalesforce LWC 유닛 테스트 도구

이렇게 설치를 하면 테스트 할 수 있는 라이브러리 준비는 끝이다.


테스트 방법은 다음과 같다.

방법 1.
LWC 폴더에 __tests__ 폴더가 있다. 그 안에 있는 파일명.test.js 파일을 들어가서

sum.js 를 불러와서 해당 js 안에 sum() 이라는 함수를 테스트하는 과정이다.
회색 글씨로 Run Test 있는데 저걸 클릭하면 알아서 테스트를 진행한다.


방법 2.
터미널 명령어로 npm run test:unit 을 치면 프로젝트에 있는 모든 .test.js 파일이 테스트 실행한다.
그래서 해당 방법으로 특정 .test.js 만 실행하고 싶다면

저렇게 "test:one" 을 추가해서 파일 경로를 지정한 뒤
npm run test:one 명령어를 치면된다.
저기서 one 은 그냥 임의로 만든 스크립트 이름이다. 맘대로 정하면 됨.


방법 3.
명령어로 바로 테스트하는 방법인데 이 방법이 젤 간편한 거 같다.
명령어로

npx jest 파일명.test.js

또는

npx sfdx-lwc-jest -- 파일명.test.js

치면 된다.

만약 같은 이름의 파일명.test.js 파일이 두 개 이상 있다면?
-> 둘 다 실행됨.


끝.

0개의 댓글