The project is the old version for Selenium-RC. If you want to use Selenium 2 (Webdriver), please refer to this project - ZTL on Github

ZK-ZTL is an open source tool which can automatically test the ZK Framework with jUnit and Selenium frameworks. And it can now support vision test to test on ZK Framework.

Introduction

The ZTL language is XML based which describes the operation of a test case for the Selenium Remote Control (RC). For example,

<test tags="button">
	<case id="Click">
		<server><!--
			<zk>
				<button id="btn" label="Click Me to Show a Message" onClick='alert("Hello!")'/>
			</zk>
		--></server>
		<client>
			click(btn);
			waitResponse();
			verifyTrue(jq("@window").exists());
		</client>
	</case>
</test>

The root tag of the ZTL file is test and encloses one or many case(s) (similar to each method of the jUnit test case). The case can enclose one or many server and client tags. The content of the server is run on the ZK server, and the content of the client is run on the Selenium server(we called client).

In the above example, the content of the server creates a button (id=btn) which when clicked on will show a "Hello!" message. The content of the client uses btn which is an instance of org.zkoss.ztl.Widget, to fire a Click event to the browser, and then waits for the response from ZK server. Once the response is received the code then checks whether @window exists or not by using the jq API which is implemented by the class org.zkoss.ztl.JQuery.

Documentation

• Getting Start Guide
• User Guide
• Developer's Guide
• Java Doc

Vision Test

This is a new feature since 2011/03/15. Now you can easily use the image comparison to test on ZTL platform. For more details, please see this guide and demo - Vision Test Tutorial

Contribution

• Contributor's Guide

If you contribute to this project, we will run through all of the ZTL files you created before ZK release and freshly builds.

Issue Tracker

• Please post the issue here

Tools