ऑटोमेशन कोडेसेप्शन + घेरकिन + पेजऑब्जेक्ट सबसे छोटे के लिए

इंटरनेट पर कोडप्शन के लिए पेज ऑब्जेक्ट डिज़ाइन पैटर्न के साथ घेरकिन कार्यान्वयन का एक भी ठोस उदाहरण नहीं मिला है, मैंने सोचा कि इस पैटर्न के हमारे अपने कार्यान्वयन के बारे में इंटरनेट को बताने के लिए जगह से बाहर नहीं होगा।

यह आलेख उन लोगों के लिए अधिक लक्षित है जो पहले से ही कोडेप्शन या समान रूपरेखाओं से थोड़ा परिचित हैं, लेकिन अभी तक यह नहीं जानते हैं कि परीक्षण को अधिक पठनीय बनाने के लिए टेस्ट ऑब्जेक्ट का उपयोग कैसे करें, उनके समर्थन को सरल करें और अतिरिक्त कोड की मात्रा को कम करें। फिर भी, मैंने स्क्रैच से स्वचालन परियोजना को इकट्ठा करने के सभी मुख्य बिंदुओं को समझाने की कोशिश की।

पृष्ठ ऑब्जेक्ट टेम्पलेट आपको पृष्ठ तत्वों के साथ काम को इनकैप्सुलेट करने की अनुमति देता है, जो बदले में आपको कोड की मात्रा कम करने और इसके समर्थन को सरल बनाने की अनुमति देता है। UI में सभी परिवर्तन आसानी से और जल्दी से लागू होते हैं - बस पृष्ठ ऑब्जेक्ट वर्ग को अपडेट करें जो इस पृष्ठ का वर्णन करता है। इस वास्तुशिल्प दृष्टिकोण का एक और महत्वपूर्ण लाभ यह है कि यह आपको विवरण के साथ HTML परीक्षण स्क्रिप्ट को अव्यवस्थित करने की अनुमति नहीं देता है, जो इसे समझने के लिए अधिक समझने योग्य और सरल बनाता है।

पृष्ठ ऑब्जेक्ट का उपयोग किए बिना परीक्षण कैसा दिखता है



पेज ऑब्जेक्ट का उपयोग करना



मैं मूल वातावरण स्थापित करने पर ध्यान नहीं दूंगा, मैं अपना प्रारंभिक डेटा दूंगा:

• उबुनियन बायोनिक बीवर
• PHP 7.1.19-1
• संगीतकार - PHP के लिए निर्भरता प्रबंधन प्रबंधक, विश्व स्तर पर स्थापित
• PhpStorm - विकास पर्यावरण

परीक्षण चलाने के लिए, हमें भी आवश्यकता है:

• Chromedriver 2.41 (लिंक न केवल डाउनलोड कर सकता है, बल्कि यह भी देख सकता है कि कौन सा ड्राइवर आपके क्रोम के संस्करण से मेल खाता है)
• क्रोम 67.0.3396.99
• सेलेनियम-सर्वर-स्टैंडअलोन-3.14.0 (ubuntu पर सेलेनियम स्थापित करने पर लेख)

विस्तृत करें कोड अपवाद

संहिता स्थापित करने के लिए आगे बढ़ें:

हम उस टर्मिनल में खोलते हैं, जिस निर्देशिका की हमें आवश्यकता होती है, जहाँ हम परियोजना एकत्र करेंगे, या परियोजना के लिए एक निर्देशिका बनाएँ और उसमें जाएँ:

mkdir ProjectTutorial cd ProjectTutorial 

कोड ढाँचा और उसकी निर्भरताएँ स्थापित करें:

 composer require codeception/codeception --dev 

इस परियोजना में कंपोज़र.जॉन निर्भरता स्थापना फ़ाइल इस तरह दिखाई देगी:

 { "require": { "php": ">=5.6.0 <8.0", "facebook/webdriver": ">=1.1.3 <2.0", "behat/gherkin": "^4.4.0", "codeception/phpunit-wrapper": "^6.0.9|^7.0.6" }, "require-dev": { "codeception/codeception": "^2.5", "codeception/base": "^2.5" } } 

