브라우저 뒤로가기에서 검색 필터가 복원되지 않을 때

자료 목록에서 ‘가이드’를 고른 뒤 ‘예제’를 골랐습니다. 뒤로가기를 누르자 주소는 ?type=guide로 돌아왔는데 화면에는 여전히 예제만 보입니다. 이 경우에는 브라우저가 주소를 복원했을 때 목록도 다시 그리는지 확인하세요. 아래 예제에서는 주소의 type 값을 읽어 버튼과 목록을 함께 갱신합니다.

주소와 화면 중 어디에서 값이 어긋나는지 확인합니다

증상 먼저 확인할 곳 수정 방향
뒤로가면 주소만 바뀜 popstate에서 현재 주소를 읽는지 돌아온 주소의 필터로 버튼과 목록을 다시 그림
필터를 선택하면 주소만 바뀜 pushState() 직후 화면을 갱신하는지 새 항목을 추가하고 화면도 바로 갱신
같은 버튼을 여러 번 눌렀더니 뒤로가기를 그만큼 눌러야 함 필터가 그대로인데 새 방문 기록을 추가하는지 사용자가 다른 필터를 확정할 때만 항목을 추가
링크를 직접 열거나 새로고침하면 전체 목록이 나옴 처음 화면을 그릴 때 주소를 읽는지 첫 로드와 이력 이동에서 같은 렌더링 함수를 사용

확정한 필터를 주소에 넣는 예제

아래를 history-example.html로 저장해 로컬 HTTP 서버에서 엽니다. ‘가이드’, ‘예제’를 차례로 누른 뒤 뒤로가기를 두 번 누르세요. 예제의 목록은 세 건이며 검색 서버에 요청하지 않습니다.

<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<title>자료 목록 필터와 방문 기록</title>
<p>보기</p>
<button type="button" data-filter="all">전체</button>
<button type="button" data-filter="guide">가이드</button>
<button type="button" data-filter="example">예제</button>
<p id="status" role="status"></p>
<ul id="results"></ul>
<script>
  const documents = [
    { kind: 'guide', title: '배포 확인표' },
    { kind: 'example', title: '검색 폼 예제' },
    { kind: 'guide', title: '접근성 점검표' }
  ];
  const filters = new Set(['all', 'guide', 'example']);
  const buttons = document.querySelectorAll('[data-filter]');
  const status = document.querySelector('#status');
  const results = document.querySelector('#results');

  function readFilter() {
    const value = new URL(location.href).searchParams.get('type');
    return filters.has(value) ? value : 'all';
  }

  function render() {
    const filter = readFilter();
    const shown = documents.filter(
      (item) => filter === 'all' || item.kind === filter
    );
    for (const button of buttons) {
      button.setAttribute('aria-pressed', String(button.dataset.filter === filter));
    }
    const items = shown.map((item) => {
      const li = document.createElement('li');
      li.textContent = item.title;
      return li;
    });
    results.replaceChildren(...items);
    status.textContent = '자료 ' + shown.length + '건';
  }

  for (const button of buttons) {
    button.addEventListener('click', () => {
      const next = button.dataset.filter;
      if (next === readFilter()) return;

      const url = new URL(location.href);
      if (next === 'all') url.searchParams.delete('type');
      else url.searchParams.set('type', next);

      history.pushState(null, '', url);
      render();
    });
  }

  window.addEventListener('popstate', render);
  render();
</script>
</html>

처음 열 때와 뒤로가기·앞으로가기에서는 현재 URL을 읽습니다. pushState()는 새 방문 기록을 추가하지만 호출 자체로 popstate가 발생하지 않으므로 버튼 클릭 처리기에서 render()도 호출합니다. 뒤로가기 처리기에서는 주소를 읽어 화면만 그립니다. 그 처리기에서 새 항목을 또 쌓으면 사용자가 돌아가려던 기록 사이에 항목이 생깁니다.

하나의 방문 기록을 보정하려면 replaceState()를 사용할 수 있습니다. 예를 들어 서비스가 현재 주소의 오래된 필터 표기만 정리한다면 방문 기록을 추가할 필요가 없습니다. 이 예제는 그대로 열 수 있는 주소를 사용하며 처음 기록의 history.state가 비어 있어도 URL에서 복원합니다.

Chrome에서 뒤로가기와 앞으로가기 순서를 확인했습니다

2026년 11월 15일 Chrome 157.0.8103.78 헤드리스로 로컬 페이지를 열어 버튼 상태, 행 개수와 주소를 확인했습니다.

조작 관찰 결과
필터 없이 열기 전체 버튼이 선택되고 자료 3건 표시
가이드를 선택하고 같은 버튼을 다시 누름 자료 2건 표시, 기존 ref=demo 유지, 같은 필터에서는 방문 기록 수 유지
예제 선택 뒤 뒤로가기 두 번 가이드 2건에서 전체 3건으로 순서대로 복원
앞으로가기 두 번 가이드 2건에서 예제 1건으로 순서대로 복원
예제 화면 새로고침, 가이드 링크 직접 열기 예제 1건과 가이드 2건을 각 주소에서 복원
등록되지 않은 type으로 열기 전체 버튼과 자료 3건 표시

검증 범위는 로컬 목록과 Chrome의 탐색입니다. 운영 라우터, 원격 검색 응답과 다른 브라우저는 별도로 확인해야 합니다.

라우터와 실제 검색을 연결할 때의 확인 순서

  1. 필터를 바꿨을 때 주소, 버튼의 선택 상태, 요청의 필터가 서로 일치하는지 봅니다. 같은 필터를 다시 선택할 때 방문 기록을 추가할 이유가 있는지 화면별로 정합니다.
  2. 라우터에 해당 주소를 복원하는 기능이 있다면 그 기능을 통해 필터를 읽습니다. URL에 넣을 값은 공유 가능한 검색 조건으로 한정합니다. 사용자 비밀이나 아직 제출하지 않은 입력은 주소에 넣지 않습니다.
  3. 검색 서버를 호출한다면 뒤로간 직후 이전 검색의 느린 응답이 도착하는 경우도 시험합니다. 현재 URL의 필터와 응답에 연결된 요청의 필터를 비교하면 기록 복원 문제와 응답 순서 문제를 구분할 수 있습니다.