dding new files
git-svn-id: svn://10.0.0.236/trunk@63213 18797224-902f-48f8-a5cc-f745e15eee43
This commit is contained in:
rpallath%eng.sun.com
709
mozilla/java/plugins/test/doc/api/description.html
Normal file
709
mozilla/java/plugins/test/doc/api/description.html
Normal file
@@ -0,0 +1,709 @@
|
||||
<html>
|
||||
<head>
|
||||
<title>Browser side Pluglet API tests description</title>
|
||||
</head>
|
||||
<body bgcolor=White>
|
||||
<pre>
|
||||
<B>Browser side Pluglet API tests description.</B>
|
||||
(first draft,30 November 1999)
|
||||
|
||||
Contents:
|
||||
|
||||
<A href=#1.>1.</A> Methods of interface PlugletManager:
|
||||
<A href=#1.1>1.1</A> getURL
|
||||
<!-- <A href=#1.2>1.2</A> getValue -->
|
||||
<A href=#1.3>1.3</A> postURL
|
||||
<A href=#1.4>1.4</A> reloadPluglets
|
||||
<A href=#1.5>1.5</A> userAgent
|
||||
<A href=#2.>2.</A> Methods of interface PlugletPeer:
|
||||
<A href=#2.1>2.1</A> getMIMEType
|
||||
<A href=#2.2>2.2</A> getMode
|
||||
<A href=#2.3>2.3</A> getTagInfo
|
||||
<A href=#2.4>2.4</A> getValue
|
||||
<A href=#2.5>2.5</A> newStream
|
||||
<A href=#2.6>2.6</A> setWindowSize
|
||||
<A href=#2.7>2.7</A> showStatus
|
||||
<A href=#3.>3.</A> Methods of interface PlugletStreamInfo:
|
||||
<A href=#3.1>3.1</A> getContentType
|
||||
<A href=#3.2>3.2</A> getLastModified
|
||||
<A href=#3.3>3.3</A> getLength
|
||||
<A href=#3.4>3.4</A> getURL
|
||||
<A href=#3.5>3.5</A> isSeekable
|
||||
<A href=#3.6>3.6</A> requestRead
|
||||
<A href=#4.>4.</A> Methods of interface PlugletTagInfo:
|
||||
<A href=#4.2>4.2</A> getAttribute
|
||||
<A href=#4.3>4.3</A> getAttributes
|
||||
<A href=#5.>5.</A> Methods of interface PlugletTagInfo2:
|
||||
<A href=#5.1>5.1</A> getAlignment
|
||||
<A href=#5.2>5.2</A> getAttribute
|
||||
<A href=#5.3>5.3</A> getAttributes
|
||||
<A href=#5.4>5.4</A> getBorderHorizSpace
|
||||
<A href=#5.5>5.5</A> getBorderVertSpace
|
||||
<A href=#5.6>5.6</A> getDocumentBase
|
||||
<A href=#5.7>5.7</A> getDocumentEncoding
|
||||
<A href=#5.8>5.8</A> getHeight
|
||||
<A href=#5.9>5.9</A> getTagText
|
||||
<A href=#5.10>5.10</A> getTagType
|
||||
<A href=#5.11>5.11</A> getUniqueID
|
||||
<A href=#5.12>5.12</A> getWidth
|
||||
|
||||
Description:
|
||||
|
||||
<A name=1.>1. Methods of PlugletManager interface
|
||||
<A name=1.1>1.1 Tests for method getURL of PlugletManager interface.
|
||||
Method description:
|
||||
Via this method pluglet can request any URL
|
||||
and paint it on browser window or fetch it self.
|
||||
Method's state: doesn't work(Pluglet's plugin code doesn't exist)
|
||||
|
||||
Test IDs: basic/api/PlugletManager_getURL:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletManager_getURL
|
||||
Recent files:
|
||||
PlugletManager_getURL_128.java
|
||||
PlugletManager_getURL_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Possible a good way to do it
|
||||
is JavaScript, well received and rendered page can
|
||||
say pluglet:"All OK :)"
|
||||
Comments:
|
||||
Now test just iterate a set of arguments and call method.
|
||||
JNI realization of this method is not yet implemented,
|
||||
so can't check results of it execution.
|
||||
<A name=1.3>1.3 Tests for method postURL of PlugletManager interface.
|
||||
Method description:
|
||||
This method used for post some data and get browser's answer.
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletManager_postURL:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletManager_postURL
|
||||
Recent files:
|
||||
PlugletManager_postURL_9216.java
|
||||
PlugletManager_postURL_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Not implemented.Possible a good way to do it is CGI script
|
||||
for receive and check posted data and generate valid answer.
|
||||
Comments:
|
||||
Now test just iterate a set of arguments and call method.
|
||||
JNI realization of this method is not yet implemented,
|
||||
so can't check results of it execution.
|
||||
|
||||
<A name=1.4>1.4 Tests for method reloadPluglets of PlugletManager interface.
|
||||
Method description:
|
||||
Via this method pluglet can request browser
|
||||
to reload pluglets from disk, so if new pluglet
|
||||
jars available in the pluglets location dir, new
|
||||
mime types should be handled successfully.
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletManager_reloadPluglets:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletManager_reloadPluglets
|
||||
Recent files:
|
||||
PlugletManager_reloadPluglets_2.java
|
||||
PlugletManager_reloadPluglets_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
From current point of view a good way to check such
|
||||
behavior is verify output from second pluglet.
|
||||
Now this test used 2 pluglets main and second,
|
||||
second pluglet located in test dir, SecondPluglet.jar
|
||||
and copied to pluglets dir during test execution.
|
||||
Also applet used to delete a SecondPluglet.jar from pluglet's dir
|
||||
(it can appear here from previous tests).
|
||||
Sequence:
|
||||
1.First page with DelApp delete SecondPluglet.jar from pluglet's dir
|
||||
and load page with test pluglet.
|
||||
2.TestPluglet copying SecondPluglet.jar to the pluglet's dir ,
|
||||
call reloadPluglets method of PlugletManager and load page
|
||||
with SecondPluglet.
|
||||
3.If pluglets was successfully reloaded then SecondPluglet
|
||||
initialized and say to test context:"All O
|
||||
Comments:
|
||||
You must grant permissions for test and applet for copying and deletion
|
||||
files on your filesystem.
|
||||
NOTE:Check for page reloading should be added
|
||||
|
||||
<A name=1.5>1.5 Tests for method userAgent of PlugletManager interface.
|
||||
Method description:
|
||||
Via this method pluglet can access
|
||||
to the current user agent name.
|
||||
Method's state: Methods work correctly
|
||||
|
||||
Test ID: basic/api/PlugletManager_userAgent
|
||||
Test Directory: PlugletManager_userAgent
|
||||
Recent files:
|
||||
PlugletManager_userAgent_0.java
|
||||
PlugletManager_userAgent_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
JavaScript used to check result of this method execution.
|
||||
JavaScript window.navigator.userAgent value transfered
|
||||
to pluglet and compared with value, returned by method.
|
||||
If values are equals then test PASSED.
|
||||
Comments:
|
||||
Now static string used to indentify userAgent in
|
||||
plugins and this string differen from window.navigator.userAgent
|
||||
|
||||
<A name=2.>2. Methods of PlugletPeer interface
|
||||
<A name=2.1>2.1 Tests for method getMIMEType of PlugletPeer interface.
|
||||
Method description:
|
||||
Via this method pluglet can access to MIME type,
|
||||
witch it was instantiated.
|
||||
Method's state: work now.
|
||||
|
||||
Test ID: basic/api/PlugletPeer_getMIMEType
|
||||
Test Directory: PlugletPeer_getMIMEType
|
||||
Recent files:
|
||||
PlugletPeer_getMIMEType_0.java
|
||||
PlugletPeer_getMIMEType_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
MIME type value transfered to pluglet via JavaScript
|
||||
and compared with returned by getMIMEType method.
|
||||
If values are equals then test PASSED
|
||||
Comments:
|
||||
Test for pluglet with multiple mime-types should be added.
|
||||
<A name=2.2>2.2 Tests for method getMode of PlugletPeer interface.
|
||||
Method description:
|
||||
This method returns a pluglet mode,possible modes is
|
||||
full page and embedded.
|
||||
Method's state:
|
||||
Method always return 1(corresponds to embedded pluglets)
|
||||
Test IDs: basic/api/PlugletPeer_getMode
|
||||
Test Directory: PlugletPeer_getMode
|
||||
Recent files:
|
||||
PlugletPeer_getMode_0.java
|
||||
PlugletPeer_getMode_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Expected value of instantiation mode pluglet read from TestProperties(located in test dir).
|
||||
Expected value compared with returned by getMode method and if they are equals then
|
||||
test PASSED.
|
||||
Comments:
|
||||
Test for full page pluglets should be added.
|
||||
<A name=2.3>2.3 Tests for method getTagInfo of PlugletPeer interface.
|
||||
Method description:
|
||||
This method return a PlugletTagInfo object.
|
||||
Via this object pluglet can access to miscellaneous tag information.
|
||||
Method's state: work
|
||||
|
||||
Test IDs: basic/api/PlugletPeer_getTagInfo:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletPeer_getTagInfo
|
||||
Recent files:
|
||||
PlugletPeer_getTagInfo_0.java
|
||||
PlugletPeer_getTagInfo_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
For verify results PlugletTagInfo.getAttribute method used.
|
||||
Returned by getAttribute value compared with value, transfered to
|
||||
pluglet via JavaScript and if they equals then test PASSED.
|
||||
Now "type" attribute used to verify a validity of PlugletTagInfo object
|
||||
Comments:
|
||||
<A name=2.4>2.4 Tests for method getValue of PlugletPeer interface.
|
||||
Method description:
|
||||
This method returns value of variable, associated
|
||||
with PlugletPeer.
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletPeer_getValue:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletPeer_getValue
|
||||
Recent files:
|
||||
PlugletPeer_getValue_3.java
|
||||
PlugletPeer_getValue_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Method doesn't work, check not implemented
|
||||
Comments:
|
||||
|
||||
<A name=2.5>2.5 Tests for method newStream of PlugletPeer interface.
|
||||
Method description:
|
||||
This method used to create stream for transfer data from pluglet to browser,
|
||||
browser should render, save, .. etc received data corresponding to data's MIME type.
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletPeer_newStream_0:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletPeer_newStream_0
|
||||
Recent files:
|
||||
PlugletPeer_newStream_4.java
|
||||
PlugletPeer_newStream_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
This test just iterate method's arguments,
|
||||
can't verify results, because method doesn't work.
|
||||
Possible a good way to check result is JavaScript,
|
||||
embedded in send ed data or in another frame of frameset
|
||||
Comments:
|
||||
|
||||
Test IDs: basic/api/PlugletPeer_newStream_1:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
PlugletPeer_newStream_1 PlugletPeer_newStream_1
|
||||
Recent files:
|
||||
PlugletPeer_newStream_4.java
|
||||
PlugletPeer_newStream_Iterator.java
|
||||
Arguments:
|
||||
In test dir PlugletPeer_newStream_1 see ParamCombinations
|
||||
and TestParameters for argument's values.
|
||||
Check result:
|
||||
This test used text/html MIME type for new stream,
|
||||
so check implemented via JavaScript, embedded in posted data.
|
||||
If page correctly loaded and rendered, then JavaScript just
|
||||
say pluglet: "All OK"
|
||||
Comments:
|
||||
|
||||
<A name=2.6>2.6 Tests for method setWindowSize of PlugletPeer interface.
|
||||
Method description: This method used to change browser widow size.
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletPeer_setWindowSize:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletPeer_setWindowSize
|
||||
Recent files:
|
||||
PlugletPeer_setWindowSize_9.java
|
||||
PlugletPeer_setWindowSize_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
JavaScript used to verify results.
|
||||
Sequence:
|
||||
1.Page with test pluglet loaded,pluglet instantiated
|
||||
2.After some time (about 5 seconds after page initialization) JavaScript transfer
|
||||
current window size to pluglet.
|
||||
3.Pluglet compare values from JavaScript and arguments of setWindowSize method
|
||||
and if they equals then test PASSED.
|
||||
Comments:
|
||||
<A name=2.7>2.7 Tests for method showStatus of PlugletPeer interface.
|
||||
Method description:
|
||||
This method used to display a string in the browser's status line.
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletPeer_showStatus:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletPeer_showStatus
|
||||
Recent files:
|
||||
PlugletPeer_showStatus_2.java
|
||||
PlugletPeer_showStatus_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Implemented via JavaScript, after small timeout
|
||||
value of window.status transfered to pluglet and
|
||||
compared with argument of showStatus.If they values are equals
|
||||
then test PASSED.
|
||||
Comments:
|
||||
|
||||
<A name=3.>3. Methods of PlugletStreamInfo interface
|
||||
<A name=3.1>3.1 Tests for method getContentType of PlugletStreamInfo interface.
|
||||
Method description:
|
||||
This method used to get stream's content type
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletStreamInfo_getContentType
|
||||
Test Directory: PlugletStreamInfo_getContentType
|
||||
Recent files:
|
||||
PlugletStreamInfo_getContentType_0.java
|
||||
PlugletStreamInfo_getContentType_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Check result implemented via JavaScript,
|
||||
when pluglet instantiated JavaScript transfer
|
||||
content type of src data to pluglet.Pluglet
|
||||
compare it with value, returned by getContentType
|
||||
method and if they equals then method PASSED
|
||||
Comments:
|
||||
|
||||
<A name=3.2>3.2 Tests for method getLastModified of PlugletStreamInfo interface.
|
||||
Method description:
|
||||
This method used for access to Last Modified
|
||||
stream field.
|
||||
Method's state: doesn't work
|
||||
|
||||
Test ID: basic/api/PlugletStreamInfo_getLastModified
|
||||
Test Directory: PlugletStreamInfo_getLastModified
|
||||
Recent files:
|
||||
PlugletStreamInfo_getLastModified_0.java
|
||||
PlugletStreamInfo_getLastModified_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Not implemented.Possible a good way to check result
|
||||
is create from pluglet URLConnection to file,
|
||||
used in src and compare URLConnection's LastModified
|
||||
values with returned by getLasModified method.Or
|
||||
use CGI script to generate Last Modified field.
|
||||
Comments:
|
||||
Always return 0 now.
|
||||
<A name=3.3>3.3 Tests for method getLength of PlugletStreamInfo interface.
|
||||
Method description:
|
||||
This method used to get length of stream's data.(Content Length field)
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletStreamInfo_getLength
|
||||
Test Directory: PlugletStreamInfo_getLength
|
||||
Recent files:
|
||||
PlugletStreamInfo_getLength_0.java
|
||||
PlugletStreamInfo_getLength_Iterator.java
|
||||
Arguments:
|
||||
Check result:
|
||||
Java Script used to transfer file name, used in embed's src attribute.
|
||||
Pluglet used a URLConnection.getContentLength method to get
|
||||
right value for ContentLength field. And then compare it
|
||||
with value, returned by getLength method.If they values are
|
||||
equals then test PASSED.
|
||||
Comments:
|
||||
<A name=3.4>3.4 Tests for method getURL of PlugletStreamInfo interface.
|
||||
Method description: This method used for access to stream's URL
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletStreamInfo_getURL
|
||||
Test Directory: PlugletStreamInfo_getURL
|
||||
Recent files:
|
||||
PlugletStreamInfo_getURL_0.java
|
||||
PlugletStreamInfo_getURL_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Java Script used to transfer file name, used in embed's src attribute.
|
||||
Pluglet use HTML_ROOT property(from CommonProperties) and src's file
|
||||
name to construct expected URL.Expected value compared with returned
|
||||
by getURL method and if they equals then test PASSED
|
||||
Comments:
|
||||
<A name=3.5>3.5 Tests for method isSeekable of PlugletStreamInfo interface.
|
||||
Method description:
|
||||
Method's state: always return true
|
||||
|
||||
Test ID: basic/api/PlugletStreamInfo_isSeekable
|
||||
Test Directory: PlugletStreamInfo_isSeekable
|
||||
Recent files:
|
||||
PlugletStreamInfo_isSeekable_0.java
|
||||
PlugletStreamInfo_isSeekable_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Now expected result specified via properties.For most streams
|
||||
seekable is false.Additional test should be added for another
|
||||
streams
|
||||
Comments:
|
||||
<A name=3.6>3.6 Tests for method requestRead of PlugletStreamInfo interface.
|
||||
Method description: This method allow to pluglet request data from stream
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletStreamInfo_requestRead:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletStreamInfo_requestRead
|
||||
Recent files:
|
||||
PlugletStreamInfo_requestRead_2.java
|
||||
PlugletStreamInfo_requestRead_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Not implemented
|
||||
Comments:
|
||||
<A name=4.>4. Methods of PlugletTagInfo interface
|
||||
|
||||
<A name=4.1>4.1 Tests for method getAttribute of PlugletTagInfo interface.
|
||||
Method description: This method used to get tag attributes
|
||||
Method's state: work
|
||||
|
||||
Test IDs: basic/api/PlugletTagInfo_getAttribute:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletTagInfo_getAttribute
|
||||
Recent files:
|
||||
PlugletTagInfo_getAttribute_2.java
|
||||
PlugletTagInfo_getAttribute_Iterator.java
|
||||
Arguments:
|
||||
String attrName
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Check implemeted via JavaScript function, that analyze embed or
|
||||
object tag node and transfer all tag's attributes to pluglet.
|
||||
Pluglet can verify they values and compare with returned by
|
||||
getAttribute.
|
||||
Comments:
|
||||
<A name=4.2>4.2 Tests for method getAttributes of PlugletTagInfo interface.
|
||||
Method description:
|
||||
This method allow to pluglet get all tag attributes.
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo_getAttributes
|
||||
Test Directory: PlugletTagInfo_getAttributes
|
||||
Recent files:
|
||||
PlugletTagInfo_getAttributes_0.java
|
||||
PlugletTagInfo_getAttributes_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Check implemeted via JavaScript function, that analyze embed or
|
||||
object tag node and transfer all tag's attributes to pluglet.
|
||||
Pluglet can verify they values and compare with returned by
|
||||
getAttributes.
|
||||
Comments:
|
||||
|
||||
|
||||
<A name=5.>5. Methods of PlugletTagInfo2 interface
|
||||
<A name=5.1>5.1 Tests for method getAlignment of PlugletTagInfo2 interface.
|
||||
Method description:
|
||||
Method's state: doesn't work
|
||||
|
||||
Test IDs: basic/api/PlugletTagInfo2_getAlignment
|
||||
Test Directory: PlugletTagInfo2_getAlignment
|
||||
Recent files:
|
||||
PlugletTagInfo2_getAlignment_0.java
|
||||
PlugletTagInfo2_getAlignment_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Not implemented.
|
||||
Comments:
|
||||
|
||||
<A name=5.2>5.2 Tests for method getAttribute of PlugletTagInfo2 interface.
|
||||
Method description: This method used to get tag attributes
|
||||
Method's state: work
|
||||
|
||||
Test IDs: basic/api/PlugletTagInfo2_getAttribute:n (where n integer, see BWTest.lst.ORIG for it values)
|
||||
Test Directory: PlugletTagInfo2_getAttribute
|
||||
Recent files:
|
||||
PlugletTagInfo2_getAttribute_2.java
|
||||
PlugletTagInfo2_getAttribute_Iterator.java
|
||||
Arguments:
|
||||
String attrName
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
Check implemeted via JavaScript function, that analyze embed or
|
||||
object tag node and transfer all tag's attributes to pluglet.
|
||||
Pluglet can verify they values and compare with returned by
|
||||
getAttribute.
|
||||
Comments:
|
||||
|
||||
<A name=5.3>5.3 Tests for method getAttributes of PlugletTagInfo2 interface.
|
||||
Method description:
|
||||
This method allow to pluglet get all tag attributes.
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getAttributes
|
||||
Test Directory: PlugletTagInfo2_getAttributes
|
||||
Recent files:
|
||||
PlugletTagInfo2_getAttributes_0.java
|
||||
PlugletTagInfo2_getAttributes_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Check implemeted via JavaScript function, that analyze embed or
|
||||
object tag node and transfer all tag's attributes to pluglet.
|
||||
Pluglet can verify they values and compare with returned by
|
||||
getAttributes.
|
||||
Comments:
|
||||
|
||||
<A name=5.4>5.4 Tests for method getBorderHorizSpace of PlugletTagInfo2 interface.
|
||||
Method description: This method used for access hspace attribute value
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getBorderHorizSpace
|
||||
Test Directory: PlugletTagInfo2_getBorderHorizSpace
|
||||
Recent files:
|
||||
PlugletTagInfo2_getBorderHorizSpace_0.java
|
||||
PlugletTagInfo2_getBorderHorizSpace_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test EMBED tag doesn't contains hspace attribute,
|
||||
so default value should be returned.
|
||||
Comments:
|
||||
Test ID: basic/api/PlugletTagInfo2_getBorderHorizSpace_1
|
||||
Test Directory: PlugletTagInfo2_getBorderHorizSpace_1
|
||||
Recent files:
|
||||
PlugletTagInfo2_getBorderHorizSpace_0.java
|
||||
PlugletTagInfo2_getBorderHorizSpace_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test tag EMBED has hspace attribute and it value
|
||||
transfered to pluglet via JavaScript.Then this value compared
|
||||
with returned by getBorderHorizSpace and if they equals then test PASSED
|
||||
Comments:
|
||||
|
||||
<A name=5.5>5.5 Tests for method getBorderVertSpace of PlugletTagInfo2 interface.
|
||||
Method description: This method used for access vspace attribute.
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getBorderVertSpace
|
||||
Test Directory: PlugletTagInfo2_getBorderVertSpace
|
||||
Recent files:
|
||||
PlugletTagInfo2_getBorderVertSpace_0.java
|
||||
PlugletTagInfo2_getBorderVertSpace_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
At this test EMBED tag doesn't contains vspace attribute,
|
||||
so default value should be returned.
|
||||
Comments:
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getBorderVertSpace_1
|
||||
Test Directory: PlugletTagInfo2_getBorderVertSpace_1
|
||||
Recent files:
|
||||
PlugletTagInfo2_getBorderVertSpace_0.java
|
||||
PlugletTagInfo2_getBorderVertSpace_Iterator.java
|
||||
Arguments:
|
||||
See ParamCombinations and TestParameters
|
||||
for argument's values.
|
||||
Check result:
|
||||
At this test tag EMBED has vspace attribute and it value
|
||||
transfered to pluglet via JavaScript.Then this value compared
|
||||
with returned by getBorderHorizSpace and if they equals then test PASSED
|
||||
Comments:
|
||||
|
||||
<A name=5.6>5.6 Tests for method getDocumentBase of PlugletTagInfo2 interface.
|
||||
Method description: Returns the URL of the document containing a pluglet instance
|
||||
Method's state: work
|
||||
|
||||
Test IDs: basic/api/PlugletTagInfo2_getDocumentBase
|
||||
Test Directory: PlugletTagInfo2_getDocumentBase
|
||||
Recent files:
|
||||
PlugletTagInfo2_getDocumentBase_0.java
|
||||
PlugletTagInfo2_getDocumentBase_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Check implemeted via JavaScriptfunction, that transfer
|
||||
window.location value from JavaScript to pluglet and
|
||||
compare it with value, returned by getDocumentBase.
|
||||
Comments:
|
||||
|
||||
<A name=5.7>5.7 Tests for method getDocumentEncoding of PlugletTagInfo2 interface.
|
||||
Method description: This method used to access document encoding
|
||||
Method's state: doesn't work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getDocumentEncoding
|
||||
Test Directory: PlugletTagInfo2_getDocumentEncoding
|
||||
Recent files:
|
||||
PlugletTagInfo2_getDocumentEncoding_0.java
|
||||
PlugletTagInfo2_getDocumentEncoding_Iterator.java
|
||||
Arguments: none
|
||||
Check result: Not implemented
|
||||
Comments:
|
||||
|
||||
<A name=5.8>5.8 Tests for method getHeight of PlugletTagInfo2 interface.
|
||||
Method description: This method used to access height attribute value
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getHeight
|
||||
Test Directory: PlugletTagInfo2_getHeight
|
||||
Recent files:
|
||||
PlugletTagInfo2_getHeight_0.java
|
||||
PlugletTagInfo2_getHeight_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test EMBED tag doesn't contains height attribute,
|
||||
so default value should be returned.
|
||||
Comments:
|
||||
Test ID: basic/api/PlugletTagInfo2_getHeight_1
|
||||
Test Directory: PlugletTagInfo2_getHeight_1
|
||||
Recent files:
|
||||
PlugletTagInfo2_getHeight_0.java
|
||||
PlugletTagInfo2_getHeight_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test tag EMBED has height attribute and it value
|
||||
transfered to pluglet via JavaScript.Then this value compared
|
||||
with returned by getHeight and if they equals then test PASSED
|
||||
Comments:
|
||||
<A name=5.9>5.9 Tests for method getTagText of PlugletTagInfo2 interface.
|
||||
Method description: This method used to access full html tag text
|
||||
Method's state: doesn't work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getTagText
|
||||
Test Directory: PlugletTagInfo2_getTagText
|
||||
Recent files:
|
||||
PlugletTagInfo2_getTagText_0.java
|
||||
PlugletTagInfo2_getTagText_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
Not implemented.
|
||||
Possible a good way to check result is JavaScript.
|
||||
Comments:
|
||||
|
||||
<A name=5.10>5.10 Tests for method getTagType of PlugletTagInfo2 interface.
|
||||
Method description:
|
||||
Returns the type of HTML tag used to instantiate this pluglet
|
||||
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getTagType
|
||||
Test Directory: PlugletTagInfo2_getTagType
|
||||
Recent files:
|
||||
PlugletTagInfo2_getTagType_0.java
|
||||
PlugletTagInfo2_getTagType_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test EMBED tag used to instantiate pluglet.The type
|
||||
of tag transfered to pluglet via JavaScript and then compared with
|
||||
returned by getTagType.If they equals then test PASSED.
|
||||
Comments:
|
||||
Test ID: basic/api/PlugletTagInfo2_getTagType_1
|
||||
Test Directory: PlugletTagInfo2_getTagType_1
|
||||
Recent files:
|
||||
PlugletTagInfo2_getTagType_0.java
|
||||
PlugletTagInfo2_getTagType_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test OBJECT tag used to instantiate pluglet.The type
|
||||
of tag transfered to pluglet via JavaScript and then compared with
|
||||
returned by getTagType.If they equals then test PASSED.
|
||||
Comments:
|
||||
<A name=5.11>5.11 Tests for method getUniqueID of PlugletTagInfo2 interface.
|
||||
Method description:
|
||||
This method returns unique ID of current document
|
||||
with this pluglet.
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getUniqueID
|
||||
Test Directory: PlugletTagInfo2_getUniqueID
|
||||
Recent files:
|
||||
PlugletTagInfo2_getUniqueID_0.java
|
||||
PlugletTagInfo2_getUniqueID_Iterator.java
|
||||
and IDPluglet pluglet.
|
||||
Arguments: none
|
||||
Check result:
|
||||
3 IDPluglet used to check results.All pluglets
|
||||
call getUniqueID method and transfer returned value
|
||||
to test pluglet.Test pluglet compare values
|
||||
and if they are equals then test PASSED.
|
||||
Comments:
|
||||
|
||||
<A name=5.12>5.12 Tests for method getWidth of PlugletTagInfo2 interface.
|
||||
Method description:
|
||||
Returns the value of width attribute of HTML tag used to instantiate this pluglet
|
||||
Method's state: work
|
||||
|
||||
Test ID: basic/api/PlugletTagInfo2_getWidth
|
||||
Test Directory: PlugletTagInfo2_getWidth
|
||||
Recent files:
|
||||
PlugletTagInfo2_getWidth_0.java
|
||||
PlugletTagInfo2_getWidth_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test EMBED tag hasn't width attribute.
|
||||
The default value of width attribute transfered to
|
||||
pluglet via JavaScript and then compared with
|
||||
returned by getWidth.If they equals then test PASSED.
|
||||
Comments:
|
||||
Test ID: basic/api/PlugletTagInfo2_getWidth_1
|
||||
Test Directory: PlugletTagInfo2_getWidth_1
|
||||
Recent files:
|
||||
PlugletTagInfo2_getWidth_0.java
|
||||
PlugletTagInfo2_getWidth_Iterator.java
|
||||
Arguments: none
|
||||
Check result:
|
||||
At this test EMBED tag used has width attribute.
|
||||
The value of width attribute transfered to
|
||||
pluglet via JavaScript and then compared with
|
||||
returned by getWidth.If they equals then test PASSED.
|
||||
Comments:
|
||||
</pre>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
110
mozilla/java/plugins/test/doc/api/index.html
Normal file
110
mozilla/java/plugins/test/doc/api/index.html
Normal file
@@ -0,0 +1,110 @@
|
||||
<html>
|
||||
<head>
|
||||
<title>
|
||||
Browser side Pluglet API tests
|
||||
</title>
|
||||
</head>
|
||||
<body bgcolor=White>
|
||||
<center><HR1>Browser side Pluglet API tests</HR1></center>
|
||||
<OL>
|
||||
<A href=#location><LI></A>Tests location.
|
||||
<A href=#struct><LI></A>Tests struct.
|
||||
<A href=#pre-build><LI></A>Pre-build requirements.
|
||||
<A href=#make><LI></A>Make instructions.
|
||||
<A href=#run><LI></A>Run API tests.
|
||||
<A href=#log><LI></A>Log files.
|
||||
<A href=description.html><LI></A>Testcase description.
|
||||
</OL>
|
||||
<OL>
|
||||
<A name=location><LI>Tests location:
|
||||
<UL>
|
||||
<LI>This document concerned tests in directory <B>src/org/mozilla/pluglet/test/basic/api</B><BR>
|
||||
at the your Pluglet tests location.
|
||||
</UL>
|
||||
<A name=struct>
|
||||
<LI>Tests struct:<BR>
|
||||
Test may contains the next files:
|
||||
<UL>
|
||||
<LI>Test java file - test execution and result verification code
|
||||
<LI>Arguments iterator java - code for read lst file and transfer arguments to TestContext
|
||||
</UL>
|
||||
And test dir with:
|
||||
<UL>
|
||||
<LI>TestProperties file - testcase properties, contains test, iterator and initial html file names
|
||||
<LI>TestParameters file - user/location specific parameters for test arguments
|
||||
<LI>ParamCombinations file - combinations of values for each argument.(for generate default lst file)
|
||||
<LI>TestArguments(.lst) file - list of all combinations of arguments (generated from ParamCombinations file)
|
||||
<LI>Misc HTML files - at least one html file with EMBED(or OBJECT) tag for instantiate pluglet and<BR>
|
||||
other html files needed for testcase.
|
||||
</UL>
|
||||
<I>- Each test contains Test and Iterator java files, TestProperties file and at least one HTML file</I><BR>
|
||||
<I>- TestParameters file exist only for tests with user/location specific parameters</I><BR>
|
||||
<I>- ParamCombinations exist only for tests on methods with arguments</I><BR>
|
||||
<I>- TestArguments(.lst) file created during make combinations from ParamCombinations file and<BR>
|
||||
  only for tests on methods with arguments.
