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

CKTIS / JavaScript

Storage: броене на записите и четене на имената на ключовете

Storage предоставя низови двойки ключ–стойност чрез localStorage и sessionStorage. Научете разликата между Storage.length, която брои записите, и Storage.key(index), която връща име на ключ, а не стойността му.

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

Синтаксис

storage.length
storage.key(index)
storage.getItem(key)
storage.setItem(key, value)
storage.removeItem(key)
storage.clear()

Storage е интерфейс на Web API, дефиниран от HTML, а не от ECMAScript. Достъп до обектите му получавате чрез window.localStorage или window.sessionStorage. Първият е предназначен за съхранение на данни и след текущата сесия; вторият е свързан със сесията и произхода на раздела. Ключовете и стойностите са низове.

Storage.length е свойство само за четене: показва броя на двойките, а не размера им в байтове. При извикване на Storage.key(index) Web IDL първо преобразува аргумента до типа unsigned long. Методът използва преобразуваната стойност като индекс с броене от нула и връща име на ключ или null, ако този индекс е по-голям или равен на length. Например storage.key(2 ** 32) използва индекс 0 и връща име на ключ, ако хранилището не е празно. Прочетете стойността с getItem(key).

Редът на ключовете не е зададен и може да се променя при промени. Не приемайте, че съответства на реда на добавяне, и не премахвайте записи, докато обхождате по индекси. За възпроизводимо показване съберете имената и ги сортирайте.

Достъпът може да предизвика SecurityError, а записването може да предизвика QuotaExceededError. Обработвайте тези грешки в приложенията. Примерът първо се опитва да използва window.sessionStorage. Ако прихване SecurityError или QuotaExceededError, използва тестово хранилище в паметта вместо Web Storage и извежда същия резултат в конзолата. Наличието на Node 24 в хранилище с код не доказва поддръжка на този Web API.

Примери

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage: counting entries and reading key names</title>
</head>
<body>
<h1>Counting storage entries and listing their keys</h1>
<p id="source"></p>
<script>
  function inspectStorage(storage) {
    const names = ['cktis:storage:a', 'cktis:storage:b'].map(base => {
      let name = base;
      let suffix = 0;
      while (storage.getItem(name) !== null) name = `${base}:${++suffix}`;
      return name;
    });
    const written = [];
    try {
      const before = storage.length;
      for (const [index, value] of ['10', '20'].entries()) {
        storage.setItem(names[index], value);
        written.push(names[index]);
      }

      const count = storage.length;
      const keys = [];
      for (let index = 0; index < count; index++) {
        const name = storage.key(index);
        if (names.includes(name)) keys.push(name);
      }
      return [count - before, keys.length, storage.key(count) === null];
    } finally {
      for (const name of written) storage.removeItem(name);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = inspectStorage(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = 'The browser storage test write is unavailable. Using an in-memory fixture for this demonstration.';
    const entries = new Map();
    lines = inspectStorage({
      get length() { return entries.size; },
      key(index) { return Array.from(entries.keys())[index] ?? null; },
      getItem(key) { return entries.has(key) ? entries.get(key) : null; },
      setItem(key, value) { entries.set(key, String(value)); },
      removeItem(key) { entries.delete(key); }
    });
  }
  document.getElementById('source').textContent = source;
  for (const line of lines) console.log(line);
</script>
</body>
</html>

Резултат

2
2
true

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

Източници