תנו למשתמשים עזרה, לא בלבול 
 
 TL;DR: להחליף הודעות שגיאה לא ברורות עם משוב ספציפי וניתן לפעול שיעזור למשתמשים לפתור בעיות. TL;DR: להחליף הודעות שגיאה לא ברורות עם משוב ספציפי וניתן לפעול שיעזור למשתמשים לפתור בעיות. בעיות שנפתרו 
 
 
 
 
 
 
 
 
 
 
 התבלבלות והתסכול של המשתמשים אין נתיב פעיל הניתן ג'ארגן טכני שגיאות לא מטופלות עני UX התאוששות שגיאה מידע שגוי ירידה באמון המשתמשים מסרים גנריים כישלונות שקטים הקוד הקשור לריח https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xx-we-have-reached-100 https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xxxiv https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xv https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-vi-cmj31om https://hackernoon.com/how-to-find-the-stinky-parts-of-your-code-part-xxvii צעדים 
 
 
 
 
 
 זיהוי כל הודעות שגיאה כלליות בסיס הקוד שלך המשתמשות במונחים כגון "Oops", "משהו הלך לא בסדר", או "התרחשה שגיאה" להחליף הודעות כלליות עם תיאורים ספציפיים של מה שקרה הוסף הוראות אפשריות המסבירות למשתמשים בדיוק מה הם יכולים לעשות כדי לפתור את הבעיה יישום יומן פנימי מתאים כדי לתפוס פרטים טכניים עבור מפתחים הוסף אזהרות מעקב כדי להודיע לצוות הפיתוח כאשר טעויות מתרחשות לעתים קרובות קוד דוגמה לפני function processPayment(paymentData) {
  try {
    // Too broad try catch  
    validatePayment(paymentData);
    chargeCard(paymentData);
    sendConfirmation(paymentData.email);
  } catch (error) {
    // Generic error message shown to user
    return {
      success: false,
      userMessage: "Oops! Something went wrong. Please try again.",
      error: error.message
    };
  }
}

