שלום לכולם. לאט לאט אנחנו יוצאים מהצללים וממשיכים בסדרת הכתבות על המוצר שלנו. לאחר קודם מאמר סקירה, קיבלנו הרבה משוב (בעיקר חיובי), הצעות ודיווחי באגים. היום נציג TestMace בפעולה ותוכלו להעריך כמה מהתכונות של האפליקציה שלנו. לטבילה מלאה יותר, אני ממליץ לך לעיין בתיעוד שלנו בכתובת http://docs-ru.testmace.com. אז בוא נלך!

התקנה

נתחיל מהבנאליות. האפליקציה זמינה ולמעשה נבדקה בשלוש פלטפורמות - לינוקס, חלונות, MacOS. אתה יכול להוריד את תוכנית ההתקנה עבור מערכת ההפעלה שממנה אתה מעוניין האתר שלנו. למשתמשי לינוקס אפשר להתקין חבילת הצמד. אנחנו מאוד מקווים ש-Microsoft Store ו-App Store יגיעו לזה בקרוב (האם זה נחוץ? מה דעתכם?).

תרחיש ניסיוני

בחרנו בתרחיש הסטנדרטי הבא כנושא המבחן שלנו:

• כניסה: משתמש - אדמין, סיסמה - סיסמה
• הוסף ערך חדש
• בואו נבדוק שהרשומה נוספה כהלכה

נבחן על https://testmace-quick-start.herokuapp.com/. זה נורמלי json-server, מושלם לבדיקת יישומים כאלה. זה עתה הוספנו הרשאה באמצעות אסימון לכל מסלולי השרת של 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"}

בוא נבצע את הבקשה ונקבל את הקוד המאתיים עם האסימון בתגובה. משהו כזה:

Refactoring: הסרת כפילות תחום

עד כה הבקשות אינן מקושרות לסקריפט אחד. אבל זה לא החיסרון היחיד. אם תסתכלו היטב, תבחינו שלפחות הדומיין משוכפל בשתי הבקשות. לא טוב. הגיע הזמן לשחזר את החלק הזה של התסריט העתידי, ומשתנים יעזרו לנו בכך.

לקירוב ראשון, משתנים ממלאים את אותו תפקיד כמו בכלים דומים ושפות תכנות אחרות - ביטול כפילות, הגברת הקריאות וכו'. תוכל לקרוא עוד על משתנים ב התיעוד שלנו. במקרה זה, נצטרך משתני משתמש.

בואו נגדיר משתנה ברמת צומת הפרויקט domain עם משמעות https://testmace-quick-start.herokuapp.com. לשם כך יש צורך

• פתח את הכרטיסייה עם הצומת הזה ולחץ על סמל המחשבון בפינה השמאלית העליונה
• לחץ על + הוסף משתנה
• הזן שם וערך של משתנה
  במקרה שלנו, תיבת הדו-שיח עם המשתנה שנוסף ייראה כך:

בסדר. כעת, עקב תורשה, אנו יכולים להשתמש במשתנה זה בצאצאים מכל רמת קינון. במקרה שלנו אלו צמתים התחבר и ליצור-פוסט. על מנת להשתמש במשתנה בשדה טקסט, עליך לכתוב ${<variable_name>}. לדוגמה, כתובת האתר לכניסה מומרת ל ${domain}/login, בהתאמה עבור ליצור-פוסט כתובת האתר של הצומת תיראה ${domain}/posts.

לפיכך, בהנחיית עקרון ה- DRY, שיפרנו מעט את התרחיש.

שמור את האסימון למשתנה

מכיוון שאנו מדברים על משתנים, בואו נרחיב מעט בנושא זה. כרגע, במקרה של כניסה מוצלחת, אנו מקבלים מהשרת אסימון הרשאה, אותו נזדקק בבקשות הבאות. בואו נשמור את האסימון הזה במשתנה. כי הערך של המשתנה ייקבע במהלך ביצוע הסקריפט, אנו משתמשים במנגנון מיוחד לשם כך - משתנים דינמיים.