परियोजना का विस्तार करें:

 php vendor/bin/codecept bootstrap 

परियोजना को स्थापित करने के तरीके के बारे में अधिक जानकारी आधिकारिक दस्तावेज में पाई जा सकती है।

इस स्तर पर, हमारी परियोजना में परीक्षणों के तीन सेट बनाए गए हैं। डिफ़ॉल्ट रूप से, कोडेप्शन उन्हें स्वीकृति, कार्यात्मक और इकाई में विभाजित करता है। इन सेटों के लिए, कोडसेप्शन तीन yml फाइलें भी बनाता है। उनमें हम सभी आवश्यक कॉन्फ़िगरेशन इंगित करते हैं, हमारे परीक्षणों को चलाने के लिए मॉड्यूल और गुणों को जोड़ते हैं।

यह पाठ स्वीकृति परीक्षण के उदाहरण पर बनाया गया है, इसलिए मैं सेटिंग्स को Acceptance.suite.yml में दे दूंगा।

PHP तूफान (या एक अन्य पसंदीदा विकास पर्यावरण) में हमारी परियोजना खोलें और Acceptance.suite.yml पर जाएं (डिफ़ॉल्ट रूप से, यह परीक्षण / स्वीकृति में निहित है ।suite.yml फ़ोल्डर)।
हम न्यूनतम आवश्यक निर्भरता लिखते हैं और हमेशा स्वरूपण पर ध्यान देते हैं। मॉड्यूल एक "-" संकेत द्वारा अलग किए जाते हैं और समान स्तर पर होने चाहिए, अन्यथा परीक्षण शुरू होने पर त्रुटियां छिड़केंगी।

यह पता चला है:

 actor: AcceptanceTester modules: enabled: - WebDriver: url: 'http://yandex.ru/' //    ,        browser: 'chrome' - \Helper\Acceptance //          gherkin: contexts: default: - AcceptanceTester 

और कुछ और प्रारंभिक कार्य:

प्रोजेक्ट रूट में एक अलग निर्देशिका बनाएं (मेरे पास लिब है)।
इस निर्देशिका में, निष्पादन योग्य फ़ाइल run.sh बनाएँ, जो सेलेनियम और क्रोम ड्राइवर चलाएगा।

हम यहां सेलेनियम और क्रोम ड्राइवर रखते हैं, और रन कमांड को रन.श में लिखते हैं:

 java -jar -Dwebdriver.chrome.driver=chromedriver_241 selenium-server-standalone-3.14.0.jar 

यह परियोजना में कैसा दिखता है:



हम कंसोल पर लौटते हैं और एक्सेस अधिकारों को बदलते हैं:

 chmod +x ./run.sh 

(नोट। डायरेक्टरी में झूठ बोलने वाले ड्राइवरों के नाम, स्टार्ट कमांड में निर्दिष्ट उन लोगों से अवश्य मेल खाना चाहिए)।

आप सेलेनियम और वेबड्राइवर अभी शुरू कर सकते हैं ताकि इस पर वापस न आएं। ऐसा करने के लिए, एक नया टर्मिनल टैब खोलें, उस निर्देशिका पर जाएं जहां run.sh फ़ाइल निहित है और लॉन्च कमांड लिखें:

 ~/AutomationProjects/ProjectTutorial/lib$ ./run.sh 

सुनिश्चित करें कि सर्वर चल रहा है:



हम इसे चालू अवस्था में छोड़ देते हैं। इस पर तैयारी पूरी हो गई है।

टेस्ट स्क्रिप्ट लिखना

हम अपने परीक्षण मामले के लिए एक सुविधा फ़ाइल बनाने के लिए आगे बढ़ते हैं। ऐसा करने के लिए, एक विशेष कमांड कोडेप्शन में दी गई है, इसे कंसोल में चलाएं:

 cept g:feature acceptance check 

(नोट "जांच" - मेरे परीक्षण का नाम)

