$sessionStorage

« Session » fait référence ici à Trajet en cours. Au cours du même trajet, l'instrument peut récupérer la valeur précédemment enregistrée lors de l'exécution de main() plusieurs fois, il est donc adapté au maintien de l'état inter-images tel que les valeurs de crête et les compteurs.

Le stockage appartient en même temps à l'instance d'instrument actuelle : placez deux instruments identiques sur la page, et chacun enregistre son propre état.

Il enregistre l'état observé et calculé pendant le fonctionnement de l'instrument. Si l'instrument est allumé à mi-chemin, la valeur maximale du trajet avant l'allumage ne peut pas être obtenue automatiquement ; les données qui doivent être conservées pendant une longue période ne doivent pas être enregistrées uniquement ici.

get et set utilisent des copies de données. Par exemple, si vous supprimez un tableau et y ajoutez des éléments, le tableau d'origine stocké ne changera pas et vous devrez appeler à nouveau set pour enregistrer les modifications.

La clé doit être une chaîne. Peut contenir des nombres finis, des chaînes, des valeurs booléennes, null et des objets et tableaux ordinaires composés de ces valeurs. Les fonctions, View, les références circulaires et les objets spéciaux ne peuvent pas être enregistrés. Après avoir défini une clé sur null, lisez la clé pour obtenir null ; l'interface actuelle propose deux méthodes, get et set.

Deux entrées Données de base sont définies dans Configuration des paramètres : la vitesse avec l'identifiant speed, et l'état d'enregistrement avec l'identifiant recording. Une ligne horizontale s'affiche lorsqu'il n'y a aucun trajet actif ; chaque exécution compare la vitesse actuelle avec la valeur maximale enregistrée, puis enregistre la valeur la plus élevée. Les valeurs maximales sont enregistrées dans km/h et converties en fonction de l'unité actuelle lorsqu'elles sont affichées pour éviter de mélanger les unités.

En l'absence de test, la valeur crête observée est conservée, et la valeur zéro effective participe normalement au calcul ; le segment suivant du voyage commence à partir de la valeur nulle.

function main() {
  if ($data.current.recording !== true) {
    return (
      <Text fontSize={48} color={$env.foreground}>
        —
      </Text>
    );
  }
  const speed = $data.current.speed;
  const saved = $sessionStorage.get('peakKmh');
  let peak = typeof saved === 'number' ? saved : null;

  if (typeof speed?.value === 'number') {
    const kmh = speed.unit === 'mph' ? speed.value * 1.609344 : speed.value;
    peak = peak == null ? kmh : Math.max(peak, kmh);
    $sessionStorage.set('peakKmh', peak);
  }

  const unit = speed?.unit ?? $env.speedUnit;
  const value =
    peak == null ? '—' : Math.round(unit === 'mph' ? peak / 1.609344 : peak);
  return (
    <VStack spacing={6}>
      <Text fontSize={48} color={$env.foreground}>
        {value}
      </Text>
      <Text color={$env.accent}>{unit}</Text>
    </VStack>
  );
}

Chaque magasin dispose d'un maximum de 256 clés, avec une taille totale de données d'environ 1 MiB ; une seule clé a un maximum de 256 UTF-8 octets. Il existe également des limites de taille et d'imbrication pour la copie des valeurs. Si la limite est dépassée ou si une valeur non prise en charge est transmise, une erreur sera signalée et l'échec de l'écriture n'écrasera pas la valeur valide d'origine.

Convient pour enregistrer une petite quantité de statut statistique. L'ajout du tableau image par image pendant une longue période continuera de croître. La courbe doit d'abord utiliser $data.history, ou limiter vous-même la longueur du tableau.