Სალამი ყველას. ჩვენ ნელ-ნელა გამოვდივართ ჩრდილიდან და ვაგრძელებთ სტატიების სერიას ჩვენი პროდუქტის შესახებ. შემდეგ წინა მიმოხილვის სტატია, მივიღეთ ბევრი გამოხმაურება (ძირითადად დადებითი), წინადადებები და შეცდომების შესახებ მოხსენებები. დღეს ჩვენ გაჩვენებთ TestMace მოქმედებაში და თქვენ შეძლებთ დააფასოთ ჩვენი აპლიკაციის ზოგიერთი მახასიათებელი. უფრო სრულყოფილი ჩაძირვისთვის, გირჩევთ, მიმართოთ ჩვენს დოკუმენტაციას მისამართზე http://docs-ru.testmace.com. მაშ, წავიდეთ!

დაყენების

დავიწყოთ ბანალურობით. აპლიკაცია ხელმისაწვდომია და რეალურად დატესტილია სამ პლატფორმაზე - Linux, Windows, MacOS. თქვენ შეგიძლიათ ჩამოტვირთოთ ინსტალერი იმ ოპერაციული სისტემისთვის, საიდანაც გაინტერესებთ ჩვენი საიტი. Linux-ის მომხმარებლებისთვის შესაძლებელია ინსტალაცია ვადამდელი პაკეტი. ჩვენ ნამდვილად ვიმედოვნებთ, რომ Microsoft Store და App Store მალე მოერგება მას (აუცილებელია? რას ფიქრობთ?).

ექსპერიმენტული სცენარი

ჩვენ ავირჩიეთ შემდეგი სტანდარტული სცენარი, როგორც ჩვენი ტესტის საგანი:

• შესვლა: მომხმარებელი - ადმინისტრატორი, პაროლი - პაროლი
• დაამატეთ ახალი ჩანაწერი
• მოდით შევამოწმოთ, რომ ჩანაწერი სწორად არის დამატებული

ჩვენ ჩავატარებთ ტესტირებას https://testmace-quick-start.herokuapp.com/. Ეს ნორმალურია json-სერვერი, იდეალურია ასეთი აპლიკაციების შესამოწმებლად. ჩვენ უბრალოდ დავამატეთ ავტორიზაცია ნიშნით ყველა json-სერვერის მარშრუტზე და შევქმენით შესვლის მეთოდი ამ ნიშნის მისაღებად. ჩვენ პროგრესულად წავალთ, თანდათან გავაუმჯობესებთ ჩვენს პროექტს.

პროექტის შექმნა და ავტორიზაციის გარეშე სუბიექტის შექმნის მცდელობა

ჯერ შევქმნათ ახალი პროექტი (ფაილი->ახალი პროექტი). თუ აპლიკაციას პირველად გაუშვით, ახალი პროექტი ავტომატურად გაიხსნება. პირველ რიგში, ვცადოთ მოთხოვნა ახალი ჩანაწერის შესაქმნელად (თუ ჩანაწერების შექმნა ავტორიზაციის გარეშეა შესაძლებელი). აირჩიეთ ელემენტები პროექტის კვანძის კონტექსტური მენიუდან კვანძის დამატება -> RequestStep. დააყენეთ კვანძის სახელი შექმნა-პოსტი. შედეგად, ხეში შეიქმნება ახალი კვანძი და გაიხსნება ამ კვანძის ჩანართი. მოდით დავაყენოთ შემდეგი მოთხოვნის პარამეტრები:

• მოთხოვნის ტიპი: POST
• URL: https://testmace-quick-start.herokuapp.com/posts
• მოთხოვნის ტექსტი: json მნიშვნელობით {"title": "New testmace quick start post"}
  თუ ყველაფერი სწორად გააკეთეთ, ინტერფეისი ასე გამოიყურება:

თუმცა, თუ ჩვენ შევეცდებით მოთხოვნის შესრულებას, სერვერი დააბრუნებს 401 კოდს და ავტორიზაციის გარეშე ჩვენ ვერაფერს მივიღებთ ამ სერვერზე. ზოგადად, როგორც მოსალოდნელი იყო).

ავტორიზაციის მოთხოვნის დამატება

როგორც უკვე ვთქვით, ჩვენ გვაქვს POST საბოლოო წერტილი /login, რომელიც იღებს json-ს, როგორც ფორმის მოთხოვნის ტექსტს: {"username": "<username>", "password": "<password>"}სად username и password (ისევ, ზემოთ, შესავალი აბზაციდან) აქვს მნიშვნელობა admin и password შესაბამისად. საპასუხოდ, ეს ბოლო წერტილი აბრუნებს json like {"token": "<token>"}. ჩვენ მას გამოვიყენებთ ავტორიზაციისთვის. შევქმნათ RequestStep კვანძი სახელით შევდივარ, იმოქმედებს როგორც წინაპარი პროექტი კვანძი გადაწევის გამოყენებით გადაიტანეთ მოცემული კვანძი ხეში კვანძზე მაღლა შექმნა-პოსტი. მოდით დავაყენოთ შემდეგი პარამეტრები ახლად შექმნილ მოთხოვნაზე:

