한글 조합 중 검색이 먼저 실행될 때: composition과 input 이벤트

‘한글’을 입력하는 동안 검색 결과가 ‘ㅎ’이나 ‘한’ 단계마다 바뀐다면, 요청 횟수뿐 아니라 글자를 조합하는 중인지 확인하세요. 입력이 잠깐 멈췄다고 조합까지 끝난 것은 아닙니다. 250ms 지연만 둔 검색은 사용자가 다음 자모를 고르는 동안에도 실행될 수 있습니다.

이 글은 웹의 텍스트 입력칸에서 조합이 끝난 뒤 작은 목록을 자동 필터링하는 경우를 다룹니다. 이미 보낸 요청의 응답 순서는 검색 요청 취소와 최신 결과 처리 글에서 따로 확인합니다. 여기서는 서버 요청을 보내지 않습니다.

입력·조합·응답 중 어디에서 실행되는지 확인합니다

관찰한 현상 확인할 지점 판단
한글을 완성하기 전에 결과가 바뀜 input 이벤트의 isComposing과 compositionstart·compositionend 조합 중에는 새 필터 작업을 예약하지 않습니다.
조합을 시작하자 이전 입력의 검색이 뒤늦게 실행됨 조합 시작 전에 만든 타이머 새 조합이 시작될 때 대기 중인 타이머도 취소합니다.
한글 확정 뒤 결과가 갱신되지 않음 compositionend에서 작업을 다시 예약하는지 종료 시점의 입력칸 값을 사용하고, input과 중복 예약되면 이전 예약을 취소합니다.
입력 완료 뒤 새 결과가 떴다가 이전 결과로 돌아감 비동기 응답과 오류를 반영하는 코드 조합 처리와 별도로 요청 소유자·취소를 검증합니다.

compositionstart는 조합 세션의 시작을, compositionend는 완료 또는 취소를 알립니다. 종료를 언제나 ‘새 글자가 확정됐다’고 해석하지 마세요. 예제는 event.data를 입력칸 뒤에 붙이지 않고 그 시점의 input.value로 목록을 다시 계산합니다.

조합 시작 때 이전 예약까지 취소하는 예제

아래를 ime-search.html로 저장해 브라우저에서 엽니다. 처음에는 세 항목을 모두 보여 줍니다. 입력 변경이 끝난 뒤 250ms를 기다려 현재 값을 필터에 적용하고, 빈 값은 전체 목록으로 돌아갑니다. 이 시간은 예제의 선택값이며 모든 입력기에서 적절한 대기 시간이라는 기준은 아닙니다. 코드는 이 사이트 본문에서 실행되지 않습니다.

<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<title>조합을 마친 뒤 목록 검색</title>
<label for="query">가이드 검색</label>
<input id="query" type="text" autocomplete="off">
<p id="status" role="status"></p>
<ul id="results"></ul>
<script>
  const input = document.querySelector('#query');
  const results = document.querySelector('#results');
  const status = document.querySelector('#status');
  const guides = ['한글 입력 안내', '웹앱 배포 점검', 'Flutter 설치'];
  let composing = false;
  let timer = null;

  function cancelPending() {
    clearTimeout(timer);
    timer = null;
  }
  function render() {
    const query = input.value.trim().toLocaleLowerCase('ko');
    const matches = guides.filter(title =>
      title.toLocaleLowerCase('ko').includes(query));
    results.replaceChildren(...matches.map(title => {
      const item = document.createElement('li');
      item.textContent = title;
      return item;
    }));
    status.textContent = query ? matches.length + '개 결과' : '전체 ' + matches.length + '개';
  }
  function schedule() {
    cancelPending();
    timer = setTimeout(() => {
      timer = null;
      if (!composing) render();
    }, 250);
  }

  input.addEventListener('compositionstart', () => {
    composing = true;
    cancelPending();
    status.textContent = '조합 중입니다. 이전 결과를 유지합니다.';
  });
  input.addEventListener('input', event => {
    cancelPending();
    if (composing || event.isComposing) return;
    schedule();
  });
  input.addEventListener('compositionend', () => {
    composing = false;
    schedule();
  });
  render();
</script>
</html>

compositionstart에서는 조합 상태를 세우고 이미 예약된 작업을 지웁니다. input에서는 다시 예약을 지운 뒤, 내부 조합 상태나 InputEvent.isComposing이 참이면 기다립니다. isComposing의 지원 여부도 대상 브라우저에서 확인하세요. 두 검사는 조합 중간의 input을 필터 실행으로 연결하지 않기 위한 것입니다.

종료 뒤에는 현재 값으로 실행할 작업을 예약합니다. 이어서 일반 input이 들어와도 schedule()이 기존 예약을 취소하므로 타이머를 두 개 쌓지 않습니다. clearTimeout은 아직 대기 중인 타이머를 취소하는 함수입니다. 이미 시작된 HTTP 요청이나 서버 작업을 되돌리지는 않습니다.

입력값을 매 이벤트에서 잘라 다시 대입하거나, 조합 문자열을 검색 결과로 덮어쓰지 않습니다. 결과에는 textContent를 사용합니다. 검색 로직을 키보드 keydown에만 연결하면 붙여넣기 등 다른 편집 경로를 놓칠 수 있어 여기서는 input 이벤트를 기준으로 삼았습니다. 코드에서 value를 직접 바꾸면 input이 자동 발생한다고 가정하지 말고, 같은 화면 코드에서 갱신 함수를 명시적으로 호출할 정책을 정하세요.

Chrome 조합 에뮬레이션에서 관찰한 결과

2026년 11월 19일 Chrome 157.0.8103.79 헤드리스에서 위 HTML을 로컬 주소로 열었습니다. 일반 문자열 삽입과 브라우저 자동화의 Chrome DevTools Protocol 조합 명령을 사용해 7개 흐름을 실행했습니다. 실제 Windows 한글 입력기, 후보 선택 창, 모바일 키보드를 조작한 시험은 아닙니다.

조작 관찰
완성 문자열 Flutter 삽입 후 대기 Flutter 설치 한 항목으로 바뀌었습니다.
조합 명령으로 ㅎ을 넣고 320ms 대기, 이어 한글로 갱신하고 다시 대기 250ms를 넘겨도 이전 전체 세 항목이 유지됐습니다. 조합 중 안내가 표시됐습니다.
한글 조합을 확정하는 명령 후 대기 한글 입력 안내 한 항목이 됐고, 목록 교체는 한 번 관찰됐습니다.
웹 입력 직후 새 앱 조합 시작 앞서 예약한 필터가 조합 중 실행되지 않았습니다.
새 조합을 취소한 뒤 대기, 이어 입력칸 비우기 남아 있던 웹으로 웹앱 배포 점검이 표시됐고, 빈 값에서는 전체 세 항목이 돌아왔습니다.

이 결과는 자동화가 만든 조합 흐름에서 DOM 목록과 이벤트를 관찰한 것입니다. 특정 OS 입력기의 이벤트 순서나 Enter 확정·폼 제출까지 입증하지 않습니다. 본문의 코드·대기 시간·검색어와 환경을 함께 비교해야 같은 결과인지 판단할 수 있습니다.

제품에서 마칠 확인과 예제의 경계

  1. 대상 기기의 실제 한글 입력기로 자모를 천천히 입력합니다. 조합 도중 250ms보다 오래 멈춰도 새 필터나 요청이 실행되지 않는지 확인합니다.
  2. 조합 확정과 취소를 각각 시험합니다. Enter로 확정할 때 폼 제출이 함께 일어나는지, 마우스로 다른 곳을 눌렀을 때 최종 값이 반영되는지 별도로 확인합니다. 이 예제에는 폼과 Enter 제출 처리기가 없습니다.
  3. 영문 입력·붙여넣기·삭제·빈 값·연속 조합을 확인합니다. 테스트 로그에는 이벤트 종류·조합 여부·작업 횟수 위주로 기록하고 실제 사용자의 검색어 원문은 불필요하게 수집하지 않습니다.
  4. 실제 검색 API를 연결하면 입력 예약과 진행 중 요청을 나누어 관리합니다. 새 검색이 시작된 뒤 이전 응답이나 오류가 화면을 덮지 않는지는 관련 요청 관리 글의 절차로 검증합니다.
  5. SPA에서 입력칸을 제거할 때는 타이머와 리스너를 정리합니다. 다른 화면의 이벤트가 이 화면의 조합 상태를 계속 소유하지 않게 컴포넌트 수명을 정하세요.

확인한 원문과 관련 글

2026년 11월 19일 아래 MDN 원문을 직접 열어 조합 시작·종료, isComposing, input과 타이머 취소 조건을 확인했습니다. 기존 검색 글 847은 요청을 보낸 뒤의 결과·오류 소유자이고, Flutter 입력 글 419는 controller와 검증·해제입니다. 웹 입력기의 조합 중 실행을 다루는 이번 글과 목적을 구분했습니다.