XPath

XPath (XML Path Language) es un lenguaje de consulta para seleccionar nodos y valores de documentos XML. En Apidog, XPath se utiliza para extraer datos de respuestas de API XML, validar estructuras XML y crear aserciones para API basadas en XML.

Puede utilizar XPath para seleccionar nodos o conjuntos de nodos en un documento XML siguiendo una ruta o una serie de pasos a través de la jerarquía del documento.

Ejemplo de XML

Utilizaremos este documento XML en los siguientes ejemplos:

<?xml version="1.0" encoding="UTF-8"?>
<bookstore>
  <book>
    <title lang="eng">Harry Potter</title>
    <price>29.99</price>
  </book>
  <book>
    <title lang="eng">Learning XML</title>
    <price>39.95</price>
  </book>
</bookstore>

Selección de nodos

XPath le permite seleccionar nodos o conjuntos de nodos en un documento XML siguiendo una ruta o pasos. A continuación se muestran algunas de las expresiones de ruta más comunes:

Expresión	Descripción
`nodename`	Selecciona todos los hijos de este nodo
`/`	Selecciona desde el nodo raíz
`//`	Selecciona nodos en el documento desde el nodo actual que coincidan con la selección, independientemente de sus posiciones
`.`	Selecciona el nodo actual
`..`	Selecciona el nodo principal del nodo actual
`@`	Selecciona un atributo

Ejemplos de expresiones de ruta

La siguiente tabla muestra expresiones de ruta y sus resultados según el XML de ejemplo:

Expresión de ruta	Resultado
`bookstore`	Selecciona todos los hijos del elemento bookstore
`/bookstore`	Selecciona el elemento raíz bookstore. Si la ruta comienza con una barra diagonal ( / ), esta ruta siempre representa una ruta absoluta a un elemento
`bookstore/book`	Selecciona todos los elementos book que son hijos de bookstore
`//book`	Selecciona todos los elementos book independientemente de su posición en el documento
`bookstore//book`	Selecciona todos los elementos book que son hijos de elementos bookstore, independientemente de dónde se encuentren bajo bookstore
`//@lang`	Selecciona todos los atributos denominados lang

Rutas absolutas frente a relativas

Las rutas que comienzan con / son absolutas (desde la raíz), mientras que las rutas sin / son relativas al nodo actual.

Predicados

Puede utilizar predicados para encontrar un nodo específico o un nodo que contenga un valor especificado. Los predicados se encierran entre corchetes y permiten un filtrado potente.

Ejemplos de predicados

Expresión de ruta	Resultado
`/bookstore/book[1]`	Selecciona el primer elemento book de los elementos hijos de bookstore
`/bookstore/book[last()]`	Selecciona el último elemento book de los elementos hijos de bookstore
`/bookstore/book[last()-1]`	Selecciona el penúltimo elemento book de los elementos hijos de bookstore
`/bookstore/book[position()<3]`	Selecciona los dos primeros elementos book de los elementos hijos de bookstore
`//title[@lang]`	Selecciona todos los elementos title que tienen un atributo denominado lang
`//title[@lang='eng']`	Selecciona todos los elementos title que tienen un atributo lang con el valor eng
`/bookstore/book[price>35.00]`	Selecciona todos los elementos book de bookstore con el valor del elemento price mayor que 35.00
`/bookstore/book[price>35.00]//title`	Selecciona todos los elementos title del elemento book en bookstore con el elemento price mayor que 35.00

Indexación de predicados

XPath utiliza indexación basada en 1 para los predicados, a diferencia de JSONPath, que utiliza indexación basada en 0. El primer elemento es [1], no [0].

Selección de nodos desconocidos

El comodín de XPath se puede utilizar para seleccionar elementos XML desconocidos sin conocer sus nombres exactos.

Sintaxis de comodines

Comodín	Descripción
`*`	Coincide con cualquier nodo de elemento
`@*`	Coincide con cualquier nodo de atributo
`node()`	Coincide con cualquier tipo de nodo

Ejemplos de comodines

Expresión de ruta	Resultado
`/bookstore/*`	Selecciona todos los elementos hijos del elemento bookstore
`//*`	Selecciona todos los elementos en el documento
`//title[@*]`	Selecciona todos los elementos title con atributos

Uso de comodines

Los comodines son útiles cuando trabaja con estructuras XML dinámicas o cuando desea seleccionar todos los elementos independientemente de sus nombres.

Seleccionar varias rutas

Puede seleccionar varias rutas utilizando el operador | en una expresión de ruta, lo que le permite combinar múltiples selecciones.

Ejemplos de varias rutas

Expresión de ruta	Resultado
`//book/title \| //book/price`	Selecciona todos los elementos title y price del elemento book
`//title \| //price`	Selecciona todos los elementos title y price en el documento
`/bookstore/book/title \| //price`	Selecciona todos los elementos title del elemento book del elemento bookstore y todos los elementos price en el documento

Casos de uso en Apidog

XPath es especialmente útil en Apidog para:

Validación de respuestas XML: Extraer valores específicos de respuestas de API XML para verificar su corrección

Pruebas de API SOAP: Analizar y validar respuestas SOAP

Variables dinámicas: Almacenar valores XML extraídos para usarlos en peticiones posteriores

Aserciones de prueba: Crear aserciones basadas en datos de respuesta XML

Extracción de datos: Extraer campos específicos de estructuras XML anidadas complejas

XML frente a JSON

Aunque JSON es más común en las API modernas, muchos sistemas heredados y servicios basados en SOAP todavía utilizan XML. XPath es esencial para probar estas API.

Referencias

Especificación W3C de XPath

Tutorial de XPath - W3Schools

Probador de XPath

Ejemplo de XML#

Selección de nodos#

Ejemplos de expresiones de ruta#

Predicados#

Ejemplos de predicados#

Selección de nodos desconocidos#

Sintaxis de comodines#

Ejemplos de comodines#

Seleccionar varias rutas#

Ejemplos de varias rutas#

Casos de uso en Apidog#

Referencias#

Ejemplo de XML

Selección de nodos

Ejemplos de expresiones de ruta

Predicados

Ejemplos de predicados

Selección de nodos desconocidos

Sintaxis de comodines

Ejemplos de comodines

Seleccionar varias rutas

Ejemplos de varias rutas

Casos de uso en Apidog

Referencias