We want to hear from you!Take our 2021 Community Survey!
Este site não é mais atualizado.Vá para pt-br.react.dev

State dos Componentes

O que setState faz?

setState() agenda uma atualização para o objeto state de um componente. Quando o state muda, o componente responde renderizando novamente.

Qual é a diferença entre state e props?

props (abreviação de ”properties”) e state são ambos objetos JavaScript. Apesar de ambos guardarem informações que influenciam no resultado da renderização, eles são diferentes por uma razão importante: props são passados para o componente (como parâmetros de funções), enquanto state é gerenciado de dentro do componente (como variáveis declaradas dentro de uma função).

Aqui estão alguns bons recursos para ler mais sobre quando usar props vs state (ambos em inglês):

Por que setState está me dando o valor errado?

Em React, tanto this.props quanto this.state representam os valores renderizados, ou seja, o que está atualmente na tela.

Chamadas para setState são assíncronas - não confie que this.state vá refletir o novo valor imediatamente após chamar setState. Use uma função de atualização ao invés de um objeto se você precisa calcular valores baseado no state atual (veja abaixo para mais detalhes).

Exemplo de código que não vai funcionar como esperado:

incrementCount() {
  // Nota: isso *não* vai funcionar como esperado.
  this.setState({count: this.state.count + 1});
}

handleSomething() {
  // Digamos que `this.state.count` começa em 0.
  this.incrementCount();
  this.incrementCount();
  this.incrementCount();
  // Quando o React renderizar novamente o componente, `this.state.count` será 1, mas você esperava 3.

  // Isso é porque a função `incrementCount()` usa `this.state.count`,
  // mas o React não atualiza `this.state.count` até o componente ser renderizado novamente.
  // Então `incrementCount()` acaba lendo `this.state.count` como 0 todas as vezes, e muda seu valor para 1.

  // A solução é exibida abaixo!
}

Veja abaixo como solucionar esse problema.

Como eu atualizo o state com valores que dependem do state atual?

Passe uma função ao invés de um objeto para setState para garantir que a chamada sempre use o valor mais recente do state (veja abaixo).

Qual é a diferença entre passar um objeto e uma função em setState?

Passar uma função de atualização permite que você acesse o valor atual do state dentro dela. Como as chamadas de setState são feitas em lotes, isso permite que você encadeie atualizações e garanta que elas se componham ao invés de entrar em conflito:

incrementCount() {
  this.setState((state) => {
    // Importante: use `state` em vez de `this.state` quando estiver atualizando.
    return {count: state.count + 1}
  });
}

handleSomething() {
  // Digamos que `this.state.count` começa em 0.
  this.incrementCount();
  this.incrementCount();
  this.incrementCount();

  // Se você ler `this.state.count` agora, ele ainda seria 0.
  // Mas quando o React renderizar novamente o componente, ele será 3.
}

Saiba mais sobre setState

Quando setState é assíncrono?

Atualmente, setState é assíncrono dentro de manipuladores de evento.

Isso garante que, por exemplo, caso tanto Parent quanto Child chamem setState após um evento de clique, Child não seja renderizado duas vezes. Em vez disso, React executa todas as atualizações de estado ao final do evento do navegador. Isso resulta numa melhoria de performance significativa para aplicativos maiores.

Isso é um detalhe de implementação, então evite depender disso diretamente. Em versões futuras, o React fará atualizações em lotes em mais casos.

Por que o React não atualiza this.state síncronamente?

Como explicado na seção anterior, React intencionalmente “espera” até todos os componentes terem chamado setState() em seus manipuladores de evento antes de começar a renderizar novamente. Isso aumenta performance por evitar renderizações desnecessárias.

No entanto, você pode ainda estar se perguntando porque o React simplesmene não atualiza this.state imediatamente, sem renderizar novamente.

Existem duas principais razões:

  • Isso quebraria a consistência entre props e state, causando problemas muito difíceis de debugar.
  • Isso tornaria algumas das novas funcionalidades em que estamos trabalhando impossíveis de implementar.

Esse comentário no GitHub se aprofunda em exemplos específicos.

Eu devo usar uma biblioteca de gerenciamento de state, como Redux ou MobX?

Talvez.

É uma boa ideia se aprofundar em React primeiro, antes de adicionar bibliotecas. Você pode fazer aplicativos bastante complexos apenas com React.

Esta página é útil?Edite esta página