자료 목록에서 ‘가이드’를 고른 뒤 ‘예제’를 골랐습니다. 뒤로가기를 누르자 주소는 ?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의 탐색입니다. 운영 라우터, 원격 검색 응답과 다른 브라우저는 별도로 확인해야 합니다.
라우터와 실제 검색을 연결할 때의 확인 순서
- 필터를 바꿨을 때 주소, 버튼의 선택 상태, 요청의 필터가 서로 일치하는지 봅니다. 같은 필터를 다시 선택할 때 방문 기록을 추가할 이유가 있는지 화면별로 정합니다.
- 라우터에 해당 주소를 복원하는 기능이 있다면 그 기능을 통해 필터를 읽습니다. URL에 넣을 값은 공유 가능한 검색 조건으로 한정합니다. 사용자 비밀이나 아직 제출하지 않은 입력은 주소에 넣지 않습니다.
- 검색 서버를 호출한다면 뒤로간 직후 이전 검색의 느린 응답이 도착하는 경우도 시험합니다. 현재 URL의 필터와 응답에 연결된 요청의 필터를 비교하면 기록 복원 문제와 응답 순서 문제를 구분할 수 있습니다.