QA/Execution/Web Testing/Docs/Automation/Testcases/AMO POM Libraries/amo page class: Difference between revisions

← Older edit

QA/Execution/Web Testing/Docs/Automation/Testcases/AMO POM Libraries/amo page class (view source)

Revision as of 07:27, 1 November 2010

34 bytes removed , 1 November 2010

→‎Actions

Twsmith

1,072

edits

@@ Line 1: / Line 1: @@
 = amo_page class =
-=== Actions ===
+=== Actions  ===
 '''go_to_app_home_page()'''
-* Clicks on the application home page link in the page header.
+*Clicks on the application home page link in the page header.
 '''go_to_application(''app_name'')'''
-* Go to a Mozilla application home page specified by ''app_name''.  If ''app_name'' is the current application (i.e. ''app_name'' is in the current page's URL) the home page link in the page header is clicked.  If ''app_name'' isn't in the current page URL the application link in the page header is clicked.
+*Go to a Mozilla application home page specified by ''app_name''. If ''app_name'' is the current application (i.e. ''app_name'' is in the current page's URL) the home page link in the page header is clicked. If ''app_name'' isn't in the current page URL the application link in the page header is clicked.
-'''go_to_extensions_category_by_index(''category_index'')
-* Click on the category specified by ''category_index'' from the category list in the sidebar. ''category_index'' is assumed to be an integer starting from 1.
+'''go_to_extensions_category_by_index(''category_index'')'''
-'''go_to_themes_landing(''themes_landing_page_object'')'''
+*Click on the category specified by ''category_index'' from the category list in the sidebar. ''category_index'' is assumed to be an integer starting from 1.
-* Click on the Themes link from sidebar menu.  To verify that the themes landing page was opened the verify_themes_landing_page_is_present() method is called from ''themes_landing_page_object'', which is assumed to be a ThemesLandingPage object.
+'''go_to_themes_landing(''themes_landing_page_object'')'''
-'''go_to_collections_directory(''collections_directory_page_object'')'''
-* Click on the Collections link from sidebar menu.  To verify that the collection landing page was opened the verify_collections_directory_page_is_present() is called from ''collections_directory_page_object'', which is assumed to be a CollectionsDiretoryPage object.
+*Click on the Themes link from sidebar menu. To verify that the themes landing page was opened the verify_themes_landing_page_is_present() method is called from ''themes_landing_page_object'', which is assumed to be a ThemesLandingPage object.
-'''go_to_personas_landing(''personas_landing_page_object'')'''
-* Click on the Personas link from sidebar menu.  To verify that the the personas landing page was opened the verify_personas_landing_page_is_present() method is called from ''personas_landing_page_object'', which is assumed to be a PersonasLandingPage object.
-'''go_back_to_previous_page(''previous_page_check'', ''previous_page_name'')'''
+'''go_to_collections_directory(''collections_directory_page_object'')'''
-* Call the Selenium go_back() method which simulates selecting the Back button on the browser.  ''previous_page_check'' is the name of a method which verifies the page expected after the go_back command.  The ''previous_page_check'' method is expected to return True if the page is present, otherwise False.  ''previous_page_check'' is passed without () so that it isn't executed when the parameters values are passed to '''go_back_to_previous_page'''.  When ''previous_page_check'' returns False an exception is thrown containing ''previous_page_name'' and text from the top of the page.
+*Click on the Collections link from sidebar menu. To verify that the collection landing page was opened the verify_collections_directory_page_is_present() is called from ''collections_directory_page_object'', which is assumed to be a CollectionsDiretoryPage object.
-'''submit_search_query_from_page_header(''search_results_page_object'', ''results_expected'', ... )'''
+'''go_to_personas_landing(''personas_landing_page_object'')'''
-* Submit a search query from the page header search panel. To verify whether any search results were returned the presence is checked for certain elements defined in ''search_results_page_object'', which is assumed to be a SearchResultsPage object.  If the parameter ''results_expected'' is True the presence of at least one search result element is expected.  If ''results_expected'' is False the search results message element is expected with the text 'no results found', case-insensitive.  The method returns no value if the expected element is present.  If the expected element is not present an exception is thrown with text from the top of the page.
+*Click on the Personas link from sidebar menu. To verify that the the personas landing page was opened the verify_personas_landing_page_is_present() method is called from ''personas_landing_page_object'', which is assumed to be a PersonasLandingPage object.
-* Search criteria is specified with the following parameters:
+'''go_back_to_previous_page(''previous_page_check'', ''previous_page_name'')'''
-** query_text: text typed into query form search value
-** category_option: category option to select
-** version_option: version option to select
-** type_option: add-on type option to select
-** platform_option: platform to select
-** last_updated_option: Last Updated date range option to select
-** per_page_option: Per Page option to select
-** sort_option: sort option to select
-* Parameter and values are specified using 'name=value' format, ex: queryText=abc.
+*Call the Selenium go_back() method which simulates selecting the Back button on the browser. ''previous_page_check'' is the name of a method which verifies the page expected after the go_back command. The ''previous_page_check'' method is expected to return True if the page is present, otherwise False. ''previous_page_check'' is passed without () so that it isn't executed when the parameters values are passed to '''go_back_to_previous_page'''. When ''previous_page_check'' returns False an exception is thrown containing ''previous_page_name'' and text from the top of the page.
-The value with query_text is passed to selenium.type() as the value parameter.  The value with the *_option parameters are passed to selenium.select() as the optionLocator parameter.
-* Examples:
+'''submit_search_query_from_page_header(''search_results_page_object'', ''results_expected'', ... )'''
-** To submit a search with the query term 'firefox sync' and sort option 'name': submit_search_query_from_page_header(search_results_page, query_text='firefox sync', sort_option='name'), where search_results_page is an instance of the SearchResultsPage class.
-** To submit a search which is expected to return no results: submit_search_query_from_page_header(search_results_page, results_expected=False, query_text='itwasadarkandstormynight'), where the query text is not expected to match anything.
+*Submit a search query from the page header search panel. To verify whether any search results were returned the presence is checked for certain elements defined in ''search_results_page_object'', which is assumed to be a SearchResultsPage object. If the parameter ''results_expected'' is True the presence of at least one search result element is expected. If ''results_expected'' is False the search results message element is expected with the text 'no results found', case-insensitive. The method returns no value if the expected element is present. If the expected element is not present an exception is thrown with text from the top of the page.
+*Search criteria is specified with the following parameters:
+**query_text: text typed into query form search value
+**category_option: category option to select
+**version_option: version option to select
+**type_option: add-on type option to select
+**platform_option: platform to select
+**last_updated_option: Last Updated date range option to select
+**per_page_option: Per Page option to select
+**sort_option: sort option to select
+*Parameter and values are specified using 'name=value' format, ex: queryText=abc.&nbsp; The value with query_text is passed to selenium.type() as the value parameter. The value with any *_option parameter is passed to selenium.select() as the optionLocator parameter.
+*Examples:
+**To submit a search with the query term 'firefox sync' and sort option 'name': submit_search_query_from_page_header(search_results_page, query_text='firefox sync', sort_option='name'), where search_results_page is an instance of the SearchResultsPage class.
+**To submit a search which is expected to return no results: submit_search_query_from_page_header(search_results_page, results_expected=False, query_text='itwasadarkandstormynight'), where the query text is not expected to match anything.