Migrando do Svelte 4 para o 5

Svelte 5 é, em grande parte, compatível com versões anteriores. É possível migrar componente por componente.

Execute o script de migração para converter automaticamente a sintaxe legada.

A ferramenta de transformação reescreve export let como $props(), $: como $derived/$effect e assim por diante.

Revise sempre o código migrado. Alguns padrões exigem decisões manuais.

As sintaxes antiga e nova podem coexistir no mesmo arquivo; Svelte 5 detecta a sintaxe em cada bloco.

Os proxies de $state tornam array.push() reativo. Você pode excluir as antigas reatribuições de contorno.

createEventDispatcher é substituído por propriedades de retorno transmitidas por meio de $props().

Os slots continuam funcionando; considere reescrevê-los como fragmentos nos componentes novos.

svelte/store continua sendo compatível. É possível continuar usando stores ou refatorar o estado do aplicativo para $state.

A maioria das bibliotecas tem como alvo as duas versões; atualize um componente por vez.

A documentação do Svelte 5 inclui um guia de migração com comparações lado a lado.

Migre para o Svelte 5 com npx sv migrate svelte-5; a sintaxe antiga continua funcionando para uma adoção gradual.