שפהעברית

בדיקות

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

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

קריאת שורת המצב

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

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

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

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

צפייה בבדיקות

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

בדיקה שמעולם לא הורצה מסומנת טרם הורץ. טבעת ההצלחה לעולם אינה מציגה 100% כשיש בדיקה שנכשלה. כל מצב מוצג תמיד עם סמל ומילה, ולא רק בצבע.

כלי הבדיקות ממיין את הקבצים אוטומטית: בדיקות יחידה, בדיקות אינטגרציה ובדיקות מקצה לקצה (תיקיות כמו e2e, integration, routes או api, קובצי Playwright ותרחישי אינטרנט), ובקרות. הבקרות כוללות ניתוח קוד, טיפוסים, בנייה וסקריפטים של אימות בפרויקט שלכם, גם כאלה ששמם כולל סיומת, כמו contrast:ui-check או tabs:guard. אם תיקייה נמצאת במשפחה הלא נכונה, פתחו את תפריט ⋯ שלה ובחרו העברה לבדיקות יחידה או העברה לאינטגרציה ו-E2E.

הרצת בדיקות

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

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

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

בחירת מספר קובצי הבדיקה שרצים במקביל

קובצי בדיקה במקביל, לצד שורת המצב, קובע כמה קובצי בדיקה של פרויקט רצים בו־זמנית. אוטומטי, ברירת המחדל, שומר על ההגדרה של כל כלי בדיקה. בחרו מספר, עד מספר המעבדים של המופע שלכם, וכל הרצה של הפרויקט, ידנית או אוטומטית, תריץ לכל היותר מספר כזה של קבצים: Node, Vitest, Jest וגם Playwright פועלים לפיו, כלי בדיקה אחרים שומרים על ההגדרה שלהם, והרצות הפרויקט מתבצעות אז אחת אחרי השנייה. הרצה שכבר התחילה שומרת על המספר שלה.

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

הרצת בדיקות לפי לוח זמנים

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

  • הרצת בדיקות אוטומטית: הפעלה או כיבוי של לוח הזמנים.
  • חזרתיות: כל שעה, כל יום, בימי חול, כל שבוע, כל חודש או ביטוי cron מותאם אישית. בין שתי הרצות חייבות לעבור 15 דקות לפחות.
  • אזור זמן: אזור הזמן שלפיו פועל לוח הזמנים. אזור הזמן שבו מוצגים לכם הזמנים מוצע ראשון; שינוי שלו בהמשך אינו מזיז לוח זמנים שכבר נשמר.
  • מה להריץ: לפחות אחד מבין בדיקות יחידה, בדיקות רגרסיה, אינטגרציה ו-E2E ו-בקרות.
  • התראה: עם רק כשמשהו נכשל (ברירת המחדל) הרצות שעברו בהצלחה אינן שולחות התראה, אבל הרצה שנכשלה, נקטעה או דורשת בדיקה עדיין מתריעה לכם; עם אחרי כל הרצה תקבלו התראה בכל פעם.
  • הרצות שהוחמצו: אם המופע היה כבוי במועד מתוכנן, האפשרות הרצה אחת כשהמופע חוזר לפעול (ברירת המחדל) משלימה את החסר בהרצה אחת, לא משנה כמה מועדים הוחמצו; האפשרות דילוג על הרצות שהוחמצו ממתינה למועד המתוכנן הבא.

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

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

יצירת בדיקה

בחרו בדיקה חדשה בפינה השמאלית העליונה:

  • כתיבת בדיקה עם AI: תארו התנהגות; הבינה המלאכותית מציעה את הבדיקה, ואתם סוקרים אותה לפני שהיא נשמרת. שום דבר לא רץ עד שתריצו אותה.
  • הגנה על באג שתוקן: צרו בדיקת רגרסיה מהבדיקות שמכסות אותו.
  • תרחיש אינטרנט: שלבים שנלחצים ונבדקים בדפדפן המשולב.
  • הוספת פקודת בדיקה: סקריפט קיים של הפרויקט שלכם, כמו npm test.

עריכת בדיקה

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

הרצת בדיקות רגרסיה

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

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

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

בדיקות שתוקנו הופכות לבדיקות רגרסיה

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

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

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

בחירת הרצת ייחוס והשוואה

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

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

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

הוספת תרחיש אינטרנט

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

לדוגמה, הגנו על שמירת המצב ביישום משימות באמצעות השלבים האלה:

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

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

הדפדפן המשולב משתמש בהקשרי Chromium זמניים וחוסם service workers. הוא אינו מאשר התנהגות offline/PWA, את Safari או Firefox, התנהגות מקורית של Android/iOS או ביצועים במכשיר אמיתי. ההתאמה בין היעד הנוכחי למקור עשויה להישאר לא ודאית: במקרה כזה תנאי בדיקה שעברו בדפדפן מוצגים כ־עבר, והעובדה הזו מופיעה ב־פרטים, אבל ההרצה אינה אימות מלא ואינה הרצת ייחוס מלאה שמתאימה לבחירה. צילום מסך הוא ראיה; רגרסיה חזותית דורשת תנאי בדיקה שהורץ ובסיס השוואה חזותי שמנוהל במפורש.

עיון בכשלים ושמירת הראיות

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

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

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

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

הפיכת באג להתנהגות מוגנת

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

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

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

מנועים שעברו הסמכה ודרישות מוקדמות

הגרסאות המדויקות האלה עברו הסמכת מקור ב-Linux עם Node 22.22.2/22.23.2. התלויות חייבות להיות קיימות; כלי הבדיקות אינו מתקין או משדרג אותן. אין בכך הבטחה לטווח גרסאות.

