Memento: guardar y volver a un estado

  • Lección 26 de 32
  • 11 min
  • Intermedio
  • 13 pasos

Un editor guarda solo su estado actual, así que Ctrl+Z no tiene a dónde volver. Vas a pedirle al propio editor una foto de su estado, guardarla en un historial sin abrirla, restaurarla y compararlo con el deshacer de Command.

Fotos en el historial
—
TecladoEditororiginator"Holamundo"originator"Hola"originator"Holamundo"originatorpresentoriginatorpáginaoriginatorEditorSnapshotmementoestadomementostatemementoSnapshotundo[]caretakerpastcaretakerhistorycaretakerundo[]insertcomandoinsertescribe " mundo"solo el estado actualSolo el estado actualeditor.type("Hola");editor.type(" mundo");// "Hola mundo", cursor 10▸// Ctrl+Z: ¿a qué vuelvo?lee campos privadosprivate textCopiar desde fuera// en el código de Ctrl+Z:const copy = {−text: editor.text, // privado−cursor: editor.cursor,};▸// ¿y la selección? ¿el scroll?una foto de su estadola guarda sin abrirlaEl memento// una foto de solo lecturatype Snapshot = Readonly<{text: string;cursor: number;}>;save() · restore()Object.freezeEl originatorclass Editor {private text = ""; private cursor = 0;save(): Snapshot {const { text, cursor } = this;▸return Object.freeze({ text, cursor }); }restore(s: Snapshot) {this.text = s.text;▸this.cursor = s.cursor; } }undo.push(save())escribeEl caretakerconst editor = new Editor();const undo: Snapshot[] = [];+undo.push(editor.save());editor.type("Hola");+undo.push(editor.save());editor.type(" mundo");// undo: 2 fotosCtrl+Zvuelve a "Hola"Deshacer// Ctrl+Z▸const last = undo.pop();▸if (last) editor.restore(last);// "Hola", cursor 4// undo: 1 fotosolo el editor la abreguarda, no lee¿Quién puede abrir la foto?Readonly + freezenadie la cambiacampos a la vistacualquiera la leetipo opaco fueraTS no deja leerlacampos #privadosnadie la leeel estado actualfotos anterioresRedux: el estado envueltopast["", "Hola"]present"Hola mundo"future[]objeto serializablepopstate da una copiaEl historial del navegador// al cambiar de pestaña:▸history.pushState({ tab: "precios" }, "", "/precios");// al pulsar Atrás:▸addEventListener("popstate", (e) => {showTab(e.state?.tab);});cómo eracómo deshacerDos formas de deshacerpatrónMementoCommandguardacómo eracómo deshacercuestamemoria por fotoun undo por acciónfalla sila foto olvida un campoel inverso está mal50 copias completasuna copia por cambioCuándo noestado enorme, cambios pequeñosdiferencias o comandosconexiones, timersno se copianhistorial sin límiteponle un topevolver a un estadoel nombre no prueba nadaCuatro ideas equivocadas«es guardar en disco»es volver a un estado«las fotos salen gratis»cada una ocupa memoria«deshacer = Memento»Command es la otra forma«se llama Memento»el nombre no lo pruebala foto, inmutableguarda sin leerMemento en una tablaproblemavolver atrás sin abrir el objetooriginatorcrea y restaura la fotomementola foto, de solo lecturacaretakerla guarda sin leerlano lo usessi el estado es enorme o no se copia
  • petición
  • respuesta
  • petición fallida

Paso 1 de 13

Problema

Escribes y no hay vuelta atrás

Tienes un editor con dos datos privados: el texto y la posición del cursor. Escribes «Hola» y después « mundo»: el editor queda en «Hola mundo» con el cursor en 10.

Ahora pulsas Ctrl+Z. El editor solo conoce su estado actual: no guardó cómo estaba antes, así que no tiene a dónde volver.

Qué cambió

  • editor.type("Hola"), editor.type(" mundo")

Paso 2 de 13

Problema

Copiar los campos desde fuera

La idea rápida: que el código de Ctrl+Z copie text y cursor antes de cada cambio. Pero son privados, y TypeScript no deja leerlos fuera de la clase.

Si los haces públicos para copiarlos, el código de fuera queda atado a cómo está hecho el editor por dentro: el día que sumes la selección o el scroll, cada copia que olvide el campo nuevo restaura un estado a medias.

Qué cambió

  • copiar campos privados desde fuera
  • cada campo nuevo rompe la copia

Paso 3 de 13

Concepto

La foto la hace el editor

La idea de Memento: quien hace la copia es el propio objeto, porque es el único que sabe qué hay dentro. El editor (el originator) entrega una foto de su estado, el memento.

Otro objeto, el caretaker (aquí, el historial de deshacer), guarda esas fotos sin mirar dentro. Para que nadie la cambie después, la foto es de solo lectura: Readonly en el tipo.

Qué cambió

  • Snapshot, el memento
  • historial, el caretaker

Paso 4 de 13

Técnica

Dos métodos en el editor

save() arma un objeto con text y cursor y lo congela con Object.freeze, así nadie lo modifica mientras espera en el historial. restore(s) hace lo inverso: copia los valores de la foto a sus campos.

Los campos siguen privados. Si mañana sumas la selección, la agregas en Snapshot, en save() y en restore(): todo el cambio queda dentro del editor, y el código de fuera no se entera.

Qué cambió

  • save(): Snapshot
  • restore(s: Snapshot)

