Pomoć korisnicima, a ne zbunjenost 
 
 TL;DR: Zamijenite nejasne poruke o greškama specifičnim, djelotvornim povratnim informacijama koje pomažu korisnicima da reše probleme. TL;DR: Zamijenite nejasne poruke o greškama specifičnim, djelotvornim povratnim informacijama koje pomažu korisnicima da reše probleme. Problemi rešeni 
 
 
 
 
 
 
 
 
 
 
 Korisnik zbunjenost i frustracije Nema akcijskog uputstva Tehnički jargon Loše obrađene greške siromašan užitak Loša greška oporavak Nepotpune greške u informacijama Smanjeno povjerenje korisnika Generičke poruke Tihi neuspeh Povezani tekstovi: Miris 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 Koraci 
 
 
 
 
 
 Identificirajte sve generičke poruke o greškama u vašoj bazi kodova koje koriste izraze kao što su "Oops", "Nešto nije u redu" ili "Došlo je do greške" Zamijenite generičke poruke specifičnim opisima onoga što se dogodilo Dodajte akcionarne smjernice koje korisnicima govore tačno šta mogu učiniti kako bi riješili problem Implementacija odgovarajućeg unutrašnjeg dnevnika za snimanje tehničkih detalja za programere Dodajte alarme za praćenje kako biste obavijestili razvojni tim kada se pogreške često javljaju Sample kod Prije 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
  });
}
 Posle 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." };
}
 Vrste 
 
 [x] Priručnik Bezbednost ️ Ovo refaktoriranje mijenja ponašanje i sigurno je ako nastavite da registrujete i aktivirate alarme za debugiranje. Izbjegavajte uklanjanje detalja potrebnih od strane timova podrške. Rizik od prekida promjena je nizak jer poboljšavate postojeće rješavanje grešaka, a ne mijenjate osnovnu poslovnu logiku. Zašto je kod bolji? Vi dajete korisnicima korisne smjernice umjesto zbunjenosti. Kreirate bolje korisničko iskustvo pružanjem jasnih, djelotvornih povratnih informacija umjesto zbunjujućeg tehničkog žargona. Korisnici shvataju šta je pogrešno i znaju svoje sljedeće korake. Odvojite brige održavanjem tehničkih detalja u logovima dok korisnicima prikazujete poslovne poruke. Vaš tim podrške dobija bolje debugiranje informacija putem strukturiranog logiranja. Možete proaktivno rješavati sistemske probleme praćenjem upozorenja prije nego što ih korisnici prijavljuju. Čuvate tehničke informacije daleko od njih, ali ih i dalje beležite za brže rješavanje problema. Kako to poboljšava bijection? ️ Umesto nejasnih "Oops" poruka, vaš sistem govori u jasnim izrazima koji odražavaju stvarne događaje. Poruke o greškama u sadrži specifične informacije o tome šta je pogrešno i kako ga ispraviti. Stvarni svet Blagajnik ne kaže "Oops, nešto nije u redu" kada je vaša kartica odbijena - oni vam kažu specifičan problem i predlažu rješenja. Ovaj refaktoring usklađuje softverski model sa uzorci komunikacije o greškama, čineći sistem intuitivnijim i korisnijim za korisnike Bijecija Ograničenja ️ Morate biti oprezni da ne otkrivate osetljive informacije o sustavu koji bi mogli pomoći napadačima. Neke greške mogu morati ostati generičke iz sigurnosnih razloga (kao što su neuspjesi autentifikacije). Osim toga, stvaranje specifičnih poruka o greškama zahtijeva više vremena za razvoj i temeljito testiranje scenarija grešaka. Reaktor sa AI 
 
 Predložena poruka: 1. Identificirajte sve generičke poruke o greškama u vašoj bazi kodova koje koriste pojmove kao što su "Oops", "Nešto je išlo pogrešno" ili "Došlo je do greške" 2. Zamijenite generičke poruke specifičnim opisima onoga što se dogodilo 3. Dodajte pokretne smjernice koje korisnicima govore tačno šta mogu učiniti kako bi riješili problem 4. Implementirajte odgovarajuće unutarnje beleženje kako biste uhvatili tehničke detalje za programere 5. Dodajte upozorenja za praćenje kako biste obavijestili razvojni tim kada se greške često javljaju. Predložena poruka: 1. Identificirajte sve generičke poruke o greškama u vašoj bazi kodova koje koriste pojmove kao što su "Oops", "Nešto je išlo pogrešno" ili "Došlo je do greške" 2. Zamijenite generičke poruke specifičnim opisima onoga što se dogodilo 3. Dodajte pokretne smjernice koje korisnicima govore tačno šta mogu učiniti kako bi riješili problem 4. Implementirajte odgovarajuće unutarnje beleženje kako biste uhvatili tehničke detalje za programere 5. Dodajte upozorenja za praćenje kako biste obavijestili razvojni tim kada se greške često javljaju. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 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 Čačak Čačak Klod Klod zbunjenost zbunjenost Piloti Piloti ti ti Blizanci Blizanci duboko duboko Cilj AI Cilj AI Grožđe Grožđe Knjiga Knjiga U toku dana ️ 
 
 Iznimke Nivo 
 
 [x] Posrednik Povezane teme https://hackernoon.com/refactoring-014-how-to-remove-if?embedable=true Ovako 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 Krediti Slika od je Rajan Mekguir Pixabay izveštaji Ovaj članak je deo serije 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.

031 - Uklanjanje OOP-a

About Author

KOMENTARI

HANG TAGS

OVAJ ČLANAK JE PREDSTAVLJEN U

Related Stories

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps