Gebruikers help, nie verwarring nie 
 
 TL;DR: vervang vage foutboodskappe met spesifieke, werkbare terugvoer wat gebruikers help om probleme op te los. TL;DR: vervang vage foutboodskappe met spesifieke, werkbare terugvoer wat gebruikers help om probleme op te los. Die probleme wat opgelos word 
 
 
 
 
 
 
 
 
 
 
 Gebruikersverwarring en frustrasie Geen werklike leiding gegee nie Tegniese jargon Slegte onbehandelde foute Slegte UX Slegte fout herstel Onvolledige verkeerde inligting Verminderde gebruikersvertroue Generiese boodskappe Stille mislukkings Geskiedenis van die geur 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 Die stappe 
 
 
 
 
 
 Identifiseer al die algemene foutboodskappe in jou kode base wat terme gebruik soos "Oops", "Iets het verkeerd gegaan", of "'n fout plaasgevind" Vervang algemene boodskappe met spesifieke beskrywings van wat gebeur het Voeg aktiewe riglyne by wat gebruikers presies vertel wat hulle kan doen om die probleem op te los Implementeer behoorlike interne logging om tegniese besonderhede vir ontwikkelaars te vang Voeg waarskuwings by om die ontwikkelingsteam in kennis te stel wanneer foute gereeld voorkom Sample kode Voordat die 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
  });
}
 Na die 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." };
}
 Die tipe 
 
 [x] Handleiding Veiligheid ️ Hierdie refaktoring verander die gedrag en is veilig as jy die logging en waarskuwings aktief hou vir debugging. Vermy die verwydering van besonderhede wat deur ondersteuningsteams benodig word. Die risiko om veranderinge te breek, is laag, aangesien jy bestaande foutbestuur verbeter eerder as om kernbedryfslogika te verander. Hoekom is die kode beter? Jy gee gebruikers nuttige leiding in plaas van verwarring. Jy skep 'n beter gebruikerservaring deur duidelike, werkbare terugvoer te verskaf in plaas van verwarrende tegniese jargon. Gebruikers verstaan wat verkeerd gegaan het en weet hul volgende stappe. Jy skei bekommernisse deur tegniese besonderhede in logboeke te hou terwyl jy besigheidsvriendelike boodskappe aan gebruikers wys. Jou ondersteuningspan kry beter debugging inligting deur gestruktureerde logging. U kan stelselprobleme proaktief aanpak deur waarschuwings te monitor voordat gebruikers dit rapporteer. Jy hou tegniese inligting weg van hulle, maar nog steeds registreer dit vir vinniger probleemoplossing. Hoe maak dit die bijection beter? ️ Jy hou 'n nader ooreenkoms tussen die werklike wêreld en jou model. In plaas van vaag "Oops" boodskappe, praat jou stelsel in duidelike terme wat werklike gebeure weerspieël. Foute boodskappe in die bevat spesifieke inligting oor wat verkeerd gegaan het en hoe om dit te herstel. Die werklike wêreld 'N kassier sê nie "Oops, iets het verkeerd gegaan" wanneer jou kaart geweier word nie - hulle vertel jou die spesifieke probleem en stel oplossings voor. Hierdie refactoring ooreenstem die sagteware model met foute kommunikasie patrone, maak die stelsel meer intuïtief en nuttig vir gebruikers Bijeksie Beperkings ☀️ Jy moet versigtig wees om nie sensitiewe stelsel inligting bloot te stel wat aanvallers kan help nie. Sommige foute moet uit sekuriteitsgronde algemeen bly (soos oortredings). Daarbenewens vereis die skep van spesifieke foutboodskappe meer ontwikkelings tyd en grondige toetsing van foute-scenario's. Refleksie met die 
 
 Voorgestelde prompt: 1. Identifiseer al die algemene foutboodskappe in jou kode-basis wat terme soos "Oops", "Iets misgegaan het", of "'n fout gebeur het" gebruik 2. Vervang algemene boodskappe met spesifieke beskrywings van wat gebeur het 3. Voeg werkbare leiding toe wat gebruikers presies vertel wat hulle kan doen om die probleem op te los 4. Implementeer behoorlike interne logging om tegniese besonderhede vir ontwikkelaars te vang 5. Voeg moniteringsalarms by om die ontwikkelingsteam te kennis te stel wanneer foute gereeld voorkom. Voorgestelde prompt: 1. Identifiseer al die algemene foutboodskappe in jou kode-basis wat terme soos "Oops", "Iets misgegaan het", of "'n fout gebeur het" gebruik 2. Vervang algemene boodskappe met spesifieke beskrywings van wat gebeur het 3. Voeg werkbare leiding toe wat gebruikers presies vertel wat hulle kan doen om die probleem op te los 4. Implementeer behoorlike interne logging om tegniese besonderhede vir ontwikkelaars te vang 5. Voeg moniteringsalarms by om die ontwikkelingsteam te kennis te stel wanneer foute gereeld voorkom. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 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 Die chat Die chat Claude se Claude se Verwarring Verwarring Kindpilot Kindpilot Jy Jy Tweeling Tweeling Diepe soek Diepe soek Die doel Die doel Groen Groen Kwen Kwen Volgende jaar ️ 
 
 uitsonderings Die vlak 
 
 [x] Die middelste Gerelateerde verwysings https://hackernoon.com/refactoring-014-how-to-remove-if?embedable=true Dit is die 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 Krediet Foto deur die Ryan McGuire se lewe Die Pixabay Hierdie artikel is deel van die Refactoring-reeks. 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 - Verwydering van OOPs

About Author

KOMMENTAAR

HANG TAGS

HIERDIE ARTIKEL IS AANGEBIED IN

Related Stories

"Walk Down the Road of Life Without Fearing Anything" Max Azarov, CEO and Co-Founder, Novakid

'Decentralization Means Freedom': Interview with Alfredo de Candia

Startups of The Year: Meet the Business Industry

$30M Raised in 30 Minutes and the Controversies to Follow: The Story Behind Dexter’s GM.ai Project

"Walk Down the Road of Life Without Fearing Anything" Max Azarov, CEO and Co-Founder, Novakid

'Decentralization Means Freedom': Interview with Alfredo de Candia

Startups of The Year: Meet the Business Industry

$30M Raised in 30 Minutes and the Controversies to Follow: The Story Behind Dexter’s GM.ai Project

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps