💡 Playwright에서 마이크 기능 자동화하기

📌 음성 입력이 필요한 테스트 화면

요즘 회사 서비스 테스트 자동화 코드를 Playwright + TypeScript로 작성하고 있다.
버튼 클릭, 입력창 검증 같은 기본적인 UI 테스트는 어느 정도 익숙해졌는데,
이번에 처음으로 마이크 입력이 필수인 화면을 자동화해야 했다.

 

실제로 음성 입력이 없는 상태에서는 다음 단계로 넘어갈 수 없도록 막혀 있었고,
매번 사람이 직접 말해야 한다면 회귀 테스트나 반복 테스트에서 자동화의 의미가 크게 줄어든다.
그래서 어떻게든 사람의 목소리를 쓰지 않고 테스트할 방법을 찾아보기로 했다.

 

📌 음성 파일을 마이크 입력처럼 쓰는 방식

결론부터 말하면, 실제 마이크 대신 미리 준비한 음성 파일을 마이크 입력처럼 사용하는 방식을 선택했다.

 

먼저 테스트에 사용할 문장을 직접 작성했다.  
실제 사용자가 말할 법한 대본을 기준으로 문장을 만들고,
ElevenLabs를 이용해 mp3 음성 파일로 생성했다.

처음엔 mp3 파일을 그대로 사용하면 될 줄 알았지만,
Playwright에서 가짜 마이크 입력으로 사용할 수 있는 파일 형식은 wav 파일이었다.
그래서 mp3 -> wav 변환을 진행했고, freeconvert를 사용해 간단히 해결했다.

 

📌 마이크 자동화의 핵심은 이 3가지 옵션

여러 시행착오 끝에 알게 된 사실은,
마이크 자동화의 핵심은 테스트 코드보다 브라우저 실행 옵션에 있다는 것이었다.

 

아래 3가지 옵션이 필요하다.

--use-fake-device-for-media-stream              // 팝업 차단
--use-fake-ui-for-media-stream                  // 장치 대체
--use-file-for-fake-audio-capture=PATH_TO_WAV   // 입력 소리 제공

이 옵션들이 적용되면 테스트 환경에서는 다음과 같은 일이 벌어진다.

• 마이크 permission 팝업이 뜨지 않고
• Chromium이 실제 마이크 대신 가짜 마이크 장치(fake mic)를 사용하며
• 지정한 wav 파일을 마이크 입력 스트림으로 흘려보낸다

여기서 가장 중요했던 포인트는 이건 ‘녹음’이 아니라 ‘입력’이다.

wav 파일을 그냥 재생하는 게 아니다. 브라우저 입장에서는 진짜 입력 장치에서 소리가 들어오고 있다고 믿는 상태가 된다.
그래서 STT(Speech To Text) 기능도 "지금 누군가 말하고 있다"고 인식하고 정상적으로 동작한다.

 

📌 Playwright 설정 (JavaScript / TypeScript 기준)

import { defineConfig } from '@playwright/test';

export default defineConfig({
  use: {
    browserName: 'chromium',
    launchOptions: {
      args: [
        '--use-fake-device-for-media-stream',
        '--use-fake-ui-for-media-stream',
        '--use-file-for-fake-audio-capture={wav 파일 경로}'
      ],
    },
  },
});

 

📌 시나리오에서는 이렇게 동작한다

이 상태에서 테스트 시나리오에서 마이크 버튼을 클릭하면,

await page.getByRole('button', { name: '마이크' }).click();

실제 마이크가 켜지는 대신, 미리 준비해 둔 wav 파일이 마이크 입력으로 들어간다.

 

덕분에 내가 겪고 있던 문제였던, 아무 소리가 없으면 다음 단계로 못 넘어가지 못하는 문제가 깔끔하게 해결됐다.
사람이 직접 말하지 않아도, 시스템은 음성이 입력되었다고 인식하고 다음 단계로 넘어간다.

 

📌 마무리하며

마이크 입력이 필요한 화면은 자동화하기 어렵다고 막연히 생각했는데, 막상 구조를 이해하고 나니 브라우저가 입력을 어떻게 인식하는지가 핵심이었다.

다만 이 방식의 목적을 분명히 해둘 필요가 있다. 이 자동화는 마이크 입력 기능 자체의 정확도를 검증하기 위한 용도는 아니다.

항상 동일한 wav 파일이 입력되기 때문에, 음성 인식의 품질이나 STT 결과의 정확성을 테스트하는 데에는 적합하지 않다.

 

내가 이 방식을 사용한 이유는 "음성 입력이 있어야만 다음 단계로 넘어갈 수 있는 화면을 자동화하기 위해서" 단 하나였다.

즉, 마이크 기능을 테스트하기 위한 자동화가 아니라 마이크 입력이라는 조건을 안정적으로 통과하기 위한 수단이었다.

 

이렇게 접근하니 사람이 직접 말하지 않아도 되고, 회귀 테스트나 반복 테스트에서도 막히지 않는 자동화 흐름을 만들 수 있었다.

자동화에서 중요한 건 모든 기능을 완벽하게 검증하는 것보다, 어디까지를 자동화로 커버할지 명확히 정하는 것이라는 생각도 함께 들었다.