מנוע מקרים והרצה חוזרת ממוקדת כיסוי ומגבלות
Node test runner 22.22.2 / 22.23.2 מקרים מובנים, hooks ו-skipped/todo; קובץ ההפעלה הנוכחי של Node מופעל ישירות. אין יכולת להרצה חוזרת של מקרה מדויק או לשמירת היסטוריית ניסיונות חוזרים. כיסוי מקורי מפורש של שורות, ענפים ופונקציות, עם תחום המדידה שלו; עד 128 קבצים/64 KiB של מטא-נתוני כיסוי.
Vitest 4.1.10 נקודת כניסה ישירה; בחירת מקרה שמור מדויק לאחר איסוף בפיקוח; הניסיונות שומרים ניסיונות חוזרים. אין כיסוי מוסמך או היפוך תוצאת כישלון צפוי. מעטפות מחזור חיים ותצורות שאינן יכולות לשמור את תוסף הראיות נדחות.
Jest 30.2.0 שם מלא ייחודי בקובץ מקובע; מקרה נבחר אחד לכל פקודה, עם מספר מוגבל של פקודות עבור כמה מקרים. אין ייבוא כיסוי. שמות עמומים, תצורות בסיס מוכנות, תצורת ריבוי פרויקטים/TypeScript ומריצים מותאמים נדחים.
pytest 8.4.2 / CPython 3.10.12 Python ישיר מסביבה וירטואלית עם -m pytest; זהויות צמתים מדויקות ושלבי setup/call/teardown. כיסוי, מעטפות, הרצה מבוזרת ותוספי ניסיונות חוזרים אינם מוסמכים. pytest חסר אינו מתוקן בשקט.
Playwright Test 1.63.0 מריץ מותקן של הפרויקט; זהויות פרויקט וחזרות, ניסיונות חוזרים וקבצים מצורפים. אין הרצה חוזרת של מקרה מדויק. אין כיסוי או היפוך תוצאת כישלון צפוי. מדיניות דפדפן הפרויקט נפרדת מזו של הדפדפן המשולב.
פקודה מותאמת / JUnit תוצאת פקודה ללא פירוט, או מקרים שסופקו בפועל בדוח מוגבל. אין הרצה חוזרת של מקרה מדויק. אין ניחוש כיסוי, מונים או פרשנות לניסיונות חוזרים; ניבי XML שאינם נתמכים נשארים לא תקינים או לא שלמים.

פקודת JUnit מותאמת חייבת לכתוב את הדוח הנוכחי שלה לתיקיית הדוח הפרטית של ההרצה באמצעות TEST_REPORT_PATH / TEST_REPORT_DIR או מצייני הארגומנטים המפורשים {{TEST_REPORT_PATH}} / {{TEST_REPORT_DIR}}. דוח ישן מסביבת העבודה אינו יכול לאמת הרצה חדשה. ייבוא XML חיצוני זמין באמצעות ה-API או הפעולה tests.importJUnit, ולא דרך כפתור ייבוא בממשק הנוכחי. מונים מיובאים אינם מוכיחים הרצה מקומית, מידע מקור עדכני או התאמה כהרצת ייחוס.

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

כלי שיחה

שיחות פרויקט רגילות ומורשות חושפות חמישה כלי MCP ופקודות CLI תואמות: aircode_tests_catalog / catalog, aircode_tests_describe / describe, aircode_tests_run / run, aircode_tests_status / status וכן aircode_tests_open / open. קראו את הסכמה לפני פעולה שמשנה נתונים:

aircode-tests catalog
aircode-tests describe --input '{"action":"tests.launchUnits"}'
aircode-tests run --input '{"action":"tests.units","input":{}}'

השתמשו ב-tests.launchUnits לחבילות בדיקות יחידה, או ב-tests.launchRegression עבור אוסף מדויק, עם קיבועי התחום והגרסה שהוחזרו ועם המפתח המפורש שבסכמה. יכולת ההרשאה של הסשן מספקת את הפרויקט; אל תוסיפו שדה project. --input - מקבל JSON מוגבל בקלט התקני. status מקבל {scopeId,ownerKind,ownerId}; open מקבל אותה זהות או {} עבור כלי הבדיקות. שמרו את openPath שהוחזר ללא שינוי. ב-MCP השתמשו באותם ארגומנטים עם כלי aircode_tests_* המתאים. ראו תיעוד לבינה מלאכותית.

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

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

אחסון וסירובים עם פעולת המשך ברורה

הגדרות, הרצות ייחוס ועובדות הרצה בלתי ניתנות לשינוי נשמרות בתחום הפרטי של כלי הבדיקות ב-SQLite במופע. יומנים גדולים, צילומים ועקבות נשמרים בקבצים פרטיים נלווים. גיבוי מסד הנתונים בלבד אינו מכיל את הבתים האלה: שמרו את הקבצים הנלווים עם גיבוי עקבי של המופע. לעולם אין להעתיק מסד WAL פעיל כגיבוי. ראיות ייחודיות או מרכזיות נשמרות כברירת מחדל; רק קובץ מצורף עודף של הרצה שהסתיימה, ושאומת כמיותר, ניתן להסרה מפורשת. אין מחיקה גורפת של ראיות ייחודיות. סודות מזוהים מושחרים או גורמים לסירוב; מסננים אינם יכולים לזהות כל סוד ביומנים, תמונות, ארכיונים או נתוני פרויקט שרירותיים.

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