웹앱 이미지 미리보기 Object URL 정리: 교체·오류·화면 종료 시점

이미지를 바꿀수록 탭이 무거워지거나, 첫 미리보기는 보였는데 저장·새 탭 열기에서 실패한다면 URL을 누가 만들었고 언제 마지막 사용이 끝났는지 먼저 추적하세요. img.src를 바꾼 것과 URL.revokeObjectURL()로 연결을 해제한 것은 다른 동작입니다. 반대로 화면에서 여전히 사용하는 URL을 너무 빨리 해제해도 문제가 생깁니다.

이 글은 브라우저에서 이미 확보한 File을 이미지 한 장으로 미리보는 경우의 수명을 다룹니다. 파일 선택창의 재선택·초기화 문제는 같은 파일 재선택 가이드, 서버 전송 뒤 413·multipart 문제는 파일 업로드 점검으로 나누세요. 아래 코드는 이 사이트의 실행 기능이 아닌 설명용 코드입니다.

누적과 조기 해제를 증상으로 구분하세요

관찰한 증상 첫 확인 다음 조치
같은 사진을 바꿀 때 생성 호출만 늘어남 성공한 create와 대응하는 revoke 수, 현재 사용 중인 URL 수 교체·실패·제거·화면 종료 경로를 한 소유자에서 정리
보이지만 저장·새 탭 열기가 실패함 load 직후 표시 URL을 해제했는지 사용자가 접근하는 동안 유지하고 마지막 사용이 끝난 뒤 해제
B를 골랐는데 늦게 A로 돌아감 선택 번호와 decode 완료 번호 최신 작업만 반영하고 오래된 후보 URL 해제
새 파일이 깨졌더니 이전 이미지도 없어짐 기존 표시를 후보 decode 전에 비웠는지 유지·삭제 정책을 정하고 후보 실패와 기존 표시를 분리
revoke했는데 메모리 수치가 즉시 줄지 않음 File 참조·이미지 요소·이벤트·디코딩 자원 등 다른 보유자 URL 연결 수와 전체 메모리 측정을 구분
새로고침 뒤 저장한 blob 주소로 복구되지 않음 임시 URL 문자열만 영구 데이터처럼 저장했는지 실제 파일·Blob 보관 정책과 재생성 흐름 설계

누적 수는 진단 출발점입니다. 생성과 해제 수가 맞는다는 사실만으로 전체 앱의 메모리 누수가 없다고 판정할 수는 없습니다. 사용자 사진 내용·전체 파일 경로·blob URL 원문 대신 작업 번호, 활성 소유 개수, 단계와 오류 분류를 기록하세요.

표시 중인 URL은 load 직후 해제하지 마세요

createObjectURL 문서에서 이 함수는 Blob·File 같은 객체를 참조할 URL을 만듭니다. 같은 File로 다시 호출해도 같은 주소를 돌려주는 캐시가 아닙니다. File API 사용 안내도 매번 만들어진 URL의 해제 책임을 설명합니다. 생성은 파일이 바뀌는 지점에 두고 화면 렌더 함수가 실행될 때마다 만들지 마세요.

MDN blob URL 메모리 관리는 이미지 load 직후 해제하는 패턴이 저장·새 탭 열기 같은 사용자 동작을 망가뜨릴 수 있다고 경고합니다. 이 예제는 화면에 표시된 URL을 다음 이미지로 교체하거나 명시적으로 제거할 때까지 유지합니다. 후보 이미지가 decode되었다는 이유만으로 그 후보의 URL을 바로 해제하지 않습니다.

문서가 끝날 때 브라우저가 정리하는 동작에만 의존하면, 문서는 그대로 둔 채 화면만 여러 번 교체하는 앱에서 자원이 오래 남을 수 있습니다. 이미지가 DOM에서 없어지는 상황을 앱이 알고 있다면 그 소유권도 함께 끝내세요. URL을 다른 카드·다운로드 링크·새 창과 공유한다면 마지막 사용자까지 추적해야 하며, 아래의 한 요소 소유 예제를 그대로 공유 URL 관리자로 쓰지 않습니다.