|
||||
<div align=right><A href=#top>index</A></div>
|
||||
<A name=pre-build>
|
||||
<LI>Pre-build requirements:
|
||||
<UL>
|
||||
<LI>Build Mozilla and java plugins
|
||||
<LI>Edit <B>TEST_TOP_DIR/config/CommonProperties</B> to change user/location specific parameters, e.g <B>PLUGLET</B>,<B>HTML_ROOT</B> etc ..
|
||||
<LI>In each test dir edit TestParameters, if it exist(and you want to run this testcase)
|
||||
<LI>Set environment variable HTML_ROOT_DIR to directory on your local filesystem, where test HTMLs will be created
|
||||
<LI>Verify that <B>MOZILLA_FIVE_HOME/dist/classes</B> exist in your <B>CLASSPATH</B>
|
||||
<LI>Place <B>TEST_TOP_DIR/build/classes</B> in your <B>CLASSPATH</B>
|
||||
<LI>Performs make in top level directory <B>basic</B> and verify that TestLoaderPluglet.jar successfully created<BR>
|
||||
and placed to TEST_TOP_DIR/build/classes/org/mozilla/pluglet/test/basic</B><BR>
|
||||
<B>PLUGLET</B> property in <B>CommonProperties</B> should point to it.
|
||||
</UL>
|
||||
<div align=right><A href=#top>index</A></div>
|
||||
<A name=make>
|
||||
<LI>Make instructions:<BR>
|
||||
Top level makefile in the api directory has next targets:
|
||||
<UL>
|
||||
<LI>combinations - used for create BWTest.lst.ORIG for all api tests and generate
|
||||
default lst files for each test (if necessary) or just add test id to BWTest.lst.ORIG
|
||||
<LI>tests - make all in test dirs:<BR>
|
||||
- copy HTML files to HTML_ROOT_DIR/api/test_case_name directory<BR>
|
||||
- replace user/location specific parameters(from CommonProperties) in TestProperties file<BR>
|
||||
- copy TestProperties file to BUILD/test/test_id directory<BR>
|
||||
- replace user-defined parameters in the default lst file
|
||||
and copy it to BUILD/test/test_id directory (if necessary)<BR>
|
||||
<LI>test_pluglet - create jar with test classes
|
||||
<LI>classes - compile all java files in the api directory
|
||||
<LI>clobber - remove builded files:<BR>
|
||||
- remove HTML files from HTML_ROOT_DIR<BR>
|
||||
- remove TestProperties and .lst files from BUILD/test/test_id directory
|
||||
</UL>
|
||||
By default classes, tests and test_pluglet targets executed.<BR>
|
||||
NOTE:<BR>
|
||||
<I>You need to do combinations only one time, and
|
||||
only if you change ParamCombinations file for some
|
||||
tests or add new test cases</I><BR>
|
||||
Build sequence(Win):
|
||||
<UL>
|
||||
<LI>Performs all pre-build instructions.
|
||||
<LI>In the api directory type nmake -f makefile.win
|
||||
</UL>
|
||||
<div align=right><A href=#top>index</A></div>
|
||||
<A name=run>
|
||||
<LI>Run API tests.
|
||||
<UL>
|
||||
<LI>Performs all pre-build and build instructions
|
||||
<LI>For run all API tests copy <B>TEST_TOP_DIR/build/test/basic/api/BWTest.lst.ORIG</B> to
|
||||
the current directory and just type <B>perl autorun.pl</B>
|
||||
<LI>For run selected API tests copy some test IDs from BWTest.lst.ORIG
|
||||
to your custom file(for example custom.lst) and type <B>perl autorun.pl -f custom.lst</B>
|
||||
</UL>
|
||||
<div align=right><A href=#top>index</A></div>
|
||||
<A name=log>
|
||||
<LI>Log files:
|
||||
<UL>
|
||||
<LI>After tests execution all logs located in the <B>TEST_TOP_DIR/log</B> directory
|
||||
<LI>BWTestRun.log contains comments and results from test and test loader
|
||||
<LI>BWTestRun.txt contains status for each test, e.g. PASSED or FAILED
|
||||
<LI>File test_name.log contains Mozilla's output
|
||||
</UL>
|
||||
</OL>
|
||||
<div align=right><A href=#top>index</A></div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user