Escuchar un evento
document.body.innerHTML = `<button id="contar">Clics: 0</button>`;
const boton = document.querySelector("#contar");
let clics = 0;
boton.addEventListener("click", (e) => {
clics++;
boton.textContent = `Clics: ${clics}`;
console.log(e.type, e.target.tagName);
});
boton.click(); // simula un clic desde el código
boton.click();
El listener recibe un objeto evento con información: type, target (dónde ocurrió), la tecla en un evento de teclado (e.key), la posición en uno de ratón (e.clientX)… Algunos eventos comunes: click, input, change, submit, keydown, pointerdown, focus, scroll.
Para dejar de escuchar, removeEventListener necesita la misma función, así que guárdala en una variable.
Captura y burbujeo
Como muestra el pizarrón, un evento recorre el árbol en tres fases: captura (bajando desde window), el objetivo y burbujeo (subiendo). Por defecto, los listeners corren en el burbujeo.
Dentro del listener:
e.targetes el elemento donde ocurrió el evento, que puede ser un hijo.e.currentTargetes el elemento cuyo listener se está ejecutando.e.stopPropagation()detiene el viaje: los ancestros no se enteran. Úsalo poco: rompe la delegación y otros listeners que dependen del burbujeo.
Acciones por defecto
Muchos eventos tienen una acción del navegador: un enlace navega, un formulario se envía, un checkbox se marca. e.preventDefault() la cancela:
document.body.innerHTML = `<a id="enlace" href="https://ejemplo.com">Ir</a>`;
document.querySelector("#enlace").addEventListener("click", (e) => {
e.preventDefault();
console.log("no navego; muestro una vista previa");
});
document.querySelector("#enlace").click();
Delegación
En lugar de un listener por cada elemento, uno solo en el contenedor: el burbujeo trae los eventos de todos los hijos, incluso de los que se agreguen después.
document.body.innerHTML = `
<ul id="colores">
<li data-color="rojo">Rojo</li>
<li data-color="azul">Azul</li>
</ul>`;
const lista = document.querySelector("#colores");
lista.addEventListener("click", (e) => {
const li = e.target.closest("li");
if (!li) return; // el clic no fue en un li
console.log("elegiste", li.dataset.color);
});
const verde = document.createElement("li");
verde.dataset.color = "verde";
verde.textContent = "Verde";
lista.append(verde); // agregado después: también funciona
lista.querySelectorAll("li").forEach((li) => li.click());
closest es la pieza clave: sube desde e.target hasta encontrar el elemento que te interesa, así que funciona aunque el clic caiga en un ícono o un texto dentro.
Opciones de addEventListener
document.body.innerHTML = `<button id="unaVez">Solo una vez</button>`;
const boton = document.querySelector("#unaVez");
const control = new AbortController();
boton.addEventListener("click", () => console.log("primera y única"), { once: true });
boton.addEventListener("click", () => console.log("hasta que se cancele"), { signal: control.signal });
boton.click();
control.abort(); // quita el segundo listener
boton.click();
once: true: el listener se quita solo después de la primera vez.signal: el listener se quita cuando se cancela la señal. Con un soloabort()quitas muchos listeners a la vez.passive: true: prometes no llamar apreventDefault; el navegador puede hacer scroll sin esperar a tu código.capture: true: el listener corre en la fase de captura.
Resumen
addEventListener(tipo, fn, opciones)suscribe; el listener recibe el objeto evento.- Tres fases: captura, objetivo y burbujeo; por defecto se escucha en el burbujeo.
e.targetes donde ocurrió;e.currentTarget, de quién es el listener.preventDefault()cancela la acción del navegador;stopPropagation(), el viaje.- Delegación: un listener en el contenedor y
e.target.closest(…). - Opciones:
once,signal,passiveycapture.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Reaccionar a lo que pasa
Resuelto
Elige una respuesta en cada pregunta.
Un clic en un botón dentro de un
<li>, ¿qué listeners declickse ejecutan?¿Qué diferencia hay entre
e.targetye.currentTarget?¿Qué es la delegación de eventos?
¿Qué hace
e.preventDefault()?
Ordena la salida: Captura y burbujeo
Resuelto
Cuatro listeners y un clic en el botón. Ordena lo que aparecería en la consola.
1document.body.innerHTML = `<div id="tarjeta"><button id="me-gusta">❤</button></div>`;2const tarjeta = document.querySelector("#tarjeta");3const boton = document.querySelector("#me-gusta");4 5document.addEventListener("click", () => console.log("document"));6tarjeta.addEventListener("click", () => console.log("tarjeta"));7tarjeta.addEventListener("click", () => console.log("tarjeta, en captura"), { capture: true });8boton.addEventListener("click", () => console.log("botón"));9 10boton.click();Consola, de arriba abajo
- tarjeta
- tarjeta, en captura
- document
- botón
Un evento viaja en tres fases: captura, bajando desde window hasta el elemento; el propio elemento; y burbujeo, subiendo de vuelta. Los listeners con capture: true corren al bajar; los normales, al subir.
Detective: Un clic en el ícono
Resuelto
El botón funciona… a veces. Encuentra la línea que falla al hacer clic en el ícono y elige el arreglo.
Consola
Uncaught TypeError: Cannot read properties of undefined (reading 'toUpperCase')
at HTMLButtonElement.<anonymous> (index.html:7:52)Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Borrar con un solo listener
Resuelto
Haz que los botones “Borrar” funcionen con delegación: un solo listener en la lista. Puedes probarlo con clics en la página de abajo.
La página index.html
Consola del navegador
Lo que debe cumplir
- Al hacer clic en el segundo "Borrar", desaparece la leche (pendiente)
- Funciona con los elementos agregados después (pendiente)
- Usa un solo listener en la lista (pendiente)
Una solución
1const lista = document.querySelector("#compras");2 3document.querySelector("#agregar").addEventListener("click", () => {4 const li = document.createElement("li");5 const boton = document.createElement("button");6 boton.className = "borrar";7 boton.textContent = "Borrar";8 li.append("Café ", boton);9 lista.append(li);10});11 12lista.addEventListener("click", (e) => {13 const boton = e.target.closest(".borrar");14 if (boton) boton.closest("li").remove();15});Un solo listener atiende a todos los botones, incluso a los que todavía no existen, porque el clic de cualquiera burbujea hasta la lista. closest sube desde el elemento clicado hasta encontrar el que buscas, así que también funciona si el botón tuviera un ícono adentro.