교체·실패·종료를 한 소유자에 모은 예제

다음 함수는 표시용 img 한 개를 독점해서 관리합니다. 시작할 때는 src가 없는 빈 요소를 넘기고, 이후 다른 코드가 그 요소의 src를 동시에 바꾸거나 생성 URL을 외부에 공유하지 않는 조건입니다. 새 후보를 별도 Image로 decode하는 동안 기존 이미지를 유지합니다. 최신 후보만 표시하고, 사용이 끝난 URL은 한 번씩 해제하도록 상태를 분리했습니다.

decode 문서는 완료 Promise와 오류를 설명합니다. 요청 변경·실패·손상 등 여러 이유로 거절될 수 있으므로 모든 실패를 메모리 누수로 부르지 마세요. 여기서 shown은 후보 decode 뒤 표시 요소의 src를 교체했다는 반환 상태이며, 화면 페인트나 서버 업로드까지 확인했다는 뜻이 아닙니다.

function createImagePreview(img, {
  urlAPI = URL,
  makeImage = () => new Image(),
} = {}) {
  let revision = 0;
  let displayed = null;
  let pending = null;
  let closed = false;

  function release(item) {
    if (!item || item.released) return;
    item.released = true;
    urlAPI.revokeObjectURL(item.url);
  }

  function cancelPending() {
    if (!pending) return;
    pending.probe?.removeAttribute('src');
    release(pending);
    pending = null;
  }

  async function show(file) {
    if (closed) return 'closed';
    const ticket = ++revision;
    cancelPending();
    let item;
    try {
      item = { url: urlAPI.createObjectURL(file), released: false, probe: null };
      pending = item;
      item.probe = makeImage();
      item.probe.src = item.url;
      await item.probe.decode();
      if (closed || ticket !== revision) return 'ignored';

      const old = displayed;
      img.src = item.url;
      img.hidden = false;
      displayed = item;
      pending = null;
      release(old); // 새 URL로 교체한 뒤 이전 표시 URL을 해제합니다.
      return 'shown';
    } catch {
      return closed || ticket !== revision ? 'ignored' : 'failed';
    } finally {
      if (item !== displayed) release(item);
      if (pending === item) pending = null;
      item?.probe?.removeAttribute('src');
      if (item) item.probe = null;
    }
  }

  function clear() {
    revision += 1;
    cancelPending();
    img.removeAttribute('src');
    img.hidden = true;
    release(displayed);
    displayed = null;
  }

  function dispose() {
    if (closed) return;
    closed = true;
    clear();
  }

  return { show, clear, dispose };
}

cancelPending은 아직 화면에 쓰지 않은 후보의 src와 URL 연결을 정리합니다. 이것이 브라우저 내부 디코딩 작업과 메모리를 즉시 모두 없앤다는 보장은 없습니다. 완료 번호 검사도 별도로 남겨, 취소 뒤 뒤늦게 완료·실패하는 경우가 현재 표시를 바꾸지 않게 합니다. 이 코드의 removeAttribute와 revoke는 표준 브라우저 요소·URL 구현을 전제로 하며 사용자 정의 정리 함수의 예외 복구까지 포함하지 않습니다.

다음은 연결 지점을 보여주는 호출 예입니다. 파일 선택 이벤트 자체와 File 확보·초기화는 앞서 연결한 재선택 글에서 따로 다룹니다. 파일의 종류·크기 정책은 호출 전에 결정하세요. Blob.type 문서처럼 MIME 문자열이 비거나 실제 내용과 다를 수 있으므로 이 속성 하나로 보안 검증을 끝내지 않습니다. 파일 바이트 크기만으로 큰 이미지의 디코딩 자원까지 제한했다고 볼 수도 없습니다.

