Escrevendo ficheiros com a Node.js

Como escrever ficheiros usando a Node.js

Autores do Artigo
Tabela de Conteúdos

Escrevendo um ficheiro

A maneira mais fácil de escrever em ficheiros na Node.js é usar a API fs.writeFile():

Escrevendo um ficheiro de maneira síncrona

De maneira alternativa, podes usar a versão síncrona fs.writeFileSync():

Tu podes também usar o método fsPromises.writeFile() baseado em promessas oferecido pelo módulo fs/promises:

Por padrão, esta API substituirá os conteúdos do ficheiro se o mesmo já existir.

Tu podes modificar o padrão especificando uma opção:

As opções que provavelmente usarás são

OpçãoDescriçãoFicheiro é criado se não existir
r+Esta opção abre o ficheiro para leitura e escrita
w+Esta opção abre o ficheiro para leitura e escrita e também posiciona a linha no princípio do ficheiro
aEsta opção abre o ficheiro escrita e também posiciona a linha no final do ficheiro
a+Esta opção abre o ficheiro para leitura e escrita e também posiciona a linha no final do ficheiro

Anexando conteúdo em um ficheiro

A adição de conteúdo no final dos ficheiros é útil quando não queres sobrescrever um ficheiro com o conteúdo novo, mas em vez disto adicioná-lo.

Exemplos

Um método útil para anexar conteúdo no final do ficheiro é fs.appendFile() (e o seu equivalente fs.appendFileSync()):

Exemplo com Promessas

No bloco abaixo está um exemplo de fsPromises.appendFile():