Paso 5 de 13

Solución

Un historial que solo apila

Antes de cada cambio, el código de la interfaz hace undo.push(editor.save()). El historial es solo un arreglo de Snapshot: no sabe qué hay en una foto ni lo necesita.

Tras escribir «Hola» y « mundo», el historial tiene 2 fotos: la del editor vacío y la de «Hola». El editor dice «Hola mundo».

Qué cambió

  • undo: Snapshot[]
  • push(save()) antes de cada cambio

Paso 6 de 13

Solución

Ctrl+Z: restaurar la última foto

Deshacer es sacar la última foto con pop() y pasársela a editor.restore(). El editor vuelve a «Hola» con el cursor en 4, y el historial queda con 1 foto.

Fíjate en lo que no hizo falta: ningún código que sepa borrar « mundo». La foto dice cómo era, no cómo deshacer. Para rehacer, guarda en otra lista una foto del estado antes de restaurar.

Qué cambió

  • la foto de "Hola" del historial
  • editor vuelve a "Hola", cursor 4

Paso 7 de 13

Técnica

Que nadie la abra

Readonly y Object.freeze impiden cambiar la foto, pero no leerla: en este código, cualquiera puede mirar snap.text. La versión original del patrón va más allá: solo el originator entiende el memento.

Si necesitas eso, deja la clase de la foto privada en el módulo del editor y exporta un tipo opaco, sin campos visibles: fuera se puede guardar y devolver, y TypeScript no deja leerla sin un cast. Es una barrera de tipos, no de ejecución: si quieres que tampoco se pueda leer al ejecutar, usa campos privados de JavaScript (#text). En muchos casos alcanza con la convención: el historial guarda, no lee.

Qué cambió

  • Snapshot opaca fuera del editor

Paso 8 de 13

Concepto

Ya lo usas: el historial de Redux

La documentación de Redux propone envolver el estado en { past, present, future }. Cada acción nueva mete present al final de past y vacía `future`. Deshacer saca el último de past, lo pone en present y mueve el anterior present al inicio de future.

Cada entrada es el estado completo, no un inverso: son fotos. Funciona sin copias extra porque en Redux el estado es inmutable, así que guardar una referencia ya es guardar la foto.

Qué cambió

  • historial → past y future
  • editor → present

Paso 9 de 13

Concepto

Ya lo usas: el botón Atrás

Con history.pushState(state, "", url) una página guarda un objeto de estado junto a la entrada del historial del navegador. Al pulsar Atrás, el evento popstate te devuelve una copia de ese objeto y la página vuelve a mostrarse como estaba.

Mismo reparto de papeles: la página arma la foto, el navegador la guarda sin usarla. El objeto tiene que poder serializarse, y los navegadores pueden limitar su tamaño: para datos grandes, usa sessionStorage o localStorage.

Qué cambió

  • editor → página
  • historial → history del navegador

Paso 10 de 13

Compromiso

Dos formas de deshacer

En la lección de Command, cada comando guarda cómo deshacer: insert " mundo" sabe quitar sus 6 caracteres. Con Memento guardas cómo era: la foto de «Hola». Las dos llevan al mismo «Hola».

Command pide un inverso correcto por cada acción, pero cada entrada pesa poco. Memento no pide inversos, pero cada foto es una copia del estado. Puedes combinarlos: un comando que, en vez de inverso, guarda una foto antes de ejecutarse.

Qué cambió

  • insert, un comando con undo()
  • foto (cómo era) frente a inverso (cómo deshacer)

Paso 11 de 13

Compromiso

Cuándo no usarlo y qué cuesta

Cada foto es una copia completa. Con un estado de 2 MB y 50 fotos guardas 100 MB (valores de ejemplo). Si el estado es enorme y cada cambio toca poco, guarda diferencias o comandos con inverso. Y ponle un tope al historial.

Tampoco sirve si el estado incluye cosas que no se copian, como una conexión abierta o un timer. Recuerda además que una acción nueva borra lo que podías rehacer. Redux recomienda envolver solo la parte del estado que se deshace.

Qué cambió

  • tope de fotos
  • estado grande: diferencias o comandos

Paso 12 de 13

Concepto

Cuatro ideas equivocadas

«Memento es guardar en disco»: es volver a un estado anterior; que la foto llegue a un archivo es opcional. «Las fotos salen gratis»: cada una ocupa memoria. «Deshacer siempre es Memento»: Command con inversos es la otra forma.

«Si se llama Memento, es el patrón»: la API de extensiones de VS Code tiene una interfaz Memento (en globalState y workspaceState) que es un almacén de pares clave-valor, no fotos que se restauran. El nombre no prueba el patrón: mira qué hace.

Paso 13 de 13

Resumen

Volver atrás sin abrir el objeto

Cuando necesitas volver a un estado anterior sin exponer cómo está hecho un objeto, pídele a él la foto: save() la crea, un historial la guarda sin leerla y restore() la aplica.

El precio es memoria por foto y decidir bien qué entra en ella. Si el estado es enorme o no se puede copiar, usa comandos con inverso o guarda solo las diferencias.

Aprenderás

  • Ver por qué copiar el estado desde fuera rompe el encapsulamiento.
  • Separar los tres papeles: originator, memento y caretaker.
  • Implementar deshacer con `save()` y `restore()`.
  • Reconocer la idea en el historial de Redux y en `history.pushState`.
  • Elegir entre fotos del estado e inversos, y saber cuándo no conviene.