База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Съхранение в браузъра

Съхранението в браузъра включва механизми на средата на браузъра за запазване на данни от страната на клиента. Научете разликата между localStorage и sessionStorage и границата между езика ECMAScript и уеб API-тата.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

localStorage.setItem(key, value);
localStorage.getItem(key);
localStorage.removeItem(key);

Съхранението в браузъра (browser storage) е възможност на средата, а не синтаксис на ECMAScript. Спецификацията ECMAScript описва езика и взаимодействието му с хост средата; тя не дефинира localStorage или sessionStorage. Наличието на Node 24 в хранилище с код не доказва, че тези интерфейси са достъпни в целевия браузър.

localStorage запазва двойки ключ-стойност между сесиите, докато sessionStorage е свързано със сесията на страница в конкретен раздел. И двата интерфейса са синхронни и съхраняват низове. Ако ключът липсва, getItem(key) връща null. Обекти могат да се записват с JSON.stringify и да се прочитат с JSON.parse.

Достъпът зависи от произхода на страницата и правилата на браузъра. Данните може да бъдат премахнати, а достъпът или записването може да предизвикат изключение. Не разглеждайте това хранилище като единствено копие на данните или като място за тайни. Разделът Web Storage на стандарта HTML на WHATWG дефинира localStorage и sessionStorage и техните методи. Той не е справочник за съвместимост с браузърите и не гарантира, че тези интерфейси са достъпни в целевия браузър.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Browser storage example</title>
</head>
<body>
  <p>localStorage can persist across visits. sessionStorage is scoped to the page session in a tab. Both are browser APIs, not part of ECMAScript.</p>
  <ul aria-label="Storage check results">
    <li id="localStorage"></li>
    <li id="sessionStorage"></li>
  </ul>
  <script>
    const fixture = JSON.stringify({ theme: 'dark' });

    function checkStorage(name) {
      const result = document.getElementById(name);
      try {
        const store = window[name];
        // A fresh temporary key avoids reusing application keys. This sequence is not atomic:
        // another same-origin tab can change localStorage between calls.
        const key = `cktis:storage:example:${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
        if (store.getItem(key) !== null) {
          throw new Error('Temporary storage key already exists');
        }
        store.setItem(key, fixture);
        let saved;
        try {
          saved = store.getItem(key);
        } finally {
          store.removeItem(key);
        }
        if (saved !== fixture || store.getItem(key) !== null) {
          throw new Error('Round trip or cleanup failed');
        }
        result.textContent = `${name}: read back theme=${JSON.parse(saved).theme}; temporary key removed.`;
      } catch (error) {
        if (!(error instanceof DOMException) || !['SecurityError', 'QuotaExceededError'].includes(error.name)) {
          throw error;
        }
        result.textContent = `${name}: temporary write unavailable (${error.name}).`;
      }
      console.log(result.textContent);
    }

    checkStorage('localStorage');
    checkStorage('sessionStorage');
  </script>
</body>
</html>

Резултат

A successful check reports that it read back theme=dark and removed the temporary key. If the check catches a DOMException named SecurityError or QuotaExceededError, it reports that the temporary write is unavailable and includes the error name. Other errors, including a temporary-key collision or a detected round-trip or cleanup failure, are rethrown without a report for that storage area. If the localStorage check rethrows, the sessionStorage check does not run.

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници