Outil de Compte à Rebours Gaokao

Le compte à rebours du Gaokao indique le temps restant avant l’examen national chinois d’entrée à l’université, en jours, heures, minutes et secondes. Il sert surtout de repère concret pour organiser les révisions, les examens blancs, les pauses, les documents administratifs et les déplacements liés à l’épreuve. Étudiants, parents et enseignants peuvent ainsi se coordonner autour d’une même échéance sans refaire le calcul à chaque fois. L’outil ne mesure pas le niveau de préparation et ne prédit aucun résultat; il rend simplement le temps disponible plus visible pendant une période où les échéances deviennent vite pressantes.

Le compte à rebours est une soustraction en une seule ligne enveloppée dans une boucle de rafraîchissement. La durée restante est calculée par `target.getTime() - Date.now()` en millisecondes, puis décomposée par division entière : jours = `Math.floor(diff / 86400000)`, heures = `Math.floor(diff / 3600000) % 24`, minutes = `Math.floor(diff / 60000) % 60`, secondes = `Math.floor(diff / 1000) % 60`. Le moment cible est fixe : le Gaokao a lieu chaque année le 7 juin à 09h00 heure normale de Chine (UTC+8), certaines provinces du nouveau Gaokao prolongeant jusqu'à un quatrième jour. La règle de bascule compare `Date.now()` à `new Date(year, 5, 9, 17, 0)` — les mois JS sont indexés à partir de 0, donc 5 correspond à juin — et incrémente `year` de une fois ce moment passé. Deux pièges de temporisation pilotent la boucle de rafraîchissement. Premièrement, `setInterval(fn, 1000)` dérive : le callback peut s'exécuter 1003 à 1020 ms plus tard sous contention du thread principal, et la dérive s'accumule car la prochaine échéance est planifiée à partir du déclenchement précédent, non depuis une ancre d'horloge murale. La solution consiste à planifier `setTimeout` avec un délai de `1000 - (Date.now() % 1000)` pour que chaque tick se réaligne sur la prochaine seconde entière, ou à recalculer la valeur affichée à partir de `Date.now()` à chaque déclenchement plutôt que d'incrémenter un compteur. Deuxièmement, l'API HTML5 Page Visibility et la limitation des navigateurs restreignent les minuteurs des onglets en arrière-plan à environ une fois par minute (1 Hz minimum dans Chrome/Firefox/Safari modernes lorsque l'onglet est masqué) ; la page se réconcilie en recalculant à partir de `Date.now()` sur l'événement `visibilitychange` plutôt que de compter les déclenchements du minuteur. `requestAnimationFrame` est réservé à l'animation fluide de retournement des chiffres et se met en pause automatiquement lorsque l'onglet est masqué, il ne doit donc pas être la source de vérité pour l'horodatage. La localisation utilise le fuseau horaire de l'appareil renvoyé par `Intl.DateTimeFormat().resolvedOptions().timeZone`. Pour un candidat situé hors d'UTC+8, le compte à rebours affiché cible toujours l'heure normale de Chine, de sorte que la cible est construite une fois avec `Date.UTC(year, 5, 7, 1, 0, 0)` — 09h00 CST correspond à 01h00 UTC — plutôt qu'avec le constructeur `Date` en heure locale qui utiliserait silencieusement le décalage de l'appareil. Les années bissextiles ne comptent que lorsque le point d'ancrage de planification tombe le 29 février : un sprint de 100 jours commencé le 29 février atterrit à une date calendaire différente du même sprint commencé le 28 février d'une année non bissextile. Le stockage utilise `localStorage` pour le thème optionnel et les surcharges de date cible ; la notification optionnelle à T-0 utilise `Notification.requestPermission()` une fois par session et `new Notification(title, { body })` pour afficher une alerte au niveau système sans quitter la page.

• Formule de base : `diff = target.getTime() - Date.now()` ; jours = `Math.floor(diff / 86400000)`, puis `% 24`, `% 60`, `% 60` pour h/m/s. Constantes : 86 400 000 ms/jour, 3 600 000 ms/heure, 60 000 ms/min.
• Cible : 7 juin, 09h00 heure normale de Chine (UTC+8). L'index de mois JS est 5 pour juin. La bascule se déclenche lorsque `Date.now() > new Date(year, 5, 9, 17, 0)` ; alors `year += 1`.
• Dérive des minuteurs : `setInterval(fn, 1000)` dérive sous charge du thread principal. Modèle auto-correctif : `setTimeout(fn, 1000 - Date.now() % 1000)` réaligne chaque tick sur la prochaine seconde entière.
• Limitation en arrière-plan : l'API Page Visibility + la politique du navigateur restreignent les minuteurs des onglets masqués à 1 Hz (Chrome/Firefox/Safari). Réconciliation par recalcul à partir de `Date.now()` sur `visibilitychange`, pas en comptant les déclenchements.
• Fuseau horaire : construction de la cible via `Date.UTC(year, 5, 7, 1, 0, 0)` (09h00 CST = 01h00 UTC) pour que les candidats hors UTC+8 voient toujours un compte à rebours correct vers le moment de l'examen, et non leur 09h00 local.
• Persistance : `localStorage.setItem(key, value)` (synchrone, quota d'environ 5 Mo par origine) pour le thème et les surcharges de cible. Les notifications utilisent `Notification.requestPermission()` puis `new Notification(title, { body, icon })`.
• Rendu : `requestAnimationFrame` pilote l'animation de retournement des chiffres (mise en pause auto lorsque masqué) ; les chiffres affichés sont recalculés à partir de `Date.now()` à chaque image, et non incrémentés, de sorte qu'une image manquée ne sous-compte jamais.