JavaScript Academy · Lekcja

API Constraint Validation

Proszę używać wbudowanego sprawdzania poprawności danych.

API Constraint Validation to bezpłatna lekcja JavaScript Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej JavaScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs JavaScript Academy zawiera 4 lekcji w sumie.

Wbudowana walidacja

Pola formularzy HTML obsługują atrybuty takie jak required, min, max, pattern i type="email". Constraint Validation API pozwala językowi JavaScript sprawdzać tę wbudowaną walidację i nią sterować.

checkValidity

checkValidity zwraca wartość logiczną i wywołuje zdarzenie invalid na każdym nieprawidłowym elemencie sterującym, nie wyświetlając dymku przeglądarki.

const email = document.querySelector("#email");
console.log(email.checkValidity());

reportValidity

reportValidity działa podobnie jak checkValidity, ale dodatkowo wyświetla interfejs komunikatu walidacyjnego przeglądarki dla nieprawidłowych pól.

if (!form.reportValidity()) {
  console.log("show built-in errors");
}

Obiekt validity

Każdy element sterujący ma obiekt validity zawierający logiczne flagi, które dokładnie opisują problem.

console.log(email.validity.valueMissing);  // empty required
console.log(email.validity.typeMismatch);  // wrong format
console.log(email.validity.tooShort);

validity.valid

validity.valid ma wartość true tylko wtedy, gdy pole spełnia wszystkie ograniczenia, podsumowując stan pozostałych flag.

if (email.validity.valid) {
  console.log("ok");
}

validationMessage

validationMessage zawiera zlokalizowany komunikat, który przeglądarka wyświetliłaby dla bieżącego błędu.

console.log(email.validationMessage);

setCustomValidity

setCustomValidity oznacza pole jako nieprawidłowe i ustawia własny komunikat. Niepusty ciąg znaków oznacza nieprawidłowość, a pusty ciąg ją usuwa.

function checkMatch() {
  if (pass.value !== confirm.value) {
    confirm.setCustomValidity("Passwords must match");
  } else {
    confirm.setCustomValidity("");
  }
}

Zawsze usuwaj niestandardowe błędy

Jeśli ustawili Państwo niestandardowy komunikat, po uznaniu pola za prawidłowe należy usunąć go za pomocą pustego ciągu znaków — w przeciwnym razie pole na zawsze pozostanie nieprawidłowe.

confirm.addEventListener("input", () => {
  confirm.setCustomValidity("");
  checkMatch();
});

Zdarzenie invalid

Należy nasłuchiwać zdarzenia invalid, aby uruchamiać własną logikę, na przykład zmieniać styl pola, gdy walidacja się nie powiedzie.

email.addEventListener("invalid", () => {
  email.classList.add("error");
});

Wyłączanie natywnych dymków

Należy dodać do formularza atrybut novalidate, aby wyłączyć natywne komunikaty, zachowując możliwość korzystania z API do wyświetlania własnych informacji.

form.setAttribute("novalidate", "");
form.addEventListener("submit", (e) => {
  if (!form.checkValidity()) e.preventDefault();
});

Stylowanie za pomocą :valid i :invalid

Pseudoklasy CSS :valid i :invalid automatycznie nadają styl polom na podstawie ich stanu walidacji.

Szybki test

Niestandardowa reguła walidacji.

Podsumowanie

Constraint Validation API współpracuje z atrybutami ograniczeń HTML. Za pomocą checkValidity/reportValidity można sprawdzać błędy i opcjonalnie je wyświetlać, przeglądać flagi obiektu validity oraz validationMessage, a także dodawać niestandardowe reguły za pomocą setCustomValidity (usuwając je pustym ciągiem znaków). Zdarzenie invalid oraz pseudoklasy CSS :valid/:invalid ułatwiają stylowanie.

Często zadawane pytania

Czy lekcja „API Constraint Validation” jest bezpłatna?

Tak — pełny tekst „API Constraint Validation” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu JavaScript Academy, przejdź na CoddyKit PRO. Kurs JavaScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „API Constraint Validation”?

Proszę używać wbudowanego sprawdzania poprawności danych. Ćwiczysz JavaScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć JavaScript Academy?

Nie wymagamy żadnego doświadczenia. JavaScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „API Constraint Validation”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji JavaScript Academy?

Tak. Każda lekcja JavaScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do JavaScript Academy