ראשית, בואו נבצע בקשת התחברות. בכרטיסייה מנותח ענה, העבר את הסמן מעל האסימון ובתפריט ההקשר (שנקרא או באמצעות לחצן העכבר הימני או על ידי לחיצה על הכפתור ...) בחר את הפריט הקצה למשתנה. תופיע תיבת דו-שיח עם השדות הבאים:

• נתיב - איזה חלק מהתשובה נלקח (במקרה שלנו זה כן body.token)
• ערך נוכחי - איזה ערך יש לאורך הנתיב (במקרה שלנו זה הערך הסמל)
• שם משתנה - שם המשתנה איפה ערך נוכחי יישמר. במקרה שלנו זה יהיה token
• צומת - באיזה מהאבות הקדמונים יווצר המשתנה שם משתנה. בוא נבחר פרויקט

תיבת הדו-שיח שהושלמה נראית כך:

עכשיו בכל פעם שהצומת מבוצע התחבר משתנה דינמי token יעודכן בערך החדש מהתגובה. והמשתנה הזה יאוחסן ב פרויקט צומת, ובזכות הירושה, יהיה זמין לצאצאים.

כדי לגשת למשתנים דינמיים, עליך להשתמש משתנה מובנה $dynamicVar. לדוגמה, כדי לגשת לאסימון מאוחסן, עליך להתקשר ${$dynamicVar.token}.

אנו מעבירים את אסימון ההרשאה לבקשות

בשלבים הקודמים קיבלנו את אסימון ההרשאה וכל מה שאנחנו צריכים לעשות הוא להוסיף כותרת Authorization עם משמעות Bearer <tokenValue> בכל הבקשות הדורשות אישור, כולל ליצור-פוסט. ישנן מספר דרכים לעשות זאת:

1. העתק באופן ידני את האסימון והוסף כותרת הרשאה לבקשות העניין. השיטה עובדת, אך השימוש בה מוגבל רק לבקשות מסוג "עשה ונזרק". לא מתאים לביצוע חוזר של סקריפטים
2. השתמש בפונקציונליות הרשאה.
3. להשתמש כותרות ברירת מחדל

השימוש בשיטה השנייה נראה מובן מאליו, אך בהקשר של מאמר זה, גישה זו היא... לא מעניינת. נו, באמת: מנגנון ההרשאה פלוס מינוס מוכר לכם מכלים אחרים (גם אם יש לנו דברים כמו ירושה של הרשאה) וסביר להניח שלא יעורר שאלות.

דבר נוסף הוא כותרות ברירת המחדל! בקצרה, כותרות ברירת המחדל הן כותרות HTTP שעברו בירושה שמתווספות לבקשה כברירת מחדל, אלא אם הן מושבתות במפורש. באמצעות פונקציונליות זו, אתה יכול, למשל, ליישם הרשאה מותאמת אישית או פשוט להיפטר משכפול בסקריפטים. בואו נשתמש בתכונה זו כדי להעביר אסימון בכותרות.

בעבר, שמרנו בזהירות את האסימון למשתנה דינמי $dynamicVar.token ברמת צומת הפרויקט. כל מה שנותר הוא לעשות את הדברים הבאים:

1. הגדר כותרת ברירת מחדל Authorization עם משמעות Bearer ${$dynamicVar.token} ברמת צומת הפרויקט. לשם כך, בממשק הפרויקט של הצומת עליך לפתוח דו-שיח עם כותרות ברירת מחדל (כפתור כותרות בפינה הימנית העליונה) והוסיפו כותרת מתאימה. תיבת הדו-שיח עם הערכים המלאים תיראה כך:
   
2. השבת את הכותרת הזו מבקשת ההתחברות. זה מובן: בזמן הכניסה, עדיין אין לנו אסימון ואנו נתקין אותו עם בקשה זו. לכן, בממשק הכניסה של הבקשה בלשונית כותרות באזור בירושה בטל את הסימון בכותרת ההרשאה.

