Kurs Vue.js · Moduł 1: Vue i Vite
Narzędzia Diagnostyczne
W tej lekcji5
W kosmosie diagnostyka to kwestia życia i śmierci. Vue DevTools to nasz skaner systemów.
Panel pokazuje zły odczyt i nie wiesz dlaczego: czy winne są dane, szablon, a może komponent w ogóle się nie wyrenderował? Dopisywanie console.log w dziesięciu miejscach to zgadywanie. Potrzebujesz narzędzi, które pokażą wnętrze działającej aplikacji.
Vue DevTools
Vue DevTools to oficjalne narzędzia deweloperskie Vue; wersje od 7 wzwyż obsługują wyłącznie Vue 3. Pierwsza droga instalacji to rozszerzenie przeglądarki:
- Chrome: Vue.js devtools
- Firefox: Vue.js devtools
- Edge: Vue.js devtools
Druga droga to plugin vite-plugin-vue-devtools, który kreator create-vue sam dopisuje do konfiguracji Vite. W trybie deweloperskim panel otwierasz wtedy przyciskiem na dole strony, bez instalowania czegokolwiek w przeglądarce. W projektach z Vite polecam właśnie tę drogę - dokumentacja DevTools zaleca ją ze względu na dodatkowe funkcje.
Funkcje Diagnostyczne
- Component Inspector - skanuj drzewo modułów
- State Inspector - monitoruj dane reaktywne w czasie rzeczywistym
- Timeline - śledź historię zdarzeń i zmian
- Router - debuguj nawigację
- Pinia - zarządzaj bazą danych misji
W obecnych wersjach inspektor komponentów i stanu to jedna zakładka Components: po lewej drzewo, po prawej dane wybranego komponentu, które możesz edytować na żywo. Drzewo typowej aplikacji wygląda tak:
App
└── MainLayout (układ: nagłówek, pasek boczny)
└── DashboardView (widok)
├── OxygenCard (UI)
└── AlertButton (UI)Na szczycie stoi komponent główny, pod nim układ, w układzie widok, a na końcu najmniejsze elementy interfejsu. Kliknij dowolny węzeł, a obok zobaczysz jego dane.
Protokoły Debugowania
Logowanie zmian systemowych
Czasem chcesz zareagować na każdą zmianę, na przykład zapisać ją w konsoli albo podnieść alarm. Służy do tego funkcja watch: pierwszy argument to obserwowane źródło, drugi to funkcja, którą Vue wywoła po każdej zmianie z nową i starą wartością:
import { ref, watch } from 'vue'
const oxygenLevel = ref(98.5)
// Monitoring zmian
watch(oxygenLevel, (newLevel, oldLevel) => {
console.log(`Poziom tlenu: ${oldLevel}% → ${newLevel}%`)
if (newLevel < 90) {
console.error('ALERT: Niski poziom tlenu!')
}
})Ustaw oxygenLevel.value na 88, a w konsoli pojawi się wpis ze strzałką i czerwony alert. watch niczego nie wyświetla i nie zmienia poziomu tlenu - tylko reaguje. Różnica wobec computed jest prosta: computed wylicza wartość, watch wykonuje akcję.
Debug w template
Druga technika to panel diagnostyczny w szablonie. Dyrektywa v-if wyświetla element tylko wtedy, gdy warunek jest prawdziwy, a JSON.stringify zamienia obiekt z danymi na czytelny tekst:
<template>
<!-- Panel diagnostyczny -->
<div v-if="debugMode" class="debug-panel">
<pre>{{ JSON.stringify(systemData, null, 2) }}</pre>
</div>
<!-- Wskaźniki krytyczne -->
<div class="critical-systems">
<span>O2: {{ oxygen }}%</span>
<span>Temp: {{ temperature }}°C</span>
<span>Ciśnienie: {{ pressure }} hPa</span>
</div>
</template>Gdy debugMode jest fałszem, Vue w ogóle nie tworzy panelu diagnostycznego, a wskaźniki pod nim działają bez zmian. Zmienne użyte w szablonie są zadeklarowane jako ref() w pominiętej tu sekcji <script setup>.
Symulator czujnika
Do testów przyda się pole, w którym wpisujesz odczyt. Dyrektywa v-model wiąże pole z kontenerem w obie strony: wpisana liczba trafia do oxygen, a zmiana oxygen w kodzie trafia do pola. Para v-if i v-else wyświetla jeden z dwóch akapitów:
<template>
<input v-model="oxygen" type="number" />
<p v-if="oxygen >= 90">Tlen w normie</p>
<p v-else>ALERT: niski poziom tlenu</p>
</template>
<script setup>
import { ref } from 'vue'
const oxygen = ref(95)
</script>Wpisz 85, a komunikat o normie zastąpi alert. v-else musi stać tuż po elemencie z v-if, bo odnosi się do jego warunku. Dyrektywy warunkowe poznasz w Pracowni Hologramów, a formularze z v-model w Symulatorze Sterowania.
Hot Module Replacement
Vite automatycznie aktualizuje moduły bez restartu, a terminal serwera melduje, który plik podmienił:
12:04:31 [vite] (client) hmr update /src/components/LifeSupport.vueFormat godziny zależy od ustawień systemu, a (client) oznacza środowisko przeglądarki. Zmiany są widoczne natychmiast - krytyczne podczas rozwoju systemów!
Komendy Operacyjne
| Komenda | Opis |
|---|---|
npm run dev | Tryb deweloperski (symulator) |
npm run build | Kompilacja do wdrożenia |
npm run preview | Test wersji produkcyjnej |
npm run test:unit | Uruchom testy jednostkowe (Vitest) |
npm run lint | Sprawdź jakość kodu |
To skrypty z package.json, które kreator dopisuje zależnie od wybranych opcji - stąd test:unit zamiast samego test. Typowy cykl pracy: npm run dev, edycja komponentów, odświeżenie przez HMR, a przed wdrożeniem npm run build i sprawdzenie wyniku przez npm run preview.
Przygotowanie do Wdrożenia
Build przebiega w czterech etapach. Vite zaczyna od index.html i znajduje w nim skrypt wejściowy. Potem Rolldown wczytuje kolejne moduły: każdy najpierw przechodzi transformację (pliki .vue kompiluje plugin Vue, a TypeScript i JSX zamienia na JavaScript narzędzie Oxc), a dopiero potem Rolldown odczytuje z niego importy i sięga po następne pliki, budując graf zależności. Następnie Rolldown skleja moduły w paczki, usuwa nieużywany kod i minifikuje wynik, a na końcu pliki trafiają do katalogu dist. Do wersji 7 transformację wykonywał esbuild, a paczki sklejał Rollup.
# Kompilacja systemu
npm run build
# Wynik w katalogu /dist
dist/
├── index.html
├── assets/
│ ├── index-[hash].js # Skompilowana logika
│ └── index-[hash].css # Skompilowane style[hash] to skrót zawartości pliku: po zmianie kodu zmienia się nazwa, więc przeglądarka nie użyje starej wersji z pamięci podręcznej. npm run preview serwuje ten katalog lokalnie, ale nie jest serwerem produkcyjnym - wdrożeniem zajmiemy się na Platformie Startowej.
Ten kod poleci na Marsa. Każdy błąd może kosztować życie załogi. Testuj dokładnie! W edytorze poniżej zmieniaj licznik, wpisuj komunikat i przełączaj system, obserwując te same zmiany w DevTools.
Zapamiętaj: DevTools pokazuje wnętrze systemu, watch reaguje na każdą zmianę, a npm run build pakuje sprawdzony kod do katalogu dist.
Kod do tej lekcji: src/App.vue
<template>
<div class="nova-lab">
<h1>Vue DevTools</h1>
<section class="info">
<h2>Twój najlepszy przyjaciel podczas developmentu</h2>
<p>
Vue DevTools to rozszerzenie przeglądarki, które pozwala:
</p>
<ul>
<li>Przeglądać drzewo komponentów</li>
<li>Sprawdzać i edytować stan (state)</li>
<li>Śledzić zdarzenia (events)</li>
<li>Debugować Pinia stores</li>
<li>Analizować wydajność</li>
</ul>
</section>
<section class="demo">
<h2>Interaktywny Stan</h2>
<p>Otwórz DevTools i obserwuj jak zmienia się stan:</p>
<div class="state-demo">
<div class="counter">
<button @click="count--">-</button>
<span>{{ count }}</span>
<button @click="count++">+</button>
</div>
<div class="input-demo">
<input v-model="message" placeholder="Wpisz wiadomość..." />
<p>{{ message }}</p>
</div>
<div class="toggle-demo">
<label>
<input type="checkbox" v-model="isActive" />
System aktywny
</label>
<div class="status" :class="{ active: isActive }">
{{ isActive ? 'ONLINE' : 'OFFLINE' }}
</div>
</div>
</div>
</section>
<section class="install">
<h2>Instalacja</h2>
<div class="browser-links">
<a href="https://chrome.google.com/webstore/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd" target="_blank" class="browser-btn">
Chrome
</a>
<a href="https://addons.mozilla.org/en-US/firefox/addon/vue-js-devtools/" target="_blank" class="browser-btn">
Firefox
</a>
<a href="https://microsoftedge.microsoft.com/addons/detail/vuejs-devtools/olofadcdnkkjdfgjcmjaadnlehnnihnl" target="_blank" class="browser-btn">
Edge
</a>
</div>
</section>
</div>
</template>
<script setup>
import { ref } from 'vue'
const count = ref(0)
const message = ref('')
const isActive = ref(true)
</script>
<style>
.nova-lab {
min-height: 100vh;
background: #0a0e27;
color: #e0e0e0;
padding: 2rem;
font-family: system-ui, sans-serif;
}
h1 {
color: #00ff88;
text-align: center;
}
section {
background: rgba(26, 30, 55, 0.8);
border: 1px solid #00b4d8;
border-radius: 12px;
padding: 1.5rem;
margin: 1.5rem auto;
max-width: 600px;
}
h2 {
color: #00b4d8;
margin-top: 0;
}
ul {
list-style: none;
padding: 0;
}
ul li {
padding: 0.5rem 0;
border-bottom: 1px solid rgba(0, 180, 216, 0.2);
}
ul li::before {
content: "» ";
color: #00ff88;
}
.state-demo {
display: flex;
flex-direction: column;
gap: 1rem;
}
.counter {
display: flex;
align-items: center;
justify-content: center;
gap: 1rem;
}
.counter button {
width: 40px;
height: 40px;
background: #00b4d8;
color: #0a0e27;
border: none;
border-radius: 8px;
font-size: 1.25rem;
cursor: pointer;
}
.counter span {
font-size: 1.5rem;
font-weight: bold;
color: #00ff88;
min-width: 60px;
text-align: center;
}
.input-demo input {
width: 100%;
padding: 0.75rem;
background: #1a1e37;
border: 2px solid #00b4d8;
border-radius: 8px;
color: #fff;
}
.input-demo p {
color: #00ff88;
font-style: italic;
min-height: 1.5rem;
}
.toggle-demo {
display: flex;
align-items: center;
justify-content: space-between;
}
.toggle-demo label {
display: flex;
align-items: center;
gap: 0.5rem;
cursor: pointer;
}
.status {
padding: 0.5rem 1rem;
border-radius: 20px;
font-weight: bold;
background: rgba(255, 68, 68, 0.2);
color: #ff4444;
}
.status.active {
background: rgba(0, 255, 136, 0.2);
color: #00ff88;
}
.browser-links {
display: flex;
gap: 1rem;
justify-content: center;
flex-wrap: wrap;
}
.browser-btn {
padding: 0.75rem 1.5rem;
background: #1a1e37;
border: 2px solid #00b4d8;
border-radius: 8px;
color: #00b4d8;
text-decoration: none;
transition: all 0.2s;
}
.browser-btn:hover {
background: #00b4d8;
color: #0a0e27;
}
</style>Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Jak nazywają się oficjalne narzędzia deweloperskie dla Vue.js?
2. Jaka komenda kompiluje projekt Vue/Vite do wersji produkcyjnej?
3. Do czego służy funkcja watch() w Vue 3?
4. Kto jest twórcą zarówno Vue.js jak i Vite?
Zadania praktyczne w grze
- Układanie w pionie
Ułóż proces instalacji i uruchomienia projektu Vue.js od zera:
- Edytor kodu
Uzupełnij komponent z watch() monitorującym zmiany zmiennej reaktywnej i logującym je w konsoli.
- Klikanie w kolejności
Ułóż składnię funkcji watch w Vue 3:
- Układanie w pionie
Ułóż typowy workflow pracy z Vite od developmentu do produkcji:
- Układanie w poziomie
Ułóż składnię warunkowego renderowania elementu:
- Edytor kodu
Użyj v-if i v-else do warunkowego wyświetlania statusu systemu w zależności od wartości zmiennej.
- Układanie w pionie
Ułóż strukturę projektu Vue od pliku wejściowego do komponentu:
- Układanie w poziomie
Ułóż składnię przycisku z obsługą zdarzenia click w Vue:
- Klikanie w kolejności
Ułóż poprawny import funkcji ref z Vue:
- Układanie w pionie
Ułóż kolejność operacji w pliku main.js:
- Układanie w poziomie
Ułóż składnię dynamicznego bindowania klasy CSS w Vue:
- Klikanie w kolejności
Ułóż składnię computed property w Vue 3:
- Układanie w pionie
Ułóż etapy procesu build w Vite od kodu źródłowego do produkcji:
- Klikanie w kolejności
Ułóż poprawną sekcję style z atrybutem scoped:
- Układanie w poziomie
Ułóż składnię inputa z dwukierunkowym bindowaniem danych w Vue:
- Układanie w pionie
Ułóż hierarchię komponentów od najwyższego do najniższego poziomu:
Zadania po tej lekcji
- PytanieNazwa DevTools dla Vue
- Ułóż w kolejnościProces instalacji Vue.js
- Zadanie z kodemZaawansowane: Praktyka: watch() i debugowanie
- PytanieZaawansowane: Komenda build w Vite
- Kliknij w kolejnościZaawansowane: Składnia watch w Vue
- Ułóż w kolejnościZaawansowane: Workflow pracy z Vite
- PytanieZaawansowane: Funkcja watch() w Vue
- Ułóż w kolejnościZaawansowane: Składnia dyrektywy v-if
- Zadanie z kodemZaawansowane: Praktyka: Warunkowe renderowanie
- PytanieZaawansowane: Twórca Vue.js i Vite
- Ułóż w kolejnościZaawansowane: Hierarchia struktury projektu Vue
- Ułóż w kolejnościZaawansowane: Składnia obsługi zdarzenia @click
- Kliknij w kolejnościZaawansowane: Składnia importu ref z Vue
- Ułóż w kolejnościZaawansowane: Kolejność skryptów w main.js
- Ułóż w kolejnościZaawansowane: Składnia v-bind dla atrybutu
- Kliknij w kolejnościZaawansowane: Składnia computed property
- Ułóż w kolejnościZaawansowane: Etapy buildu Vite
- Kliknij w kolejnościZaawansowane: Składnia style scoped
- Ułóż w kolejnościZaawansowane: Składnia v-model na inpucie
- Ułóż w kolejnościHierarchia komponentów Vue