Migrando a React Router Dom 5 en proyectos reales

Curso de React.js: Navegación con React Router

Contenido del curso

No sé dónde empezar

Fundamentos de navegación en la web

Introducción a React Router DOM 6

Fake authentication con React Router DOM 6

React Router en TODO Machine

Próximos pasos

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:007:09

Migrando a React Router Dom 5 en proyectos reales

Curso de React.js: Navegación con React Router

Clase 27 de 30

Clase 27 / 30

Recursos

Migrar de React Router Dom 6 a React Router Dom 5 suena como un retroceso, pero es justamente el tipo de tarea que vas a enfrentar cuando entres a trabajar en una empresa real. Aquí aprendes por qué bajar de versión es un ejercicio profesional valioso y cómo replicar comportamientos en proyectos legacy sin romper la aplicación.

Por qué hacer downgrade de React Router Dom 6 a React Router Dom 5

El reto parte del mismo package.json con el que desplegaste tu aplicación. La idea es regresar a la rama inicial del curso y empezar de cero, pero esta vez instalando React Router Dom 5 en lugar de la 6.

La razón es simple: cuando construyes proyectos personales, eliges la última versión de cualquier tecnología. Quieres React 18, el router más nuevo, las dependencias recién salidas. Pero al entrar a una startup, agencia o empresa, lo más probable es que el código ya exista y use versiones anteriores que siguen funcionando perfectamente.

¿Por qué muchas empresas siguen usando React Router Dom 5? Porque la aplicación funciona, migrar cuesta tiempo de desarrollo y los beneficios de actualizar no siempre justifican el esfuerzo frente a arreglar bugs o mejorar la experiencia del usuario.

Qué hacer cuando llegas a un proyecto con dependencias desactualizadas

Imagina que entras como front end o software developer a Platzi. Te asignan tu primera tarea, abres el package.json y ves React Router Dom 5. Tu primer impulso es decirle a tu líder que hay que actualizar.

La respuesta probable de tu jefe será: concéntrate en el bug que te asignaron. Y si insistes con que solo trabajas con la versión 6, te van a echar. No por grosería, sino porque no es prioridad para el negocio.

Ahora, si planteas la migración con argumentos sólidos, la conversación cambia. Tu product manager o líder técnico te preguntará por qué vale la pena. Las razones válidas suelen ser:

Mejor rendimiento medible en la aplicación.
Una API más limpia que reduce código repetido.
Funcionalidades que la versión nueva ofrece y la actual no.
Soporte activo frente a una versión que dejará de recibir parches.

Cuándo no vale la pena migrar dependencias

Si los custom hooks cambian un poco, la API es ligeramente distinta y la mejora de rendimiento es irrelevante, la migración no se justifica. Cambiar el package.json es lo fácil; lo costoso es actualizar todos los archivos donde se usa esa dependencia en todo el proyecto.

Ese tiempo podría invertirse en arreglar bugs reales, mejorar la user experience o implementar funcionalidades que los usuarios llevan tiempo pidiendo. Esa es la decisión de negocio que tu líder tiene que tomar.

¿Qué es un proyecto legacy? Es un proyecto en producción que usa tecnologías o versiones anteriores y que sigue funcionando. Migrarlo cuesta tiempo y se hace solo cuando el beneficio supera al esfuerzo.

Cómo replicar los comportamientos de React Router Dom 6 con la versión 5

El ejercicio consiste en tomar todo lo que construiste con React Router Dom 6 en Todo Machine y reproducir los mismos comportamientos usando React Router Dom 5. No el mismo código, porque la herramienta cambia, pero sí el mismo resultado funcional.

Algunos puntos donde notarás diferencias:

La forma de declarar rutas cambia entre Routes (v6) y Switch (v5).
Los custom hooks tienen firmas distintas en cada versión.
La navegación programática usa APIs diferentes entre ambas versiones.
El manejo de rutas anidadas se estructura distinto.

Qué aprendes al hacer este ejercicio

Replicar comportamientos en una versión anterior te entrena para el escenario real de tu primer trabajo. Vas a leer documentación antigua, vas a revisar issues de GitHub, vas a comparar APIs y vas a tomar decisiones de implementación con restricciones que no elegiste tú.

Esa es una habilidad clave: adaptarte al stack de la empresa en lugar de imponer el tuyo. Los proyectos personales son tu laboratorio; los proyectos de empresa son donde demuestras criterio técnico.

Qué hacer después de completar el reto

Cuando termines, comparte tu experiencia en los comentarios. Si React Router Dom 5 te pareció espantoso, cuéntalo. Si bajándole el ego al asunto te dio casi lo mismo trabajar con una u otra versión, también cuéntalo.

El objetivo es aprender en comunidad cuándo vale la pena migrar dependencias en proyectos legacy y cuándo no. Esa conversación te va a servir más que cualquier curso aislado cuando estés frente a tu primer package.json desactualizado en una empresa real.

