Início·Mensagens de erro

react · JavaScript

A mensagem

Each child in a list should have a unique "key" prop.

O que significa

Os elementos irmãos renderizados como lista não têm key, então o React não consegue pareá-los com os mesmos itens no próximo render. Você criou os elementos com items.map(...) e deixou key de fora; é só um aviso, a tela ainda desenha, mas volta como bug silencioso quando a lista muda — o sintoma é o valor de um input ou uma animação ficar na linha errada. Dê um id estável dos seus dados. Usar o índice do array como key só é seguro numa lista cuja ordem nunca muda e onde nada é inserido ou removido no meio; caso contrário, reproduz quase exatamente o problema de não ter key. A partir do React 19 o Warning: inicial desapareceu.

A correção

Não há um comando de uma linha. A explicação diz o que verificar.

Impresso por
react
JavaScript
15

Erros de navegador e de Node costumam dizer o que quebrou e não por que o valor ficou assim — você leu undefined, não era uma função, não era JSON — então o lugar de corrigir está acima da linha que estourou, e calar só aquela linha com ?. e valores padrão faz o mesmo problema reaparecer mais longe, numa forma mais difícil de reconhecer.

Como ler uma mensagem de erro

  • Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
  • Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
  • Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
  • A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
  • Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.

Perguntas frequentes

Q. O que significa “Each child in a list should have a unique "key" prop.”?

Os elementos irmãos renderizados como lista não têm key, então o React não consegue pareá-los com os mesmos itens no próximo render. Você criou os elementos com items.map(...) e deixou key de fora; é só um aviso, a tela ainda desenha, mas volta como bug silencioso quando a lista muda — o sintoma é o valor de um input ou uma animação ficar na linha errada. Dê um id estável dos seus dados. Usar o índice do array como key só é seguro numa lista cuja ordem nunca muda e onde nada é inserido ou removido no meio; caso contrário, reproduz quase exatamente o problema de não ter key. A partir do React 19 o Warning: inicial desapareceu.

Q. Como corrigir?

Não há comando de uma linha. A explicação acima diz o que verificar.

Q. Qual ferramenta imprime isso?

react. Fica em JavaScript e a mensagem tem 11 palavras.

Erros próximos