feat(resenas): media en la cabecera, formulario bajo la barra y cajón solo de reseñas

- LocalCard: las estrellas de la media van arriba a la derecha, a la
  altura del título; el formulario de reseña se monta DEBAJO de la barra
  y solo al pulsar «Comentar», que queda en estado activo (aria-pressed).
- ResenasLocal pasa a ser presentacional: el cajón animado revela SOLO
  el resto de reseñas y el control de ampliar/plegar es de ancho completo
  y va debajo de ellas (Ver las N reseñas / Ver menos).
- Nuevo hook useResenas (dueño único del estado: lista, total, media,
  reseña propia, envío, borrado, reporte, error) y nuevo FormularioResena
  controlado. Desaparece el ref imperativo comentar().
- Tarjetas de comentario con padding uniforme y texto sin margen interno.
- StarRating exporta TAMANO_ESTRELLAS (14) y lo usan media, tarjetas e
  input: un único tamaño.
- Botones con hover/activo a superficie completa por clases CSS
  (.btn-hover, .btn-hover.activo, .btn-sobre-tarjeta, .btn-primario,
  .btn-verde); se retiran los background inline que anulaban el hover.

164/164 tests y build en verde.
This commit is contained in:
2026-10-13 23:38:32 +02:00
parent 92a13915bc
commit 3f0c58e26d
10 changed files with 685 additions and 384 deletions
+76
View File
@@ -0,0 +1,76 @@
// @vitest-environment jsdom
import { afterEach, describe, expect, it, vi } from "vitest";
import { cleanup, fireEvent, render, screen } from "@testing-library/react";
import FormularioResena from "../../src/components/FormularioResena.jsx";
afterEach(cleanup);
function renderFormulario(over = {}) {
const props = {
puntuacion: 0, setPuntuacion: vi.fn(),
comentario: "", setComentario: vi.fn(),
tienePropia: false, enviando: false, error: "",
onEnviar: vi.fn(), onCerrar: vi.fn(),
...over,
};
render(<FormularioResena {...props} />);
return props;
}
describe("FormularioResena (presentación)", () => {
it("estrellas 1–5, comentario, Publicar y Cerrar; el foco arranca en la primera estrella", () => {
renderFormulario();
expect(screen.getByRole("radiogroup", { name: /selecciona una puntuación/i })).toBeTruthy();
expect(screen.getAllByRole("radio")).toHaveLength(5);
expect(screen.getByLabelText(/comentario de la reseña/i)).toBeTruthy();
expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy();
expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/);
});
it("Publicar está deshabilitado sin puntuación y se habilita con 1 o más", () => {
renderFormulario({ puntuacion: 0 });
expect(screen.getByRole("button", { name: /publicar/i }).disabled).toBe(true);
cleanup();
renderFormulario({ puntuacion: 3 });
expect(screen.getByRole("button", { name: /publicar/i }).disabled).toBe(false);
});
it("con reseña propia muestra Actualizar y el aviso de edición", () => {
renderFormulario({ tienePropia: true, puntuacion: 5, comentario: "Mi favorito" });
expect(screen.getByText(/tu reseña \(anónima\)/i)).toBeTruthy();
expect(screen.getByRole("button", { name: /actualizar/i })).toBeTruthy();
expect(screen.getByLabelText(/comentario de la reseña/i).value).toBe("Mi favorito");
});
it("los cambios de estrellas y comentario se notifican al dueño del estado", () => {
const props = renderFormulario();
fireEvent.click(screen.getByRole("radio", { name: "4 estrellas" }));
expect(props.setPuntuacion).toHaveBeenCalledWith(4);
fireEvent.change(screen.getByLabelText(/comentario de la reseña/i), { target: { value: "Buen sitio" } });
expect(props.setComentario).toHaveBeenCalledWith("Buen sitio");
});
it("el error del servidor se muestra como aviso y Cerrar delega en el padre", () => {
const props = renderFormulario({ error: "El comentario contiene palabras no permitidas" });
expect(screen.getByRole("alert").textContent).toMatch(/no permitidas/i);
fireEvent.click(screen.getByRole("button", { name: /cerrar/i }));
expect(props.onCerrar).toHaveBeenCalled();
});
it("enviar delega en el padre (y bloquea mientras guarda)", () => {
const props = renderFormulario({ puntuacion: 2, enviando: true });
const publicar = screen.getByRole("button", { name: /guardando/i });
expect(publicar.disabled).toBe(true);
cleanup();
const props2 = renderFormulario({ puntuacion: 2 });
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
expect(props2.onEnviar).toHaveBeenCalled();
});
});
+91 -11
View File
@@ -1,9 +1,9 @@
// @vitest-environment jsdom
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
import { cleanup, fireEvent, render, screen, waitFor, within } from "@testing-library/react";
// Mock del cliente API: LocalCard importa confirmarLocal vía firebase.js y
// ResenasLocal importa las funciones de reseñas por la misma vía.
// Mock del cliente API: LocalCard importa confirmarLocal vía firebase.js y el
// hook useResenas, las funciones de reseñas por la misma vía.
vi.mock("../../src/api.js", () => ({
confirmarLocal: vi.fn(),
listarResenas: vi.fn(async () => ({ resenas: [], total: 0 })),
@@ -13,6 +13,7 @@ vi.mock("../../src/api.js", () => ({
}));
import LocalCard from "../../src/components/LocalCard.jsx";
import { enviarResena, listarResenas } from "../../src/api.js";
beforeEach(() => { vi.clearAllMocks(); localStorage.clear(); });
afterEach(cleanup);
@@ -24,6 +25,17 @@ const LOCAL = {
fecha: "2026-10-01T10:00:00.000Z",
};
const ISO = "2026-10-11T10:00:00.000Z";
const resena = (id, huella, puntuacion, comentario) => ({ id, huella, puntuacion, comentario, fecha: ISO, fechaEdicion: null, esPropia: false });
const CUATRO = [
resena("r1", "#111111", 5, "Uno"),
resena("r2", "#222222", 4, "Dos"),
resena("r3", "#333333", 3, "Tres"),
resena("r4", "#444444", 2, "Cuatro"),
];
const boton = (nombre) => screen.getByRole("button", { name: nombre });
describe("LocalCard (rediseño de usabilidad)", () => {
it("la descripción va en bloque propio ENCIMA de la sección de reseñas", () => {
render(<LocalCard local={LOCAL} />);
@@ -43,6 +55,20 @@ describe("LocalCard (rediseño de usabilidad)", () => {
expect(screen.getByText(/^publicado /i)).toBeTruthy();
});
it("la media va arriba a la derecha de la cabecera, a la altura del título", () => {
render(<LocalCard local={LOCAL} />);
const estrellas = screen.getByRole("img", { name: /valoración: 4 de 5 estrellas/i });
const titulo = screen.getByText("Bar Prueba");
// mismo bloque de cabecera, después del nombre
const filaCabecera = titulo.closest("div").parentElement;
expect(filaCabecera.contains(estrellas)).toBe(true);
expect(titulo.compareDocumentPosition(estrellas) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
expect(filaCabecera.style.alignItems).toBe("flex-start");
// y no está en la sección de reseñas
expect(within(screen.getByRole("button", { name: /reseñas \(2\)/i })).queryByRole("img")).toBeNull();
});
it("Marcar alterna el favorito (aria-pressed + persistencia)", () => {
render(<LocalCard local={LOCAL} />);
const marcar = screen.getByRole("button", { name: /^marcar$/i });
@@ -59,25 +85,79 @@ describe("LocalCard (rediseño de usabilidad)", () => {
it("Reportar abre el formulario controlado encima de la barra; Cancelar lo cierra", () => {
render(<LocalCard local={LOCAL} />);
fireEvent.click(screen.getByRole("button", { name: /^reportar$/i }));
fireEvent.click(boton(/^reportar$/i));
expect(screen.getByText(/¿Qué está mal con este local\?/i)).toBeTruthy();
fireEvent.click(screen.getByRole("button", { name: /cancelar/i }));
fireEvent.click(boton(/cancelar/i));
expect(screen.queryByText(/¿Qué está mal/i)).toBeNull();
});
it("Comentar expande la sección de reseñas y enfoca el formulario", async () => {
it("Comentar abre el formulario DEBAJO de la barra y el botón queda activo", async () => {
render(<LocalCard local={LOCAL} />);
fireEvent.click(screen.getByRole("button", { name: /^comentar$/i }));
const comentar = boton(/^comentar$/i);
expect(comentar.getAttribute("aria-pressed")).toBe("false");
expect(screen.queryByLabelText(/comentario de la reseña/i)).toBeNull();
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 });
fireEvent.click(comentar);
const textarea = await screen.findByLabelText(/comentario de la reseña/i);
expect(screen.getByText(/deja tu reseña/i)).toBeTruthy();
// debajo de los botones: el formulario va después de la barra
const barra = comentar.parentElement;
expect(barra.compareDocumentPosition(textarea.closest("div")) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
expect(comentar.getAttribute("aria-pressed")).toBe("true");
expect(comentar.className).toMatch(/activo/);
await waitFor(
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
{ timeout: 3000 },
);
// Comentar ALTERNA: la segunda pulsación cierra la sección
fireEvent.click(screen.getByRole("button", { name: /^comentar$/i }));
await waitFor(() => expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull());
// el botón activo se apaga al cerrar desde «Cerrar»
fireEvent.click(boton(/cerrar/i));
expect(screen.queryByLabelText(/comentario de la reseña/i)).toBeNull();
expect(boton(/^comentar$/i).getAttribute("aria-pressed")).toBe("false");
});
it("expandir las reseñas no abre el formulario (solo amplía reseñas)", async () => {
listarResenas.mockResolvedValueOnce({ resenas: CUATRO, total: 4 });
render(<LocalCard local={LOCAL} />);
await screen.findByText("Uno");
fireEvent.click(await screen.findByRole("button", { name: /ver las 4 reseñas/i }));
expect(await screen.findByText("Cuatro")).toBeTruthy();
expect(screen.queryByLabelText(/comentario de la reseña/i)).toBeNull();
expect(screen.getByRole("button", { name: /ver menos/i })).toBeTruthy();
});
it("publicar desde el formulario envía la reseña y refresca la tarjeta", async () => {
enviarResena.mockResolvedValue({ ok: true, media: 5, total: 1 });
render(<LocalCard local={LOCAL} />);
fireEvent.click(boton(/^comentar$/i));
await screen.findByRole("radio", { name: "5 estrellas" });
fireEvent.click(screen.getByRole("radio", { name: "5 estrellas" }));
fireEvent.click(boton(/publicar/i));
await waitFor(() => expect(enviarResena).toHaveBeenCalledWith("loc-1", {
deviceId: expect.any(String),
puntuacion: 5,
comentario: "",
}));
// la media de la cabecera se actualiza con la respuesta
await waitFor(() => expect(screen.getByRole("img", { name: /valoración: 5 de 5 estrellas/i })).toBeTruthy());
});
it("los botones llevan hover a superficie completa (clase btn-hover / activo)", () => {
render(<LocalCard local={LOCAL} />);
const barra = boton(/^comentar$/i).parentElement;
for (const b of barra.querySelectorAll("button")) expect(b.className).toMatch(/btn-hover/);
fireEvent.click(boton(/^marcar$/i));
expect(boton(/marcado/i).className).toMatch(/activo/);
fireEvent.click(boton(/^comentar$/i));
expect(boton(/publicar/i).className).toMatch(/btn-primario/);
expect(boton(/cerrar/i).className).toMatch(/btn-hover/);
});
});
+71 -126
View File
@@ -1,164 +1,109 @@
// @vitest-environment jsdom
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { act, cleanup, fireEvent, render, screen, waitFor, within } from "@testing-library/react";
import { afterEach, describe, expect, it, vi } from "vitest";
import { cleanup, fireEvent, render, screen, within } from "@testing-library/react";
// Mock del cliente API (firebase.js re-exporta api.js: el mock intercepta la
// resolución del módulo y cubre ambas vías).
vi.mock("../../src/api.js", () => ({
listarResenas: vi.fn(),
enviarResena: vi.fn(),
borrarResena: vi.fn(),
reportarLocal: vi.fn(),
}));
import { createRef } from "react";
import ResenasLocal from "../../src/components/ResenasLocal.jsx";
import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../../src/api.js";
beforeEach(() => {
vi.clearAllMocks();
localStorage.clear();
});
afterEach(cleanup);
const ISO = "2026-10-11T10:00:00.000Z";
const reseña = (id, huella, puntuacion, comentario, extra = {}) => ({
const resena = (id, huella, puntuacion, comentario, extra = {}) => ({
id, huella, puntuacion, comentario, fecha: ISO, fechaEdicion: null, esPropia: false, ...extra,
});
const CUATRO = [
reseña("r1", "#111111", 5, "Uno"),
reseña("r2", "#222222", 4, "Dos"),
reseña("r3", "#333333", 3, "Tres"),
reseña("r4", "#444444", 2, "Cuatro"),
resena("r1", "#111111", 5, "Uno"),
resena("r2", "#222222", 4, "Dos"),
resena("r3", "#333333", 3, "Tres"),
resena("r4", "#444444", 2, "Cuatro"),
];
const PROPIA = reseña("r9", "#999999", 5, "Mi favorito", { esPropia: true });
const PROPIA = resena("r9", "#999999", 5, "Mi favorito", { esPropia: true });
const cabecera = () => screen.getByRole("button", { name: /reseñas \(\d+\)/i });
const botonAmpliar = () => screen.getByRole("button", { name: /ver las \d+ reseñas/i });
describe("ResenasLocal (grid + cierre por tres vías)", () => {
it("carga al montar y muestra 3 en fila; la 4ª y el formulario quedan plegados", async () => {
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" totalInicial={4} mediaInicial={4} />);
describe("ResenasLocal (presentación)", () => {
it("vista previa de 3 en fila, sin estrellas de media y sin formulario", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
await waitFor(() => expect(listarResenas).toHaveBeenCalledWith("loc-1", expect.any(String)));
expect(await screen.findByText("Uno")).toBeTruthy();
expect(screen.getByText("Dos")).toBeTruthy();
expect(screen.getByText("Tres")).toBeTruthy();
// la vista previa contiene solo las 3 primeras
const previa = screen.getByLabelText(/vista previa de reseñas/i);
const previa = screen.getByLabelText(/reseñas del local/i);
expect(within(previa).getByText("Uno")).toBeTruthy();
expect(within(previa).getByText("Tres")).toBeTruthy();
// la 4ª vive en el cajón plegado
expect(within(previa).queryByText("Cuatro")).toBeNull();
// pista y formulario plegado (aria-hidden excluye los roles)
expect(screen.getByRole("button", { name: /ver las 4 reseñas/i })).toBeTruthy();
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
// la media NO está en la sección (vive en la cabecera de la tarjeta)
expect(within(cabecera()).queryByRole("img")).toBeNull();
// no hay formulario de reseña
expect(screen.queryByRole("radio")).toBeNull();
expect(screen.queryByLabelText(/comentario de la reseña/i)).toBeNull();
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
});
it("expandir revela el resto en el mismo grid y el formulario; la cabecera vuelve a cerrar", async () => {
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno");
it("el control de ampliar va debajo de las reseñas y a ancho completo", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
const boton = botonAmpliar();
const previa = screen.getByLabelText(/reseñas del local/i);
expect(previa.compareDocumentPosition(boton) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
expect(boton.style.width).toBe("100%");
expect(boton.getAttribute("aria-expanded")).toBe("false");
});
it("expandir revela SOLO el resto de reseñas (sin formulario) y pasa a «Ver menos»", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
fireEvent.click(botonAmpliar());
expect(screen.getByText("Cuatro")).toBeTruthy();
expect(screen.queryByRole("radio")).toBeNull();
expect(screen.queryByLabelText(/comentario de la reseña/i)).toBeNull();
expect(screen.getByRole("button", { name: /ver menos/i })).toBeTruthy();
});
it("la cabecera también alterna el plegado", () => {
render(<ResenasLocal resenas={CUATRO} total={4} />);
fireEvent.click(cabecera());
expect(await screen.findByText("Cuatro")).toBeTruthy();
expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy();
expect(screen.getByRole("button", { name: /cerrar/i })).toBeTruthy();
expect(screen.queryByRole("button", { name: /ver las 4 reseñas/i })).toBeNull();
expect(cabecera().getAttribute("aria-expanded")).toBe("true");
expect(screen.getByRole("button", { name: /ver menos/i })).toBeTruthy();
// cierre vía cabecera
fireEvent.click(cabecera());
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
expect(screen.getByRole("button", { name: /ver las 4 reseñas/i })).toBeTruthy();
});
it("el botón Cerrar del formulario pliega la sección", async () => {
listarResenas.mockResolvedValue({ resenas: CUATRO, total: 4 });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno");
fireEvent.click(cabecera());
fireEvent.click(await screen.findByRole("button", { name: /cerrar/i }));
expect(cabecera().getAttribute("aria-expanded")).toBe("false");
expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull();
it("sin reseñas que desplegar no aparece el control de ancho completo", () => {
render(<ResenasLocal resenas={CUATRO.slice(0, 3)} total={3} />);
expect(screen.queryByRole("button", { name: /ver las 3 reseñas/i })).toBeNull();
expect(screen.queryByRole("button", { name: /ver menos/i })).toBeNull();
});
it("comentar() (barra de acciones) alterna: abre con foco y vuelve a cerrar", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
const ref = createRef();
render(<ResenasLocal ref={ref} localId="loc-1" />);
await waitFor(() => expect(listarResenas).toHaveBeenCalled());
it("la reseña propia ofrece Borrar y la ajena Reportar (o el ✅ si ya se reportó)", () => {
const onBorrar = vi.fn();
const onReportar = vi.fn();
render(<ResenasLocal resenas={[PROPIA, CUATRO[0]]} total={2} onBorrar={onBorrar} onReportar={onReportar} />);
act(() => ref.current.comentar());
await waitFor(() => expect(screen.getByRole("button", { name: /publicar/i })).toBeTruthy(), { timeout: 3000 });
await waitFor(
() => expect(document.activeElement?.getAttribute("aria-label")).toMatch(/1 estrella/),
{ timeout: 3000 },
);
const previa = screen.getByLabelText(/reseñas del local/i);
const tarjetaPropia = within(previa).getByText("Mi favorito").closest("div");
expect(within(tarjetaPropia).getByText(/^tú$/i)).toBeTruthy();
fireEvent.click(within(tarjetaPropia).getByRole("button", { name: /borrar/i }));
expect(onBorrar).toHaveBeenCalledWith(PROPIA);
act(() => ref.current.comentar());
await waitFor(() => expect(screen.queryByRole("button", { name: /publicar/i })).toBeNull());
});
it("elegir estrellas y publicar llama a enviarResena con el deviceId", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
enviarResena.mockResolvedValue({ ok: true, media: 4, total: 1 });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText(/aún no hay reseñas/i);
fireEvent.click(cabecera());
fireEvent.click(await screen.findByRole("radio", { name: "4 estrellas" }));
fireEvent.change(screen.getByLabelText(/comentario de la reseña/i), { target: { value: "Muy bien" } });
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
await waitFor(() => expect(enviarResena).toHaveBeenCalledWith("loc-1", {
deviceId: expect.any(String),
puntuacion: 4,
comentario: "Muy bien",
}));
expect(localStorage.getItem("localesp_device_id")).toMatch(/./);
});
it("la propia aparece como «Tú» con botón Borrar en su tarjeta; el formulario se precarga (Actualizar)", async () => {
listarResenas.mockResolvedValue({ resenas: [PROPIA], total: 1 });
borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 });
render(<ResenasLocal localId="loc-1" totalInicial={1} mediaInicial={5} />);
const previa = screen.getByLabelText(/vista previa de reseñas/i);
await waitFor(() => expect(within(previa).getByText("Mi favorito")).toBeTruthy());
// tarjeta propia en la vista previa: etiqueta «Tú» + Borrar (sin Reportar)
const tarjeta = within(previa).getByText("Mi favorito").closest("div");
expect(within(tarjeta).getByText(/^tú$/i)).toBeTruthy();
fireEvent.click(within(tarjeta).getByRole("button", { name: /borrar/i }));
await waitFor(() => expect(borrarResena).toHaveBeenCalledWith("loc-1", expect.any(String)));
// el formulario expandido sigue precargando la propia (Actualizar)
fireEvent.click(cabecera());
expect(await screen.findByRole("button", { name: /actualizar/i })).toBeTruthy();
expect(screen.getByLabelText(/comentario de la reseña/i).value).toBe("Mi favorito");
});
it("las reseñas ajenas tienen botón Reportar por tarjeta y queda marcada", async () => {
listarResenas.mockResolvedValue({ resenas: [CUATRO[0]], total: 1 });
reportarLocal.mockResolvedValue({ ok: true });
render(<ResenasLocal localId="loc-1" />);
await screen.findByText("Uno");
const tarjetaAjena = within(previa).getByText("Uno").closest("div");
fireEvent.click(within(tarjetaAjena).getByRole("button", { name: /reportar/i }));
expect(onReportar).toHaveBeenCalledWith(CUATRO[0]);
cleanup();
render(<ResenasLocal resenas={[CUATRO[0]]} total={1} reportada="r1" />);
const tarjeta = screen.getByText("Uno").closest("div");
fireEvent.click(within(tarjeta).getByRole("button", { name: /reportar/i }));
await waitFor(() => expect(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "r1"));
await waitFor(() => expect(within(tarjeta).getByText("✅")).toBeTruthy());
expect(within(tarjeta).getByText("✅")).toBeTruthy();
expect(within(tarjeta).queryByRole("button", { name: /reportar/i })).toBeNull();
});
it("errores del servidor (palabras no permitidas, 429) se muestran como aviso", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
enviarResena.mockRejectedValue(new Error("El comentario contiene palabras no permitidas"));
render(<ResenasLocal localId="loc-1" />);
await screen.findByText(/aún no hay reseñas/i);
it("estados de carga y sin reseñas", () => {
render(<ResenasLocal resenas={null} cargando total={0} />);
expect(screen.getByText(/cargando reseñas/i)).toBeTruthy();
cleanup();
fireEvent.click(cabecera());
fireEvent.click(await screen.findByRole("radio", { name: "3 estrellas" }));
fireEvent.click(screen.getByRole("button", { name: /publicar/i }));
expect((await screen.findByRole("alert")).textContent).toMatch(/no permitidas/i);
render(<ResenasLocal resenas={[]} total={0} />);
expect(screen.getByText(/aún no hay reseñas/i)).toBeTruthy();
});
});
+125
View File
@@ -0,0 +1,125 @@
// @vitest-environment jsdom
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { act, cleanup, renderHook, waitFor } from "@testing-library/react";
// Mock del cliente API (firebase.js re-exporta api.js: el mock intercepta la
// resolución del módulo y cubre ambas vías).
vi.mock("../../src/api.js", () => ({
listarResenas: vi.fn(),
enviarResena: vi.fn(),
borrarResena: vi.fn(),
reportarLocal: vi.fn(),
}));
import useResenas from "../../src/hooks/useResenas.js";
import { borrarResena, enviarResena, listarResenas, reportarLocal } from "../../src/api.js";
const ISO = "2026-10-11T10:00:00.000Z";
const PROPIA = { id: "r9", huella: "#999999", puntuacion: 5, comentario: "Mi favorito", fecha: ISO, fechaEdicion: null, esPropia: true };
beforeEach(() => {
vi.clearAllMocks();
localStorage.clear();
});
afterEach(cleanup);
describe("useResenas (dueño único del estado de reseñas)", () => {
it("carga al montar y precarga la reseña propia", async () => {
listarResenas.mockResolvedValue({ resenas: [PROPIA], total: 1 });
const { result } = renderHook(() => useResenas("loc-1", { totalInicial: 1, mediaInicial: 4 }));
await waitFor(() => expect(result.current.resenas).not.toBeNull());
expect(listarResenas).toHaveBeenCalledWith("loc-1", expect.any(String));
expect(result.current.cargando).toBe(false);
expect(result.current.total).toBe(1);
// La media la aporta el local (el listado no la devuelve)
expect(result.current.media).toBe(4);
expect(result.current.tienePropia).toBe(true);
expect(result.current.puntuacion).toBe(5);
expect(result.current.comentario).toBe("Mi favorito");
});
it("enviar manda el deviceId y refresca lista, media y total", async () => {
listarResenas
.mockResolvedValueOnce({ resenas: [], total: 0 })
.mockResolvedValueOnce({ resenas: [PROPIA], total: 1 });
enviarResena.mockResolvedValue({ ok: true, media: 4, total: 1 });
const { result } = renderHook(() => useResenas("loc-1"));
await waitFor(() => expect(result.current.resenas).toEqual([]));
act(() => { result.current.setPuntuacion(4); result.current.setComentario("Muy bien"); });
await act(async () => { await result.current.enviar(); });
expect(enviarResena).toHaveBeenCalledWith("loc-1", {
deviceId: expect.any(String),
puntuacion: 4,
comentario: "Muy bien",
});
expect(result.current.media).toBe(4);
expect(result.current.total).toBe(1);
expect(result.current.tienePropia).toBe(true);
expect(listarResenas).toHaveBeenCalledTimes(2);
expect(localStorage.getItem("localesp_device_id")).toMatch(/./);
});
it("sin puntuación no envía", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
const { result } = renderHook(() => useResenas("loc-1"));
await waitFor(() => expect(result.current.resenas).toEqual([]));
await act(async () => { await result.current.enviar(); });
expect(enviarResena).not.toHaveBeenCalled();
});
it("el error del servidor se expone como mensaje", async () => {
listarResenas.mockResolvedValue({ resenas: [], total: 0 });
enviarResena.mockRejectedValue(new Error("El comentario contiene palabras no permitidas"));
const { result } = renderHook(() => useResenas("loc-1"));
await waitFor(() => expect(result.current.resenas).toEqual([]));
act(() => result.current.setPuntuacion(3));
await act(async () => { await result.current.enviar(); });
expect(result.current.error).toMatch(/no permitidas/i);
expect(result.current.enviando).toBe(false);
});
it("borrar la propia recalcula la media y limpia el formulario", async () => {
listarResenas
.mockResolvedValueOnce({ resenas: [PROPIA], total: 1 })
.mockResolvedValueOnce({ resenas: [], total: 0 });
borrarResena.mockResolvedValue({ ok: true, media: 0, total: 0 });
const { result } = renderHook(() => useResenas("loc-1", { totalInicial: 1, mediaInicial: 5 }));
await waitFor(() => expect(result.current.tienePropia).toBe(true));
await act(async () => { await result.current.borrarPropia(); });
expect(borrarResena).toHaveBeenCalledWith("loc-1", expect.any(String));
expect(result.current.media).toBe(0);
expect(result.current.tienePropia).toBe(false);
expect(result.current.puntuacion).toBe(0);
expect(result.current.comentario).toBe("");
});
it("reportar marca la reseña reportada", async () => {
listarResenas.mockResolvedValue({ resenas: [{ id: "r1", huella: "#111", puntuacion: 5, comentario: "Uno", fecha: ISO, esPropia: false }], total: 1 });
reportarLocal.mockResolvedValue({ ok: true });
const { result } = renderHook(() => useResenas("loc-1"));
await waitFor(() => expect(result.current.resenas?.length).toBe(1));
await act(async () => { await result.current.reportar(result.current.resenas[0]); });
expect(reportarLocal).toHaveBeenCalledWith("loc-1", "inapropiado", "", "r1");
expect(result.current.reportada).toBe("r1");
});
it("si falla la carga lo avisa y deja de cargar", async () => {
listarResenas.mockRejectedValue(new Error("boom"));
const { result } = renderHook(() => useResenas("loc-1"));
await waitFor(() => expect(result.current.error).toMatch(/no se pudieron cargar/i));
expect(result.current.cargando).toBe(false);
expect(result.current.resenas).toBeNull();
});
});