Harold Zurita Simon

Hace 2 años

Reto: TODO Machine con React Router DOM 5

. El reto es replicar el mismo comportamiento de la aplicación con React Router DOM 5. . Para ello vamos a mantener la misma estructura de carpetas que utilizamos para la aplicación con React Router DOM 6 pero modificando algunos archivos donde algunos hooks o componentes proporcionados por este no existan o funcionen distintamente en la versión 5. . Para este reto hemos utilizado la versión 5.3.4 de React Router DOM. .

"react-router-dom": "^5.3.4"

. En src/routes/App.js ya no se usa el componente Routes de la versión 6, sino que se usa Switch. En lugar de element para definir el componente que se debe renderizar ahora utilizamos component. . Otra diferencia es que en la versión 6 element acepta un elemento de React directamente como <HomePage />, mientras que en la versión 5 component solo acepta una referencia a un componente como HomePage. . En la versión 6, es más directo usar el prop element={<p>Not Found</p>} con JSX, mientras que en la versión 5, se utiliza una función que retorna JSX component={() => <p>Not Found</p>}. . en la versión 6 Routes entiende de forma implícita cuándo una ruta es exacta, no se usa exact porque el enrutador lo maneja automáticamente, mientras que en la versión 5 usa exact para asegurar que la ruta exacta se corresponda. .

import React from "react";
import { HashRouter, Route, Switch } from "react-router-dom";
import { EditTodoPage } from "./edit/EditTodoPage";
import { HomePage } from "./home/HomePage";
import { NewTodoPage } from "./new/NewTodoPage";

function App() {
  return (
    <HashRouter>
      <Switch>
        <Route exact path="/" component={HomePage} />
        <Route path="/new" component={NewTodoPage} />
        <Route path="/edit/:id" component={EditTodoPage} />
        <Route path="*" component={() => <p>Not Found</p>} />
      </Switch>
    </HashRouter>
  );
}

export { App };

. En el componente HomePage, vamos a remplazar useNavigate por useHistory para la navegación con React Router DOM 5. El hook useHistory utiliza un método push para navegar a una ruta. . Ambas versiones permiten pasar un estado a través de la navegación, en la versión 6 con navigate('/edit/' + todo.id, { state: { todo } }) y en la versión 5 con history.push('/edit/' + todo.id, { todo }). .

import React from "react";
import { useHistory } from "react-router-dom";
import { useTodos } from "../useTodos";
import { TodoHeader } from "../../ui/TodoHeader";
import { TodoCounter } from "../../ui/TodoCounter";
import { TodoSearch } from "../../ui/TodoSearch";
import { TodoList } from "../../ui/TodoList";
import { TodoItem } from "../../ui/TodoItem";
import { TodosError } from "../../ui/TodosError";
import { TodosLoading } from "../../ui/TodosLoading";
import { EmptyTodos } from "../../ui/EmptyTodos";
import { CreateTodoButton } from "../../ui/CreateTodoButton";
import { ChangeAlert } from "../../ui/ChangeAlert";

function HomePage() {
  const history = useHistory();
  const { state, stateUpdaters } = useTodos();

  const {
    error,
    loading,
    searchedTodos,
    totalTodos,
    completedTodos,
    searchValue,
  } = state;

  const {
    completeTodo,
    deleteTodo,
    setSearchValue,
    sincronizeTodos,
  } = stateUpdaters;

  return (
    <React.Fragment>
      <TodoHeader loading={loading}>
        <TodoCounter totalTodos={totalTodos} completedTodos={completedTodos} />
        <TodoSearch searchValue={searchValue} setSearchValue={setSearchValue} />
      </TodoHeader>

      <TodoList
        error={error}
        loading={loading}
        totalTodos={totalTodos}
        searchedTodos={searchedTodos}
        searchText={searchValue}
        onError={() => <TodosError />}
        onLoading={() => <TodosLoading />}
        onEmptyTodos={() => <EmptyTodos />}
        onEmptySearchResults={(searchText) => (
          <p>No hay resultados para {searchText}</p>
        )}
      >
        {(todo) => (
          <TodoItem
            key={todo.id}
            text={todo.text}
            completed={todo.completed}
            onEdit={() => {
              history.push("/edit/" + todo.id, { todo });
            }}
            onComplete={() => completeTodo(todo.id)}
            onDelete={() => deleteTodo(todo.id)}
          />
        )}
      </TodoList>

      <CreateTodoButton
        onClick={() => history.push("/new")}
        // setOpenModal={setOpenModal}
      />

      <ChangeAlert sincronize={sincronizeTodos} />
    </React.Fragment>
  );
}

export { HomePage };

. En TodoForm es hacer lo mismo, remplazar useNavigate por useHistory. .

import React from 'react';
import { useHistory } from 'react-router-dom';
import './TodoForm.css';

