Tester XPath

Introduzione al Tester XPath

Il Tester XPath è uno strumento progettato per verificare le espressioni XPath su contenuti XML o HTML forniti direttamente dall'utente. Lo strumento permette di individuare e analizzare tutte le parti del documento che corrispondono all'espressione inserita, mostrando per ciascun nodo corrispondente il tipo, il nome, il percorso e un'anteprima del relativo valore. Inoltre, è possibile copiare singolarmente il valore di ciascun risultato ottenuto.

Questo strumento si rivela particolarmente utile per diverse figure professionali e attività, tra cui:

• Sviluppatori
• Tester
• Persone che effettuano lo scraping o la migrazione dei dati
• Utenti che lavorano correntemente con file XML

Input supportati e limiti dello strumento

Per eseguire una verifica, lo strumento richiede tre input principali, ciascuno soggetto a specifiche limitazioni tecniche per garantire il corretto funzionamento:

• Input XML / HTML: Il contenuto testuale del documento in formato XML o HTML. La lunghezza massima consentita per questo campo è di 500.000 caratteri.
• Espressione XPath: L'espressione XPath che si desidera testare. La lunghezza massima consentita per l'espressione è di 4.000 caratteri.
• Tipo di input: Una scelta di modalità tra "XML" (modalità XML) o "HTML" (modalità HTML).

Output e dettagli dei risultati

Dopo aver eseguito il test, lo strumento restituisce una serie di informazioni dettagliate sulla corrispondenza dell'espressione con il documento inserito:

• Risultati: Viene mostrato il conteggio totale delle corrispondenze individuate.
• Dettaglio: Per ogni singolo nodo che soddisfa i criteri dell'espressione, vengono mostrati il tipo, il nome, il percorso e un'anteprima del valore.
• Copia risultato: Accanto a ciascun risultato è presente un pulsante che consente di copiare il valore del singolo nodo.
• Caratteri: Viene indicato il numero complessivo di caratteri che compongono il documento inserito come input.
• Risultati (statistiche): Il numero effettivo di risultati mostrati a schermo.

Regole di funzionamento e gestione degli errori

Durante l'analisi e la valutazione delle espressioni, lo strumento applica regole precise e gestisce eventuali situazioni di errore o limiti di elaborazione attraverso messaggi specifici:

• Gestione dei tempi di esecuzione: Per mantenere la pagina web reattiva, lo strumento interrompe la valutazione dell'espressione XPath dopo 2 secondi. Se l'esecuzione supera questo limite, viene mostrato il messaggio: "L'elaborazione di questo percorso XPath ha richiesto troppo tempo. Ottimizzi l'espressione o utilizzi un campione di dati ridotto.".
• Documento troppo grande: Se il documento inserito supera i limiti di gestione, viene visualizzato il messaggio: "Questo documento è troppo grande per essere testato qui. Provi con un campione di dati ridotto.".
• Espressione troppo lunga: Se l'espressione XPath supera il limite di caratteri consentito, compare il messaggio: "Questa espressione XPath è troppo lunga per essere testata qui.".
• Errore di analisi del documento: Nel caso in cui il documento inserito non possa essere analizzato correttamente, lo strumento mostra l'errore: "Impossibile analizzare questo documento.".
• Sintassi XPath non valida: Se l'espressione XPath inserita presenta errori di sintassi, viene mostrato il messaggio: "Questa espressione XPath non è valida.".
• Errore di valutazione: Se l'espressione è sintatticamente corretta ma non può essere valutata sul documento, compare il messaggio: "Impossibile valutare questo percorso XPath.".
• Nessun risultato: Se l'espressione non trova alcuna corrispondenza nel testo, viene mostrato il messaggio: "Nessun risultato.".
• Limite dei risultati visualizzati: Quando l'espressione genera più di 200 corrispondenze, lo strumento limita la visualizzazione per preservare le prestazioni, mostrando il messaggio "Visualizzazione dei primi {max} risultati." e mostrando unicamente i primi 200 risultati.

Differenze tra modalità XML e modalità HTML

Il comportamento dell'analizzatore varia in base alla modalità di input selezionata, consentendo di gestire in modo appropriato le peculiarità dei due formati:

• In modalità XML: Lo strumento segue rigorosamente le regole relative ai namespace XML. I prefissi dei namespace dichiarati nel documento XML possono essere utilizzati direttamente all'interno dell'espressione XPath (ad esempio, //x:item). Anche per i namespace predefiniti, un percorso semplice come //item segue le dichiarazioni presenti nel documento.
• In modalità HTML: Lo strumento adotta un approccio più flessibile e tollerante, consentendo a percorsi semplici come //a di trovare e corrispondere ai normali tag HTML.

È importante sottolineare che questo strumento esegue un'analisi statica del codice inserito e non rappresenta la struttura in tempo reale, il DOM renderizzato o le richieste di rete delle pagine web reali disponibili online.

Sicurezza e trattamento dei dati

L'utilizzo del Tester XPath garantisce la massima riservatezza dei dati inseriti. I documenti XML o HTML e le espressioni XPath vengono elaborati e testati direttamente all'interno del browser dell'utente. Nessun dato o contenuto inserito viene caricato sui server di BroBroGo.

Domande frequenti (FAQ)

È possibile testare espressioni XPath sia su codice HTML sia su XML?
Sì. La modalità XML rispetta le regole relative ai namespace XML. La modalità HTML è più flessibile e consente a percorsi semplici come //a di trovare i tag standard.

Come funzionano i namespace XML?
I prefissi dei namespace dichiarati nel documento XML possono essere utilizzati all'interno dell'espressione XPath, ad esempio //x:item. Per i namespace predefiniti, anche il percorso //item segue le dichiarazioni del documento.

Perché un'interrogazione può andare in timeout?
Documenti molto estesi o espressioni generiche possono richiedere tempi di elaborazione elevati. Lo strumento interrompe l'esecuzione dopo 2 secondi per garantire la reattività della pagina; provi a ottimizzare il percorso o a utilizzare un campione di dati ridotto.