JAFSJosé Antonio Fuentes Santiago

Faker: usa datos realistas en tus pruebas y demos

12-09-2022

¿Te has cansado de usar siempre John Doe o Juanita Banana como nombre en tus pruebas? ¿Sientes que los tests no tienen datos realistas? ¿Quieres hacer una demo con datos que parezcan completamente auténticos?

En ese caso, Faker es exactamente lo que necesitas. Esta librería para JavaScript y TypeScript te permite generar datos aleatorios pero increíblemente verosímiles: nombres, direcciones, correos electrónicos, colores, contraseñas, títulos de trabajo, elementos químicos, palabras, imágenes y muchísimo más.

En este artículo ampliado veremos cómo usarla y añadiremos un ejemplo completo de generación de datos falsos para una aplicación realista.

Instalación del proyecto

Para que puedas hacer una prueba rápida, lo primero será inicializar un proyecto con TypeScript e instalar la librería:

npm init -y
npm install --save-dev typescript
node "./node_modules/typescript/bin/tsc" --init
npm install @faker-js/faker --save-dev

Ahora debemos indicar que podamos importar módulos. Para ello añade al package.json lo siguiente:

{
    // ...
    "type": "module"
}

Listo. Ya podemos comenzar a generar datos realistas.

Uso básico

import { faker } from "@faker-js/faker";

// Si necesitas usar un idioma en específico, por ejemplo, en español puedes
// hacer lo siguiente:
// import { fakerES as faker } from "@faker-js/faker";

// Ejemplos de generación simple
console.log(faker.location.city());  // "Pozuelo de Alarcón"
console.log(faker.location.country()); // España
console.log(faker.location.streetAddress()); // Lado José Luis Collazo, 27
console.log(faker.location.zipCode("#####")); // 77007

console.log(faker.color.rgb()); // #bcea7a
console.log(faker.color.human()); // granate

console.log(faker.internet.userName()); // Esperanza.MontemayorMendoza
console.log(faker.internet.password()); // zZ0pbsYHZBH0CnE
console.log(faker.internet.email()); // Monica_Heinz_43928@gmail.com

// https://avatars.githubusercontent.com/u/71163098
console.log(faker.image.avatar());

console.log(faker.person.fullName({ sex: "female" })); // Celia Cazares Lucero

console.log(faker.person.jobTitle()); // Asociado de Paradigma Producto
console.log(faker.person.jobType()); // Consultor

// { symbol: 'Si', name: 'Silicon', atomicNumber: 14 }
console.log(faker.science.chemicalElement());

// /media/fine.kar
console.log(faker.system.filePath());

Ejemplo realista: generar usuarios para una API o demo

Imagina que quieres poblar una base de datos local o simular un backend para una demo de frontend. Necesitas 20 usuarios coherentes, con su nombre, email, imagen de avatar, dirección completa y un rol laboral.

Con Faker es tan sencillo como esto:

import { faker } from "@faker-js/faker";
faker.setLocale("es");

interface Usuario {
  id: string;
  nombre: string;
  email: string;
  avatar: string;
  direccion: {
    calle: string;
    ciudad: string;
    pais: string;
    cp: string;
  };
  puesto: string;
}

function generarUsuario(): Usuario {
  return {
    id: faker.string.uuid(),
    nombre: faker.person.fullName(),
    email: faker.internet.email(),
    avatar: faker.image.avatar(),
    direccion: {
      calle: faker.location.streetAddress(),
      ciudad: faker.location.city(),
      pais: faker.location.country(),
      cp: faker.location.zipCode("#####")
    },
    puesto: faker.person.jobTitle()
  };
}

// Generamos 20 usuarios
const usuarios = Array.from({ length: 20 }, generarUsuario);

console.log(JSON.stringify(usuarios, null, 2));

Esto produce algo del estilo:

[
  {
    "id": "7a1b55d2-1bd8-4fc5-80b1-d1f3df4381e2",
    "nombre": "María Gómez Fuentes",
    "email": "MariaGFuentes@example.com",
    "avatar": "https://cloudflare-ipfs.com/ipfs/.../avatar/123.jpg",
    "direccion": {
      "calle": "Calle del Fresno, 12",
      "ciudad": "Burgos",
      "pais": "España",
      "cp": "09112"
    },
    "puesto": "Especialista en Marketing Digital"
  },
  ...
]

Como puedes ver, esta librería es perfecta en casos como los siguientes:

  • Necesitas rellenar una base de datos ficticia.
  • Debes mostrar un listado de ejemplo con usuarios, productos, etc. en tu interfaz.
  • Quieres simular peticiones a una API con datos realistas.
  • Vas a preparar demos sin datos personales reales.

Conclusión

Hemos podido ver como Faker es una herramienta imprescindible para demos, prototipos y testing. Te ahorra tiempo, te evita tener que inventar datos y te permite trabajar con ejemplos mucho más naturales. Además, de añadir un punto de aletoriedad que puede venir bien a la hora de testear el código.

Aún hay muchas más funciones a utilizar. Pero lo mejor es dar una vuelta a la documentación para descubrirlas todas. Espero que de ahora en adelante, puedas enriquecer los datos simulados gracias a esta librería.

ESTO SIGUE EN EL REFUGIO

Si estás empezando a programar, o empezando otra vez, en Guía de Programación en un Apocalipsis Zombi enseño TypeScript desde cero con problemas como los de aquí, solo que con zombis en la puerta. Hay un fragmento gratis para que pruebes antes de comprar, y si tienes Kindle Unlimited, el libro entero te sale gratis.