• მოთხოვნის ტიპი: POST
• URL: https://testmace-quick-start.herokuapp.com/login
• მოთხოვნის ტექსტი: json მნიშვნელობით {"username": "admin", "password": "password"}

მოდით შევასრულოთ მოთხოვნა და მივიღოთ ორასი კოდი პასუხის ნიშნით. Რაღაც მსგავსი:

რეფაქტორირება: დომენის დუბლირების მოხსნა

ჯერჯერობით მოთხოვნები არ არის დაკავშირებული ერთ სკრიპტში. მაგრამ ეს არ არის ერთადერთი ნაკლი. თუ დააკვირდებით, შეამჩნევთ, რომ მინიმუმ დომენი დუბლირებულია ორივე მოთხოვნაში. Არ არის კარგი. დროა გადავაკეთოთ მომავალი სკრიპტის ეს ნაწილი და ცვლადები დაგვეხმარება ამაში.

პირველი მიახლოებით, ცვლადები ასრულებენ იგივე როლს, როგორც სხვა მსგავს ინსტრუმენტებსა და პროგრამირების ენებში - აღმოფხვრის დუბლირებას, გაზრდის კითხვადობას და ა.შ. შეგიძლიათ მეტი წაიკითხოთ ცვლადების შესახებ ჩვენი დოკუმენტაცია. ამ შემთხვევაში დაგვჭირდება მომხმარებლის ცვლადები.

მოდით განვსაზღვროთ ცვლადი პროექტის კვანძის დონეზე domain მნიშვნელობით https://testmace-quick-start.herokuapp.com. ამისთვის აუცილებელია

• გახსენით ჩანართი ამ კვანძით და დააწკაპუნეთ კალკულატორის ხატულაზე ზედა მარჯვენა კუთხეში
• Დააკლიკეთ + ცვლადის დამატება
• შეიყვანეთ ცვლადის სახელი და მნიშვნელობა
  ჩვენს შემთხვევაში, დიალოგი დამატებული ცვლადით ასე გამოიყურება:

ᲙᲐᲠᲒᲘ. ახლა, მემკვიდრეობითობის გამო, ჩვენ შეგვიძლია გამოვიყენოთ ეს ცვლადი ნებისმიერი ბუდის დონის შთამომავლებში. ჩვენს შემთხვევაში ეს არის კვანძები შევდივარ и შექმნა-პოსტი. იმისათვის, რომ გამოიყენოთ ცვლადი ტექსტურ ველში, თქვენ უნდა დაწეროთ ${<variable_name>}. მაგალითად, შესვლის url გარდაიქმნება ${domain}/login, შესაბამისად შექმნა-პოსტი კვანძის url ასე გამოიყურება ${domain}/posts.

ამრიგად, DRY პრინციპით ხელმძღვანელობით, ჩვენ ოდნავ გავაუმჯობესეთ სცენარი.

შეინახეთ ჟეტონი ცვლადში

ვინაიდან ჩვენ ვსაუბრობთ ცვლადებზე, მოდით გავაფართოვოთ ეს თემა ცოტათი. ამ დროისთვის, წარმატებული შესვლის შემთხვევაში, სერვერისგან ვიღებთ ავტორიზაციის ჟეტონს, რომელიც დაგვჭირდება შემდგომ მოთხოვნებში. შევინახოთ ეს ჟეტონი ცვლადში. იმიტომ რომ ცვლადის მნიშვნელობა განისაზღვრება სკრიპტის შესრულების დროს, ამისთვის ვიყენებთ სპეციალურ მექანიზმს - დინამიური ცვლადები.

პირველი, მოდით შევასრულოთ შესვლის მოთხოვნა. ჩანართში გაანალიზებული უპასუხეთ, გადაიტანეთ კურსორი ჟეტონზე და კონტექსტურ მენიუში (რომელსაც უწოდებენ მაუსის მარჯვენა ღილაკით ან ღილაკზე დაჭერით ...) აირჩიეთ ელემენტი მიანიჭეთ ცვლადს. გამოჩნდება დიალოგი შემდეგი ველებით:

• ბილიკი - პასუხის რომელი ნაწილია აღებული (ჩვენს შემთხვევაში ასეა body.token)
• მიმდინარე ღირებულება - რა მნიშვნელობა დევს ბილიკის გასწვრივ (ჩვენს შემთხვევაში ეს არის სიმბოლური მნიშვნელობა)
• ცვლადი სახელი - ცვლადის სახელი სადაც მიმდინარე ღირებულება შენარჩუნდება. ჩვენს შემთხვევაში ასე იქნება token
• Node — რომელ წინაპრებში შეიქმნება ცვლადი ცვლადი სახელი. მოდით ავირჩიოთ პროექტი