// HTML: <img id="photo-preview" alt="선택한 이미지 미리보기" hidden>
const owner = createImagePreview(document.querySelector('#photo-preview'));

// FileList에서 확보하고 앱 정책으로 검사한 File을 전달합니다.
async function applySelectedFile(file) {
  const result = await owner.show(file);
  if (result === 'shown') {
    // 새 후보의 decode 완료 후 src를 교체했습니다. 업로드 성공이 아닙니다.
  } else if (result === 'failed') {
    // 기존 이미지는 유지됩니다. 최신 선택의 미리보기 실패를 안내하세요.
  }
  // ignored·closed는 오래되었거나 종료된 작업이므로 현재 안내를 덮지 않습니다.
}

// 명시적 제거 버튼: owner.clear();
// 컴포넌트를 완전히 끝낼 때: owner.dispose(); 이후에는 새 owner를 만듭니다.

제거·화면 종료·공유 URL의 계약을 정하세요

시점 이 예제의 정책 호출부가 맡을 일
새 파일 선택·decode 진행 이전 미완료 후보는 정리하고 현재 표시 이미지는 유지 현재 선택을 읽는 중이라고 안내
최신 후보 decode 성공 표시 src 교체 뒤 이전 표시 URL 해제 업로드 완료와 혼동하지 않는 상태 문구
최신 후보 생성·decode 실패 후보만 해제하고 기존 표시 유지 실패한 새 선택과 남아 있는 기존 이미지를 명확히 구분
clear 표시와 후보 정리, 이후 show 가능 입력 필드와 별도 File 참조도 제품 정책에 따라 비우기
dispose clear 후 닫힘, 이후 show는 closed 컴포넌트 종료 훅 연결, 외부 리스너·File 참조 제거
URL을 여러 요소에서 공유 지원 범위 밖 공유 소유권과 마지막 해제 주체를 별도로 설계

페이지 이동 버튼에서만 dispose를 호출해 두면 다른 종료 경로를 놓칠 수 있습니다. 사용 중인 프레임워크의 실제 컴포넌트 종료 지점에 연결하세요. 임시로 숨겼다가 재사용할 화면에서 dispose를 호출했다면 다시 사용할 때 새 소유자를 만들어야 합니다. 표시용 URL을 해제해도 앱 상태·파일 input·리스너가 별도로 보유하는 File까지 지워지는 것은 아닙니다.

File API의 URL 수명·해제 규칙은 해제 뒤의 새 참조와 이미 시작된 요청을 구분합니다. revoke는 업로드 취소 함수나 보안상 접근 회수의 증명으로 쓰지 마세요. 영구 복원에는 URL 문자열을 그대로 저장하는 방식 대신 실제 데이터 수명과 새 URL 생성 시점을 설계해야 합니다.

모의 검사에서 확인한 결과와 확인하지 않은 것

2026년 10월 30일 Node.js v24.19.0에서 위 함수 원문을 실행하고, URL 등록부·img·Image와 decode Promise를 모의 객체로 바꾼 검사 14건을 통과했습니다. 실제 브라우저의 Object URL 등록부나 이미지 코덱을 실행한 결과가 아닙니다. 아래 수치는 자바스크립트 소유권 계산의 결과입니다.

검사 묶음 모의 관찰 결과 범위의 한계
첫 표시·교체·같은 File 재선택 표시 중 URL 유지, 교체 완료 후 활성 1개 화면 페인트·실제 파일 재선택 이벤트 미검증
이전 후보의 늦은 성공·늦은 실패 ignored, 최신 src 유지 실제 디코더의 취소 시점 미측정
decode 실패·URL 생성 실패·Image 생성 실패 실패 후보 연결 정리, 기존 표시 유지 실제 손상 이미지·브라우저 오류 미검증
clear·dispose·종료 후 재호출·소유자 분리 범위 내 연결 정리, 중복 해제 없음 프레임워크 종료 훅·리스너 해제는 별도 검증
100회 순차 교체 뒤 종료 생성 100, 해제 100, 활성 URL 0 브라우저 메모리 사용량·누수 해소를 입증하지 않음

