Probador de XPath

Funcionamiento del Probador de XPath

Esta herramienta permite evaluar expresiones XPath sobre contenido XML o HTML introducido por el usuario. El sistema analiza el documento y muestra todos los fragmentos que coinciden con la expresión indicada, detallando su tipo, nombre, ruta y una vista previa de su valor. Además, facilita la copia individual del valor de cada resultado obtenido.

El procesamiento se realiza bajo las siguientes especificaciones de entrada:

• Entrada XML / HTML: Contenido de texto en formato XML o HTML con un límite máximo de 500.000 caracteres.
• Expresión XPath: La consulta XPath que se desea evaluar, con una longitud máxima de 4.000 caracteres.
• Tipo de entrada: Un selector para alternar entre el modo XML y el modo HTML.

Tras procesar la consulta, la interfaz devuelve el número total de coincidencias, el desglose detallado de cada nodo y un botón para copiar el resultado de forma individual. También se muestran estadísticas con el número de caracteres del documento de entrada y la cantidad de resultados visualizados.

Diferencias entre el modo XML y el modo HTML

La evaluación de las expresiones varía según el tipo de entrada seleccionado, adaptándose a las reglas de cada formato:

• Modo XML: En esta modalidad se aplican estrictamente las reglas de espacios de nombres de XML. Los prefijos declarados en el documento XML se pueden emplear directamente en la expresión XPath (por ejemplo, //x:item). En el caso de existir un espacio de nombres predeterminado, la búsqueda mediante //item también respetará la declaración del documento.
• Modo HTML: Este modo es más tolerante con la sintaxis. Permite que rutas directas y sencillas como //a coincidan con las etiquetas estándar del documento sin necesidad de cumplir con las restricciones de estructura estricta del formato XML.

Es importante señalar que esta herramienta trabaja sobre el código estático introducido y no representa la estructura en tiempo real, el DOM renderizado ni las peticiones de red de páginas web activas.

Reglas de validación y gestión de errores

Para garantizar la estabilidad del navegador, el entorno de pruebas aplica una serie de límites y controles automáticos durante la evaluación:

• Límite de tiempo: La evaluación de la expresión XPath se interrumpe automáticamente tras 2 segundos de ejecución para mantener la página receptiva. Si se supera este tiempo, se muestra el mensaje "Este XPath tardó demasiado. Acota la expresión o usa una muestra más pequeña.".
• Límite de tamaño del documento: Si el texto de entrada supera los 500.000 caracteres, la herramienta no realiza el análisis y muestra el aviso "Este documento es demasiado grande para probarlo aquí. Usa una muestra más pequeña.".
• Límite de la expresión: Si la consulta XPath excede los 4,000 caracteres, se detiene el proceso con el mensaje "Esta expresión XPath es demasiado larga para probarla aquí.".
• Errores de análisis del documento: Si la estructura de entrada no es válida o está corrupta, se presenta el error "No se pudo analizar este documento.".
• Errores de sintaxis XPath: Si la expresión contiene errores de construcción, se muestra "Esta expresión XPath no es válida.". En caso de que la expresión sea válida pero no pueda ejecutarse sobre el árbol del documento, aparecerá "No se pudo evaluar este XPath.".
• Límite de resultados: Cuando la búsqueda genera más de 200 coincidencias, la herramienta limita la visualización para evitar la sobrecarga del navegador, mostrando el aviso "Se muestran los primeros {max}." y listando únicamente los primeros 200 resultados. Si no hay ninguna coincidencia, se indica "Sin resultados.".

Privacidad y procesamiento local

El funcionamiento de esta herramienta respeta la privacidad de los datos introducidos. Tu XML, HTML y XPath se prueban en tu navegador. No se sube nada a BroBroGo, por lo que todo el análisis y la generación de resultados ocurren de manera local en el dispositivo del usuario.

Estrategias para optimizar expresiones XPath

Para evitar interrupciones por exceso de tiempo de ejecución (timeout) en documentos complejos, es aconsejable estructurar las consultas de forma eficiente. Las búsquedas que utilizan el eje descendente de forma indefinida (como // repetidos de manera consecutiva) obligan al motor a escanear todo el árbol del documento de manera recursiva.

Siempre que sea posible, se recomienda definir rutas absolutas o acotar la búsqueda especificando nodos intermedios conocidos. Reducir el uso de funciones de comparación de cadenas complejas sobre conjuntos de datos masivos también ayuda a que la evaluación finalice dentro del límite de 2 segundos establecido por la herramienta.

Preguntas frecuentes

¿Puedo probar XPath sobre HTML además de XML?
Sí. El modo XML conserva las reglas de espacios de nombres. El modo HTML es más tolerante y permite que rutas simples como //a coincidan con etiquetas normales.

¿Cómo funcionan los espacios de nombres XML?
Los prefijos declarados en tu XML se pueden usar en el XPath, como //x:item. Con un espacio de nombres predeterminado, //item también sigue la declaración del documento.

¿Por qué puede agotarse una consulta?
Los documentos muy grandes o las expresiones demasiado amplias pueden tardar mucho en evaluarse. La herramienta detiene la ejecución tras 2 segundos para que la página siga respondiendo; acota la ruta o usa una muestra más pequeña.