Formations — 1 037 leçons en français

Accueil › Architecture & design patterns › Le singleton

Le singleton

Patterns de créationintermediaire

Un singleton, c'est une instance unique accessible globalement. La définition tient en deux moitiés, et il faut les séparer : l'unicité est souvent légitime, l'accès global est ce qui coûte.

En JavaScript, un module est déjà un singleton : le chargeur l'évalue une seule fois, et tous les importateurs reçoivent le même objet.

// config.js — évalué une fois, quel que soit le nombre d'imports
export const config = Object.freeze({ url: "/api", delai: 5000 });

Aucun pattern n'est nécessaire. La forme à cache paresseux sert quand la construction coûte ou dépend d'une configuration pas encore lue :

let instance = null;

export function obtenirConnexion() {
  if (instance === null) instance = ouvrirConnexion(config.url);
  return instance;
}

Ce que ça casse : toute fonction qui appelle obtenirConnexion() dépend de cette connexion sans le dire dans sa signature. Un test ne peut pas la remplacer, et ne peut pas remettre l'état à zéro entre deux cas — un test passe seul et échoue dans la suite.

// L'unicité sans l'accès global : on construit une fois, on passe
const connexion = ouvrirConnexion(config.url);  // au démarrage, une seule fois
const service = creerServiceClients(connexion); // la dépendance est visible

Même instance unique. Dépendance déclarée. Test possible.

Les termes à connaître

Singleton

Un objet dont il n'existe qu'une instance, accessible globalement. Les deux moitiés de la définition sont séparables, et c'est la seconde qui coûte cher.

État global

Un état accessible de partout sans être passé en argument. Il rend les dépendances invisibles dans les signatures.

Module singleton

En JavaScript, un module évalué une seule fois par le chargeur : ce qu'il exporte est déjà unique, sans pattern.

Initialisation paresseuse

Construire à la première demande et garder le résultat. Utile quand la construction coûte ou dépend d'une configuration pas encore lue.

Fuite entre tests

Le symptôme caractéristique : un test passe seul et échoue dans la suite, parce que l'instance a gardé l'état du test précédent.

Bean singleton Spring

Une instance unique par conteneur, injectée par le conteneur. L'unicité est une portée, pas une propriété du type — et le test peut en fournir une autre.

Instance injectée

L'alternative : construire l'instance unique une fois au démarrage et la passer en paramètre. On garde l'unicité, on perd l'accès global.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.