Usage

<scripttype="text/javascript"src="jquery.xpath2.js"></script>

API Reference

Running queries with context

$(document).xpath("*");// Returns an html element (direct child of context item)$(document).xpath("//head << //body");// Returns true or false on whether the head is preceding the body$(document).xpath("//*[parent::html][last()]")// Returns the html element body's last child$(document.body).xpath("count(ancestor-or-self::node())");// Returns number of elements in an ancestor nodes (in this case returns 3)$(document.body).xpath("preceding-sibling::element()");// Returns element head (body prev sibling)$(document.documentElement).xpath("body | head");// Returns element head and body (document order)$(document.documentElement).xpath("body, head");// Returns element body and head (not ordered)

Running queries that do not require context

$().xpath("0.1+0.2");// Returns number 0.3 (Note: in JavaScript it returns 0.30000000000000004)$().xpath("xs:date('2012-12-12')-xs:yearMonthDuration('P1Y1M')");// Returns string '2011-11-12'$().xpath("2 to 5");// Returns {number} 2, 3, 4 and 5$().xpath("for $var in (1, 2, 3) return $var * 3");// Returns number 3, 6 and 9$().xpath("round-half-to-even(35540, -2)");// Returns number 35500$().xpath("translate('bar','abc','ABC')");// Returns string BAr$().xpath("matches('helloworld', 'hello world', 'x')");// Returns boolean true$().xpath("xs:double('-INF') castable as xs:decimal)");// Returns boolean false$().xpath("1e2 instance of xs:double");//  Returns boolean true$().xpath("1.5 cast as xs:integer");// Returns number 1

Running queries with prefixes

$(document).xpath("//my:body",function(prefix){if(prefix=="my")return"http://www.w3.org/1999/xhtml";});// Returns element body ('my' prefix resolved to XHTML namespace)

Error reporting

Syntax errors

$().xpath("1 to ");// Throw "Error: Expected second operand in range expression"$().xpath("$*");// Throws: "Error: Illegal use of wildcard in var expression variable name"$(document).xpath("self::document()");// Throws: "Error: Unknown 'document' kind test"

Evaluation errors

$().xpath("1+'2'")// Throws "Error: Arithmetic operator is not defined for provided arguments"$().xpath("self::node()");// Throws "Error: In an axis step, the context item is not a node."$().xpath("max((1,''))");// Throws "Error: Input to max() contains a mix of not comparable values"

XPath 2.0 trace() function

$().xpath("for $a in (1, 2), $b in (3 to 4) return trace($b, 'b: ') - $a");// See browser console