Українська
Завдання клієнта
Завдання клієнта робить для Source/Chatex.Web те саме, що завдання серверної частини для рішення. Воно коротше, бо кожна перевірка вже є скриптом npm у package.json (теми 15–21).
Крок 1. Node і кеш npm
Навіщо. Angular CLI потребує Node.js 24 – версії з engines у package.json. Як і для .NET, виконавець має використовувати ту саму основну версію, що й розробники.
Що зробити. Завдання та його налаштування:
yaml
frontend:
name: Frontend
runs-on: ubuntu-latest
timeout-minutes: 15
defaults:
run:
working-directory: Source/Chatex.Web
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 24
cache: npm
cache-dependency-path: Source/Chatex.Web/package-lock.jsondefaults: run: working-directoryзмушує кожен крокrun:цього завдання починатися в папці застосунку Angular, тож команди нижче записано так, як ви набираєте їх там.actions/setup-nodeвстановлює найновіший Node.js 24.cache: npmзберігає між запусками кеш завантажень npm. Його ключ – хешpackage-lock.json, який лежить не в корені репозиторію, звідсиcache-dependency-path. Кеш містить завантажені архіви пакетів, а неnode_modules: інсталяція на наступному кроці все одно чиста.
Крок 2. Чиста інсталяція й аудит
Навіщо. npm install може оновити package-lock.json, коли знайде новіші версії, що відповідають діапазонам у package.json; тоді CI тестував би інші версії, ніж у репозиторії. Проблеми безпеки в пакетах знаходять щотижня, тож аудит має виконуватися за кожного збирання, а не один раз.
Що зробити.
yaml
- run: npm ci
# Only what ships to browsers; run a full npm audit by hand when updating dev tooling.
- run: npm audit --omit=dev --audit-level=highnpm ci(«чиста інсталяція») видаляєnode_modules, встановлює точно версії зpackage-lock.jsonі завершується помилкою, якщо файл блокування не відповідаєpackage.json. Він ніколи не записує файл блокування.npm audit --omit=dev --audit-level=highперевіряє встановлені пакети за базою вразливостей npm.--omit=devобмежує перевірку пакетамиdependencies– Angular, RxJS, клієнт SignalR – кодом, який постачається в браузери. Інструменти збирання зdevDependenciesпрацюють лише на машинах розробників і виконавцях, а повідомлення про їхні вразливості (часто про спеціально створений вхід для інструмента збирання) розглядають вручну під час оновлення інструментів.--audit-level=highпровалює крок лише для повідомлень високого або критичного рівня.
На зафіксованих версіях крок виводить:
found 0 vulnerabilitiesСам npm ci, який переглядає всі пакети, може водночас повідомити про 9 moderate severity vulnerabilities в інструментах збирання; саме таку різницю дає --omit=dev.
Крок 3. Prettier і ESLint
Навіщо. Та сама ідея, що й dotnet format та аналізатори: стиль і підозрілий код відхиляє машина, ще до того, як зміну розгляне людина.
Що зробити.
yaml
- run: npm run format:check
- run: npm run lintnpm run format:checkзапускаєprettier --check "src/**/*.{ts,html,css}"(тема 15). Успіх – цеAll matched files use Prettier code style!; файл із зайвою крапкою з комою провалює крок таким виводом:
[warn] src/main.ts
[warn] Code style issues found in the above file. Run Prettier with --write to fix.npm run lintзапускаєng lint, тобто ESLint із правилами Angular і TypeScript ізeslint.config.js. Успіх – цеAll files pass linting.
Крок 4. Модульні тести й збирання для production
Навіщо. Специфікації Vitest із тем 16–21 перевіряють сховища, сервіси та компоненти. Збирання для production – це окремий тест: воно компілює шаблони в суворому режимі з оптимізатором, перевіряє бюджети пакетів із angular.json і створює файли, які сервер віддаватиме в темі 24.
Що зробити.
yaml
- run: npm test -- --watch=false
- run: npm run buildnpm test -- --watch=falseзапускаєng testодин раз замість стеження за файлами. Усе після--npm передає скрипту. Крок завершується таким виводом:
Test Files 8 passed (8)
Tests 49 passed (49)npm run buildзапускаєng buildзі стандартною конфігурацієюproduction. Він виводить таблицю створених файлів із хешованими іменами, наприкладmain-IWEIRFGV.js, і завершується рядкомApplication bundle generation complete.Помилка шаблону, яку терпів сервер розробки, або пакет, що перевищує свій бюджет, провалиться саме тут.
Разом два завдання містять перші п’ять із восьми «воріт» зі слайдів курсу: форматування, аналізатори, аудит, міграції та тести. Решта три – рев’ю, перевірка стану й димовий тест – належать до розгортання (тема 24).
Перевірка
Запустіть клієнтську частину на своєму комп’ютері з Source/Chatex.Web:
powershell
npm cipowershell
npm audit --omit=dev --audit-level=highpowershell
npm run format:checkpowershell
npm run lintpowershell
npm test -- --watch=falsepowershell
npm run buildКожна команда завершується наведеним вище рядком успіху. Потім поверніться до кореня репозиторію командою cd ../...