O ajuste acontece no texto do caminho
Um caminho normalizado é uma string de caminho com os segmentos e os separadores ajustados pelas convenções de uma função ou sistema. No Node.js, path.normalize trata segmentos como ., que indica o diretório atual, e .., que indica o diretório anterior. Também reúne separadores consecutivos conforme a plataforma.
Essa função recebe uma string e devolve outra, sem abrir o arquivo indicado. O resultado depende das convenções utilizadas: o Node.js oferece path.posix para caminhos POSIX e path.win32 para caminhos Windows. Escolher uma dessas versões permite explicitar o formato tratado pelo código.
De uma sequência relativa a outra
Neste exemplo didático em Node.js, a versão POSIX trata um caminho relativo com uma referência ao diretório anterior e uma barra repetida:
import path from 'node:path'
console.log(path.posix.normalize('relatorios/../imagens//logo.png'))// Resultado: imagens/logo.pngO segmento .. cancela textualmente relatorios. As duas barras entre imagens e logo.png viram uma só. O resultado continua relativo e não informa se a imagem existe ou se a aplicação tem permissão para abri-la.
O destino exige outra conferência
Links simbólicos podem fazer o sistema de arquivos percorrer um destino diferente daquele sugerido pelo ajuste textual. A própria documentação do Node.js ressalva que remover segmentos .. pode mudar como o sistema resolve um caminho. Portanto, a normalização não comprova que duas strings levam ao mesmo arquivo.
Você precisa conferir o destino permitido pela aplicação e tratar o acesso efetivo ao arquivo. Um caminho como ../privado.txt pode continuar contendo uma referência ao diretório anterior depois da normalização. Reescrever a string não concede permissão nem restringe a consulta a uma pasta autorizada.
Dúvidas frequentes
Perguntas frequentes sobre caminho normalizado
- Normalizar um caminho confirma que o arquivo existe?
- No Node.js, path.normalize trabalha com a string recebida. A existência do arquivo só pode ser conferida por uma consulta ao sistema de arquivos.
- Um caminho normalizado sempre é absoluto?
- A normalização pode produzir um caminho relativo. No exemplo do verbete, imagens/logo.png continua relativo, pois a função não acrescenta o diretório atual.
- A normalização resolve links simbólicos e autoriza o acesso?
- path.normalize não consulta o destino dos links simbólicos nem as permissões do arquivo. A aplicação precisa verificar o destino permitido e tratar a abertura do arquivo.
Para continuar
Recursos relacionados
Documentação
Node.js: normalização textual de caminhos
Descreve o tratamento de segmentos relativos e separadores em path.normalize, com exemplos para POSIX e Windows.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão prática para revisar o tratamento de caminhos e investigar acessos a arquivos no código da aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar código gerado por agentes, você precisa distinguir o ajuste textual de um caminho da verificação do arquivo que a aplicação pode acessar.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.