დასრულებული დიალოგი ასე გამოიყურება:

ახლა ყოველ ჯერზე, როდესაც კვანძი შესრულდება შევდივარ დინამიური ცვლადი token განახლდება პასუხის ახალი მნიშვნელობით. და ეს ცვლადი შეინახება პროექტი კვანძი და, მემკვიდრეობის წყალობით, ხელმისაწვდომი იქნება შთამომავლებისთვის.

დინამიურ ცვლადებზე წვდომისთვის, თქვენ უნდა გამოიყენოთ ჩაშენებული ცვლადი $dynamicVar. მაგალითად, შენახულ ჟეტონზე წვდომისთვის საჭიროა დარეკვა ${$dynamicVar.token}.

ჩვენ გადავცემთ ავტორიზაციის ჟეტონს მოთხოვნებში

წინა ნაბიჯებში მივიღეთ ავტორიზაციის ჟეტონი და ყველაფერი რაც უნდა გავაკეთოთ არის სათაურის დამატება Authorization მნიშვნელობით Bearer <tokenValue> ყველა მოთხოვნაში, რომელიც საჭიროებს ავტორიზაციას, მათ შორის შექმნა-პოსტი. ამის გაკეთების რამდენიმე გზა არსებობს:

1. ხელით დააკოპირეთ ჟეტონი და დაამატეთ ავტორიზაციის სათაური ინტერესის მოთხოვნებს. მეთოდი მუშაობს, მაგრამ მისი გამოყენება შემოიფარგლება მხოლოდ „გამზადებული და გადაყრილი“ ტიპის მოთხოვნებით. არ არის შესაფერისი სკრიპტების განმეორებით შესრულებისთვის
2. გამოიყენეთ ფუნქციონირება ავტორიზაცია.
3. გამოიყენეთ ნაგულისხმევი სათაურები

მეორე მეთოდის გამოყენება აშკარად ჩანს, მაგრამ ამ სტატიის კონტექსტში ეს მიდგომა... უინტერესოა. კარგი, მართლაც: ავტორიზაციის მექანიზმი პლუს მინუსი თქვენთვის ცნობილია სხვა ხელსაწყოებიდან (თუნდაც ჩვენ გვაქვს მსგავსი რამ ავტორიზაციის მემკვიდრეობა) და ნაკლებად სავარაუდოა, რომ დააყენებს კითხვებს.

სხვა რამ არის ნაგულისხმევი სათაურები! მოკლედ, ნაგულისხმევი სათაურები არის მემკვიდრეობითი HTTP სათაურები, რომლებიც ემატება მოთხოვნას ნაგულისხმევად, თუ აშკარად არ არის გამორთული. ამ ფუნქციის გამოყენებით, შეგიძლიათ, მაგალითად, განახორციელოთ პერსონალური ავტორიზაცია ან უბრალოდ მოიცილოთ დუბლირება სკრიპტებში. მოდით გამოვიყენოთ ეს ფუნქცია სათაურებში ჟეტონის გადასაცემად.

ადრე, ჩვენ გონივრულად ვინახავდით ჟეტონს დინამიურ ცვლადში $dynamicVar.token პროექტის კვანძის დონეზე. რჩება მხოლოდ შემდეგი:

1. განსაზღვრეთ ნაგულისხმევი სათაური Authorization მნიშვნელობით Bearer ${$dynamicVar.token} პროექტის კვანძის დონეზე. ამისათვის, კვანძის პროექტის ინტერფეისში თქვენ უნდა გახსნათ დიალოგი ნაგულისხმევი სათაურებით (ღილაკი ჰედერისა ზედა მარჯვენა კუთხეში) და დაამატეთ შესაბამისი სათაური. დიალოგი შევსებული მნიშვნელობებით ასე გამოიყურება:
   
2. გამორთეთ ეს სათაური შესვლის მოთხოვნიდან. ეს გასაგებია: შესვლის დროს ჯერ არ გვაქვს ჟეტონი და ამ მოთხოვნით დავაინსტალირებთ. ამიტომ, ჩანართში მოთხოვნის შესვლის ინტერფეისში ჰედერისა არეალში Მემკვიდრეობით მიღებული მოხსენით ავტორიზაციის სათაური.

Სულ ეს არის. ახლა ავტორიზაციის სათაური დაემატება ყველა მოთხოვნას, რომელიც არის პროექტის კვანძის შვილი, გარდა შესვლის კვანძისა. გამოდის, რომ ამ ეტაპზე უკვე მზად გვაქვს სკრიპტი და რაც უნდა გავაკეთოთ არის მისი გაშვება. შეგიძლიათ სკრიპტის გაშვება არჩევით გასაშვებად პროექტის კვანძის კონტექსტურ მენიუში.

