LocalStorage 원리?

0 조회수
로컬스토리지 원리는 웹 브라우저가 사용자 기기 내부에 데이터를 영구 저장하는 방식입니다. 서버와 통신하지 않고 로컬 환경에서 키와 값 형태로 정보를 유지합니다. 브라우저 창을 닫거나 기기를 재부팅해도 저장된 데이터는 삭제되지 않고 그대로 남습니다.
의견 0 좋아요

로컬스토리지 원리: 브라우저 데이터 영구 저장 방식

로컬스토리지 원리를 정확히 이해하면 웹 서비스의 데이터 관리 효율을 크게 높입니다. 불필요한 서버 요청을 줄이고 사용자 환경에 필요한 정보를 안전하게 보관하는 핵심 기술입니다. 브라우저 저장소가 작동하는 구체적인 구조와 특징을 지금 바로 확인해 보세요.

로컬스토리지 원리: 브라우저가 데이터를 영구 저장하는 방식

로컬스토리지 원리는 웹 브라우저가 서버와의 네트워크 통신 없이 클라이언트 측 저장소에서 직접 데이터를 읽고 쓰는 구조에 있습니다. 특정 네트워크 요청을 통해 값을 주고받는 대신 키-값 쌍(Key-Value Pair)을 사용하여 온전히 브라우저의 리소스만으로 데이터를 처리합니다. 덕분에 브라우저를 완전히 종료했다가 다시 열어도 저장된 데이터가 그대로 유지됩니다.

대부분의 최신 웹 브라우저에서 LocalStorage는 출처(Origin)당 일반적으로 5MB에서 10MB 정도의 저장 공간을 제공합니다. 쿠키(Cookie)의 용량 제한이 보통 4KB 수준인 것과 비교하면 꽤 넉넉한 크기입니다. 하지만 여기서 많은 입문자가 놓치는 치명적인 실수가 하나 있습니다 - 실무에서 데이터를 잘못 저장했다가 서비스 전체가 위험해지는 문제인데, 이 부분은 뒤쪽 보안 한계 섹션에서 자세히 풀어드리겠습니다. 단순해 보입니다. 실제로 기본 사용법 자체는 매우 직관적입니다.

브라우저를 종료해도 데이터가 영구 보존되는 localStorage 작동 원리

브라우저를 껐다 켜도 데이터가 사라지지 않는 이유는 LocalStorage가 휘발성 메모리(RAM)가 아닌 사용자 기기의 로컬 디스크에 데이터를 기록하기 때문입니다. 브라우저가 닫히면 메모리 영역은 초기화되지만 디스크에 파일 형태로 저장된 데이터는 사용자가 직접 삭제하거나 코드로 지우기 전까지 영구적으로 남습니다.

출처(Origin) 기반의 격리 구조와 디스크 저장 방식

브라우저 저장소 원리의 핵심은 보안과 데이터 분리를 위한 출처(Origin) 단위 격리입니다. 출처는 프로토콜(http/https), 도메인, 포트 번호의 조합으로 결정되며, 서로 다른 출처에서는 상대방의 저장소에 접근할 수 없습니다. 내부적으로 크롬(Chrome)이나 파이어폭스(Firefox) 같은 브라우저는 이 데이터를 사용자의 로컬 프로필 폴더 안에 있는 SQLite 데이터베이스나 LevelDB 같은 경량 스토리지 엔진에 파일로 저장합니다.

제가 처음 프론트엔드 개발을 시작했을 때, 로컬스토리지 데이터가 브라우저 어딘가 구름처럼 떠다닌다고 막연히 생각한 적이 있습니다. 어느 날 테스트용 데이터가 계속 남아서 화면이 깨지는데 원인을 못 찾아 두 시간 동안 땀을 뻘뻘 흘리며 코드를 뒤집어엎었습니다. 결국 개발자 도구의 Application 탭을 열어보고 나서야 디스크에 파일로 박혀 있다는 사실을 깨달았죠. 솔직히 말해서, 원리를 모르고 쓰면 이런 사소한 문제로 반나절을 날리기 십상입니다.

동기적(Synchronous) 처리와 메인 스레드 영향

