From 98215a603fb798cdb4178e49061977544aaa45b7 Mon Sep 17 00:00:00 2001 From: wei <> Date: Sat, 10 Dec 2005 11:49:29 +0000 Subject: Initial import selenium functional test framework. --- tests/FunctionalTests/selenium/doc/usage.html | 84 +++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 tests/FunctionalTests/selenium/doc/usage.html (limited to 'tests/FunctionalTests/selenium/doc/usage.html') diff --git a/tests/FunctionalTests/selenium/doc/usage.html b/tests/FunctionalTests/selenium/doc/usage.html new file mode 100644 index 00000000..81ee7152 --- /dev/null +++ b/tests/FunctionalTests/selenium/doc/usage.html @@ -0,0 +1,84 @@ + + + + + + Usage + + + +
+
+

Overview 

+This document details how Selenium can be deployed to test or script +web +applications.
+
+
+

Modes of Operation

+Broadly speaking there are two modes of operation for Selenium +TestRunner and Driven
+

TestRunner

+standalone pic
+
+The TestRunner mode of operation for Selenium is where its HTML & +Javascript +and the test suite are deployed alongside the Application Under Test +(AUT) on a arbitrary web server. The test suite is coded as tables in a +HTML page for each test.
+
+See test runner documentation for more +information.
+

Driven

+embedded pic 
+Driven Selenium is where the browser is under the the control of a +process on the same machine. That process is either a Java, .Net, Ruby +or Python +application and it is typically run in conjunction with a unit testing +framework like JUnit or NUnit. Also possible, is a console application +driving a browser interactively.
+
+The test script is one that would be recognisable to people adept with +unit test frameworks :
+
+  public void testOKClick() {
+    selenium.verifyTitle("First Page");
+    selenium.open("/TestPage.html");
+    selenium.click("OKButton");
+    selenium.verifyTitle("Another Page");
+  }
+
+The difference from normal unit testing is that as part of the startup, +three major things have to happen:
+
    +
  1. The test framework needs to publish a fresh copy of the AUT. +Selenium prefers to mount its own web server temporarily for the +purposes of testing.
  2. +
  3. The test framework needs to publish the static Selenium's HTML +pages and Javascript in an apparent directory +on the same web server as (1).
  4. +
  5. The test framework needs to open a browser instance and point it +to Selenium.html served in (2) above.
  6. +
+As each of these is a fairly time consuming operation, it is best that +all three of those happen in a one-time setup mode.  As such, and +even though these leverage a unit testing framework, this is definately +for acceptance or functional rather than unit-testing.
+
+Some variations in the accesibility of the the webserver in question +for testing purposes or its scriptablity mean a more complex setup is +required:
+
+Adjacent pic
+
+See the driven documentation for more +information.
+
+
+
+ + -- cgit v1.2.3