Hydration mismatch terjadi ketika markup yang dibuat server berbeda dari hasil render pertama di browser. Untuk UI arsip skrip web retro, pertahankan daftar dan markup awal tetap deterministik: gunakan data yang sama, urutan yang eksplisit, dan hindari membaca waktu, angka acak, atau state browser saat render. Jalankan perilaku khusus browser setelah hydration.
UI arsip sering menampilkan metadata seperti tanggal, label, dan status favorit. Detail yang tampak kecil dapat menghasilkan HTML berbeda di server dan browser. Inspirasi visualnya dapat berupa arsip skrip web yang dikurasi, seperti konteks pada retrospeksi arsip skrip Matt; fokus implementasi di sini adalah konsistensi SSR, bukan rangkuman artikel tersebut.
Bangun daftar arsip dengan render awal yang deterministik
Berikan komponen data arsip yang sudah tersedia saat server merender halaman. Simpan urutan pilihan sebagai bagian dari data atau susun dengan aturan eksplisit sebelum render. Gunakan ID stabil sebagai key, bukan indeks array jika daftar dapat berubah.
import { useEffect, useState } from "react";
type Script = {
id: string;
title: string;
year: number;
description: string;
};
const scripts: Script[] = [
{
id: "cursor-trail",
title: "Cursor Trail",
year: 1998,
description: "Efek jejak kursor untuk halaman personal.",
},
{
id: "guestbook-counter",
title: "Guestbook Counter",
year: 2001,
description: "Penghitung kunjungan untuk buku tamu.",
},
];
export function ScriptArchive() {
const [savedIds, setSavedIds] = useState<string[]>([]);
useEffect(() => {
try {
const stored = window.localStorage.getItem("saved-script-ids");
if (!stored) return;
const parsed: unknown = JSON.parse(stored);
if (Array.isArray(parsed) && parsed.every((id) => typeof id === "string")) {
setSavedIds(parsed);
}
} catch {
// Data penyimpanan rusak atau akses storage ditolak; gunakan state kosong.
}
}, []);
return (
<main>
<h1>Arsip Skrip Web</h1>
<ol>
{scripts.map((script) => (
<li key={script.id}>
<article>
<h2>{script.title} ({script.year})</h2>
<p>{script.description}</p>
<p>{savedIds.includes(script.id) ? "Tersimpan" : "Belum disimpan"}</p>
</article>
</li>
))}
</ol>
</main>
);
}
Contoh ini menggunakan array statis agar fokusnya jelas. Pada aplikasi SSR, sumber data dapat berasal dari server; pastikan data yang dipakai untuk render pertama di browser sama dengan data yang menghasilkan HTML server. Jika data berubah di antara dua render, kirim snapshot yang sama kepada klien atau tangani pembaruan setelah hydration.
Penyebab umum hydration mismatch
Waktu dan format tanggal
Hindari membuat nilai seperti new Date() di dalam render untuk menampilkan waktu saat ini. Server dan browser dapat merender pada waktu berbeda. Format tanggal juga dapat berbeda menurut zona waktu atau locale. Untuk tanggal arsip, simpan tanggal sebagai data dan tampilkan format yang sudah ditentukan secara konsisten. Jika waktu saat ini memang harus ditampilkan, render placeholder yang sama terlebih dahulu, lalu isi nilainya setelah hydration.
Angka acak dan ID yang berubah
Math.random() saat render menghasilkan nilai berbeda pada setiap lingkungan. Jangan gunakan nilai acak untuk urutan, label, atau atribut yang muncul dalam markup awal. Gunakan ID yang berasal dari data arsip. Jika elemen dekoratif memerlukan variasi, tentukan variasinya dalam data, bukan saat render.
Urutan data yang tidak stabil
Jangan mengandalkan urutan yang kebetulan sama pada dua lingkungan. Susun data dengan kunci eksplisit dan aturan yang konsisten, atau simpan urutan editorial di sumber data. Hindari comparator yang bergantung pada locale perangkat untuk menghasilkan urutan markup awal. Pastikan pemfilteran dan paginasi juga menggunakan input yang sama di server dan browser.
State browser pada render awal
Jangan membaca window, localStorage, preferensi tema, atau ukuran layar untuk menentukan JSX pertama. API tersebut tidak tersedia di server, dan nilainya di browser mungkin berbeda dari asumsi server. Pada contoh, daftar favorit dimulai sebagai array kosong di kedua tempat. useEffect membaca penyimpanan setelah hydration, lalu memperbarui tampilan tanpa mengubah syarat render awal.
Pindahkan perilaku browser ke efek setelah hydration
Gunakan pola placeholder awal yang deterministik ketika tampilan bergantung pada lingkungan browser. Setelah komponen terpasang, baca nilai browser dan perbarui state. Pola ini mencegah perbedaan markup, tetapi dapat menampilkan perubahan sesaat setelah hydration, misalnya label favorit yang berubah dari “Belum disimpan” menjadi “Tersimpan”.
Jika perubahan sesaat mengganggu, pilih perilaku produk yang sesuai: jangan simpan state tersebut di browser, tampilkan kontrol dengan status netral sampai preferensi dimuat, atau gunakan mekanisme server yang membuat preferensi tersedia saat SSR. Jangan menyembunyikan mismatch dengan menonaktifkan hydration atau memakai penekanan peringatan; tindakan itu menutupi gejala, bukan memperbaiki markup yang berbeda.
Uji SSR dan hydration
Uji halaman dalam mode produksi atau lingkungan yang benar-benar melakukan SSR, bukan hanya render sisi klien. Verifikasi HTML awal, lalu biarkan browser melakukan hydration. Tangkap error dan peringatan konsol yang berkaitan dengan hydration, serta periksa apakah markup berubah hanya setelah efek yang memang direncanakan.
- Render dengan fixture arsip tetap dan pastikan judul, urutan, tanggal, serta ID cocok dengan data yang diharapkan.
- Jalankan pengujian dengan zona waktu atau locale berbeda jika format tanggal menjadi bagian dari markup.
- Uji penyimpanan kosong, valid, rusak, dan tidak dapat diakses; kegagalan membaca penyimpanan seharusnya tidak merusak halaman.
- Periksa bahwa setiap item memakai ID stabil dan tidak ada nilai acak atau waktu langsung di hasil render.
Untuk diagnosis, bandingkan HTML respons server dengan DOM setelah hydration dan cari komponen terkecil yang menghasilkan perbedaan. Mulai dari teks tanggal, urutan daftar, atribut ID, dan cabang render yang membaca state browser. Perbaiki sumber nilai yang tidak deterministik sebelum menambah pengecualian.
Checklist implementasi
- Gunakan snapshot data yang sama untuk render server dan render pertama browser.
- Tentukan urutan arsip secara eksplisit dan gunakan ID stabil sebagai key.
- Jangan membaca waktu, nilai acak, atau API browser untuk membentuk markup awal.
- Pindahkan pembacaan state browser ke efek setelah hydration, dengan fallback yang aman.
- Uji HTML SSR, hydration, variasi data penyimpanan, dan peringatan konsol.
Dengan batas yang jelas antara markup arsip dan perilaku browser, UI retro tetap dapat dirender di server tanpa mengorbankan fitur interaktif seperti favorit atau preferensi tampilan.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!