js-cache-storage — правило для Claude Code
Правило js-cache-storage требует держать значения localStorage, sessionStorage и cookie в памяти, а не дёргать синхронное хранилище на каждом вызове.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/js-cache-storage.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/js-cache-storage.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/js-cache-storage.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/js-cache-storage.mdВручную: положить файлы
.clinerules/js-cache-storage.mdПо шагам, с командами для каждой платформы: 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