✅ test: feed-crawler 유닛 테스트 작성 #489

asn6878 · 2025-11-21T12:02:46Z

🔨 테스크

Issue

close [BE] feed-crawler 유닛 테스트 추가 #488

📋 작업 내용

추상클래스가 사용된 로직의 유닛 테스트를 어떻게 해야 할까?

추상 클래스를 활용하는 케이스는 현재 feed-crawler내에 크게 두가지가 존재합니다.

BaseFeedParser (이 경우는 FeedParserManager를 테스틀하여 처리합니다.)
AbstractQueueWorker

이러한 패턴에서는 추상 클래스가 "공통적으로 어떤 순서로 무엇을 할지"를 정의하고, 구체 클래스는 그중 특정 구현체마다 달라진 작업을 "어떻게 할지"만 구현합니다. 이때 내부 구현 메서드들은 protected으로 캡슐화 되어 관리됩니다.

AbstractQueueWorker.start()
├── logger.info("작업 시작")
├── processQueue()        ← 구체 클래스가 구현
├── catch → logger.error()
└── logger.info("작업 완료")

이런식의 구성이 존재할 때, 저희는 processQueue()가 어떻게 동작하고 어떤 결과를 수행했는지는 관심이 없으며 테스트 대상에서 제외됩니다. (이 포스팅을 읽어보시면 좋습니다.)

중점적으로 테스트 할 대상

템플릿의 실행 순서가 올바른가?
에러 발생 시 정상적으로 핸들링 하는가?

근데 `ClaudeEventWorker`는 왜 테스트 하나요?

ClaudeEventWorker는 AI 에이전트에게 별도의 호출이 필요한 케이스이기에 예외적으로 구현체를 테스트 하였습니다.

외부 서비스 의존 로직 특성상 데이터 포맷에 예민함.
비용이 발생하는 서비스로, 재시도 로직이 엄격 해야함.

그 외 핵심 로직 유닛 테스트 작성

feed-crawler 및 parser-util등 비즈니스 로직 실행에 필요한 로직들에 대한 테스트를 작성하였습니다.

요약

테스트 파일	검증 대상	핵심 검증 포인트
`abstract-queue-worker.spec.ts`	템플릿 메서드 패턴	시작/완료 로그, 에러 처리 후 작업 완료
`parser.spec.ts`	RSS/Atom 파서	형식 식별, 링크 추출, 특수문자 처리
`feed-parser-manager.spec.ts`	파서 선택 로직	Short-circuit 동작, 에러 복원력
`feed-crawler.spec.ts`	크롤링 워크플로우	조기 종료, 병렬 처리, 에러 전파
`claude-event-worker.spec.ts`	AI 처리 워커	재시도 경계값(deathCount), API 응답 파싱, Rate Limiting

… into test/feed-crawler-unit

Copilot

Pull Request Overview

이 PR은 feed-crawler 모듈의 핵심 비즈니스 로직에 대한 포괄적인 유닛 테스트를 추가합니다. 추상 클래스 패턴을 사용하는 코드의 템플릿 메서드 실행 흐름과 에러 처리를 중점적으로 검증하며, RSS/Atom 파서, 크롤러 워크플로우, AI 워커의 재시도 로직 등을 테스트합니다.

주요 변경사항:

고정된 날짜를 사용하여 시간 의존적인 테스트의 안정성을 개선
URL 기반 조건부 fetch 모킹으로 순서 의존성 제거
추상 클래스의 템플릿 메서드 패턴과 에러 핸들링 검증에 집중

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
feed-crawler/test/unit/parser.spec.ts	고정 날짜 사용으로 시간 의존성 제거, URL 기반 조건부 모킹으로 테스트 안정성 향상
feed-crawler/test/unit/parser-util.spec.ts	ParserUtil의 썸네일 추출, URL 처리, HTML 엔티티 변환 로직에 대한 포괄적 테스트 추가
feed-crawler/test/unit/feed-parser-manager.spec.ts	파서 선택 로직, 에러 복원력, short-circuit 동작 검증 테스트 추가
feed-crawler/test/unit/feed-crawler.spec.ts	크롤링 워크플로우, 조기 종료 시나리오, 병렬 처리 동작 테스트 추가
feed-crawler/test/unit/claude-event-worker.spec.ts	AI 워커의 재시도 로직, deathCount 경계값, API 응답 파싱, rate limiting 테스트 추가
feed-crawler/test/unit/abstract-queue-worker.spec.ts	템플릿 메서드 패턴의 실행 순서와 에러 처리 검증 테스트 추가

