Método Node.js fsPromises.writeFile()

El método fsPromises.writeFile() se utiliza para escribir de forma asíncrona los datos especificados en un archivo. De forma predeterminada, el archivo se reemplazaría si existe. El parámetro ‘opciones’ se puede utilizar para modificar la funcionalidad del método.

La Promesa se resolverá sin argumentos en caso de éxito.

Sintaxis:

fsPromises.writeFile( file, data, options )

Parámetros: este método acepta tres parámetros, como se mencionó anteriormente y se describe a continuación:

• archivo: Es una string, Buffer, URL o entero de descripción de archivo que denota la ruta del archivo donde se tiene que escribir. El uso de un descriptor de archivo hará que se comporte de manera similar al método fsPromises.write().
• data: Es una string, Buffer, TypedArray o DataView que se escribirá en el archivo.
• opciones: es una string u objeto que se puede usar para especificar parámetros opcionales que afectarán la salida. Tiene tres parámetros opcionales:
  • codificación: Es un valor de string que especifica la codificación del archivo. El valor predeterminado es ‘utf8’.
  • modo: Es un valor entero que especifica el modo del archivo. El valor predeterminado es 0o666.
  • bandera: es un valor de string que especifica la bandera utilizada al escribir en el archivo. El valor predeterminado es ‘w’.

Valor de retorno: este método devuelve una promesa.

Los siguientes ejemplos ilustran el método fsPromises.writeFile() en Node.js:

Ejemplo 1:

// Node.js program to demonstrate the 
// fsPromises.writeFile() method 
  
// Import the filesystem module 
const fs = require('fs');
const fsPromises = require('fs').promises;
let data = "This is a file containing"
        + " a collection of movies.";
  
(async function main() {
    try {
        await fsPromises.writeFile(
                "movies.txt", data)
  
        console.log("File written successfully");
        console.log("The written file has"
            + " the following contents:");
  
        console.log("" + 
            fs.readFileSync("./movies.txt"));
  
    } catch (err) {
        console.error(err);
    }
})();

Producción:

File written successfully
The written file has the following contents:     
This is a file containing a collection of movies.

Ejemplo 2:

// Node.js program to demonstrate the 
// fsPromises.writeFile() method 
  
// Import the filesystem module 
const fs = require('fs');
const fsPromises = require('fs').promises;
let data = "This is a file containing"
        + " a collection of books.";
  
(async function main() {
    try {
  
        await fsPromises.writeFile(
                "books.txt", data, {
            encoding: "utf8",
            flag: "w",
            mode: 0o666
        });
  
        console.log("File written successfully\n");
        console.log("The written has the "
                + "following contents:");
  
        console.log("" + 
            fs.readFileSync("books.txt"));
    }
    catch (err) {
        console.error(err);
    }
})();

Producción:

File written successfully

The written has the following contents:
This is a file containing a collection of books.

Referencia: https://nodejs.org/api/fs.html#fs_fspromises_writefile_file_data_options