हम स्वीकृति फ़ोल्डर में नई check.feature फ़ाइल देखते हैं।



हमें डिफ़ॉल्ट सामग्री की आवश्यकता नहीं है, हम तुरंत इसे हटा देते हैं और अपना परीक्षण लिखते हैं।

कलेक्टर को सिरिलिक वर्णमाला को पहचानने के लिए, स्क्रिप्ट को # भाषा: आरयू के साथ शुरू करना न भूलें।
हम रूसी में एक छोटी स्क्रिप्ट लिख रहे हैं। मैं आपको याद दिलाता हूं कि प्रत्येक वाक्य को कीवर्ड के साथ शुरू होना चाहिए: "जब", "फिर", "और", प्रतीक "*", आदि।

मेरे उदाहरण के लिए, मैंने यैंडेक्स वेबसाइट ली, आप कोई भी ले सकते हैं।



यह देखने के लिए कि परीक्षण में कौन से चरण हैं, हम टर्मिनल में अपनी स्क्रिप्ट चलाते हैं:

 cept dry-run acceptance check.feature 

स्क्रिप्ट के चरण कंसोल में प्रदर्शित होते हैं, लेकिन उनका कार्यान्वयन अभी तक उपलब्ध नहीं है।

फिर हम एक कमांड चलाते हैं जो स्वचालित रूप से हमारे तरीकों को लागू करने के लिए टेम्पलेट उत्पन्न करेगा:

 cept gherkin:snippets acceptance 

स्क्रिप्ट के सभी नाम जो उद्धरण चिह्नों में थे, उन्हें चर के साथ बदल दिया गया है: arg।
हम उन्हें टर्मिनल से कॉपी करते हैं और उन्हें AcceptanceTester.php फ़ाइल में पेस्ट करते हैं, जहां पृष्ठ तत्वों के साथ काम करने के तरीके झूठ होंगे।



पढ़ने योग्य लोगों के तरीकों का नाम बदलें, उनके सार (वैकल्पिक) को दर्शाते हैं, और उनके कार्यान्वयन को लिखते हैं।



सब कुछ सरल है, लेकिन इससे भी आसान अगर आप स्मार्ट विकास के माहौल में काम कर रहे हैं, जैसे कि तूफान, जो खुद पुस्तकालय के लिए आवश्यक आदेशों का संकेत देगा:



हम अतिरिक्त हटाते हैं और तरीके लिखते हैं:

 /** * @When      */ public function step_beingOnMainPage($page) { $this->amOnPage('/'); } /** * @Then    :element */ public function step_seeElement($element) { this->seeElement($element); } /** * @Then    :button */ public function step_clickOnButton($button) { $this->click($button); } /** * @Then    :field  :text */ public function step_fillField($field, $text) { $this->fillField($field, $text); } 

आइए देखें क्या हुआ। हम एक टीम लॉन्च करते हैं जो हमें दिखाएगी कि कौन से तरीके (स्टेप) अब हमारे पास लागू हैं।

 cept gherkin:steps acceptance 

सफलता!

लेकिन फ़ीचर फ़ाइल के चरण अभी भी विधियों के रूप में पहचाने नहीं गए हैं।



स्टॉर्म के लिए यह समझने के लिए कि चरणों के साथ क्या करना है, हम एक ट्रिक करेंगे जो नेमस्पेस गेरकिन कॉनटेक्स्ट से प्रसंग इंटरफ़ेस को लागू करने के साथ।

 namespace Behat\Behat\Context { interface Context {} } 

हमारे एक्सेप्टेंसटेस्टर वर्ग को नेमस्पेस में लपेटें और संदर्भ से विरासत में लें

 implements \Behat\Behat\Context\Context 

अब फ़ीचर फ़ाइल के सभी चरण उनके कार्यान्वयन से बंधे हैं:



वेबड्राइवर को समझने के लिए कि किस पर क्लिक करना है और कहां देखना है, आपको पढ़ने योग्य तत्व के नाम और पेज के पते को संबंधित लोकेटर और यूआरएल के साथ बदलना होगा, जो तर्कों के रूप में तरीकों में आ जाएंगे।

फिर हमें फॉर्म का परीक्षण मिलता है:



और आप चला सकते हैं:

 cept run acceptance 

पारित कर दिया।

लगभग। यदि पृष्ठ तत्व लोड होने में लंबा समय लेते हैं, तो आप प्रतीक्षा को वांछित विधि में जोड़ सकते हैं:

 $this->waitForElementVisible($element); 

हम अपने परीक्षण परिदृश्य पर लौटते हैं। हम परेशान हैं कि परीक्षण की पूरी पठनीयता इस तथ्य के कारण खो गई है कि तत्वों और पृष्ठों के स्पष्ट नामों के बजाय, हम एचटीएमएल तत्वों और यूआरएल को देखते हैं।

यदि हम इसे ठीक करना चाहते हैं, तो पृष्ठ ऑब्जेक्ट पैटर्न के कार्यान्वयन के लिए आगे बढ़ने का समय है।

पेज ऑब्जेक्ट पर जाएं

_Support निर्देशिका में, पृष्ठ निर्देशिका बनाएं, जहां हम अपनी कक्षा के पृष्ठ डालेंगे:

 php vendor/bin/codecept generate:pageobject MainPage 

पहला पेज ऑब्जेक्ट यैंडेक्स का मुख्य पेज है, इसे मेनपेज कहते हैं, हम क्लास को उसी के नाम से बुलाएंगे:



यहाँ हम स्थैतिक क्षेत्र और विधियाँ घोषित करते हैं ताकि उन्हें एक वस्तु बनाए बिना बुलाया जा सके।

चूंकि Acceptance.suite.yml के कॉन्फ़िगरेशन में हमने पहले से ही प्रारंभ पृष्ठ url निर्दिष्ट किया है: yandex.ru , मुख्य पृष्ठ के लिए यह निर्दिष्ट करने के लिए पर्याप्त होगा

 public static $URL = '/'; 

इसके बाद पृष्ठ तत्वों की एक सरणी आती है। हम कई तत्वों के लिए लोकेटरों का वर्णन करते हैं और उन्हें स्पष्ट और अद्वितीय नाम देते हैं।

अब आपको getElement मेथड जोड़ना होगा, जो एरे से एलिमेंट के नाम से लोकेटर लौटाएगा।

परिणामस्वरूप, हमारे पास:

 <?php //location: tests/_support/Page/MainPage.php namespace Page; /**   */ class MainPage { public static $URL = '/'; public static $elements = array( ' ' => "//*[@id='wd-wrapper-_afisha']", ' ' => "//*[@data-statlog='afisha.title.link']", ' ' => "//*[@class='weather__icon weather__icon_ovc']|//*[@class='weather__icon weather__icon_skc_d']", ); public static function getElement($name){ return self::$elements[$name]; } } 

पेज कक्षाओं के एक जोड़े को जोड़ें:

/ ** पोस्टर * /



/ ** पोस्टर - खोज परिणाम * /



हम AcceptanceTester.php वर्ग में लौटते हैं, जहाँ हमने अपने तरीके लिखे हैं।
आइए इसे पेजऑब्जेक्ट कक्षाओं की एक सरणी बनाते हैं, जहाँ हम पृष्ठों को नामों को निर्दिष्ट करेंगे और उनके वर्ग नामों को नामस्थान में दर्शाएँगे:

  private $pages = array( " " => "\Page\MainPage", "" => "\Page\AfishaPage", " -  " => "\Page\AfishaResult" ); 

प्रत्येक नया PageObject इसी प्रकार इस सरणी में जोड़ा जाता है।

इसके बाद, हमें currentPage फ़ील्ड बनाने की आवश्यकता है, जो लिंक को वर्तमान पृष्ठ के PageObject में संग्रहीत करेगा:

 private $currentPage; 

अब हम एक विधि लिखते हैं, जब बुलाया जाता है, तो हम करंटपेज प्राप्त कर सकते हैं और उस पेजऑब्जेक्ट को आरंभ कर सकते हैं जिसकी हमें आवश्यकता है।

