Files
localesp/tests/component/BarraFiltros.spec.jsx
T
edgar.friendly 232ef3fcda
deploy-branch / deploy (push) Successful in 2m59s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 3m25s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m14s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(busqueda): búsqueda fuzzy por erratas, sólo como rescate
El fuzzy entra únicamente cuando la búsqueda normal no devuelve NADA, para no
ensuciar los resultados con falsos positivos.

- src/utils/busqueda.js: buscarLocales() en dos etapas.
  1. Exacta (todas las palabras aparecen), con puntuación de relevancia:
     3 si empiezan palabra ("bar" en «Bar Torrijos»), 2 si van a mitad
     ("bar" en «Albardón»).
  2. Aproximada, sólo si la 1 no devolvió nada: cada palabra a distancia de
     edición corta de alguna palabra del índice (Levenshtein con corte
     temprano). Umbral: sin fuzzy por debajo de 4 letras, 1 edición hasta 6,
     2 a partir de 7. "peluquera" → Peluquería, "torrjos" → Torrijos.
- App: filtra por el mapa de puntuaciones y ordena por relevancia primero,
  dejando el orden elegido como desempate.
- BarraFiltros: cuando los resultados son aproximados lo dice
  («1 de 4 · búsqueda aproximada») en el mismo role=status anunciado.
- scripts/entornos.env: alta del entorno de la rama.

Tests: 195/195 (10 nuevos) — umbrales, distancia con corte, cascada,
relevancia y que el fuzzy no se activa si hay coincidencias exactas.
2026-11-01 14:01:52 +01:00

196 lines
8.8 KiB
React

