Kurs Vue.js · Moduł 1: Vue i Vite

Narzędzia Diagnostyczne

5 min czytania ·
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

  1. Component Inspector - skanuj drzewo modułów
  2. State Inspector - monitoruj dane reaktywne w czasie rzeczywistym
  3. Timeline - śledź historię zdarzeń i zmian
  4. Router - debuguj nawigację
  5. 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.vue

Format godziny zależy od ustawień systemu, a (client) oznacza środowisko przeglądarki. Zmiany są widoczne natychmiast - krytyczne podczas rozwoju systemów!

Komendy Operacyjne

KomendaOpis
npm run devTryb deweloperski (symulator)
npm run buildKompilacja do wdrożenia
npm run previewTest wersji produkcyjnej
npm run test:unitUruchom testy jednostkowe (Vitest)
npm run lintSprawdź 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. 1. Jak nazywają się oficjalne narzędzia deweloperskie dla Vue.js?

  2. 2. Jaka komenda kompiluje projekt Vue/Vite do wersji produkcyjnej?

  3. 3. Do czego służy funkcja watch() w Vue 3?

  4. 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:

  1. PytanieNazwa DevTools dla Vue
  2. Ułóż w kolejnościProces instalacji Vue.js
  3. Zadanie z kodemZaawansowane: Praktyka: watch() i debugowanie
  4. PytanieZaawansowane: Komenda build w Vite
  5. Kliknij w kolejnościZaawansowane: Składnia watch w Vue
  6. Ułóż w kolejnościZaawansowane: Workflow pracy z Vite
  7. PytanieZaawansowane: Funkcja watch() w Vue
  8. Ułóż w kolejnościZaawansowane: Składnia dyrektywy v-if
  9. Zadanie z kodemZaawansowane: Praktyka: Warunkowe renderowanie
  10. PytanieZaawansowane: Twórca Vue.js i Vite
  11. Ułóż w kolejnościZaawansowane: Hierarchia struktury projektu Vue
  12. Ułóż w kolejnościZaawansowane: Składnia obsługi zdarzenia @click
  13. Kliknij w kolejnościZaawansowane: Składnia importu ref z Vue
  14. Ułóż w kolejnościZaawansowane: Kolejność skryptów w main.js
  15. Ułóż w kolejnościZaawansowane: Składnia v-bind dla atrybutu
  16. Kliknij w kolejnościZaawansowane: Składnia computed property
  17. Ułóż w kolejnościZaawansowane: Etapy buildu Vite
  18. Kliknij w kolejnościZaawansowane: Składnia style scoped
  19. Ułóż w kolejnościZaawansowane: Składnia v-model na inpucie
  20. Ułóż w kolejnościHierarchia komponentów Vue

Przydatne artykuły