summaryrefslogtreecommitdiff
path: root/tests/FunctionalTests/selenium/doc/FAQ.txt
diff options
context:
space:
mode:
authorwei <>2005-12-10 11:49:29 +0000
committerwei <>2005-12-10 11:49:29 +0000
commit98215a603fb798cdb4178e49061977544aaa45b7 (patch)
tree282787037961f7466acbd174ce151cac6de71273 /tests/FunctionalTests/selenium/doc/FAQ.txt
parent25f9c45261aafd65477ad526e0b6ad3dca80803a (diff)
Initial import selenium functional test framework.
Diffstat (limited to 'tests/FunctionalTests/selenium/doc/FAQ.txt')
-rw-r--r--tests/FunctionalTests/selenium/doc/FAQ.txt127
1 files changed, 127 insertions, 0 deletions
diff --git a/tests/FunctionalTests/selenium/doc/FAQ.txt b/tests/FunctionalTests/selenium/doc/FAQ.txt
new file mode 100644
index 00000000..ad9894ee
--- /dev/null
+++ b/tests/FunctionalTests/selenium/doc/FAQ.txt
@@ -0,0 +1,127 @@
+===========================================
+ Selenium Frequently Asked Questions
+===========================================
+
+.. Please note that until there's a Q&A-specific construct available,
+ this FAQ will use section titles for questions. Therefore
+ questions must fit on one line. The title may be a summary of the
+ question, with the full question in the section body.
+
+This is a work in progress. Please feel free to ask questions and/or
+provide answers; send email to the Selenium users email address at `selenium-users@lists.public.thoughtworks.org`__.
+
+.. _let us know:
+__ mailto:selenium-users@lists.public.thoughtworks.org
+
+
+.. contents::
+.. sectnum::
+
+
+
+
+Selenium
+========
+
+What is Selenium used for?
+--------------------------
+
+It is used for functional or system testing web applications. These tests
+are also sometimes called acceptance, customer, or integration tests. Selenium is not meant for unit testing.
+
+
+
+Why can't I script google.com?
+------------------------------
+Question:
+*I was trying to write a simple script that does a google search.
+I have been running into all sorts of problems. Does this work for you?
+Here is my test:* |test|.
+
+.. |test| raw:: html
+
+ <table cellpadding="1" cellspacing="1" border="1">
+ <tbody>
+ <tr>
+ <td rowspan="1" colspan="3">Test Type<br>
+ </td>
+ </tr>
+ <tr>
+ <td>open</td>
+ <td>http://www.google.com/</td>
+ <td>&nbsp;</td>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>q</td>
+ <td>testing tools</td>
+ </tr>
+ <tr>
+ <td>click</td>
+ <td>submitButton</td>
+ <td>&nbsp;</td>
+ </tr>
+ </tbody>
+ </table>
+
+Answer:
+The quick answer is that because of cross-site scripting security built into
+JavaScript engines in all browsers, you can't edit the content of a web page
+from another domain. The foreign page will probably load correctly and be visible
+in the test runner window, but Selenium won't be able to query or edit its contents.
+In other words, you can't run selenium on "foo.com" and
+run a test that edits values and clicks buttons against "bar.com". So, in
+its current form, you can't "script" google.com because your script isn't
+currently hosted on google.com. When Selenium and the application you are
+testing is hosted on the same domain, however, you do not run into the
+cross-site scripting security feature/limitation.
+
+You read more about cross-site scripting here: http://www.devarticles.com/c/a/JavaScript/JavaScript-Security/
+
+Also, if cross-site scripting security didn't exist, be careful about your
+field and button references in your tests. The current version
+of Selenium uses the "id" attribute of the object you are referring to in your
+test. The search field and submit button at google.com have "name" attributes,
+but not not "id" attributes. Therefore, Selenium wouldn't be able to find the objects.
+Future versions of Selenium will be able to search for objects by more than
+just the id attribute, though.
+
+
+How can I run my test against a foreign or remote server and get around cross-site scripting security?
+------------------------------------------------------------------------------------------------------
+
+There are a few ways around cross-site scripting to access a remote server.
+You could use a combination of proxying and URL rewriting in Apache to
+trick the browser into the thinking the application and the testing tool
+are coming from the same domain.
+
+Another option is to run Selenium as an "HTA" application, or "HTML
+Application" in Internet Explorer. HTA applications run in the security
+context of any trusted application on the client, so there is no cross-site
+scripting limitation. (You can find out more here:
+http://msdn.microsoft.com/workshop/author/hta/overview/htaoverview.asp) The
+equivalent to this "security-free" client on the Mozilla side of the fence
+would be to write a XUL wrapper/extension.
+
+Also, please see the answer to the related question: "Why can't I script google.com".
+
+
+How do you create test tables?
+------------------------------
+
+The developers on the Selenium project use Mozilla Composer to
+create plain HTML text files for their tests.
+By default, Mozilla Composer writes very clean HTML without any extra, unnecessary markup.
+
+Future versions of Selenium may support RST (ReStructred Text), or wiki-table
+syntax, natively. However, you are free to use another format now,
+as long as you remember to generate the HTML files from your source files,
+either during your build process or dynamically at run-time.
+
+
+
+:Author:
+ Jason Huggins
+:Created Date: 11/05/2004
+:Modified Date: 11/05/2004
+:Created With: reStructuredText: http://docutils.sourceforge.net/rst.html \ No newline at end of file