diff options
Diffstat (limited to 'tests/test_tools/simpletest/frames.php')
| -rw-r--r-- | tests/test_tools/simpletest/frames.php | 241 |
1 files changed, 78 insertions, 163 deletions
diff --git a/tests/test_tools/simpletest/frames.php b/tests/test_tools/simpletest/frames.php index 75951476..8eefbe8d 100644 --- a/tests/test_tools/simpletest/frames.php +++ b/tests/test_tools/simpletest/frames.php @@ -3,7 +3,7 @@ * Base include file for SimpleTest * @package SimpleTest * @subpackage WebTester - * @version $Id: frames.php,v 1.29 2004/11/30 05:33:56 lastcraft Exp $ + * @version $Id: frames.php,v 1.39 2005/09/09 01:42:29 lastcraft Exp $ */ /**#@+ @@ -12,7 +12,7 @@ require_once(dirname(__FILE__) . '/page.php'); require_once(dirname(__FILE__) . '/user_agent.php'); /**#@-*/ - + /** * A composite page. Wraps a frameset page and * adds subframes. The original page will be @@ -26,7 +26,7 @@ protected $_frames; protected $_focus; protected $_names; - + /** * Stashes the frameset page. Will make use of the * browser to fetch the sub frames recursively. @@ -38,7 +38,7 @@ $this->_focus = false; $this->_names = array(); } - + /** * Adds a parsed page to the frameset. * @param SimplePage $page Frame page. @@ -51,7 +51,7 @@ $this->_names[$name] = count($this->_frames) - 1; } } - + /** * Replaces existing frame with another. If the * frame is nested, then the call is passed down @@ -73,7 +73,7 @@ } $this->_frames[$index]->setFrame($path, $page); } - + /** * Accessor for current frame focus. Will be * false if no frame has focus. Will have the nested @@ -89,7 +89,7 @@ array($this->_getPublicNameFromIndex($this->_focus)), $this->_frames[$this->_focus]->getFrameFocus()); } - + /** * Turns an internal array index into the frames list * into a public name, or if none, then a one offset @@ -106,7 +106,7 @@ } return $subject + 1; } - + /** * Sets the focus by index. The integer index starts from 1. * If already focused and the target frame also has frames, @@ -127,7 +127,7 @@ $this->_focus = $choice - 1; return true; } - + /** * Sets the focus by name. If already focused and the * target frame also has frames, then the nested frame @@ -148,7 +148,7 @@ } return false; } - + /** * Clears the frame focus. * @access public @@ -157,7 +157,7 @@ $this->_focus = false; $this->_clearNestedFramesFocus(); } - + /** * Clears the frame focus for any nested frames. * @access private @@ -167,7 +167,7 @@ $this->_frames[$i]->clearFrameFocus(); } } - + /** * Test for the presence of a frameset. * @return boolean Always true. @@ -176,7 +176,7 @@ function hasFrames() { return true; } - + /** * Accessor for frames information. * @return array/string Recursive hash of frame URL strings. @@ -192,7 +192,7 @@ } return $report; } - + /** * Accessor for raw text of either all the pages or * the frame in focus. @@ -209,7 +209,7 @@ } return $raw; } - + /** * Accessor for plain text of either all the pages or * the frame in focus. @@ -226,7 +226,7 @@ } return trim($raw); } - + /** * Accessor for last error. * @return string Error from last response. @@ -238,7 +238,7 @@ } return $this->_frameset->getTransportError(); } - + /** * Request method used to fetch this frame. * @return string GET, POST or HEAD. @@ -250,7 +250,7 @@ } return $this->_frameset->getMethod(); } - + /** * Original resource name. * @return SimpleUrl Current url. @@ -265,7 +265,7 @@ } return $url; } - + /** * Original request data. * @return mixed Sent content. @@ -277,7 +277,7 @@ } return $this->_frameset->getRequestData(); } - + /** * Accessor for current MIME type. * @return string MIME type as string; e.g. 'text/html' @@ -289,7 +289,7 @@ } return $this->_frameset->getMimeType(); } - + /** * Accessor for last response code. * @return integer Last HTTP response code received. @@ -301,7 +301,7 @@ } return $this->_frameset->getResponseCode(); } - + /** * Accessor for last Authentication type. Only valid * straight after a challenge (401). @@ -314,7 +314,7 @@ } return $this->_frameset->getAuthentication(); } - + /** * Accessor for last Authentication realm. Only valid * straight after a challenge (401). @@ -327,7 +327,7 @@ } return $this->_frameset->getRealm(); } - + /** * Accessor for outgoing header information. * @return string Header block. @@ -339,7 +339,7 @@ } return $this->_frameset->getRequest(); } - + /** * Accessor for raw header information. * @return string Header block. @@ -351,7 +351,7 @@ } return $this->_frameset->getHeaders(); } - + /** * Accessor for parsed title. * @return string Title or false if no title is present. @@ -360,7 +360,7 @@ function getTitle() { return $this->_frameset->getTitle(); } - + /** * Accessor for a list of all fixed links. * @return array List of urls with scheme of @@ -377,7 +377,7 @@ } return array_values(array_unique($urls)); } - + /** * Accessor for a list of all relative links. * @return array List of urls without hostname. @@ -393,7 +393,7 @@ } return array_values(array_unique($urls)); } - + /** * Accessor for URLs by the link label. Label will match * regardess of whitespace issues and case. @@ -417,7 +417,7 @@ } return $urls; } - + /** * Accessor for a URL by the id attribute. If in a frameset * then the first link found with that ID attribute is @@ -438,7 +438,7 @@ } return false; } - + /** * Attaches the intended frame index to a list of URLs. * @param array $urls List of SimpleUrls. @@ -456,85 +456,35 @@ } return $tagged; } - - /** - * Finds a held form by button label. Will only - * search correctly built forms. The first form found - * either within the focused frame, or across frames, - * will be the one returned. - * @param string $label Button label, default 'Submit'. - * @return SimpleForm Form object containing the button. - * @access public - */ - function getFormBySubmitLabel($label) { - return $this->_findForm('getFormBySubmitLabel', $label); - } - + /** * Finds a held form by button label. Will only - * search correctly built forms. The first form found - * either within the focused frame, or across frames, - * will be the one returned. - * @param string $name Button name attribute. - * @return SimpleForm Form object containing the button. + * search correctly built forms. + * @param SimpleSelector $selector Button finder. + * @return SimpleForm Form object containing + * the button. * @access public */ - function getFormBySubmitName($name) { - return $this->_findForm('getFormBySubmitName', $name); - } - - /** - * Finds a held form by button id. Will only - * search correctly built forms. The first form found - * either within the focused frame, or across frames, - * will be the one returned. - * @param string $id Button ID attribute. - * @return SimpleForm Form object containing the button. - * @access public - */ - function getFormBySubmitId($id) { - return $this->_findForm('getFormBySubmitId', $id); - } - - /** - * Finds a held form by image label. Will only - * search correctly built forms. The first form found - * either within the focused frame, or across frames, - * will be the one returned. - * @param string $label Usually the alt attribute. - * @return SimpleForm Form object containing the image. - * @access public - */ - function getFormByImageLabel($label) { - return $this->_findForm('getFormByImageLabel', $label); - } - - /** - * Finds a held form by image button id. Will only - * search correctly built forms. The first form found - * either within the focused frame, or across frames, - * will be the one returned. - * @param string $name Image name. - * @return SimpleForm Form object containing the image. - * @access public - */ - function getFormByImageName($name) { - return $this->_findForm('getFormByImageName', $name); + function &getFormBySubmit($selector) { + $form = $this->_findForm('getFormBySubmit', $selector); + return $form; } - + /** - * Finds a held form by image button id. Will only - * search correctly built forms. The first form found - * either within the focused frame, or across frames, - * will be the one returned. - * @param string $id Image ID attribute. - * @return SimpleForm Form object containing the image. + * Finds a held form by image using a selector. + * Will only search correctly built forms. The first + * form found either within the focused frame, or + * across frames, will be the one returned. + * @param SimpleSelector $selector Image finder. + * @return SimpleForm Form object containing + * the image. * @access public */ - function getFormByImageId($id) { - return $this->_findForm('getFormByImageId', $id); + function &getFormByImage($selector) { + $form = $this->_findForm('getFormByImage', $selector); + return $form; } - + /** * Finds a held form by the form ID. A way of * identifying a specific form when we have control @@ -545,25 +495,27 @@ * @return SimpleForm Form object containing the matching ID. * @access public */ - function getFormById($id) { - return $this->_findForm('getFormById', $id); + function &getFormById($id) { + $form = $this->_findForm('getFormById', $id); + return $form; } - + /** * General form finder. Will search all the frames or * just the one in focus. * @param string $method Method to use to find in a page. * @param string $attribute Label, name or ID. * @return SimpleForm Form object containing the matching ID. - * @access protected + * @access private */ - function _findForm($method, $attribute) { + function &_findForm($method, $attribute) { if (is_integer($this->_focus)) { - return $this->_findFormInFrame( + $form = $this->_findFormInFrame( $this->_frames[$this->_focus], $this->_focus, $method, $attribute); + return $form; } for ($i = 0; $i < count($this->_frames); $i++) { $form = $this->_findFormInFrame( @@ -575,9 +527,10 @@ return $form; } } - return null; + $null = null; + return $null; } - + /** * Finds a form in a page using a form finding method. Will * also tag the form with the frame name it belongs in. @@ -586,83 +539,45 @@ * @param string $method Method to use to find in a page. * @param string $attribute Label, name or ID. * @return SimpleForm Form object containing the matching ID. - * @access protected + * @access private */ - function _findFormInFrame($page, $index, $method, $attribute) { + function &_findFormInFrame($page, $index, $method, $attribute) { $form = $this->_frames[$index]->$method($attribute); if (isset($form)) { $form->setDefaultTarget($this->_getPublicNameFromIndex($index)); } return $form; } - + /** * Sets a field on each form in which the field is * available. - * @param string $name Field name. - * @param string $value Value to set field to. - * @return boolean True if value is valid. - * @access public - */ - function setField($name, $value) { - if (is_integer($this->_focus)) { - $this->_frames[$this->_focus]->setField($name, $value); - } else { - for ($i = 0; $i < count($this->_frames); $i++) { - $this->_frames[$i]->setField($name, $value); - } - } - } - - /** - * Sets a field on the form in which the unique field is - * available. - * @param string/integer $id Field ID attribute. - * @param string $value Value to set field to. - * @return boolean True if value is valid. + * @param SimpleSelector $selector Field finder. + * @param string $value Value to set field to. + * @return boolean True if value is valid. * @access public */ - function setFieldById($id, $value) { + function setField($selector, $value) { if (is_integer($this->_focus)) { - $this->_frames[$this->_focus]->setFieldById($id, $value); + $this->_frames[$this->_focus]->setField($selector, $value); } else { for ($i = 0; $i < count($this->_frames); $i++) { - $this->_frames[$i]->setFieldById($id, $value); + $this->_frames[$i]->setField($selector, $value); } } } - - /** - * Accessor for a form element value within a frameset. - * Finds the first match amongst the frames. - * @param string $name Field name. - * @return string/boolean A string if the field is - * present, false if unchecked - * and null if missing. - * @access public - */ - function getField($name) { - for ($i = 0; $i < count($this->_frames); $i++) { - $value = $this->_frames[$i]->getField($name); - if (isset($value)) { - return $value; - } - } - return null; - } - + /** * Accessor for a form element value within a page. - * Finds the first match. - * @param string/integer $id Field ID attribute. - * @return string/boolean A string if the field is - * present, false if unchecked - * and null if missing. + * @param SimpleSelector $selector Field finder. + * @return string/boolean A string if the field is + * present, false if unchecked + * and null if missing. * @access public */ - function getFieldById($id) { + function getField($selector) { for ($i = 0; $i < count($this->_frames); $i++) { - $value = $this->_frames[$i]->getFieldById($id); + $value = $this->_frames[$i]->getField($selector); if (isset($value)) { return $value; } |