로컬스토리지 특징 중 하나는 모든 읽기 및 쓰기 작업이 동기적(Synchronous)으로 실행된다는 점입니다. 자바스크립트 코드가 데이터를 요청하면 브라우저가 디스크에서 값을 찾아 반환할 때까지 다음 코드 실행이 잠시 멈춥니다. 일반적인 설정값이나 작은 텍스트를 다룰 때는 눈치채기 어려울 만큼 빠릅니다. 하지만 수 메가바이트에 달하는 거대한 데이터를 반복해서 읽고 쓰면 메인 스레드가 차단되어 화면이 버벅거릴 수 있습니다. 주의가 필요합니다.

문자열 데이터만 저장하는 제약과 JSON.stringify() 활용법

LocalStorage는 오직 UTF-16 문자열(UTF-16 String) 형식의 데이터만 저장할 수 있도록 설계되었습니다. 숫자나 불리언, 배열, 객체(Object)를 그대로 넣으면 브라우저가 강제로 문자열로 변환해 버리기 때문에 원래의 데이터 구조가 망가집니다. 이를 해결하기 위해 실무에서는 데이터를 저장할 때 JSON.stringify()를 사용하고 불러올 때 JSON.parse()로 복원합니다.

드물게는 자바스크립트 객체를 그대로 setItem 메서드에 넘겼다가 화면에 (object Object)라는 기괴한 문자열이 출력되어 당황하는 경우가 생깁니다. 저 역시 초년생 시절 장바구니 배열을 그대로 저장했다가 결제 페이지가 통째로 먹통이 되어 식은땀을 흘린 기억이 생생합니다. 문자열 변환은 선택이 아닙니다. 필수입니다.

객체 데이터를 안전하게 다루는 기본적인 흐름은 다음과 같습니다: 1. 저장할 자바스크립트 객체나 배열을 준비합니다. 2. JSON.stringify() 함수로 객체를 JSON 형식의 문자열로 직렬화합니다. 3. localStorage.setItem()을 호출하여 키-값 쌍으로 브라우저에 저장합니다. 4. 데이터를 다시 쓸 때는 localStorage.getItem()으로 문자열을 꺼낸 뒤 JSON.parse()를 통해 원래 객체로 되돌립니다.

여기서 한 가지 더 짚고 넘어갈 부분이 있습니다. UTF-16 인코딩 방식은 문자 하나당 보통 2바이트를 차지하기 때문에 - 의외로 많은 개발자가 이 계산을 놓치는데 - 5MB 용량 제한은 실제로 약 250만 글자 내외를 저장할 수 있다는 뜻이 됩니다. 용량이 가득 찬 상태에서 데이터를 더 넣으려고 하면 QuotaExceededError 예외가 발생하므로, 중요한 로직에서는 반드시 try-catch 구문으로 예외 처리를 감싸는 습관을 들이는 편이 안전합니다.

실무에서 놓치기 쉬운 로컬스토리지 보안 한계와 XSS 위험

앞서 글 초반에 언급했던 치명적인 실수가 바로 여기입니다. LocalStorage는 자바스크립트 코드라면 누구나 접근할 수 있는 개방된 공간이기 때문에 XSS(Cross-Site Scripting) 공격에 매우 취약합니다. 만약 웹사이트에 악성 스크립트가 단 한 줄이라도 삽입되면 공격자는 로컬스토리지에 들어 있는 모든 값을 손쉽게 탈취해 외부 서버로 전송할 수 있습니다.

많은 튜토리얼에서는 로그인 후 발급받은 JWT(JSON Web Token) 인증 토큰을 LocalStorage에 저장하라고 간단하게 안내합니다. 하지만 제 경험상 실제 서비스 환경에서 민감한 인증 토큰이나 개인정보를 로컬스토리지에 그대로 두는 것은 현관문 열쇠를 화분 밑에 숨겨두는 것과 다를 바 없습니다. 현실적으로 보안 사고가 터졌을 때 피해 규모를 감당하기 어렵습니다. 물론 모든 프로젝트에 최고 수준의 보안 아키텍처를 적용하기는 부담스러울 수 있지만, 최소한 사용자 인증 정보만큼은 자바스크립트 접근을 막아주는 HttpOnly 속성이 적용된 쿠키를 사용하는 것이 훨씬 안전합니다.

