Tester XPath

Zasada działania i możliwości Testera XPath

Narzędzie Tester XPath umożliwia weryfikację poprawności i skuteczności wyrażeń XPath w odniesieniu do wprowadzonej zawartości XML lub HTML. Po wprowadzeniu dokumentu oraz zapytania, system analizuje strukturę danych i wskazuje wszystkie fragmenty kodu, które odpowiadają zdefiniowanej ścieżce.

Dla każdego wykrytego dopasowania prezentowane są szczegółowe informacje, w tym typ węzła, jego nazwa, dokładna ścieżka oraz podgląd wartości. Użytkownik ma możliwość skopiowania wartości dowolnego pojedynczego wyniku bezpośrednio do schowka za pomocą dedykowanego przycisku. Narzędzie na bieżąco monitoruje parametry wejściowe, wyświetlając statystyki takie jak liczba znaków w dokumencie źródłowym oraz łączna liczba zwróconych wyników.

Parametry wejściowe i ograniczenia techniczne

Aby zapewnić stabilne działanie aplikacji bezpośrednio w przeglądarce internetowej, wprowadzono określone limity techniczne oraz reguły walidacji danych wejściowych:

• Dane wejściowe XML / HTML: Pole przeznaczone na tekst źródłowy w formacie XML lub HTML. Maksymalna dopuszczalna długość tego dokumentu wynosi 500 000 znaków. W przypadku przekroczenia tego limitu wyświetlany jest komunikat: „Ten dokument jest zbyt duży do przetestowania tutaj. Spróbuj użyć mniejszej próbki.”.
• Wyrażenie XPath: Pole na zapytanie XPath o maksymalnej długości 4000 znaków. Przekroczenie tej wartości skutkuje błędem: „To wyrażenie XPath jest zbyt długie, aby je tutaj przetestować.”.
• Typ wejściowy: Przełącznik pozwalający wybrać odpowiedni tryb interpretacji dokumentu – XML lub HTML.

Wydajność procesu jest ściśle kontrolowana. Narzędzie automatycznie przerywa ewaluację zapytania XPath po upływie 2 sekund, co zapobiega zawieszeniu karty przeglądarki. Jeśli limit czasu zostanie przekroczony, użytkownik zobaczy komunikat: „Wykonanie tego zapytania XPath trwało zbyt długo. Proszę zawęzić wyrażenie lub użyć mniejszej próbki danych.”.

Różnice między trybem XML a HTML

Wybór odpowiedniego trybu pracy ma kluczowe znaczenie dla sposobu parsowania dokumentu i dopasowywania ścieżek:

1. Tryb XML: W tym trybie bezwzględnie przestrzegane są reguły dotyczące przestrzeni nazw XML. Jeśli dokument XML deklaruje określone przestrzenie nazw, prefiksy te mogą być używane bezpośrednio w zapytaniu XPath (np. //x:item). W przypadku domyślnych przestrzeni nazw, zapytanie takie jak //item również będzie zgodne z deklaracją zawartą w dokumencie.
2. Tryb HTML: Jest znacznie bardziej tolerancyjny dla struktury dokumentu. Pozwala na stosowanie prostych ścieżek, takich jak //a, do bezproblemowego dopasowywania standardowych znaczników HTML, nawet przy braku rygorystycznej struktury znanej z XML.

Należy pamiętać, że narzędzie to operuje wyłącznie na statycznym tekście dostarczonym przez użytkownika. Nie odzwierciedla ono struktury generowanej w czasie rzeczywistym przez skrypty JS, wyrenderowanego drzewa DOM w przeglądarce ani nie wykonuje zewnętrznych żądań sieciowych do żywych stron internetowych.

Obsługa błędów i interpretacja wyników

Podczas pracy z dokumentami i zapytaniami mogą wystąpić błędy składniowe lub strukturalne. Tester XPath obsługuje je poprzez precyzyjne komunikaty:

• Błąd parsowania: Jeśli dokument wejściowy posiada uszkodzoną strukturę uniemożliwiającą jego odczytanie, pojawia się komunikat: „Nie można sparsować tego dokumentu.”.
• Błąd składni XPath: Wpisanie niepoprawnego zapytania skutkuje informacją: „To wyrażenie XPath jest nieprawidłowe.”.
• Błąd ewaluacji: Gdy zapytanie jest poprawne składniowo, ale jego wykonanie na danym dokumencie jest niemożliwe z przyczyn technicznych, system zgłasza: „Nie można przetworzyć tego wyrażenia XPath.”.
• Brak dopasowań: Jeśli struktura nie zawiera poszukiwanych elementów, wyświetlany jest komunikat: „Brak wyników.”.
• Ograniczenie liczby wyników: Gdy zapytanie wygeneruje bardzo dużą liczbę dopasowań, narzędzie ogranicza prezentację danych ze względów wydajnościowych. Maksymalnie prezentowanych jest 200 dopasowań, a użytkownik otrzymuje powiadomienie: „Wyświetlanie pierwszych {max} wyników.”.

Prywatność i bezpieczeństwo danych

Wszystkie operacje związane z przetwarzaniem dokumentów XML, HTML oraz wykonywaniem zapytań XPath odbywają się lokalnie. Państwa dane XML, HTML oraz zapytania XPath są testowane bezpośrednio w przeglądarce. Żadne informacje wprowadzane do pól formularza nie są przesyłane do serwerów zewnętrznych ani do BroBroGo.

FAQ

Czy mogę testować XPath na kodzie HTML, jak również na XML?

Tak. Tryb XML zachowuje reguły przestrzeni nazw XML. Tryb HTML jest bardziej tolerancyjny i pozwala prostym ścieżkom, takim jak //a, dopasowywać standardowe znaczniki.

Jak działają przestrzenie nazw XML?

Prefiksy przestrzeni nazw zadeklarowane w dokumencie XML mogą być używane w zapytaniu XPath, np. //x:item. W przypadku domyślnych przestrzeni nazw, zapytanie //item również będzie zgodne z deklaracją dokumentu.

Dlaczego zapytanie może ulec przekroczeniu czasu oczekiwania?

Przetwarzanie bardzo dużych dokumentów lub szerokich wyrażeń może być kosztowne obliczeniowo. Narzędzie przerywa działanie po 2 sekundach, aby strona pozostała responsywna; w takim przypadku warto zawęzić ścieżkę lub spróbować z mniejszą próbką danych.