All files / app/utils module.js

100% Statements 19/19
100% Branches 10/10
100% Functions 5/5
100% Lines 19/19

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92                          42x 1x   41x 1x   40x 2x   38x 1x   37x 37x 37x                           28x 28x                               134x 134x                           48x 48x                         36x     36x  
/**
 * Calcule l'âge en années d'une personne à partir de sa date de naissance.
 *
 * @param {{birth: Date}} p Objet représentant une personne, avec un champ `birth` de type Date.
 * @returns {number} L'âge en années (NaN si la date est invalide).
 * @throws {Error} "missing param p" si `p` est undefined.
 * @throws {Error} "wrong format" si `p` n'est pas un objet.
 * @throws {Error} "no birth field" si `p.birth` est manquant ou n'est pas une Date.
 *
 * @example
 * calculateAge({ birth: new Date("1998-01-22") }); // 28
 */
export function calculateAge(p) {
    if (p === undefined) {
        throw new Error('missing param p')
    }
    if (typeof p !== 'object') {
        throw new Error('wrong format')
    }
    if (!p.birth || !(p.birth instanceof Date)) {
        throw new Error('no birth field')
    }
    if (isNaN(p.birth)) {
        return NaN
    }
    let dateDiff = new Date(Date.now() - p.birth.getTime())
    let age = Math.abs(dateDiff.getUTCFullYear() - 1970);
    return age;
}
 
/**
 * Vérifie qu'un code postal est au format français (exactement 5 chiffres).
 *
 * @param {string} code Le code postal à valider.
 * @returns {boolean} `true` si le code est composé de 5 chiffres exactement, sinon `false`.
 *
 * @example
 * isValidCodePost("75001"); // true
 * isValidCodePost("123");   // false
 */
export function isValidCodePost(code){
    const codeRegexp = /^\d{5}$/;
    return codeRegexp.test(code)
}
 
/**
 * Vérifie qu'une chaîne contient uniquement des lettres (accents/trémas inclus),
 * espaces, apostrophes ou tirets — utilisé pour nom, prénom et ville.
 *
 * @param {string} name La chaîne à valider.
 * @returns {boolean} `true` si la chaîne est valide, sinon `false`.
 *
 * @example
 * isValidName("Jean-Pierre"); // true
 * isValidName("Élodie");      // true
 * isValidName("Jean123");     // false
 */
export function isValidName(name){
    const nameRegexp = /^[a-zA-ZÀ-ÿ' -]+$/;
    return nameRegexp.test(name)
}
 
/**
 * Vérifie qu'une adresse email a un format valide (`local@domaine.ext`, sans espaces).
 *
 * @param {string} email L'email à valider.
 * @returns {boolean} `true` si l'email est valide, sinon `false`.
 *
 * @example
 * isValidEmail("test@example.com"); // true
 * isValidEmail("test@example");     // false
 */
export function isValidEmail(email){
    const emailRegexp = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
    return emailRegexp.test(email)
}
 
/**
 * Vérifie qu'une personne est majeure (>= 18 ans) à partir de sa date de naissance.
 *
 * @param {Date} birth La date de naissance.
 * @returns {boolean} `true` si la personne a 18 ans ou plus, sinon `false`.
 *
 * @example
 * isAdult(new Date("1998-01-22")); // true
 */
export function isAdult(birth){
    let objectDate = {
        birth: birth
    }
    return calculateAge(objectDate) >= 18;
}