Майстерність створення Exercise Tracker: як пройти перевірки на freeCodeCamp

8 Березня 2024 в 01:27 104

Робота над проектами на freeCodeCamp є відмінним способом не тільки закріпити знання з програмування, а й навчитися вирішувати типові задачі, з якими розробники стикаються в реальних проектах. Проект “Exercise Tracker” є частиною навчальної програми з Back-End розробки і вимагає глибокого розуміння як створення REST API, так і роботи з датами і часовими зонами в JavaScript. У цій статті ми детально розглянемо, як пройти дві конкретні перевірки, на яких часто спотикаються учні: форматування відповіді при додаванні вправ та коректне відображення дати у журналі користувача.

Запит і відповідь API при додаванні вправ

Ключовим моментом при реалізації функціональності додавання вправ є коректна відповідь сервера на POST запит. Специфікація вимагає, щоб разом з даними про вправу повертався і об’єкт користувача, що може здатися непростим завданням для новачків. Використання UTC часу для поля дати є обов’язковим, оскільки це забезпечує уніфікацію даних незалежно від часової зони користувача. Наведений нижче код ілюструє, як це можна реалізувати:

// Функція для перевірки і форматування дати
const checkDate = (date) => {
  if (!date) {
    return new Date(Date.now()).toDateString();
  } else {
    const parts = date.split("-");
    const year = parseInt(parts[0]);
    const month = parseInt(parts[1]) - 1;
    const day = parseInt(parts[2]);
    const utcDate = new Date(Date.UTC(year, month, day));
    return new Date(
      utcDate.getTime() + utcDate.getTimezoneOffset() * 60000
    ).toDateString();
  }
};

// Функція для перевірки і форматування дати

const checkDate = (date) => {

if (!date) {

return new Date(Date.now()).toDateString();

} else {

const parts = date.split("-");

const year = parseInt(parts[0]);

const month = parseInt(parts[1]) - 1;

const day = parseInt(parts[2]);

const utcDate = new Date(Date.UTC(year, month, day));

return new Date(

utcDate.getTime() + utcDate.getTimezoneOffset() * 60000

).toDateString();

}

};

Виклик і обробка дат в журналі користувача

Ще одним нюансом, що вимагає уваги, є представлення дат у відповіді на запит GET журналу користувача. Тест вимагає, щоб кожен об’єкт у масиві логів містив дату у форматі рядка. Це важливо для забезпечення консистентності даних та їх легкого читання користувачами. Проблема з форматуванням дат часто виникає через різницю в часових зонах, тому використання методу toDateString() дозволяє отримати локалізоване представлення дати, що ідеально підходить для цієї мети:

// Витягування логів з користувача та форматування дати
logs = logs.map((log) => ({
  description: log.description,
  duration: log.duration,
  date: new Date(log.date).toDateString(), // Конвертація дати у читабельний формат
}));
// Конструювання об'єкта відповіді
const userLog = { _id: userId, username: user.username, count, log: logs };
// Повернення об'єкта користувача з масивом логів і загальною кількістю вправ
return res.json(userLog);

// Витягування логів з користувача та форматування дати

logs = logs.map((log) => ({

description: log.description,

duration: log.duration,

date: new Date(log.date).toDateString(), // Конвертація дати у читабельний формат

}));

// Конструювання об'єкта відповіді

const userLog = { _id: userId, username: user.username, count, log: logs };

// Повернення об'єкта користувача з масивом логів і загальною кількістю вправ

return res.json(userLog);

Загальні рекомендації

При розробці REST API важливо не тільки виконувати конкретні вимоги до функціональності, а й дотримуватися загальних принципів проектування інтерфейсів. Це включає в себе створення зрозумілої структури URL, правильне використання HTTP методів (GET для отримання даних, POST для створення нових записів, і т.д.), а також надання коректних HTTP статус-кодів відповідей. Окрім того, слід звернути увагу на безпеку даних, особливо при обробці персональної інформації користувачів.

Враховуючи вищесказане, ключ до успішного виконання проекту “Exercise Tracker” на freeCodeCamp лежить не тільки в технічному вирішенні поставлених задач, а й в глибокому розумінні основ REST API розробки та вмінні адаптувати свої рішення до специфікацій і вимог користувача. Застосування рекомендованих підходів та методів дозволить не тільки успішно пройти тести на платформі, а й стане міцною основою для подальших проектів у сфері веб-розробки.