CursosEmpresasBlogLiveConfPrecios

Primeras funciones del sistema de notas

Clase 24 de 39 • Curso de Fundamentos de JavaScript

Clase anteriorSiguiente clase
Resumen

Crear un sistema de notas Markdown en JavaScript es más sencillo cuando la base está clara: utilidades reutilizables, funciones CRUD y una mentalidad serena ante los errores. Aquí verás cómo estructurar las funciones esenciales —crear, listar, actualizar y eliminar—, cómo generar un ID único con Date.now y cómo aplicar validaciones mínimas que evitan fallos comunes.

¿Cómo iniciar el sistema de notas Markdown en JavaScript?

Antes de codificar, separamos espacios de trabajo: uno para ejercicios de JavaScript y otro para el proyecto “notes-md”. En este segundo, inicializamos, creamos tres archivos base y comenzamos en app.js. Se elimina el console.log inicial y se documenta con un comentario: sistema de notas en Markdown. La prioridad es definir utilidades en la parte superior del archivo para reutilizarlas cuando sea necesario.

  • Estructura clara desde el inicio.
  • Utilidades definidas arriba del archivo.
  • Comentarios que explican propósito.

¿Qué funciones principales construimos y cómo validarlas?

Se implementan utilidades y funciones clave: generateID, createNote, updateNote, deleteNote y listNotes. La idea es asegurar entradas válidas, usar un timestamp confiable y devolver mensajes claros.

¿Cómo generar un id único con Date.now?

Se usa la API de JavaScript para fechas: Date.now() retorna un número en milisegundos desde 1970. Este valor crece continuamente, ideal como ID único y como marca de tiempo de creación y actualización.

// Sistema de notas en Markdown

// Utilidad: generar un ID único a partir del timestamp
function generateID() {
  const timestamp = Date.now();
  return timestamp;
}

// Crear nota: valida, resume contenido y arma un bloque informativo
function createNote(content, title) {
  const contentTrim = (content || '').trim();
  if (!contentTrim) return 'error, el contenido no puede estar vacío';

  const noteID = generateID();
  const currentTime = Date.now();
  const noteTitle = title || 'nota sin título';

  const noteExcerpt = contentTrim.length > 100
    ? `${contentTrim.slice(0, 100)}...`
    : contentTrim;

  const noteInfo = `id|${noteID}\n` +
                   `título|${noteTitle}\n` +
                   `contenido|${contentTrim}\n` +
                   `descripción|${noteExcerpt}\n` +
                   `creado|${currentTime}\n` +
                   `actualizado|${currentTime}`;

  return noteInfo;
}

// Actualizar nota: valida el ID y reemplaza el contenido
function updateNote(noteID, newContent) {
  if (noteID === undefined || noteID === null || noteID === '') {
    return 'error id inválido';
  }

  const contentTrim = (newContent || '').trim();
  if (!contentTrim) return 'error, el contenido no puede estar vacío';

  const currentTime = Date.now();
  const noteExcerpt = contentTrim.length > 100
    ? `${contentTrim.slice(0, 100)}...`
    : contentTrim;

  const updateNoteInfo = `id|${noteID}\n` +
                         `contenido|${contentTrim}\n` +
                         `descripción|${noteExcerpt}\n` +
                         `actualizado|${currentTime}`;

  return updateNoteInfo;
}

// Eliminar nota: valida el ID y confirma la acción
function deleteNote(noteID) {
  if (noteID === undefined || noteID === null || noteID === '') {
    return 'error id inválido';
  }
  const message = `nota con id ${noteID} fue eliminada`;
  return message;
}

// Listar notas: base para futura lógica
function listNotes() {
  const message = 'listando todas las notas disponibles';
  return message;
}
  • Validaciones con triple igualdad para detectar undefined, null y string vacío.
  • Limpieza de entrada con trim() para evitar falsos positivos.
  • Resúmenes con operador ternario y template literals para legibilidad.

¿Cómo crear una nota con validaciones y excerpt?

La creación de la nota exige que el contenido no esté vacío. Se genera el ID con generateID, se obtiene currentTime con Date.now, se asigna un título por defecto si no existe y se produce un excerpt limitado a 100 caracteres con puntos suspensivos. Luego se compone un bloque de texto usando pipes y saltos de línea para leer rápido los campos clave: id, título, contenido, descripción, creado y actualizado.

¿Cómo actualizar, eliminar y listar notas?

  • Actualizar: requiere noteID válido y newContent con texto. Devuelve un bloque con contenido nuevo, excerpt y hora de actualización.
  • Eliminar: valida noteID y retorna un mensaje claro para el usuario.
  • Listar: por ahora, retorna un mensaje base que luego conectará con la persistencia.

¿Cómo depurar errores y mantener estándares en el código?

Los errores son aliados. Mantener la calma permite leer el mensaje, ubicar la línea y evitar confusiones por “copiar y pegar”. Un caso típico: redeclara noteID en updateNote cuando ya se recibe como parámetro. Solución: eliminar la reasignación y reutilizar el argumento.

¿Cómo leer errores y advertencias del editor?

  • Observa advertencias: “variable declarada pero no leída” indica retornos faltantes.
  • Aplica formateo y puntos y coma consistentes.
  • Usa selección múltiple con Command D o Control D para cambios masivos sin omisiones.

¿Qué es la técnica del patito para depurar?

La “técnica del patito” consiste en explicar el problema en voz alta a un objeto inanimado o a un compañero. Al verbalizar, la mente organiza el razonamiento y aparecen las causas reales. Útil para detectar inconsistencias como variables duplicadas o validaciones mal planteadas.

¿Te animas a compartir cómo estructurarías el guardado o el listado real de notas? Deja tu comentario con ideas o mejoras que quisieras implementar a continuación.

      Primeras funciones del sistema de notas