Задачник курса по Vue 3

Использование задачника

Подробная инструкция по работе с задачником описана во введении в 00-intro/README.md.

Подготовка

Перед началом работы требуется установить Node.js и все необходимые npm пакеты. Они понадобятся для запуска и проверки решений.

npm ci

Команды

# Запуск сервера разработки для ручного тестирования
npm run serve
# псевдоним
npm run dev

# Тестирование задачи TASK (например, "npm test sum" протестирует "00-intro/01-sum")
npm test <TASK>

# Тестирование всех задач
npm test

# Тестирование с отслеживанием - автоматическим перезапуском при изменении исходных файлов
npm run test:watch <TASK>

# Проверка качества кода через eslint
npm run lint

# Проверка качества кода через eslint с исправлением проблем
npm run lint:fix

# Форматирование решений с prettier
npm run format

Ручное тестирование и отладка

Для удобства решения в каждой задаче есть окружение для ручного тестирования в браузере.

1. В корне репозитория выполните команду npm run serve;
   Выполнится запуск дев-сервера через Vite.
2. Откройте страницу по ссылке из терминала и выберите нужную задачу, либо сразу откройте страницу задачи по ссылке из инструкции (например, http://localhost:8080/00-intro/01-sum/);
3. После изменения файлов решения страница должна обновиться автоматически.

Проверка качества и форматирование кода

В задачнике настроена связка eslint + prettier. Вы можете изменить конфигурацию линтера и форматера на ваше усмотрение в файлах .eslintrc.js и .prettierrc, а также настраивать .editorconfig, .gitattributes и другие конфигурационные файлы. Линтер и форматер не запускаются автоматически. Вы можете запускать их вручную, либо настроить свою IDE.

Доступные библиотеки

В задачнике доступны дополнительные библиотеки, которые вы можете использовать при решении задач:

• Vue:
  • Vue 3
  • VueRouter 4
  • Vuex 4
  • Pinia
• Работа с датой и временем
  • dayjs
  • date-fns
  • luxon
  • moment (не рекомендуется, deprecated)
• Прочее
  • lodash + lodash-es - классический набор утилит, но лучше не злоупотреблять
  • klona - маленькая быстрая библиотека для глубокого клонирования объектов
  • dequal - маленькая быстрая библиотека для глубокого сравнения объектов
  • ola - библиотека интерполяции значений
  • nanoid - простой лёгкий и быстрый генератор случайных ID (обычно достаточно инкремента)
  • uuid - генератор UUID (обычно достаточно инкремента)

В файлах задач могут быть дополнительные библиотеки.

Вы также можете устанавливать другие библиотеки для ваших решений, однако обычно задачи не подразумевают необходимость установки дополнительных библиотек.

TypeScript

Вы можете использовать TypeScript при решении задач начиная с третьего модуля. Для этого требуется:

1. В .vue файлах добавить lang="ts".
2. Обернуть экспортируемый компонент в defineComponent при использовании Options API.

Для использования TSX по Vue 3 потребуется использовать .tsx модуль вместо одно-файлового компонента в файле .vue с <script lang="tsx">, так как последний пока не поддерживается для тестирования с vue-jest.