Uma sequência no mesmo parâmetro
Uma rota catch-all captura um ou mais segmentos consecutivos de um caminho. No App Router do Next.js, a pasta [...slug] reúne esses segmentos em uma lista disponível em params. Isso permite tratar caminhos de comprimentos diferentes na mesma página.
Por exemplo, o arquivo app/loja/[...slug]/page.js pode atender /loja/roupas e /loja/roupas/camisas. No segundo endereço, o valor de slug é ['roupas', 'camisas']. A ordem preserva a sequência do caminho para que a página localize a seção ou o item correspondente.
O caminho sem segmentos adicionais
O formato [...slug] exige ao menos um segmento depois de /loja. A variante opcional usa outro par de colchetes: app/loja/[[...slug]]/page.js. Ela também aceita /loja, com o valor de slug igual a undefined.
A página precisa tratar esse valor ausente ao escolher o conteúdo inicial. Você pode conferir os dois formatos acessando o caminho base e um endereço com dois segmentos, observando os valores recebidos pela página.
Rota encontrada e conteúdo ausente
A consulta pode não encontrar conteúdo mesmo quando a rota aceita o endereço. O App Router oferece notFound() para interromper a renderização daquele segmento e mostrar a interface de conteúdo não encontrado. A aplicação precisa realizar a consulta e chamar a função quando o resultado estiver ausente.
Essa verificação merece um teste com um endereço inexistente. O nome catch-all descreve a captura do caminho e não comprova que cada sequência aceita corresponda a um item cadastrado.
Dúvidas frequentes
Perguntas frequentes sobre catch-all
- Qual é a diferença entre slug e catch-all no Next.js?
- Um segmento [slug] captura um valor. O formato [...slug] captura um ou mais segmentos e os reúne em uma lista ordenada.
- Como aceitar também o caminho sem segmentos adicionais?
- A variante [[...slug]] é opcional. Numa rota abaixo de /loja, ela também aceita /loja, com slug igual a undefined.
- A correspondência da rota confirma que o conteúdo existe?
- A página ainda precisa consultar o conteúdo. No App Router do Next.js, notFound() permite interromper a renderização do segmento e apresentar a interface de conteúdo não encontrado.
Para continuar
Recursos relacionados
Documentação
Next.js: segmentos dinâmicos
Mostra a sintaxe dos segmentos catch-all e opcionais e os valores recebidos em params.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar rotas e investigar endereços que exibem conteúdo incorreto ou ausente.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você pode testar os parâmetros das rotas para conferir como a página interpreta um endereço e trata uma consulta sem resultado.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.