პოსტის შექმნის სისწორის შემოწმება

ამ ეტაპზე ჩვენს სკრიპტს შეუძლია შესვლა და ავტორიზაციის ჟეტონის გამოყენებით პოსტის შექმნა. თუმცა, ჩვენ უნდა დავრწმუნდეთ, რომ ახლად შექმნილ პოსტს აქვს სწორი სახელი. ანუ, არსებითად, რჩება მხოლოდ შემდეგი:

• გაგზავნეთ მოთხოვნა პოსტის მისაღებად ID-ით,
• შეამოწმეთ, რომ სერვერიდან მიღებული სახელი ემთხვევა პოსტის შექმნისას გაგზავნილ სახელს

მოდით შევხედოთ პირველ ნაბიჯს. ვინაიდან id-ის მნიშვნელობა განისაზღვრება სკრიპტის შესრულების დროს, თქვენ უნდა შექმნათ დინამიური ცვლადი (მოდით დავარქვათ postId) კვანძიდან შექმნა-პოსტი პროექტის კვანძის დონეზე. ჩვენ უკვე ვიცით როგორ გავაკეთოთ ეს, უბრალოდ მიმართეთ განყოფილებას შეინახეთ ჟეტონი ცვლადში. რჩება მხოლოდ ამ ID-ის გამოყენებით პოსტის მიღების მოთხოვნის შექმნა. ამისათვის შევქმნათ RequestStep მიღება-პოსტი შემდეგი პარამეტრებით:

• მოთხოვნის ტიპი: GET
• URL: ${domain}/posts/${$dynamicVar.postId}

მეორე ნაბიჯის განსახორციელებლად საჭიროა გავეცნოთ Მტკიცება კვანძი. Assertion კვანძი არის კვანძი, რომელიც საშუალებას გაძლევთ დაწეროთ შემოწმებები კონკრეტული მოთხოვნებისთვის. თითოეული Assertion კვანძი შეიძლება შეიცავდეს რამდენიმე მტკიცებას (შემოწმებას). თქვენ შეგიძლიათ წაიკითხოთ მეტი ყველა სახის მტკიცების შესახებ ჩვენიდან დოკუმენტაცია. ჩვენ გამოვიყენებთ Compare მტკიცება ოპერატორთან equal. განცხადებების შექმნის რამდენიმე გზა არსებობს:

1. გრძელი. ხელით შექმენით Assertion კვანძი RequestStep კვანძის კონტექსტური მენიუდან. შექმნილ Assertion კვანძში დაამატეთ ინტერესის მტკიცება და შეავსეთ ველები.
2. Სწრაფი. შექმენით Assertion კვანძი RequestStep კვანძის პასუხის მტკიცებასთან ერთად კონტექსტური მენიუს გამოყენებით

გამოვიყენოთ მეორე მეთოდი. ასე გამოიყურება ჩვენი საქმე.

ვისაც არ ესმის, აი რა ხდება:

1. გააკეთეთ მოთხოვნა კვანძში მიღება-პოსტი
2. ჩანართში გაანალიზებული უპასუხეთ, დაურეკეთ კონტექსტურ მენიუს და აირჩიეთ შექმენით მტკიცება -> შეადარეთ -> თანაბარი

გილოცავთ, ჩვენ შევქმენით ჩვენი პირველი ტესტი! მარტივია, არა? ახლა თქვენ შეგიძლიათ სრულად გაუშვათ სკრიპტი და ისიამოვნოთ შედეგით. რჩება მხოლოდ მისი ოდნავ გადაკეთება და ამოღება title ცალკე ცვლადად. მაგრამ ჩვენ ამას საშინაო დავალებად დავტოვებთ)

დასკვნა

ამ სახელმძღვანელოში ჩვენ შევქმენით სრულფასოვანი სცენარი და ამავდროულად განვიხილეთ ჩვენი პროდუქტის ზოგიერთი მახასიათებელი. რა თქმა უნდა, ჩვენ არ გამოვიყენეთ ყველა ფუნქცია და შემდეგ სტატიებში მოგაწვდით TestMace-ის შესაძლებლობების დეტალურ მიმოხილვას. Ადევნეთ თვალყური!

P.S. მათთვის, ვისაც ძალიან ეზარება ყველა ნაბიჯის რეპროდუცირება, ჩვენ კეთილად ჩავწერეთ საცავი პროექტთან ერთად სტატიიდან. თქვენ შეგიძლიათ გახსნათ იგი ფაილი -> გახსენით პროექტი და აირჩიეთ პროექტის საქაღალდე.

წყარო: www.habr.com