그렇다면 LocalStorage에는 어떤 데이터를 넣는 것이 적절할까요? 다크 모드 설정 여부, 사용자가 마지막으로 선택한 언어, 임시 작성 중인 게시글 초안, 혹은 오늘 하루 보지 않기 같은 팝업 상태값처럼 외부에 노출되어도 보안상 큰 타격이 없는 UI 상태 데이터를 저장하는 용도가 가장 이상적입니다. 보안이 중요한 데이터와 단순 편의성 데이터를 명확히 구분하는 기준을 세우는 것 - 이것이 로컬스토리지 원리를 제대로 이해하고 실무에 적용하는 핵심입니다.

웹 스토리지 차이점: LocalStorage, sessionStorage, Cookie 비교

클라이언트 측 저장소는 크게 LocalStorage, sessionStorage, 그리고 Cookie 세 가지로 나뉩니다. 각 저장소의 구조적 작동 차이를 이해해야 상황에 맞는 도구를 고를 수 있습니다.

LocalStorage

  • 브라우저를 종료하고 다시 열어도 데이터가 영구적으로 유지되며 직접 삭제해야 사라짐
  • 네트워크 요청 시 서버로 자동 전송되지 않고 온전히 브라우저 리소스만 사용
  • 출처(Origin)당 일반적으로 5MB에서 10MB 수준으로 넉넉한 편
  • 다크 모드 설정, 언어 선택, 비회원 장바구니 등 영구 보존이 필요한 UI 상태

sessionStorage

  • 현재 열려 있는 브라우저 탭이나 창을 닫으면 데이터가 즉시 삭제됨
  • 서버로 자동 전송되지 않으며 같은 사이트라도 탭마다 독립적인 공간 유지
  • LocalStorage와 마찬가지로 보통 5MB에서 10MB 내외 제공
  • 일회성 입력 폼 임시 저장, 다단계 결제 진행 상태 등 세션 단위 데이터

Cookie (쿠키)

  • 만료 시간(Expires/Max-Age)을 직접 설정할 수 있으며 미설정 시 브라우저 종료 시 삭제
  • 매 HTTP 요청 헤더에 자동으로 포함되어 서버로 전송되므로 네트워크 부하 유발 가능
  • 개당 최대 4KB 정도로 용량이 매우 작아 대용량 데이터 저장 불가
  • HttpOnly 옵션을 활용한 사용자 로그인 세션 관리 및 보안 인증 토큰 저장
네트워크 트래픽을 아끼면서 브라우저를 닫아도 유지되어야 하는 일반 설정값에는 LocalStorage가 적합합니다. 반면 탭을 닫으면 사라져야 하는 임시 데이터는 sessionStorage를, 서버와 매번 통신하며 보안이 필요한 인증 정보는 HttpOnly 쿠키를 선택하는 것이 합리적입니다.

판교 스타트업 개발자 민수의 장바구니 오류 해결기

판교의 한 이커머스 스타트업에서 일하는 프론트엔드 개발자 민수는 비회원 장바구니 기능을 구현하며 LocalStorage를 도입했습니다. 상품 목록 배열을 그대로 저장하면 될 줄 알았지만, 새로고침을 할 때마다 장바구니가 깨지며 오류가 쏟아졌습니다.

민수는 처음에 브라우저 캐시 문제라고 생각해 코드만 계속 수정하며 이틀을 허비했습니다. 개발자 도구를 확인해 보니 배열 데이터가 쉼표로 이어진 일반 문자열로 변질되어 있었습니다.

로컬스토리지가 문자열만 저장한다는 원리를 뒤늦게 파악한 민수는 저장 시점에 JSON.stringify()를 적용하고, 불러올 때 JSON.parse()와 예외 처리 구문을 추가하는 방식으로 구조를 바꿨습니다.

수정 배포 후 비회원 장바구니 관련 오류 제보가 완전히 사라졌고, 브라우저를 껐다 켜도 상품이 유지되면서 비회원 구매 전환율이 이전보다 눈에 띄게 개선되었습니다.

부산 웹 에이전시 지은의 보안 감사 대응 경험

