Conversor en Svelte

Este proyecto representa el clásico ejemplo del conversor de millas a kilómetros, generado con sv, con las siguientes configuraciones:

• Typescript
• ESlint + prettier + vitest
• agregamos plugins de testing library para tests de front
• y manejamos las dependencias con yarn (es mucho más rápido que usar npm)

Implementación

• El input millas se define como number para evitar valores alfabéticos incorrectos
• También tiene un binding contra el estado (la runa $.state), llamado miles
• Como los kilómetros se definen en función de las millas, utilizamos la runa $derived. Esto automáticamente recalcula el valor cuando cambiamos las millas
• De yapa, utilizamos una función que muestra los kilómetros en formato coma decimal
• Como solo tenemos una página, ubicamos dentro de la carpeta src/routes el archivo +page.svelte que la define como página principal de nuestra SPA (single page application)

Lo bueno es que Svelte necesita de esos pocos conceptos dentro de nuestra página:

<script lang="ts">
  import { convertMilesToKms } from '$lib'

  const formattedNumber = (value: number) => value.toLocaleString('es');

  let miles = $state(0)
  let kilometers = $derived(formattedNumber(convertMilesToKms(miles)))
  ...
</script>

<div class="form">
  ...
  <div class="row">
    <input type='number' data-testid='millas' bind:value={miles} />
  </div>
  <div class="row">
    <span data-testid="kilometers">{kilometers}</span>

Botón reset

Para resetear el valor de las millas contamos con un botón al que le asociamos una función que cambia el estado de millas:

<script lang="ts">
  ...
  const reset = () => { miles = 0 }
</script>

<button class="button secondary" data-testid="reset" onclick={reset}>Resetear</button>

Tests

La propiedad data-testid nos sirve para encontrar fácilmente los elementos del DOM y probar

• que inicialmente el valor del input millas es 0
• que podemos convertir exitosamente de millas a kilómetros (y también verificamos que la conversión se haga respetando el locale castellano con la coma decimal)
• y por último probamos el botón de Reset

Testing Library ofrece una técnica simple para el testeo de una página:

• tiene una función render propia, que guarda el DOM en una variable global, screen
• luego es posible acceder a los elementos del DOM mediante funciones helpers (nosotros vamos a preferir por data-testid para no utilizar cosas que el usuario pueda cambiar, contrariamente a la opinión que tiene el creador de la biblioteca Testing Library)
• y también tenemos funciones de alto nivel para simular la escritura de un input o presionar click en un botón

Dejamos el ejemplo del test del flujo feliz: escribimos millas y se convierten a kilómetros:

it('should convert valid miles to kilometers to locale es', async () => {
  render(Conversor)

  const miles = screen.getByTestId('millas') as HTMLInputElement
  await userEvent.type(miles, '100')
  const kilometers = screen.getByTestId('kilometers')
  expect(kilometers.innerHTML).to.equal('160,934')
})