המרת YAML ל־JSON ובדיקת הרחבת ההגדרות המשותפות
המירו בדפדפן YAML עם זמן המתנה ומספר ניסיונות משותפים ל־JSON, בדקו ערכים שהתקבלו בירושה ונדרסו, ואז ערכו JSON והחזירו אותו ל־YAML. כולל הטיפול בהערות ובעוגנים.
נגדיר זמן המתנה משותף של 30 שניות ושני ניסיונות חוזרים, אבל בסביבת התצוגה המקדימה נגדיר אפס ניסיונות. YAML מאפשר להפנות להגדרות משותפות, אך ככל שהתצורה מתארכת קשה יותר לעקוב אחר המקור של כל ערך. ממיר YAML ⇄ JSON מאפשר להמיר ל־JSON ולבדוק את התוצאה לאחר הרחבת ההפניות.
הרחבת הגדרות YAML משותפות בתוך JSON
הדביקו את הדוגמה הבאה בשדה „YAML” משמאל. לשימוש בקובץ, בחרו באפשרות טעינת קובץ YAML, הנקראת „Load YAML file” בממשק האנגלי. &defaults נותן שם להגדרות המשותפות, ו־<<: *defaults ממזג אותן לתוך preview.
# Shared request settings
defaults: &defaults
timeoutSeconds: 30
retries: 2
preview:
<<: *defaults
retries: 0
לחצו על „YAML → JSON”. התוצאה תופיע בשדה „JSON” מימין. preview.timeoutSeconds יורש את הערך 30 מההגדרות המשותפות, ואילו ההגדרה המפורשת של preview.retries מקבלת עדיפות ולכן ערכו 0. defaults.retries נשאר 2.
עריכת JSON והמרה חזרה ל־YAML
- בשדה JSON מימין, שנו בתוך
previewאת"timeoutSeconds": 30ל־"timeoutSeconds": 10. השאירו את הערך ב־defaultsכ־30. - לחצו על כפתור האימות מימין, שבממשק האנגלי נקרא „Validate: JSON → YAML → JSON”. YAML חדש יופיע משמאל ותוצאת האימות תוצג מתחת לשדות. ודאו ש־
preview.timeoutSecondsמשמאל הוא10. - כדי לשמור את תוצאת ההמרה בקובץ, העתיקו את תוכן השדה הדרוש לעורך טקסט ושמרו אותו.
כאשר צריך לשמור על הערות או טיפוסי נתונים
JSON אינו מכיל את ההערות או את שמות העוגנים של ה־YAML המקורי. בכלי זה, לחיצה על „JSON → YAML” באותו עמוד עשויה להחזיר את הטקסט המקורי שנשמר, אם נתוני ה־JSON שקולים ל־YAML המקורי. כאשר עורכים ערך כמו בדוגמה זו, נוצר YAML חדש מהנתונים המורחבים. כדי לשנות רק את זמן ההמתנה ולהשאיר את ההערות וההפניות המשותפות, הוסיפו timeoutSeconds: 10 אל preview ב־YAML המקורי.
האימות שמתחיל ב־YAML, „Validate: YAML → JSON → YAML”, מפיק JSON ושומר את טקסט ה־YAML המקורי. לדוגמה, גם אם אימות limit: .nan מדווח על הצלחה, ב־JSON מתקבל "limit": null. בעת העברת הגדרות שבהן טיפוסי הנתונים חשובים, בדקו גם את הערכים שהומרו באופן ישיר.