부산에서 웹 서비스를 운영하는 개발자 지은은 빠른 개발을 위해 사용자 로그인 토큰을 LocalStorage에 저장해 두었습니다. 기능은 매끄럽게 돌아갔지만, 출시 직전 외부 보안 점검에서 XSS 취약점 경고를 받았습니다.

처음에는 입력값 필터링만 강화하면 된다고 생각했지만, 서드파티 마케팅 스크립트 하나만 뚫려도 토큰이 통째로 유출될 수 있다는 지적을 받고 고민에 빠졌습니다.

지은은 결국 인증 토큰 저장 방식을 HttpOnly 쿠키로 전면 교체하고, LocalStorage에는 사용자 테마 설정과 최근 본 상품 목록만 남기도록 역할을 분리했습니다.

일주일간의 리팩토링 끝에 보안 감사를 무사히 통과했고, 이후 신규 프로젝트를 설계할 때도 데이터 민감도에 따라 저장소를 나누는 명확한 기준을 팀에 정착시켰습니다.

다른 관점

브라우저를 종료해도 데이터가 클라이언트 측에 영구 보존되는 원리가 무엇인가요?

LocalStorage는 휘발성 메모리인 RAM이 아니라 사용자 컴퓨터나 스마트폰의 로컬 디스크에 파일 형태로 데이터를 기록합니다. 따라서 브라우저를 닫았다가 다시 실행해도 디스크에 남아 있는 데이터를 그대로 불러올 수 있습니다.

쿠키(Cookie) 및 세션스토리지(sessionStorage)와의 구조적 작동 차이는 무엇인가요?

쿠키는 매 네트워크 요청마다 서버로 자동 전송되며 용량이 약 4KB로 작습니다. 반면 LocalStorage와 sessionStorage는 서버로 전송되지 않고 5MB 이상을 저장할 수 있으며, 탭을 닫을 때 데이터가 지워지는지(sessionStorage) 영구 유지되는지(LocalStorage)에 차이가 있습니다.

문자열 데이터만 저장할 수 있는 제약 조건에서 객체(Object) 데이터는 어떻게 다루나요?

자바스크립트 객체나 배열을 저장할 때는 JSON.stringify() 함수를 사용해 문자열 형태로 변환한 뒤 setItem으로 넣어야 합니다. 데이터를 다시 꺼내어 쓸 때는 getItem으로 가져온 문자열을 JSON.parse()로 변환해 원래 객체로 복구합니다.

시크릿 모드(Incognito Mode)에서도 로컬스토리지 데이터가 영구적으로 남나요?

아니요, 시크릿 모드에서는 개인정보 보호를 위해 LocalStorage가 임시로만 작동합니다. 시크릿 창을 모두 닫는 순간 해당 세션에서 저장된 모든 로컬스토리지 데이터는 디스크에서 즉시 삭제됩니다.

마지막 조언

네트워크 통신 없는 디스크 기반 영구 저장

LocalStorage는 서버 요청 없이 브라우저 자체 리소스와 로컬 디스크를 사용해 출처(Origin)별로 보통 5MB에서 10MB의 데이터를 영구 보존합니다.

더 안전한 데이터 관리를 위해 로컬 스토리지와 쿠키의 차이점도 함께 확인해 보시기 바랍니다.
문자열 전용 구조와 JSON 직렬화 필수

모든 데이터는 UTF-16 문자열로만 저장되므로, 객체나 배열을 다룰 때는 반드시 JSON.stringify()와 JSON.parse()를 함께 사용해야 데이터 손상을 막을 수 있습니다.

XSS 취약점을 고려한 보안 데이터 분리

자바스크립트로 누구나 접근할 수 있어 XSS 공격에 노출될 위험이 크므로, 로그인 토큰 같은 민감 정보는 HttpOnly 쿠키에 보관하고 UI 설정값 위주로 활용해야 합니다.

동기적 작동 방식과 용량 초과 예외 처리

읽기 및 쓰기 작업이 동기적으로 처리되어 대용량 데이터 조작 시 화면이 느려질 수 있으며, 용량 제한 초과 시 발생하는 오류를 대비해 try-catch 처리가 필요합니다.