Ejemplos funciones con doc y casos de prueba

/* Ejemplo 1: Una función que dados dos números, me devuelva el mayor */

// Nombre de la función: mayor
// ¿Tengo parámetros? : Dos números
// ¿Devuelvo algo? : El número mayor

/**
 * 
 * @param {Number} a 
 * @param {Number} b 
 * @returns El mayor de los dos números
 */
function mayor(a, b) {
    if (b < a) {
        return a;
    } else {
        return b;
    }
}

// Casos de prueba
console.log(mayor(2, 8)); // 8
console.log(mayor(7, 2)); // 7
console.log(mayor(2, 2)); // 2

// Más o menos lo que hacen los test unitarios
if (mayor(2, 8) == 8 && mayor(7, 2) == 7 && mayor(2, 2) == 2) {
    console.log("Todo ok")
}

// Una función a la que le pasamos un nombre y un apellido y nos devuelve el nombre completo (nombra + apellido)

// Nombre: nombreCompleto
// Parámetros?: dos cadenas nombre y apellido
// Devuelvo algo?: Una cadena

/**
 * 
 * @param {String} nombre 
 * @param {String} apellido 
 * @returns El nombre completo
 */
function nombreCompleto(nombre, apellido) {
    return nombre + " " + apellido;
}

let n=nombreCompleto("Ana","Pi");
console.log(n); // Ana Pi
console.log(nombreCompleto("Pepe","Pérez")); // Pepe Pérez

// Una función que nos calcule la suma de los números hasta el que le pasemos

// Nombre: sumaNumeros
// Parámetro: El número límite
// Retorno: El total

/**
 * 
 * @param {number} limite 
 * @returns La suma desde 1 hasta límite
 */
function sumaNumeros(limite){
    let suma=0;
    for(let i=1;i<=limite;i++){
        suma+=i;
    }
    return suma;
}

// Casos de prueba
console.log(sumaNumeros(50)); // 1275
console.log(sumaNumeros(100)); // 5050