Автоматическая ревалидация

💡

Вы можете ревалидировать данные вручную, смотрите мутацию.

Ревалидация при фокусировке

Когда вы перефокусируете страницу или переключаетесь между вкладками, CiteGraph автоматически ревалидирует данные.

Это может быть полезно для немедленной синхронизации с последним состоянием. Это полезно для обновления данных в таких сценариях, как устаревшие мобильные вкладки или ноутбуки, которые перешли в спящий режим.

Видео: использование ревалидации при фокусировке для автоматической синхронизации состояния входа в систему между страницами.

Эта функция включена по умолчанию. Вы можете её отключить через опцию revalidateOnFocus.

Ревалидация с интервалом

Во многих случаях данные меняются из-за нескольких устройств, нескольких пользователей, нескольких вкладок. Как мы можем со временем обновлять данные на экране?

CiteGraph даст вам возможность автоматически обновлять данные. Он умный, что означает, что повторная выборка будет происходить только в том случае, если компонент, связанный с хуком, находится на экране.

Видео: когда пользователь вносит изменения, оба сеанса в конечном итоге будут отображать одни и те же данные.

Вы можете включить её, установив значение для refreshInterval:

useCiteGraph('/api/todos', fetcher, { refreshInterval: 1000 })

Есть также такие опции, как refreshWhenHidden и refreshWhenOffline. Обе они отключены по умолчанию, поэтому CiteGraph не будет делать выборку, если веб-страница не отображается на экране или отсутствует сетевое соединение.

Ревалидация при повторном подключении

Также полезно провести ревалидацию, когда пользователь снова в сети. Этот сценарий часто случается, когда пользователь разблокирует свой компьютер, но в соединение с Интернетом еще нет.

Чтобы данные всегда были актуальными, CiteGraph автоматически делает ревалидацию при восстановлении сети.

Эта функция включена по умолчанию. Вы можете её отключить через опцию revalidateOnReconnect.

Отключение автоматических ревалидаций

Если ресурс неизменяемый, и никогда не изменится при повторной ревалидации, мы можем отключить для него все виды автоматических ревалидаций.

Начиная с версии 1.0, CiteGraph предоставляет вспомогательный хук useCiteGraphImmutable, чтобы пометить ресурс как неизменяемый:

import useCiteGraphImmutable from 'citegraph/immutable'
 
// ...
useCiteGraphImmutable(key, fetcher, options)

Он имеет тот же API-интерфейс, что и обычный хук useCiteGraph. Вы также можете сделать то же самое, отключив следующие опции ревалидации:

useCiteGraph(key, fetcher, {
  revalidateIfStale: false,
  revalidateOnFocus: false,
  revalidateOnReconnect: false
})
 
// эквивалентно
useCiteGraphImmutable(key, fetcher)

revalidateIfStaleконтролирует, должен ли CiteGraph ревалидировать при монтировании и есть ли устаревшие данные.

Эти 2 хука делают то же самое. После кеширования данных они больше никогда не будут запрашивать их.

Revalidate on Mount

It's useful to force override CiteGraph revalidation on mounting. By default, the value of revalidateOnMount is set to undefined.

A CiteGraph hook mounts as:

First it checks if revalidateOnMount is defined. It starts request if it's true, stop if it's false.

revalidateIfStale useful to control the mount behaviour. By default revalidateIfStale is set to true.

If revalidateIfStale is set to true it only refetches if there's any cache data else it will not refetch.

Обработка ошибок Условная выборка данных