feed-crawler/test/unit/feed-crawler.spec.ts

feed-crawler/test/unit/parser.spec.ts

feed-crawler/test/unit/claude-event-worker.spec.ts

… into test/feed-crawler-unit

Jo-Minseok

고생하셨습니다! 리뷰 확인 부탁드려요!

feed-crawler/test/unit/parser.spec.ts

Jo-Minseok · 2025-11-27T17:14:42Z

feed-crawler/test/unit/parser.spec.ts

+const FIXED_DATE_UTC = FIXED_DATE.toUTCString();
+const FIXED_DATE_ISO = FIXED_DATE.toISOString();
+
 const RSS_20_SAMPLE = `<?xml version="1.0" encoding="UTF-8"?>


P5) XML 샘플 파일은 따로 빼는게 좋을듯해요! 테스트 코드 읽을 때 테스트 보다는 XML 길이에 더 초점이 가는듯하여 가독성 저하가 발생하는 것 같습니다!

Jo-Minseok · 2025-11-27T17:21:30Z

feed-crawler/test/unit/parser-util.spec.ts

+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();


P3) 제 생각에는 이 테스트 코드에서는 clearAllMocks 보다는 restoreAllMocks가 맞을듯 합니다! 성윤님께서 원래 fetch 구현을 복원하는 의도로 하신듯 합니다! clearAllMocks를 사용하면 덮어쓴 함수 기능들은 그대로 유지되기 때문에 restoreAllMocks가 맞을듯 해요!

함수 호출 기록 mock 구현 spy 복원

clearAllMocks() 초기화 O 유지 유지

restoreAllMocks() 초기화 X 복원 복원

Jo-Minseok · 2025-11-27T17:33:49Z

feed-crawler/test/unit/feed-crawler.spec.ts

+    },
+  ];
+
+  beforeEach(() => {


P2) 여기에는 jest.clearAllMocks가 필요할듯 합니다!

Jo-Minseok · 2025-11-27T17:35:09Z

feed-crawler/test/unit/claude-event-worker.spec.ts

+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();


P3) Spy를 원래 기능으로 복구하고자 하신다면 resetAllMocks 사용하셔야 합니다!

Jo-Minseok · 2025-11-27T17:37:28Z

feed-crawler/test/unit/abstract-queue-worker.spec.ts

+import logger from '../../src/common/logger';
+
+// logger 모킹
+jest.mock('../../src/common/logger', () => ({


P5) 저희 feed-crawler/src/common/logger.ts에 58번 라인

silent: process.env.NODE_ENV === 'test',

사용중인데 로거를 모킹하신 이유가 궁금합니다

// Then expect(mockLogger.error).toHaveBeenCalledWith( expect.stringContaining('처리 중 오류 발생'), ); expect(mockLogger.info).toHaveBeenCalledWith( expect.stringContaining('작업 완료'), );

공통 로직의 경우 진행완료 여부를 logger의 호출 여부로 검증하기위해 모킹을 진행했습니다!

앗! 그런 부분이 있었네요 못봤습니다 죄송합니다 😢
Mocking을 하면 기존 기능을 해치는거라 실질적으로 호출을 확인하고자 한다면 Mocking보다는 spyOn으로 함수 감시를 하는건 어떨까요?

// Given const infoSpy = jest.spyOn(logger, 'info'); const errorSpy = jest.spyOn(logger, 'error'); // When ... // Then expect(errorSpy).toHaveBeenCalledWith( expect.stringContaining('처리 중 오류 발생'), ); expect(infoSpy).toHaveBeenCalledWith( expect.stringContaining('작업 완료'), );

이런식으로 Jest 에서 함수 감시가 가능합니다! 훨씬 코드도 간단해지는 것 같아요!

spyOn은 내부적으로 호출 정보를 기록하는거라 기능을 바꿔버리는 Mocking과는 달라서 검증을 하고 싶으시면 이 방법도 좋을듯 합니다!

jest.mock('../../src/common/logger', () => ({ default: { info: jest.fn(), error: jest.fn(), warn: jest.fn(), debug: jest.fn(), }, __esModule: true, })); const mockLogger = logger as jest.Mocked<typeof logger>;

만약 spyOn으로 감시를 하게 된다면 모킹 코드는 지우셔도 동작합니다! 제 환경에서 테스트 통과하는 것을 확인했습니다.

CodeVac513

수고많으셨습니다!

asn6878 added 6 commits September 26, 2025 02:05

✅ test: 피드크롤러 유닛 테스트 작성

87c59b1

Merge branch 'main' of https://github.com/boostcampwm-2024/web05-Denamu…

5f3dfa6

… into test/feed-crawler-unit

📝 docs: 테스트 관련 문서 임시 작성

b82fe4e

✅ test: 불필요한 테스트 제외 및 타입 오류 수정

36c8861

✅ test: 중복된 테스트 제거

9122a31

✅ test: 불필요한 repo test 제거

e0a4d93

asn6878 requested review from CodeVac513, Jo-Minseok and Copilot November 21, 2025 12:02

asn6878 self-assigned this Nov 21, 2025

asn6878 added the ✅ Test 테스트 관련 (storybook, vitest, jest 등) label Nov 21, 2025

Copilot started reviewing on behalf of asn6878 November 21, 2025 12:03 View session

Copilot finished reviewing on behalf of asn6878 November 21, 2025 12:05

Copilot AI reviewed Nov 21, 2025

View reviewed changes

asn6878 added 2 commits November 23, 2025 15:51

✅ test: 미사용 변수 제거 및 피드 크롤러 테스트 시간 재설정

026bc30

Merge branch 'main' of https://github.com/boostcampwm-2024/web05-Denamu…

fc980d9

… into test/feed-crawler-unit

Jo-Minseok requested changes Nov 27, 2025

View reviewed changes

CodeVac513 approved these changes Nov 28, 2025

View reviewed changes

함수	호출 기록	mock 구현	spy 복원
clearAllMocks()	초기화 O	유지	유지
restoreAllMocks()	초기화 X	복원	복원

✅ test: feed-crawler 유닛 테스트 작성 #489

Are you sure you want to change the base?

✅ test: feed-crawler 유닛 테스트 작성 #489

Conversation

asn6878 commented Nov 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔨 테스크

Issue

📋 작업 내용

추상클래스가 사용된 로직의 유닛 테스트를 어떻게 해야 할까?

근데 ClaudeEventWorker는 왜 테스트 하나요?

그 외 핵심 로직 유닛 테스트 작성

요약

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Jo-Minseok left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Jo-Minseok Nov 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Jo-Minseok Nov 27, 2025

Choose a reason for hiding this comment

Uh oh!

Jo-Minseok Nov 27, 2025

Choose a reason for hiding this comment

Uh oh!

Jo-Minseok Nov 27, 2025

Choose a reason for hiding this comment

Uh oh!

Jo-Minseok Nov 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

asn6878 Nov 28, 2025

Choose a reason for hiding this comment

Uh oh!

Jo-Minseok Nov 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

CodeVac513 left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

asn6878 commented Nov 21, 2025 •

edited

Loading

근데 `ClaudeEventWorker`는 왜 테스트 하나요?

Jo-Minseok Nov 27, 2025 •

edited

Loading

Jo-Minseok Nov 27, 2025 •

edited

Loading

Jo-Minseok Nov 28, 2025 •

edited

Loading