// @vitest-environment jsdom
import { afterEach, describe, expect, it, vi } from "vitest";
import { cleanup, fireEvent, render, screen } from "@testing-library/react";
import BarraFiltros from "../../src/components/BarraFiltros.jsx";
import { PROVINCIAS, PROVINCIAS_POR_COMUNIDAD } from "../../src/constants/provincias.js";
function renderBarra(over = {}) {
const props = {
locales: [],
favoritos: [],
busqueda: "", setBusqueda: vi.fn(),
filtroCategoria: "", setFiltroCategoria: vi.fn(),
filtroProvincia: "", setFiltroProvincia: vi.fn(),
orden: "fecha", setOrden: vi.fn(),
soloFavoritos: false, setSoloFavoritos: vi.fn(),
ubicacion: null, buscandoUbicacion: false, errorUbicacion: "",
pedirUbicacion: vi.fn(), limpiarUbicacion: vi.fn(),
totalResultados: 4, totalLocales: 4, onLimpiar: vi.fn(),
...over,
};
const utils = render(<BarraFiltros {...props} />);
return { ...utils, props };
}
afterEach(cleanup);
describe("BarraFiltros", () => {
it("Sección única con búsqueda, provincia, categorías y acciones rápidas", () => {
const { container } = renderBarra();
expect(screen.getByRole("region", { name: /filtros de locales/i })).toBeTruthy();
expect(screen.getByLabelText(/buscar por nombre/i)).toBeTruthy();
expect(screen.getByLabelText(/filtrar por provincia/i)).toBeTruthy();
expect(screen.getByRole("button", { name: /restauración/i })).toBeTruthy();
expect(screen.getByRole("button", { name: /favoritos/i })).toBeTruthy();
expect(screen.getByRole("group", { name: /ordenar locales/i })).toBeTruthy();
// Todo vive dentro de la misma sección
expect(container.querySelectorAll("section[aria-label]").length).toBe(1);
});
it("No ofrece control de subcategoría y el único select es el de provincia", () => {
const { container } = renderBarra({ filtroCategoria: "Restauración" });
expect(screen.queryByLabelText(/tipo específico/i)).toBeNull();
expect(screen.queryByRole("option", { name: /todos los tipos/i })).toBeNull();
const selects = container.querySelectorAll("select");
expect(selects.length).toBe(1);
expect(selects[0].getAttribute("aria-label")).toMatch(/provincia/i);
// Todas las provincias disponibles en el desplegable compacto
expect(selects[0].querySelectorAll("option").length).toBe(PROVINCIAS.length + 1);
});
it("Agrupa las provincias por comunidad autónoma con optgroup", () => {
const { container } = renderBarra();
const select = container.querySelector("select");
const grupos = [...select.querySelectorAll("optgroup")];
expect(grupos.map((g) => g.getAttribute("label"))).toEqual(Object.keys(PROVINCIAS_POR_COMUNIDAD));
grupos.forEach((g) => {
const esperadas = PROVINCIAS_POR_COMUNIDAD[g.getAttribute("label")];
expect([...g.querySelectorAll("option")].map((o) => o.value)).toEqual(esperadas);
});
// Listado completo: las 50 provincias una sola vez cada una
const valores = [...select.querySelectorAll("optgroup option")].map((o) => o.value);
expect(valores.length).toBe(50);
expect(new Set(valores).size).toBe(50);
});
it("El buscador comunica el filtrado por provincia y notifica los cambios", () => {
const { props } = renderBarra();
const input = screen.getByLabelText(/buscar por nombre/i);
expect(input.getAttribute("placeholder")).toMatch(/provincia/i);
expect(input.getAttribute("placeholder")).toMatch(/categoría/i);
fireEvent.change(input, { target: { value: "Madrid" } });
expect(props.setBusqueda).toHaveBeenCalledWith("Madrid");
});
it("Chips de categoría: conteo, aria-pressed y alternado", () => {
const locales = [
{ id: "1", categoria: "Restauración" },
{ id: "2", categoria: "Restauración" },
{ id: "3", categoria: "Otros" },
];
const { props } = renderBarra({ locales, filtroCategoria: "Restauración" });
const chip = screen.getByRole("button", { name: /restauración/i });
expect(chip.getAttribute("aria-pressed")).toBe("true");
expect(chip.textContent).toContain("2"); // conteo de locales de la categoría
fireEvent.click(chip);
expect(props.setFiltroCategoria).toHaveBeenCalledWith(""); // pulsar de nuevo la deselecciona
});
it("Orden segmentado: sin desplegable y con distancia solo si hay ubicación", () => {
const sinUbicacion = renderBarra();
expect(screen.queryByRole("button", { name: /más cerca/i })).toBeNull();
expect(sinUbicacion.container.querySelectorAll("select").length).toBe(1);
fireEvent.click(screen.getByRole("button", { name: /mejor/i }));
expect(sinUbicacion.props.setOrden).toHaveBeenCalledWith("puntuacion");
cleanup();
const conUbicacion = renderBarra({ ubicacion: { lat: 40.4, lng: -3.7 }, orden: "distancia" });
const cerca = screen.getByRole("button", { name: /más cerca/i });
expect(cerca.getAttribute("aria-pressed")).toBe("true");
fireEvent.click(screen.getByRole("button", { name: /reciente/i }));
expect(conUbicacion.props.setOrden).toHaveBeenCalledWith("fecha");
});
it("«✕ Limpiar» está siempre presente: deshabilitado sin filtros y delega en App con ellos", () => {
renderBarra();
// Presente desde el principio (reserva su hueco: activar un filtro no
// desplaza al grupo de orden que el usuario acaba de pulsar)
const inactivo = screen.getByRole("button", { name: /limpiar todos los filtros/i });
expect(inactivo.disabled).toBe(true);
cleanup();
const { props } = renderBarra({
busqueda: "pizza",
filtroCategoria: "Restauración",
filtroProvincia: "Madrid",
orden: "puntuacion",
soloFavoritos: true,
ubicacion: { lat: 40.4, lng: -3.7 },
});
const activo = screen.getByRole("button", { name: /limpiar todos los filtros/i });
expect(activo.disabled).toBe(false);
fireEvent.click(activo);
// El reseteo vive en App (lo comparten la barra y el estado vacío)
expect(props.onLimpiar).toHaveBeenCalledTimes(1);
});
it("Muestra el conteo de resultados y distingue filtrar de ordenar", () => {
renderBarra();
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
renderBarra({ busqueda: "bar", totalResultados: 2 });
expect(screen.getByRole("status").textContent).toBe("2 de 4 locales");
cleanup();
// Ordenar no reduce: sigue siendo el total
renderBarra({ orden: "puntuacion", totalResultados: 4 });
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
// Un filtro que no reduce nada tampoco se anuncia como "N de M"
renderBarra({ filtroProvincia: "Madrid", totalResultados: 4 });
expect(screen.getByRole("status").textContent).toBe("4 locales");
cleanup();
renderBarra({ totalResultados: 1, totalLocales: 1 });
expect(screen.getByRole("status").textContent).toBe("1 local");
cleanup();
renderBarra({ totalResultados: 0, totalLocales: 0 });
expect(screen.getByRole("status").textContent).toMatch(/todavía no hay locales publicados/i);
cleanup();
// Resultados de la etapa fuzzy: se avisa explícitamente
renderBarra({ busqueda: "peluquera", totalResultados: 1, aproximada: true });
expect(screen.getByRole("status").textContent).toBe("1 de 4 · búsqueda aproximada");
});
it("El ✕ del buscador aparece solo con texto y borra únicamente la consulta", () => {
renderBarra();
expect(screen.queryByRole("button", { name: /borrar búsqueda/i })).toBeNull();
cleanup();
const { props } = renderBarra({ busqueda: "pizza", filtroProvincia: "Madrid" });
fireEvent.click(screen.getByRole("button", { name: /borrar búsqueda/i }));
expect(props.setBusqueda).toHaveBeenCalledWith("");
// No toca el resto de filtros
expect(props.setFiltroProvincia).not.toHaveBeenCalled();
expect(props.onLimpiar).not.toHaveBeenCalled();
});
it("Escape en el buscador limpia la consulta", () => {
const { props } = renderBarra({ busqueda: "pizza" });
fireEvent.keyDown(screen.getByLabelText(/buscar por nombre/i), { key: "Escape" });
expect(props.setBusqueda).toHaveBeenCalledWith("");
});
it("Activar el orden no cambia el número de botones de la fila de acciones (sin reflujo)", () => {
const { container } = renderBarra({ orden: "fecha" });
const filaInactiva = container.querySelectorAll("button").length;
cleanup();
const { container: c2 } = renderBarra({ orden: "puntuacion" });
expect(c2.querySelectorAll("button").length).toBe(filaInactiva);
});
it("Favoritos refleja el conteo y su estado", () => {
const { props } = renderBarra({ favoritos: ["a", "b"], soloFavoritos: true });
const boton = screen.getByRole("button", { name: /favoritos \(2\)/i });
expect(boton.getAttribute("aria-pressed")).toBe("true");
fireEvent.click(boton);
const alternar = props.setSoloFavoritos.mock.calls[0][0];
expect(alternar(false)).toBe(true); // setSoloFavoritos recibe la función de alternado
});
});