function handleError(res, error) {
  // Exposing HTTP 500 to users
  res.status(500).json({
    message: "Internal Server Error",
    error: error.message
  });
}
 אחרי 🙂 function processPayment(paymentData) {
  try {
    validatePayment(paymentData);
    // This catch is specific to payment validation
  } catch (error) {
    // 1. Identify all generic error messages in your codebase
    // that use terms like "Oops", "Something went wrong", 
    // or "An error occurred"    
    // 2. Replace generic messages 
    // with specific descriptions of what happened
    // 3. Add actionable guidance telling users 
    // exactly what they can do to resolve the issue
    // 4. Implement proper internal logging 
    // to capture technical details for developers
    logger.error('Payment validation failed', {
      userId: paymentData.userId,
      error: error.message,
      stack: error.stack,
      timestamp: new Date().toISOString()
    });
    // 5. Add monitoring alerts to notify 
    // the development team when errors occur frequently    
    alerting.notifyError('PAYMENT_VALIDATION_FAILED', error);
    if (error.code === 'INVALID_CARD') {
      return {
        success: false,
        userMessage: "Your card information" + 
        " appears to be incorrect." +
        "Please check your card number," + 
        " expiry date, and security code."
      };
    }
    return {
      success: false,
      userMessage: "There was a problem validating" +
      " your payment." +
      "Please try again or contact support."
    };
  }

  // You should break this long method
  // Using extract method
  try {
    chargeCard(paymentData);
  } catch (error) {
    logger.error('Card charging failed', {
      userId: paymentData.userId,
      error: error.message,
      stack: error.stack,
      timestamp: new Date().toISOString()
    });
    alerting.notifyError('CARD_CHARGING_FAILED', error);
    if (error.code === 'INSUFFICIENT_FUNDS') {
      return {
        success: false,
        userMessage: "Your payment couldn't be processed"+
        " due to insufficient funds. " +
        "Please use a different payment method" + 
        " or contact your bank."
      };
    }
    if (error.code === 'CARD_EXPIRED') {
      return {
        success: false,
        userMessage: "Your card has expired. " +
        "Please update your payment method with a current card."
      };
    }
    return {
      success: false,
      userMessage: "There was a problem processing your payment." +
      " Please try again or contact support."
    };
  }

  try {
    sendConfirmation(paymentData.email);
  } catch (error) {
    logger.error('Confirmation sending failed', {
      userId: paymentData.userId,
      error: error.message,
      stack: error.stack,
      timestamp: new Date().toISOString()
    });
    alerting.notifyError('CONFIRMATION_FAILED', error);
    return {
      success: true,
      userMessage: "Payment processed successfully,"+
      " but we couldn't send the confirmation email." +
      " Please check your email address or contact support."
    };
  }

  return { success: true,
          userMessage: "Payment processed successfully." };
}
 סוג 
 
 [x] מדריך בטיחות ️ Refactoring זה משנה את ההתנהגות והוא בטוח אם אתה שומר על יומן והתראות פעיל עבור דיבוג. הימנע מלהסיר את הפרטים הנדרשים על ידי צוותי התמיכה. הסיכון לשבור שינויים הוא נמוך מכיוון שאתה משפר את ניהול הטעויות הקיימות במקום לשנות את ההיגיון העסקי הבסיסי. למה הקוד טוב יותר? אתה נותן למשתמשים הדרכה שימושית במקום בלבול. אתה יוצר חוויה משתמש טובה יותר על ידי מתן משוב ברור וניתן לפעול במקום בלגן טכני מבולבל. המשתמשים מבינים מה לא בסדר ויודעים את הצעדים הבאים שלהם. אתה מפרק דאגות על ידי שמירה על פרטים טכניים בלוגים תוך הצגת הודעות ידידותיות לעסקים למשתמשים. צוות התמיכה שלך מקבל דיבוג טוב יותר של מידע באמצעות יומן מובנה. באפשרותך לפתור בעיות מערכת באופן אקטיבי באמצעות מעקב אחר אזהרות לפני שהמשתמשים מדווחים עליהן. אתה שומר מידע טכני מהם, אבל עדיין להקליט את זה לפתרון בעיות מהיר יותר. איך זה משפר את ההשפעה? ️ אתם שומרים על התאמה קרובה יותר בין העולם האמיתי לבין המודל שלכם.במקום הודעות "Oops" מעורפלות, המערכת שלכם מדברת במונחים ברורים המשקפים אירועים אמיתיים. הודעות שגיאה ב יש מידע מדויק על מה שקרה ואיך לתקן את זה. העולם האמיתי קופאי לא אומר "אופס, משהו לא בסדר" כאשר הכרטיס שלך נדחה - הם אומרים לך את הבעיה הספציפית ומציע פתרונות. התוכנה מתאימה למודל התוכנה עם דפוסי תקשורת שגיאה, מה שהופך את המערכת לאינטואיטיבית ויעילה יותר למשתמשים Bijection מגבלות ️ עליך להיזהר לא לחשוף מידע רגיש של המערכת שיכול לעזור לתוקפים. ייתכן שחסרונות מסוימים יצטרכו להישאר כלליים מסיבות אבטחה (כגון כישלונות אימות). יתר על כן, יצירת הודעות שגיאה ספציפיות דורשת זמן פיתוח נוסף ובדיוק בדיקות של תסריטי שגיאה. מחזור עם AI 
 
 הצעה: 1.הזהה את כל הודעות השגיאה הגנריות במסד הקוד שלך המשתמשות במונחים כגון "Oops", "משהו הלך לא בסדר", או "התרחשה שגיאה" 2.החליף הודעות גנריות עם תיאורים ספציפיים של מה שקרה 3.הוספת הוראות אפשריות אומר למשתמשים בדיוק מה הם יכולים לעשות כדי לפתור את הבעיה 4.הפעיל יומן פנימי מתאים כדי לתפוס פרטים טכניים עבור מפתחים 5.הוספת אזהרות מעקב כדי ליידע את צוות הפיתוח כאשר שגיאות מתרחשות לעתים קרובות הצעה: 1.הזהה את כל הודעות השגיאה הגנריות במסד הקוד שלך המשתמשות במונחים כגון "Oops", "משהו הלך לא בסדר", או "התרחשה שגיאה" 2.החליף הודעות גנריות עם תיאורים ספציפיים של מה שקרה 3.הוספת הוראות אפשריות אומר למשתמשים בדיוק מה הם יכולים לעשות כדי לפתור את הבעיה 4.הפעיל יומן פנימי מתאים כדי לתפוס פרטים טכניים עבור מפתחים 5.הוספת אזהרות מעקב כדי ליידע את צוות הפיתוח כאשר שגיאות מתרחשות לעתים קרובות 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Without Proper Instructions 
 With Specific Instructions 
 
 
 
 ChatGPT 
 ChatGPT 
 
 
 
 Claude 
 Claude 
 
 
 
 Perplexity 
 Perplexity 
 
 
 
 Copilot 
 Copilot 
 
 
 
 You 
 You 
 
 
 
 Gemini 
 Gemini 
 
 
 
 DeepSeek 
 DeepSeek 
 
 
 
 Meta AI 
 Meta AI 
 
 
 
 Grok 
 Grok 
 
 
 
 Qwen 
 Qwen צ'אט צ'אט קלוד קלוד בלבול בלבול ילד טייס ילד טייס אתה אתה תאומים תאומים DeepSeek DeepSeek מטרה AI מטרה AI גרוק גרוק קווין קווין יום יום ️ 
 
 חריגים רמה 62 
 
 [x] ביניים תגיות קשורות https://hackernoon.com/refactoring-014-how-to-remove-if?embedable=true זהו https://hackernoon.com/fail-fast-philosophy-explained-si963vk9?embedable=true https://www.morling.dev/blog/whats-in-a-good-error-message/?embedable=true https://ulrikapark.wordpress.com/2021/05/03/are-you-sure-people-get-happy-about-your-oops-error-messages-or-does-it-lower-their-trust-in-your-software/?embedable=true https://www.sonarsource.com/learn/error-handling-guide/?embedable=true קרדיט תמונה של הוא ריאן מקגוויר פיקסביי מאמר זה הוא חלק מהסדרה Refactoring. https://maximilianocontieri.com/how-to-improve-your-code-with-easy-refactorings?embedable=true

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

Winner of Noonies 2020 for the award Hacker Noon Contributor of the Year - REFACTORING.

Refactoring 031 - הסרת OOP

About Author

הערות

תלו תגים

מאמר זה הוצג ב

Related Stories

The TechBeat: To Focus or Not Focus: How to Find the Right Product-Market Fit (3/10/2024)

10 Reasons Why Publishing on HackerNoon Will Skyrocket Your Reach and Impact

The TechBeat: Python's Testing Playbook: Building Bulletproof Code (1/16/2024)

100 Days of AI, Day 12: How to Quickly Demo Your Gen AI Experiments to Get Feedback

The TechBeat: To Focus or Not Focus: How to Find the Right Product-Market Fit (3/10/2024)

10 Reasons Why Publishing on HackerNoon Will Skyrocket Your Reach and Impact

The TechBeat: Python's Testing Playbook: Building Bulletproof Code (1/16/2024)

100 Days of AI, Day 12: How to Quickly Demo Your Gen AI Experiments to Get Feedback

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps