Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Patron d’annulation par ticket de génération

Un ticket de génération réserve la mise à jour de l’état à la dernière opération lancée, si elle est toujours d’actualité. Une opération plus ancienne peut se terminer sans écraser cet état.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

let current = null;

async function run(load, commit) {
  const ticket = {};
  current = ticket;
  const result = await load();
  if (ticket !== current) return;
  commit(result);
}

function invalidate() {
  current = null;
}

Dans un champ de recherche, la réponse à une ancienne requête peut arriver après celle à une requête plus récente. Ce patron détermine quelle opération a le droit de modifier l’état. C’est un patron de conception, pas une syntaxe spéciale ni une API intégrée à JavaScript.

À chaque lancement, créez un nouvel objet ticket et stockez-le dans current. Le test ticket === current compare l’identité des objets, pas leur contenu. Un nouveau lancement remplace le ticket courant ; current = null l’invalide sans lancer de nouvelle opération, par exemple à la fermeture d’une vue. Gardez un current distinct pour chaque ressource mise à jour indépendamment.

Après await, vérifiez le ticket juste avant de modifier l’état. Si un autre await intervient, vérifiez-le de nouveau avant d’écrire. Le rejet d’une promesse déclenche une exception au niveau de await : vérifiez donc aussi le ticket avant d’afficher une erreur ou de modifier un indicateur de chargement dans finally. Traitez ou propagez les erreurs de l’opération courante ; ne laissez pas une opération obsolète modifier l’interface.

C’est une annulation logique : elle n’arrête pas le travail et n’annule pas les effets déjà produits. Si l’API accepte un signal, créez une nouvelle instance d’AbortController pour chaque opération et transmettez à l’API la valeur de sa propriété signal. Après avoir invalidé le ticket de l’opération, appelez abort() sur cette même instance. Conservez la vérification du ticket, car toutes les opérations ne tiennent pas compte du signal. AbortController est une API du Web, pas une partie d’ECMAScript ; vérifiez sa prise en charge dans l’environnement cible.

Exemples

(async () => {
  let current = null;
  let visible = '(empty)';

  async function show(pending) {
    const ticket = {};
    current = ticket;
    const result = await pending;
    if (ticket !== current) {
      console.log(`skip: ${result}`);
      return;
    }
    visible = result;
    console.log(`commit: ${visible}`);
  }

  let finishOld;
  const oldResult = new Promise((resolve) => { finishOld = resolve; });
  const oldRun = show(oldResult);
  await show(Promise.resolve('new'));
  finishOld('old');
  await oldRun;
  console.log(`visible: ${visible}`);
})();

Résultat

commit: new
skip: old
visible: new

`finishOld('old')` n’est appelée qu’après l’enregistrement de `new`. `skip: old` est un message de diagnostic, pas une modification de `visible`.

Leçons associées

  • JavaScript · Leçon 14 · Avancé · Version : 4

Sources