Mikä XPath on?

XPath on pieni kyselykieli, jolla poimitaan osia XML-asiakirjasta. Lauseke, kuten //book/title, kulkee asiakirjan elementtipuussa ja palauttaa jokaisen kirjan sisällä olevan otsikon riippumatta siitä, missä kohtaa asiakirjaa kirja sijaitsee. XPathia käytetään XSLT-tyylisivuissa, XML Schemassa, Selenium- ja Playwright-testeissä, verkkokaapimissa sekä monien XML-tiedostoja lukevien työkalujen määrityksissä.

Näin käytät testaustyökalua

  1. Kirjoita XPath-lauseke, esimerkiksi //book[price > 15]/title.
  2. Liitä XML sen alle.
  3. Tulokset päivittyvät kirjoittaessasi. Lausekkeessa tai XML:ssä oleva kirjoitusvirhe kertoo, mikä meni pieleen. XML:n kohdalla ilmoitetaan myös virheen rivi ja sarake.

Tulosten lukeminen

  • Solmuja valitseva lauseke luettelee kaikki osumat asiakirjan mukaisessa järjestyksessä ja kertoo niiden tyypin: elementti näytetään sisennettynä XML:nä, attribuutti muodossa name="value" ja teksti, CDATA sekä kommentit tekstinään. Osumat-kentässä näytetään niiden määrä, ja sen kopiointipainike kopioi ne kaikki, kukin omalle rivilleen.
  • Jotakin laskeva lauseke, kuten count(//book) tai contains(//title, 'Garden'), näyttää yksittäisen arvonsa: numeron, merkkijonon tai totuusarvon (true tai false).
  • Sisennettyjen XML-elementtien välissä olevat pelkkiä välilyöntejä ja rivinvaihtoja sisältävät tekstisolmut merkitään, jotta ne erottaa tyhjästä tuloksesta.

Nimiavaruudet

XML:ssä määritellyt etuliitteet, kuten media määrittelyssä xmlns:media="…", toimivat lausekkeessa sellaisinaan: //media:thumbnail.

Oletusnimiavaruus, joka määritellään ilman etuliitettä muodossa xmlns="…", aiheuttaa usein ongelmia. XPath 1.0:ssa etuliitteetön nimi vastaa vain elementtejä, jotka eivät kuulu mihinkään nimiavaruuteen, joten //entry ei löydä mitään Atom-syötteestä. Testaustyökalu antaa kullekin oletusnimiavaruudelle etuliitteen ns (seuraaville ns2, ns3 ja niin edelleen), joten //ns:entry toimii. Voit myös valita elementin pelkän nimen perusteella lausekkeella //*[local-name()='entry']. Nimiavaruuksien etuliitteet -taulukossa luetellaan kaikki käytettävissä olevat etuliitteet.

Esimerkkejä

Esimerkkikirjastossa on seuraavat kirjat:

  • //book/title valitsee kolme otsikkoelementtiä.
  • //book[@genre='garden']/title/text() valitsee puutarhakirjojen otsikot tekstinä.
  • //book/@id valitsee id-attribuutit.
  • //book[price > 15]/title valitsee yli 15 maksavien kirjojen otsikot.
  • count(//book) palauttaa arvon 3.
  • sum(//price) palauttaa arvon 51.75.
  • string(//book[last()]/author) palauttaa viimeisen kirjan kirjoittajan.

Näin se toimii

XML luetaan xmldom-jäsentimellä, ja lauseke arvioidaan xpath-kirjastolla, joka toteuttaa XPath 1.0:n kaikkine funktioineen ja akseleineen. Molemmat toimivat selaimessasi, joten XML ei koskaan poistu laitteeltasi.

Ominaisuudet

  • XPath 1.0 -lausekkeet, joissa on predikaatteja, akseleita ja funktioita
  • Elementit, attribuutit, teksti, kommentit ja lasketut arvot
  • Automaattiset nimiavaruuksien etuliitteet, myös oletusnimiavaruudelle
  • Virheilmoitukset, joissa kerrotaan XML-virheen rivi ja sarake
  • Kopioi kaikki osumat kerralla
  • Toimii selaimessasi