Chrome에서 이미지 교체와 URL 해제를 확인했습니다

2026년 11월 16일 Chrome 157.0.8103.78 헤드리스에서 위 함수를 그대로 실행했습니다. 합성 PNG 두 장과 PNG로 이름만 붙인 손상 데이터를 사용했습니다. URL 등록과 해제를 세는 래퍼는 브라우저의 실제 URL API에 위임했고, 이미지 디코딩도 브라우저에서 실행했습니다.

조작 관찰 결과
320px PNG를 첫 표시 이미지가 디코딩되고 표시 URL을 로컬 fetch()로 읽을 수 있었습니다.
손상된 후보를 선택 failed가 반환됐습니다. 320px 이미지와 그 주소는 유지됐고 후보 URL만 해제됐습니다.
640px PNG로 교체 표시 이미지 폭이 640px로 바뀌었습니다. 교체 뒤 이전 주소로 시작한 새 요청은 실패했고, 표시 중인 새 주소는 읽을 수 있었습니다.
clear() src가 제거되고 이미지가 숨겨졌습니다. 방금까지 표시했던 주소는 새 요청에서 읽히지 않았습니다.
다시 표시한 뒤 dispose()를 두 번 호출 생성 4회와 해제 4회가 대응했고, 이후 show()는 closed를 반환했습니다.

검증 범위는 로컬 Chrome의 순차 교체와 해제입니다. 빠르게 연속 선택했을 때의 디코더 완료 순서는 위 모의 검사 범위이며, 우클릭 저장과 메모리 사용량은 별도로 확인해야 합니다.

대상 브라우저에서 끝낼 확인 순서

  1. 공개해도 되는 작은 테스트 이미지로 첫 표시를 확인하고, 표시 중인 URL이 아직 활성 상태인지 생성·해제 기록과 대조합니다. 기존 사진이 남아 있다면 읽는 중인 새 파일의 성공으로 표시하지 않습니다.
  2. A를 읽는 동안 B를 선택해 최종 표시가 B인지 확인합니다. A가 늦게 성공하거나 실패해도 B와 상태 문구가 바뀌지 않아야 합니다.
  3. 깨진 이미지와 지원하지 않는 형식으로 새 후보를 실패시키고, 이 글의 정책대로 이전 이미지는 남고 실패 안내는 새 선택을 가리키는지 봅니다.
  4. 표시 중에 저장·새 탭 열기 동작이 필요한 제품이면 실제 브라우저에서 따로 확인합니다. 외부 창과 URL을 공유하게 된다면 이 예제의 단독 소유 조건부터 다시 설계합니다.
  5. 제거와 실제 화면 종료를 각각 실행하고 생성·해제·활성 수를 비교합니다. 다시 진입했을 때 새 소유자로 동작하는지, 이벤트가 중복 등록되지 않는지도 봅니다.
  6. 메모리 문제는 같은 파일·횟수·대기 조건으로 별도로 측정합니다. File 참조·DOM·리스너·디코딩 자원과 URL 연결을 나눠 조사하고 revoke 직후 숫자 하나로 성공을 선언하지 않습니다.

Object URL API는 Service Worker에서 사용할 수 없습니다. Service Worker의 캐시 교체와 이 화면의 URL 정리를 섞어 캐시 전체 삭제로 해결하지 마세요. 업데이트가 오래된 파일을 제공하는 문제라면 PWA 업데이트·캐시 가이드에서 별도로 확인합니다.

공식 원문과 관련 가이드

2026년 10월 30일 아래 원문을 직접 열어 생성·해제·decode·유형 판단 조건을 대조했습니다. 2026년 11월 16일에는 decode와 blob URL 해제 문서를 다시 대조하고 로컬 Chrome에서 같은 함수의 순차 교체를 확인했습니다.