Usage

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

API Reference

Running queries with context

$(document).xpath("*");// Returns {Element} html (direct child of context item - document)$(document).xpath("//head << //body");// Returns {Boolean} true (head is preceding body)$(document).xpath("//*[parent::html][last()]")// Returns {Element} body (last child of html)$(document.body).xpath("count(ancestor::node())");// Returns {Number} 2 (2 ancestor nodes)$(document.body).xpath("preceding-sibling::element()");// Returns {Element} head (prev sibling)$(document.documentElement).xpath("body | head");// Returns {Element} head and body (ordered)$(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 ");// Throws "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,'2'))");// 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