El Provador de XPath és una eina dissenyada per avaluar i depurar expressions XPath directament sobre contingut XML o HTML. Aquest recurs permet analitzar l'estructura de les dades, identificar la ubicació exacta dels nodes i extreure valors específics de manera immediata.
Funcionament i límits tècnics de l'eina
L'eina processa la informació a partir de dues entrades principals que s'han d'introduir en els camps de text corresponents:
- Entrada XML / HTML: El document d'origen sobre el qual s'executarà la cerca. Aquest camp admet un límit màxim de 500.000 caràcters.
- Expressió XPath: La ruta de consulta que es vol avaluar, amb una longitud màxima permesa de 4.000 caràcters.
L'usuari ha de seleccionar el tipus d'entrada mitjançant les opcions "XML" o "HTML" per definir el comportament de l'analitzador. Un cop executada la consulta, l'eina mostra mètriques en temps real com el nombre de caràcters del document d'entrada i la quantitat de resultats obtinguts. Per a cada coincidència, es detalla el tipus de node, el nom, la ruta i una vista prèvia del seu valor, acompanyat d'un botó individual per copiar el resultat.
Per garantir la fluïdesa de la pàgina, el motor d'avaluació s'atura automàticament si el procés triga més de 2 segons. Així mateix, quan una cerca genera un volum elevat de coincidències, l'eina limita la visualització i mostra el missatge "Es mostren els primers {max}." per a un màxim de 200 resultats.
Diferències entre el mode XML i el mode HTML
L'avaluació de les expressions XPath varia segons la naturalesa del document analitzat:
Mode XML
En seleccionar aquest mode, s'apliquen estrictament les regles de sintaxi i d'espais de noms de l'especificació XML. L'analitzador requereix que el document estigui ben format. Si el document presenta errors d'estructura que impedeixen la seva lectura, es mostrarà l'error "No s'ha pogut analitzar aquest document.".
Mode HTML
El mode HTML és més flexible i tolerant amb els errors de tancament d'etiquetes o estructures laxes comunes en les pàgines web. Permet utilitzar rutes simplificades com //a per trobar elements de manera directa sense necessitat de definir estructures complexes. Cal tenir en compte que aquesta eina avalua el codi font introduït i no representa l'estructura en temps real, el DOM renderitzat ni les peticions de xarxa d'una pàgina web activa.
Gestió d'espais de noms en XML
Els espais de noms (namespaces) són fonamentals per evitar conflictes de noms en documents XML complexos. El Provador de XPath gestiona aquestes declaracions de la següent manera:
- Prefixos declarats: Si el document XML defineix prefixos per als espais de noms, aquests mateixos prefixos es poden utilitzar directament dins de l'expressió XPath, com per exemple
//x:item. - Espais de noms per defecte: Quan un document utilitza un espai de noms per defecte sense un prefix explícit, la consulta
//itemseguirà correctament la declaració establerta en el document per localitzar els nodes corresponents.
Resolució d'errors i missatges del sistema
Durant l'anàlisi i l'avaluació de les expressions, l'interfície pot mostrar diferents missatges d'error específics per diagnosticar problemes en les dades o en la sintaxi:
- "Aquest document és massa gran per provar-lo aquí. Provi amb un exemple més petit.": Es mostra si el text introduït supera el límit de caràcters admès.
- "Aquesta expressió XPath no és vàlida.": Apareix quan la sintaxi de l'expressió XPath conté errors de construcció.
- "Aquesta expressió XPath és massa llarga per provar-la aquí.": S'activa si la consulta supera el límit de 4.000 caràcters.
- "No s'ha pogut avaluar aquest XPath.": S'emet quan l'expressió és sintàcticament correcta però no es pot executar sobre l'estructura del document proveït.
- "Aquest XPath ha trigat massa a executar-se. Acoteu l'expressió o utilitzeu un exemple més petit.": Es presenta si el procés d'avaluació supera el límit de temps de 2 segons.
- "Sense resultats.": S'indica quan l'expressió és vàlida però no troba cap coincidència en el document.
Privadesa i seguretat de les dades
El tractament de la informació es realitza de manera local. Tant el contingut XML o HTML com les expressions XPath s'avaluen directament al navegador de l'usuari. No es puja cap tipus de dada als servidors de BroBroGo, garantint que la informació no surt del dispositiu durant l'ús de l'eina.
Preguntes freqüents
Puc provar XPath tant en HTML com en XML?
Sí. El mode XML manté les regles d'espais de noms XML. El mode HTML és més flexible i permet que rutes senzilles com ara //a coincideixin amb etiquetes normals.
Com funcionen els espais de noms XML?
Els prefixos d'espais de noms declarats al seu XML es poden utilitzar a l'XPath, com ara //x:item. Per als espais de noms per defecte, //item també segueix la declaració del document.
Per què pot expirar el temps d'espera d'una consulta?
Els documents molt grans o les expressions molt àmplies poden ser costosos d'avaluar. L'eina atura l'execució després de 2 segons perquè la pàgina continuï sent interactiva; acoteu la ruta o proveu amb un exemple més petit.