זה הכל. כעת כותרת ההרשאה תתווסף לכל הבקשות שהן ילדים של צומת הפרויקט, מלבד צומת הכניסה. מסתבר שבשלב הזה כבר יש לנו תסריט מוכן וכל מה שאנחנו צריכים לעשות זה להשיק אותו. אתה יכול להפעיל את הסקריפט על ידי בחירה הפעלה בתפריט ההקשר של צומת הפרויקט.

בדיקת נכונות יצירת הפוסט

בשלב זה, הסקריפט שלנו יכול להיכנס וליצור פוסט באמצעות אסימון הרשאה. עם זאת, עלינו לוודא שלפוסט החדש שנוצר יש את השם הנכון. כלומר, בעצם, כל מה שנותר הוא לעשות את הדברים הבאים:

• שלח בקשה לקבלת פוסט באמצעות תעודת זהות,
• בדקו שהשם שהתקבל מהשרת תואם את השם שנשלח בעת יצירת הפוסט

בואו נסתכל על הצעד הראשון. מכיוון שערך המזהה נקבע במהלך ביצוע סקריפט, עליך ליצור משתנה דינמי (בואו נקרא לזה postId) מהצומת ליצור-פוסט ברמת צומת הפרויקט. אנחנו כבר יודעים איך לעשות זאת, פשוט עיין בסעיף שמור את האסימון למשתנה. כל מה שנותר הוא ליצור בקשה לקבל פוסט באמצעות המזהה הזה. לשם כך, בואו ניצור RequestStep לקבל פוסט עם הפרמטרים הבאים:

• סוג הבקשה: GET
• כתובת אתר: ${domain}/posts/${$dynamicVar.postId}

כדי ליישם את השלב השני, עלינו להכיר טַעֲנָה קשר. צומת Assertion הוא צומת המאפשר לך לכתוב צ'קים עבור בקשות ספציפיות. כל צומת טענה יכול להכיל מספר הצהרות (צ'קים). אתה יכול לקרוא עוד על כל סוגי הטענות שלנו תיעוד. אנחנו נשתמש Compare טענה עם מפעיל equal. ישנן מספר דרכים ליצור הצהרות:

1. ארוך. צור באופן ידני צומת Assertion מתפריט ההקשר של הצומת RequestStep. בצומת ה-Assertion שנוצר, הוסף את הצהרת העניין ומלא את השדות.
2. מָהִיר. צור צומת Assertion יחד עם טענה מתגובת הצומת RequestStep באמצעות תפריט ההקשר

בואו נשתמש בשיטה השנייה. כך זה ייראה במקרה שלנו.

למי שלא מבין, זה מה שקורה:

1. בצע בקשה בצומת לקבל פוסט
2. בכרטיסייה מנותח ענה, התקשר לתפריט ההקשר ובחר צור טענה -> לְהַשְׁווֹת -> שווה

מזל טוב, יצרנו את המבחן הראשון שלנו! פשוט, לא? כעת תוכלו להריץ את הסקריפט במלואו וליהנות מהתוצאה. כל מה שנותר הוא לשחזר אותו מעט ולהוציא אותו title למשתנה נפרד. אבל נשאיר את זה בשבילך כשיעורי בית)

מסקנה

במדריך זה יצרנו תרחיש מלא ובמקביל סקרנו כמה מהתכונות של המוצר שלנו. כמובן שלא השתמשנו בכל הפונקציונליות ובכתבות הבאות נספק סקירה מפורטת של היכולות של TestMace. המשך לעקוב!

נ.ב למי שמתעצל לשחזר את כל השלבים, הקלטנו בחביבות מאגר עם הפרויקט מהמאמר. אתה יכול לפתוח אותו עם שלח -> פרוייקט פתוח ובחר בתיקייה Project.

מקור: www.habr.com