
Corriger l’erreur « localStorage is not defined » dans Next.js
Comprendre et corriger l’erreur « localStorage is not defined » dans Next.js, avec des exemples et des conseils pratiques.
L’erreur localStorage is not defined fait partie des problèmes fréquents rencontrés avec Next.js. Elle apparaît parce que localStorage appartient à l’objet window du navigateur, qui n’est pas disponible pendant le rendu côté serveur. Voyons pourquoi elle survient et comment la corriger.
Pourquoi cette erreur se produit-elle ?#
Dans Next.js, les composants sont rendus sur le serveur par défaut. Le code JavaScript s’exécute donc sur le serveur avant d’être envoyé au client. Comme localStorage est une API propre au navigateur, tenter d’y accéder côté serveur provoque une erreur.
Les solutions pour corriger l’erreur#
Utiliser le hook useEffect#
L’une des solutions les plus simples consiste à utiliser le hook useEffect. Celui-ci s’exécute uniquement côté client, après le rendu initial.
import { useEffect } from 'react';
const MyComponent = () => {
useEffect(() => {
const storedValue = localStorage.getItem('myKey');
console.log(storedValue);
}, []);
return <div>Check the console for localStorage value</div>;
};
export default MyComponent;En plaçant l’accès à localStorage dans useEffect, vous vous assurez qu’il ne s’exécute que dans le navigateur.
Effectuer une vérification conditionnelle#
Une autre approche consiste à vérifier que l’objet window existe avant d’accéder à localStorage.
const MyComponent = () => {
let storedValue;
if (typeof window !== 'undefined') {
storedValue = localStorage.getItem('myKey');
}
return <div>{storedValue}</div>;
};
export default MyComponent;Cette méthode empêche l’exécution du code côté serveur.
Importer dynamiquement avec ssr: false#
Pour les composants qui dépendent fortement des API du navigateur, vous pouvez utiliser un import dynamique et désactiver le rendu côté serveur.
import dynamic from 'next/dynamic';
const BrowserComponent = dynamic(() => import('../components/BrowserComponent'), {
ssr: false,
});
const MyPage = () => (
<div>
<h1>Hello Next.js</h1>
<BrowserComponent />
</div>
);
export default MyPage;L’option ssr: false garantit que le composant est rendu uniquement côté client.
Exemple pratique#
Combinons ces techniques dans un exemple. Imaginons un composant qui lit une valeur dans localStorage et l’affiche.
import { useEffect, useState } from 'react';
import dynamic from 'next/dynamic';
const BrowserComponent = () => {
const [value, setValue] = useState('');
useEffect(() => {
const storedValue = localStorage.getItem('myKey');
setValue(storedValue || '');
}, []);
return <div>Stored Value: {value}</div>;
};
const MyPage = () => (
<div>
<h1>Hello Next.js</h1>
<dynamic(() => import('../components/BrowserComponent'), { ssr: false }) />
</div>
);
export default MyPage;`Conclusion#
Corriger l’erreur localStorage is not defined dans Next.js demande de comprendre la distinction entre le rendu côté serveur et le rendu côté client. Les hooks comme useEffect, les vérifications conditionnelles et les imports dynamiques permettent de gérer le code propre au navigateur. Pour approfondir le sujet, consultez la documentation Next.js et les ressources associées.
Ressources complémentaires#
- Documentation Next.js
- Gérer l’erreur « window is not defined »
- Les imports dynamiques dans Next.js

