<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Leona Souza on Medium]]></title>
        <description><![CDATA[Stories by Leona Souza on Medium]]></description>
        <link>https://medium.com/@leonasouza?source=rss-8a98575f0bbe------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*M1tU0iZpmbU316pZXTMITg.jpeg</url>
            <title>Stories by Leona Souza on Medium</title>
            <link>https://medium.com/@leonasouza?source=rss-8a98575f0bbe------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 06:44:24 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@leonasouza/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Evite que seu React quebre!]]></title>
            <link>https://medium.com/gamersclub/evite-que-seu-react-quebre-c1f23b2d6827?source=rss-8a98575f0bbe------2</link>
            <guid isPermaLink="false">https://medium.com/p/c1f23b2d6827</guid>
            <category><![CDATA[sentry]]></category>
            <category><![CDATA[react]]></category>
            <dc:creator><![CDATA[Leona Souza]]></dc:creator>
            <pubDate>Wed, 13 Sep 2023 17:11:21 GMT</pubDate>
            <atom:updated>2023-09-28T13:04:32.478Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*95VNf2DAn2Q8gsYLfgAtvQ.jpeg" /></figure><p>Sabe aquela situação em que sua aplicação em React simplesmente desaparece do nada e, quando você vai debugar, descobre que o JavaScript estava tentando acessar uma propriedade indefinida? Seus problemas acabaram! Hoje vou comentar como implementamos o tratamento de erros no front-end da Gamers Club e, de bônus, dicas de como implementamos o Sentry para monitoramento de front-end.</p><h3>Problema: “cannot read property of undefined”</h3><p>Mesmo usando TypeScript, às vezes os objetos que utilizamos podem ser alterados de forma inesperada. Por exemplo, quando um endpoint não retorna um dado que o front estava esperando. Nesses casos o JavaScript produz um erro e o React não sabe muito bem como reagir. Vamos usar como exemplo a seguinte estrutura:</p><pre>&lt;Container&gt;<br>  &lt;List&gt;<br>    &lt;Produto id={1} /&gt;<br>  &lt;/List&gt;<br>&lt;/Container&gt;</pre><p>Vamos supor que, dentro do componente <strong>Produto,</strong> o endpoint que retorna os dados do produto não está funcionando como o esperado. O React tenta ler <strong>produto.nome</strong> (ainda dentro de <strong>Produto</strong>), mas não há <strong>nome</strong> no objeto. O erro acontece em <strong>Produto</strong>, mas o React procura algum tratamento fora do componente, no nosso caso em <strong>List</strong>. Mas também não há tratamento no <strong>List</strong>, então o React procura algum tratamento em <strong>Container</strong>. Chegamos no último componente possível e não há tratamento para o erro, então o React simplesmente vai tomar um cafezinho e desaparece.</p><h3>Solução: ErrorBoundary</h3><p>Segundo a própria documentação do React, podemos tratar os erros usando um componente chamado <strong>ErrorBoundary</strong> (veja a estrutura do componente <a href="https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary">clicando aqui</a>). Esse componente deve ser um componente de classe (até o momento que esse artigo foi escrito) e deve envelopar componentes suscetíveis a erro. Veja a seguir como ficaria nosso componente de produto:</p><pre>&lt;Container&gt;<br>  &lt;List&gt;<br>    &lt;ErrorBoundary fallback={&lt;ErrorFallback onError={() =&gt; cry()} /&gt;}&gt;<br>      &lt;Produto id={1} /&gt;<br>    &lt;/ErrorBoundary&gt;<br>  &lt;/List&gt;<br>&lt;/Container&gt;</pre><p>Agora, quando o erro acontecer em <strong>Produto</strong>, o React vai encontrar um tratamento no componente pai (<strong>ErrorBoundary</strong>). O componente pai vai parar o erro por ali e, ao invés de sumir, vai exibir o que passamos como fallback, que pode ser outro componente JSX, no lugar do componente filho. Na Gamers Club criei um componente chamado <strong>ErrorFallback</strong>, onde customizamos visualmente a mensagem de erro, callbacks e outras coisas.</p><p>Um exemplo prático da utilidade dos componentes é que temos vários produtos que ficam à mostra na loja da GC e, quando algum deles dava problema, a loja inteira sumia. Agora, se houver erro, apenas o produto com erro será substituído por um componente visual de erro e o restante da loja continuará funcionando normalmente.</p><h3>Como saber que há erros?</h3><p>Uma das melhores partes de usar <strong>ErrorBoundary </strong>é usar o método interno chamado <strong>componentDidCatch() </strong>que pode executar funções quando houver um erro capturado. Ou seja, podemos registrar logs via <strong>Sentry</strong>, que é uma das ferramentas mais populares para monitoramento de erros de aplicações. Instalei a biblioteca <strong>@sentry/react</strong> e fiz assim:</p><pre>public componentDidCatch(error: Error, info: ErrorInfo) {<br>    Sentry.withScope((scope) =&gt; {<br>      scope.setExtra(&#39;componentStack&#39;, info) // informação opcional<br>      scope.setExtra(&#39;userId&#39;, userId) // informação opcional<br>      Sentry.captureException(error)<br>    })<br><br>    this.props.onError &amp;&amp; this.props.onError()<br>  }</pre><p>Pronto! Agora é só ficar de olho no dashboard do Sentry e monitorar o projeto. Você pode ficar sabendo quando algum erro acontece antes mesmo que haja uma reclamação e ainda terá informações suficientes para debugar.</p><h3>Dicas de configurações para React + Sentry</h3><p>Dependendo do tamanho do seu projeto pode ser que você receba um número muito alto de erros de bibliotecas externas ou erros que na verdade não são erros. Muitos desses erros podem ser ignorados e só poluem o histórico no dashboard. Podemos contornar esse problema de algumas formas no arquivo de configuração (caso não saiba configurar, <a href="https://docs.sentry.io/platforms/javascript/guides/react/">veja aqui</a>).</p><blockquote>defaultIntegrations</blockquote><pre>Sentry.init({<br>  dsn: SENTRY_DSN,<br>  defaultIntegrations: false<br>})</pre><p>O <strong>defaultIntegrations</strong> como false vai impedir registros automáticos do Sentry. Neste caso os únicos registros serão os chamados “na mão” com o <strong>Sentry.captureException(error)</strong> citado anteriormente no <strong>componentDidCatch()</strong>.</p><blockquote>sampleRate</blockquote><pre>Sentry.init({<br>  dsn: SENTRY_DSN,<br>  sampleRate: 0.1 // equivalente a 10%<br>})</pre><p>O <strong>sampleRate </strong>vai limitar a quantidade de registros a uma porcentagem passada como valor. No exemplo acima só teremos registros de 10% dos erros. Isso é muito útil em projetos grandes, onde apenas uma pequena amostra pode ser suficiente.</p><blockquote>ignoreErrors</blockquote><pre>const ignoreErrors = [<br>  /pedaço da mensagem de erro/i,<br>  &quot;Cannot read properties of null (reading &#39;nome&#39;)&quot;<br>]<br><br>Sentry.init({<br>  dsn: SENTRY_DSN,<br>  ignoreErrors<br>})</pre><p>O <strong>ignoreErrors </strong>vai ignorar um array de erros que possuam a mensagem igual (no caso de strings) ou parcial (via regex). Mas atenção, pois essa configuração pode não funcionar caso a opção <strong>defaultIntegrations</strong> esteja como false. A razão disso é que uma das integrations do Sentry é responsável justamente por essa filtragem (saiba mais sobre integrations <a href="https://docs.sentry.io/platforms/javascript/guides/react/configuration/integrations/">clicando aqui</a>). Caso você queira desabilitar todas as integrations, como citei anteriormente, exceto a responsável por essa filtragem, faça uma combinação como essa:</p><pre>const ignoreErrors = [<br>  /pedaço da mensagem de erro/i,<br>  &quot;Cannot read properties of null (reading &#39;nome&#39;)&quot;<br>]<br><br>Sentry.init({<br>  dsn: SENTRY_DSN,<br>  defaultIntegrations: false,<br>  integrations: [new Sentry.Integrations.InboundFilters()],<br>  ignoreErrors<br>})</pre><blockquote>beforeSend()</blockquote><p>Por fim, podemos usar o método <strong>beforeSend()</strong> para customizar o erro antes de ser enviado e até mesmo ignorá-lo (leia mais <a href="https://docs.sentry.io/platforms/javascript/guides/react/configuration/filtering/">clicando aqui</a>).</p><pre>const environment = process.env.NODE_ENV<br><br>Sentry.init({<br>  dsn: SENTRY_DSN,<br>  beforeSend: (event) =&gt; {<br>    if (environment === &#39;production&#39;) {<br>      return event<br>    }<br><br>    return null<br>  },<br>})</pre><blockquote><strong>Referência e leitura adicional</strong></blockquote><blockquote><a href="https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary">https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary</a><br><a href="https://docs.sentry.io/platforms/javascript/guides/react/">https://docs.sentry.io/platforms/javascript/guides/react/</a></blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c1f23b2d6827" width="1" height="1" alt=""><hr><p><a href="https://medium.com/gamersclub/evite-que-seu-react-quebre-c1f23b2d6827">Evite que seu React quebre!</a> was originally published in <a href="https://medium.com/gamersclub">Gamers Club - Escuro Baixo (de 🏡)</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Retorno dinâmico em funções usando React e TypeScript]]></title>
            <link>https://medium.com/gamersclub/retorno-din%C3%A2mico-em-fun%C3%A7%C3%B5es-usando-react-e-typescript-8aca8e406b24?source=rss-8a98575f0bbe------2</link>
            <guid isPermaLink="false">https://medium.com/p/8aca8e406b24</guid>
            <category><![CDATA[typescript]]></category>
            <category><![CDATA[react]]></category>
            <dc:creator><![CDATA[Leona Souza]]></dc:creator>
            <pubDate>Wed, 16 Aug 2023 23:56:11 GMT</pubDate>
            <atom:updated>2023-08-23T17:58:13.778Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="React and Typescript logos" src="https://cdn-images-1.medium.com/max/1024/1*9JgJVpakezXsbPkRWIYRIA.jpeg" /></figure><p>Olá, me chamo Leona Souza, trabalho na Gamers Club há pouco mais de dois anos como desenvolvedora front-end e decidi comentar sobre uma situação que aconteceu comigo durante o trabalho. Os nomes dos arquivos e variáveis utilizados no artigo são fictícios, mas a aplicação dos conceitos apresentados é 100% utilizável.</p><p>Há muito tempo escrevi uma função que faz uma consulta ao banco de dados via endpoint e retorna um tipo de registro. Recentemente surgiu a necessidade de alterar esse endpoint para que tenha mais de um possível retorno dependendo de uma variável na url. Ao invés de escrever uma função diferente para consumir o endpoint com variável (visto que os retornos são diferentes), pensei se seria possível reaproveitar a função tornando dinâmico o tipo do retorno.</p><p>No front-end com <strong>TypeScript </strong>usar uma função com mais de um possível retorno pode ser um pouco problemático, pois o <strong>TS</strong> interpreta o valor da função como “<strong>Tipo1 | Tipo2”</strong> e isso pode gerar alguns conflitos de tipo nos estados do React. Vamos analisar dois componentes fictícios chamados <strong>Listagem.tsx</strong> e <strong>services.ts</strong>.</p><blockquote>services.ts</blockquote><pre>export interface Usuario {<br>  id: number;<br>  nome: string;<br>}<br><br>export interface Paginacao&lt;T&gt; {<br>  resultados: T[];<br>  pagina: number;<br>  total: number;<br>}<br><br>export const PAGINACAO_INICIAL = {<br>  resultados: [],<br>  pagina: 1,<br>  total: 10<br>};<br><br>interface Props {<br>  devePaginar?: boolean;<br>}<br><br>export const getUsuarios = async (<br>  props: Props<br>): Promise&lt;Usuario[] | Paginacao&lt;Usuario&gt;&gt; =&gt; {<br>  const { devePaginar } = props || false<br>  // Há outras formas de converter para string, mas vamos simplificar<br>  const params = devePaginar ? &quot;?paginado=true&quot; : &quot;&quot;;<br>  const retorno = await fetch(`url.com/usuarios${params}`);<br>  return retorno.json();<br>};</pre><p>Esse código funciona perfeitamente, porém na hora de passar o resultado para algum estado do React teremos que especificar “na mão” qual é o tipo esperado (type assertion), pois erros podem acontecer.</p><blockquote>Listagem.tsx:</blockquote><pre>const [usuarios, setUsuarios] = useState&lt;Usuario[]&gt;([]);<br>const [paginados, setPaginados] = useState&lt;Paginacao&lt;Usuario&gt;&gt;(<br>  PAGINACAO_INICIAL<br>);<br><br>const carregarDados = async () =&gt; {<br>  // getUsuarios retorna Usuario[] | Paginacao&lt;Usuario&gt;<br>  const listaNormal = await getUsuarios();<br>  setUsuarios(listaNormal); // Erro. O estado espera apenas Usuario[]<br>  const listaPaginada = await getUsuarios({ devePaginar: true });<br>  setPaginados(listaPaginada); // Erro. O estado espera apenas Paginacao&lt;Usuario&gt;<br>};<br><br>useEffect(() =&gt; {<br>  carregarDados();<br>}, []);</pre><blockquote>Uma forma simples de resolver esse problema:</blockquote><pre>setUsuarios(listaNormal as Usuario[]);<br>setPaginados(listaPaginada as Paginacao&lt;Usuario&gt;);</pre><p>No entanto, pensando em escalabilidade, seria necessário fazer isso em todos os casos em que a função é chamada. Particularmente acredito que é melhor fazer a conferência apenas uma vez, direto na função. E, já que quem “reclama” é o TS, vamos ensiná-lo que o retorno pode ser dinâmico.</p><blockquote>services.ts:</blockquote><pre>interface Props {<br>  devePaginar?: boolean;<br>}<br><br>export const getUsuarios = async &lt;<br>  T extends Props, // *1<br>  P = T[&quot;devePaginar&quot;] extends true ? Paginacao&lt;Usuario&gt; : Usuario[] // *2<br>&gt;(<br>  props?: T<br>): Promise&lt;P&gt; =&gt; { // *3<br>  const { devePaginar } = props || {};<br>  const params = devePaginar ? &quot;?paginado=true&quot; : &quot;&quot;;<br>  const retorno = await fetch(`url.com/usuarios${params}`);<br>  return retorno.json();<br>};<br><br>// *Explicações à seguir</pre><p>Essa função deixou de ter <strong>Promise&lt;Usuario[] | Paginacao&lt;Usuario&gt;&gt; </strong>como retorno fixo e agora tem um retorno dinâmico dependendo da configuração que passamos na hora de consumir o endpoint. Se utilizarmos a variável <strong>devePaginar </strong>como <strong>true</strong> a função retorna apenas <strong>Promise&lt;Paginacao&lt;Usuario&gt;&gt;</strong>. Se não utilizarmos uma configuração, ou <strong>devePaginar </strong>seja <strong>false</strong>, a função retorna apenas <strong>Promise&lt;Usuario[]&gt;</strong>. Para isso estamos dizendo ao TS que vamos trabalhar com dois tipos chamados <strong>T</strong> e <strong>P</strong>, que são genéricos.</p><ul><li><strong>1) T</strong> é um objeto com a chave opcional <strong>devePaginar</strong> do tipo <strong>boolean</strong>.</li><li><strong>2)</strong> Depois definimos o valor de <strong>P</strong>, que é dinâmico, utilizando um operador ternário. Dizemos que, se existir a propriedade <strong>devePaginar </strong>com valor <strong>true </strong>no nosso tipo <strong>T</strong>, significa que <strong>P</strong> terá o valor <strong>Paginacao&lt;Usuario&gt;</strong>. Em qualquer outro caso o valor de <strong>P</strong> será <strong>Usuario[]</strong>.</li><li><strong>3)</strong> Agora basta dizer que o retorno da função é <strong>Promise&lt;P&gt;</strong> e o TS fará a conferência em todos os casos que formos utilizar a função.</li></ul><pre>const [usuarios, setUsuarios] = useState&lt;Usuario[]&gt;([]);<br>const [paginados, setPaginados] = useState&lt;Paginacao&lt;Usuario&gt;&gt;(<br>  PAGINACAO_INICIAL<br>);<br><br>const carregarDados = async () =&gt; {<br>  const listaNormal = await getUsuarios();<br>  setUsuarios(listaNormal); // Sem erros<br>  const listaPaginada = await getUsuarios({ devePaginar: true });<br>  setPaginados(listaPaginada); // Sem erros<br>};</pre><p>Caso queira ver o código completo, ou até mesmo fazer modificações para testes, visite: <a href="https://codesandbox.io/s/quirky-thunder-hzfqs4">https://codesandbox.io/s/quirky-thunder-hzfqs4</a></p><blockquote><strong>Referência e leitura adicional</strong></blockquote><blockquote><a href="https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#type-assertions">https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#type-assertions</a><br><a href="https://www.typescriptlang.org/docs/handbook/2/conditional-types.html">https://www.typescriptlang.org/docs/handbook/2/conditional-types.html</a></blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8aca8e406b24" width="1" height="1" alt=""><hr><p><a href="https://medium.com/gamersclub/retorno-din%C3%A2mico-em-fun%C3%A7%C3%B5es-usando-react-e-typescript-8aca8e406b24">Retorno dinâmico em funções usando React e TypeScript</a> was originally published in <a href="https://medium.com/gamersclub">Gamers Club - Escuro Baixo (de 🏡)</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>