TypeScript · Intermediário · Inglês · Técnico
path mapping
Opção paths do tsconfig que cria apelidos de importação, como '@/*' apontando para src/*. O compilador resolve o apelido, mas não reescreve o import no JavaScript gerado.
Onde usar
Aparece em projetos com imports profundos, como '../../../utils'. Funciona no editor, mas quebra em runtime se o bundler ou o Node não conhecerem o mesmo apelido.
Em código
{
"compilerOptions": {
"paths": {
"@/*": ["./src/*"]
}
}
}Exemplos
Path mapping works in the editor but the build can't find it.
O path mapping funciona no editor, mas o build não encontra.
Add the same alias to the bundler config.
Adicione o mesmo alias na configuração do bundler.
Cuidado
O paths só diz ao verificador de tipos onde achar o arquivo; configure o mesmo alias no bundler ou no Jest, senão o build compila e a execução falha.
Sinônimos
paths, alias de importação