"जब पृष्ठ उपयोगकर्ता नाम" पृष्ठ पर पहुँच जाता है, तो इस विधि का उपयोग करके इस तरह का कदम उठाना तर्कसंगत है। तब जांच के बिना PageObject वर्ग को इनिशियलाइज़ करने का सबसे सरल तरीका इस प्रकार होगा:

 /** * @When     :page */ public function step_beingOn($page) { //   pageObject $this->currentPage = $this->pages[$page]; } 

अब हम getPageElement विधि लिखते हैं, जो हमें वर्तमान पृष्ठ से तत्व, या इसके लोकेटर को प्राप्त करने की अनुमति देगा:

 private function getPageElement($elementName) { //         $curPage = $this->currentPage; return $curPage::getElement($elementName); } 

पहले से लागू किए गए तरीकों के लिए, यह आवश्यक है कि हम पेजऑबजेक्ट के तत्वों के साथ शुरुआत में फ़ीचर टेक्स्ट से सीधे प्राप्त होने वाले तर्कों को प्रतिस्थापित करें:

 $arg 

रूप ले लेगा

 getPageElement($arg)) 

फिर हमारी विधियाँ फार्म लेंगी:

 /** * @When     :page */ public function step_beingOnMainPage($page) { //      pageObject $this->currentPage = $this->pages[$page]; $curPage = $this->currentPage; $this->amOnPage($curPage::$URL); } /** * @Then    :element */ public function step_seeElement($element) { $this->waitForElementVisible($this->getPageElement($element)); $this->seeElement($this->getPageElement($element)); } /** * @Then    :button */ public function step_clickOnButton($button) { $this->click($this->getPageElement($button)); } /** * @Then    :field  :text */ public function step_fillField($field, $text) { $this->fillField($this->getPageElement($field), $text); } /** * @Then      :field */ public function step_deleteText($field) { $this->clearField($this->getPageElement($field)); } 

Enter दबाकर खोज परिणाम प्रदर्शित करने के लिए एक और तरीका जोड़ा गया:

 /** * @Then    ENTER */ public function step_keyboardButton() { $this->pressKey('//input',WebDriverKeys::ENTER); } 

अंतिम चरण तब है जब सभी आवश्यक तरीकों और पेजऑब्जेक्ट्स का वर्णन किया गया है, आपको स्वयं परीक्षण को फिर से तैयार करने की आवश्यकता है। नए पृष्ठ पर जाते समय PageObject को इनिशियलाइज़ करने वाले चरणों को जोड़ें। हमारे पास यह "* उपयोगकर्ता पृष्ठ पर गया: पृष्ठ" है।

स्पष्टता के लिए, मैं कुछ और कदम जोड़ूंगा। परिणाम इस परीक्षण है:

 #language: ru :     :   .    .   .      " "     " "     " "     " "      ""     " "  " "     ENTER      " -  "     "   "       " "     " "  ""     ENTER 

ऐसा परीक्षण परिदृश्य किसी भी बाहरी व्यक्ति के लिए समझने योग्य और पठनीय है।

भागो!

अधिक विस्तृत रन परिणाम देखने के लिए, आप कमांड का उपयोग कर सकते हैं

 cept run acceptance --debug 

हम परिणाम को देखते हैं:



इस प्रकार, पेज ऑब्जेक्ट पैटर्न का उपयोग करने से आप सभी पृष्ठ तत्वों को परीक्षण स्क्रिप्ट से अलग कर सकते हैं और उन्हें एक अलग निर्देशिका में संग्रहीत कर सकते हैं।

परियोजना को स्वयं https://github.com/Remneva/ProjectTutorial पर पाया जा सकता है

एक शुरुआत स्वचालन इंजीनियर के रूप में, मैं आभारी रहूंगा यदि आप अपने विचारों को साझा करते हैं और, शायद, मुझे बताएं कि प्रोजेक्ट संरचना को तार्किक रूप से यथासंभव कैसे बदलना और सरल करना है।