function TodoForm(props) {
  const history = useHistory();
  const [newTodoValue, setNewTodoValue] = React.useState(props.defaultTodoText || '');

  const onChange = (event) => {
    setNewTodoValue(event.target.value);
  };
  const onCancel = () => {
    history.push('/');
  };
  const onSubmit = (event) => {
    event.preventDefault();
    props.submitEvent(newTodoValue);
    history.push('/');
  };

  return (
    <form onSubmit={onSubmit}>
      <label>{props.label}</label>
      <textarea
        value={newTodoValue}
        onChange={onChange}
        placeholder="Cortar la cebolla oara el almuerzo"
      />
      <div className="TodoForm-buttonContainer">
        <button
          type="button"
          className="TodoForm-button TodoForm-button--cancel"
          onClick={onCancel}
          >
          Cancelar
        </button>
        <button
          type="submit"
          className="TodoForm-button TodoForm-button--add"
        >
          {props.submitText}
        </button>
      </div>
    </form>
  );
}

export { TodoForm };

. Finalmente, en TodoSearch es donde se dio el mayor cambio, puesto que habíamos implementado búsqueda por navegación con useSearchParams. Sin embargo, este hook no existe en la versión 5 de React Router DOM. . Lo que se hizo fue utilizar useHistory y useLocation para obtener la propiedad search de useLocation, luego cada que escribamos algo en el input de búsqueda vamos a navegar con useHistory hacia el pathname / con ?search=${event.target.value} concatenado con lo que escribamos en dicho input. . Finalmente, en un useEffect revisamos que si el search empieza con ?search= significa que hemos accedido directamente a la búsqueda por la url, así que recuperamos el valor de la búsqueda, lo decodificamos en caso de que la búsqueda contuviera espacios representados como %20 y cambiamos el estado de searchValue mediante setSearchValue. . De esta manera obtendremos la búsqueda por navegación tanto por el input de búsqueda, como desde la url. .

import React, { useEffect } from "react";
import "./TodoSearch.css";
import { useHistory, useLocation } from "react-router-dom";

function TodoSearch({ searchValue, setSearchValue, loading }) {
  const { search } = useLocation();
  const history = useHistory();

  const onSearchValueChange = (event) => {
    setSearchValue(event.target.value);
    history.push({
      pathname: "/",
      search: `?search=${event.target.value}`,
    });
  };

  useEffect(() => {
    if (search.startsWith("?search=")) {
      setSearchValue(decodeURIComponent(search.substring(8)));
    }
  }, [searchValue]);

  return (
    <input
      className="TodoSearch"
      placeholder="Cebolla"
      value={searchValue}
      onChange={onSearchValueChange}
      disabled={loading}
    />
  );
}

export { TodoSearch };

Jose Ever Muñoz Muñoz

Hace 2 años

es la mejor explicacion que he leido :)

Comentarios (22)22 comentarios

Axlin Miranda

Hace 4 años

Seba Cardoso

Juan Castro

Profesor

Orlando Manuel Mendoza Vargas

Hace 3 años

Gilbert Ardila

Bramucci Candela

Raycris Maldonado

Diego Reyes Cabrera

Josue Tapia Linarez

Juan Pablo Cortés

Lenin Garizabalo

Neil Ruiz

Hace un año

Sebastian Carballo

Invitado Certificado

Adrian Villamil

Ricardo Daniel Quiroga

gemma clavero del moral

Andres Prieto

Fundamentos de navegación en la web

Cuándo y por qué usar React Router

SSR vs SPA: cómo funciona cada una

Uso de React Router DOM 6 en Proyectos React

Introducción a React Router DOM 6

Instalar React Router Dom 6 paso a paso

Browser Router vs Hash Router en GitHub Pages

Primeras rutas con React Router Dom 6

Link y NavLink para navegación en React

Rutas dinámicas con React Router DOM y useParams

useNavigate para navegar con JavaScript

Outlet y rutas anidadas en React Router

Fake authentication con React Router DOM 6

Rutas privadas con fake auth en React

Rutas privadas y públicas en React

Rutas protegidas con Navigate en React

Roles y permisos en aplicaciones web: Autenticación y autorización

Retos avanzados en React: manejo de estado y composición de componentes

Redirect al login con useLocation en React

Rutas dinámicas con roles de usuario

React Router en TODO Machine

Cómo migrar React portals a rutas reales

Estructura de carpetas con React Router Dom 6

Botón de editar todos con React y SVG

Generación de IDs únicos para gestionar tareas en React

Migrar modales a rutas con useNavigate

Cómo funciona editTodo con useParams

Texto por defecto en textarea con useLocation

Implementación de React Router en Proyectos Legacy

Próximos pasos

Sincronizar el buscador con la URL

Migrando a React Router Dom 5 en proyectos reales

Migra Platzi Movies de JS a React

Clonar React Router desde cero

Navegación Avanzada con React Router DOM 6

Migrando a React Router Dom 5 en proyectos reales