К основному содержанию
правило CX Codex

js-cache-storage — правило для Claude Code

Правило js-cache-storage требует держать значения localStorage, sessionStorage и cookie в памяти, а не дёргать синхронное хранилище на каждом вызове.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/js-cache-storage.md
Открыть на GitHub

Что делает js-cache-storage

localStorage, sessionStorage и document.cookie синхронные, и каждое чтение стоит времени. Правило требует прочитать значение один раз, а дальше брать его из памяти.

Внутри два рецепта. Для хранилища служит Map: заполняется при первом обращении по ключу, а setLocalStorage обновляет его вместе с записью. Для cookie хватает обычного объекта, собранного из document.cookie один раз. Map выбран вместо хука, потому что тогда кэш работает и в утилитах, и в обработчиках событий, не только в компонентах React.

Хранилище меняется не только из вашего кода. Соседняя вкладка или сервер, выставивший cookie, оставят в кэше старое значение, поэтому правило добавляет подписку на storage и очистку по visibilitychange, когда вкладка снова становится видимой. Без этого кэш тихо расходится с реальностью.

Какие задачи решает

  • убрать повторные чтения localStorage из горячего пути рендера
  • собрать cookie в объект вместо парсинга document.cookie на каждый запрос
  • синхронизировать кэш при записи через setItem
  • сбросить устаревшие ключи, когда их поменяла другая вкладка
  • держать кэш в утилите, а не в React-хуке

Примеры запросов агенту

  • Перепиши getTheme так, чтобы localStorage читался один раз и кэшировался в Map
  • Добавь сброс кэша по событию storage
  • Закэшируй чтение cookie в объект, не парси document.cookie каждый раз

Как установить js-cache-storage

Вручную: положить файлы

.claude/rules/js-cache-storage.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о js-cache-storage

Как установить js-cache-storage в Claude Code?

Скопируйте файл правила в .claude/rules/js-cache-storage.md в проекте.

Что делает js-cache-storage?

Учит агента кэшировать чтение localStorage, sessionStorage и document.cookie в памяти, чтобы не обращаться к синхронному API на каждом вызове.

Когда кэш нужно сбрасывать?

Когда значение может измениться в обход кода: другая вкладка записала ключ или сервер выставил cookie. Правило закрывает оба случая через событие storage и visibilitychange.

Исходный текст

js-cache-storage.md · MIT
---
title: Cache Storage API Calls
impact: LOW-MEDIUM
impactDescription: reduces expensive I/O
tags: javascript, localStorage, storage, caching, performance
---

## Cache Storage API Calls

`localStorage`, `sessionStorage`, and `document.cookie` are synchronous and expensive. Cache reads in memory.

**Incorrect (reads storage on every call):**

```typescript
function getTheme() {
  return localStorage.getItem('theme') ?? 'light'
}
// Called 10 times = 10 storage reads
```

**Correct (Map cache):**

```typescript
const storageCache = new Map<string, string | null>()

function getLocalStorage(key: string) {
  if (!storageCache.has(key)) {
    storageCache.set(key, localStorage.getItem(key))
  }
  return storageCache.get(key)
}

function setLocalStorage(key: string, value: string) {
  localStorage.setItem(key, value)
  storageCache.set(key, value)  // keep cache in sync
}
```

Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.

**Cookie caching:**

```typescript
let cookieCache: Record<string, string> | null = null

function getCookie(name: string) {
  if (!cookieCache) {
    cookieCache = Object.fromEntries(
      document.cookie.split('; ').map(c => c.split('='))
    )
  }
  return cookieCache[name]
}
```

**Important (invalidate on external changes):**

If storage can change externally (another tab, server-set cookies), invalidate cache:

```typescript
window.addEventListener('storage', (e) => {
  if (e.key) storageCache.delete(e.key)
})

document.addEventListener('visibilitychange', () => {
  if (document.visibilityState === 'visible') {
    storageCache.clear()
  }
})
```

© tech-leads-club · MIT · tech-leads-club/agent-skills

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
js-cache-property-access jarrodwatts Правило js-cache-property-access заставляет модель сохранять вложенные свойства объектов и длину массивов в локальные переменные перед выполнением циклов в JavaScript. CX Codex +1 ★ 1 064звёзд репо react-fetch-cache-patterns pproenca Скилл react-fetch-cache-patterns с 48 правилами для масштабируемой выборки и кеширования данных в React: от параллелизма запросов до защиты бэкенда, префетча и восстановления после ошибок. CX Codex +1 180установок cache-components laguagu Скилл cache-components даёт экспертные советы по кэшированию компонентов и частичному предрендерингу в Next.js 16.4+. CX Codex +1 222установок performance-optimization Mindrally Скилл performance-optimization для Claude Code задаёт правила веб-производительности: серверный рендеринг, CSS, JavaScript, ассеты и кэш. Агент применяет их при написании фронтенда. CX Codex +1 907установок competition-browser-persistence zhaoxuya520 Скилл competition-browser-persistence для Claude Code разбирает сохранённое состояние браузера в CTF-песочнице. Помогает расследовать сессии, кэши и поведение страниц после перезагрузки. CX Codex +1 109установок nextjs-cache-architecture mohamed-hossam1 Скилл nextjs-cache-architecture выстраивает архитектуру кеширования для Next.js 16+ App Router. Помогает внедрить директиву "use cache", собрать типизированный реестр тегов и настроить границы Suspense. CX Codex +1 5 100установок

Из того же набора130

Весь набор →
advanced-event-handler-refs Правило advanced-event-handler-refs учит Claude Code сохранять колбэки в useRef или useEffectEvent внутри хуков эффектов, чтобы подписки на события не пересоздавались при каждом рендере. CX Codex +1 ★ 7 191звёзд репо server-parallel-fetching Правило server-parallel-fetching для Claude Code показывает, как перестроить React Server Components для параллельных независимых запросов данных. Устраняет цепочки загрузки, где компонент ждёт другого. CX Codex +1 ★ 7 191звёзд репо _sections Правило _sections для Claude Code, которое определяет восемь разделов оптимизации производительности, их приоритеты и порядок применения. Устанавливается один раз в проект и служит справочником при анализе кода агентом. CX Codex +1 ★ 7 191звёзд репо client-passive-event-listeners Правило client-passive-event-listeners учит агента добавлять { passive: true } к обработчикам событий скролла и тача, чтобы браузер не задерживал прокрутку страницы. CX Codex +1 ★ 7 191звёзд репо rerender-use-ref-transient-values Правило rerender-use-ref-transient-values учит агента хранить часто меняющиеся значения в useRef, а не в useState, чтобы избежать перерисовок компонента на каждое обновление. CX Codex +1 ★ 7 191звёзд репо js-length-check-first Правило js-length-check-first для Claude Code, которое подсказывает проверять длину массивов перед дорогими операциями вроде сортировки или глубокого сравнения. Если длины не совпадают, массивы точно не равны — операция не нужна. CX Codex +1 ★ 7 191звёзд репо js-tosorted-immutable Правило js-tosorted-immutable заменяет мутирующий .sort() на .toSorted(), чтобы сортировка не меняла массивы в props и state React. CX Codex +1 ★ 7 191звёзд репо patterns-children-over-render-props Правило patterns-children-over-render-props для Claude Code описывает композицию React-компонентов через children вместо renderX-пропсов, в том числе для формы с разросшимися колбэками. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой