СПРАВОЧНИК FRAMECACHE / 01

Несколько заметок
о свежести.

Политика кэша отвечает не только на вопрос «как долго?». Разделяйте хранение, свежесть и валидацию, чтобы понять, что ответ на самом деле разрешает.

Как начать

Откройте инспектор сети в браузере, выберите ответ и найдите Cache-Control в его заголовках ответа. Скопируйте значение в калькулятор, введите текущий возраст в секундах и выберите кэш, который хотите проверить.

  1. Общий кэш: кэш, который может обслуживать нескольких пользователей — например, промежуточный прокси или CDN.
  2. Браузерный кэш: приватный кэш, связанный с браузером одного пользователя.
  3. Разобрать политику: показывает оценку по указанным директивам. Ресурс при этом не запрашивается.
ПРИМЕРpublic, max-age=3600

При текущем возрасте 120 секунд у ответа остаётся 3 480 секунд — 58 минут — свежести.

Свежесть — это обратный отсчёт.

Для явного срока жизни калькулятор использует:

осталось = max(0, срок жизни − текущий возраст)

Ответ свеж, только пока его текущий возраст меньше срока свежести. На границе срока он устаревает. Устаревание не всегда означает непригодность: кэш может провести валидацию, а отдельная политика — разрешить ограниченное использование устаревшего ответа.

Заголовок Age — полезный снимок, но точный текущий возраст зависит также от дат ответа, времени передачи и того, сколько ответ пролежал в кэше. Если вы скопировали старый ответ, учтите прошедшее время. Калькулятор не вычисляет эти тайминги сам, но может оценить возраст от заголовка Date — см. блок «Дополнительно».

Директивы простыми словами.

max-age=N
У ответа явный срок свежести N секунд.
s-maxage=N
Переопределяет max-age для общего кэша. Для такого кэша устаревший ответ должен пройти успешную валидацию перед использованием.
public
Разрешает хранение в общем кэше там, где иначе оно было бы ограничено. Сам по себе срок жизни не задаёт.
private
Общий кэш не должен хранить неполевой private-ответ. Приватный браузерный кэш всё ещё может его сохранить.
no-store
Ответ не должен сохраняться. Это инструкция о хранении, а не короткий срок свежести.
no-cache
Сохранённый ответ требует успешной валидации перед использованием. Само хранение не запрещено.
must-revalidate
После устаревания ответ требует успешной валидации перед использованием.
proxy-revalidate
Применяет требование валидации устаревшего ответа к общим кэшам.
stale-while-revalidate=N
Может разрешить использование устаревшего ответа ещё N секунд, пока валидация идёт в фоне. Калькулятор не показывает этот допуск, если действует более строгое требование валидации.

Читайте политику. Держите контекст.

Калькулятор — компактный пояснитель, а не полный симулятор кэша HTTP. Он проверяет директивы выше и требует однозначных целочисленных значений срока. Неизвестные расширенные директивы не оцениваются.

Полное решение о кэшировании зависит также от метода и заголовков запроса, статуса ответа, Authorization, Vary, Expires, валидаторов вроде ETag, реализации кэша и локальной конфигурации. «Разрешено этой политикой» не гарантирует, что ответ будет закэширован.

Полевые private и no-cache требуют обработки на уровне полей; инструмент намеренно применяет консервативную трактовку всего ответа. Без max-age или применимого s-maxage он сообщает о незаданном сроке (или использует Expires с Date, если они указаны), а не угадывает. Он не оценивает stale-if-error и immutable.

Маленький по замыслу. Локальный по умолчанию.

Калькулятор работает целиком в вашем браузере. Ввод заголовков не загружается, не сохраняется и не попадает в URL страницы. Framecache не использует аналитику, сторонние скрипты, cookie или внешние шрифты. Настройка темы хранится локально в браузере (localStorage) и никуда не отправляется.

Загрузка этих страниц всё же выполняет обычные запросы к веб-хосту, который может вести стандартные журналы доступа. Не вставляйте учётные данные или другие чувствительные данные; инструменту нужны только директивы кэша и значение возраста.

Попробовать политику