Método Node.js fs.renameSync()

El método fs.renameSync() se usa para cambiar el nombre de un archivo en la ruta antigua dada a la nueva ruta dada de forma síncrona. Sobrescribirá el archivo de destino si ya existe.

Sintaxis:

fs.renameSync( oldPath, newPath )

Valores de propiedad:

• oldPath: contiene la ruta del archivo que se debe renombrar. Puede ser una string, un búfer o una URL.
• newPath: contiene la nueva ruta a la que se debe renombrar el archivo. Puede ser una string, un búfer o una URL.

Los siguientes ejemplos ilustran el método fs.renameSync() en Node.js:

Ejemplo 1: este ejemplo utiliza el método fs.renameSync() para cambiar el nombre de un archivo.

// Node.js program to demonstrate the
// fs.renameSync() method
  
// Import the filesystem module
const fs = require('fs');
  
// List all the filenames before renaming
getCurrentFilenames();
  
// Rename the file
fs.renameSync('hello.txt', 'world.txt');
  
// List all the filenames after renaming
getCurrentFilenames();
  
// function to get current filenames in directory
function getCurrentFilenames() {
  console.log("Current filenames:");
  fs.readdirSync(__dirname).forEach(file => {
    console.log(file);
  });
}

Producción:

Current filenames:
hello.txt
index.js
package.json
Current filenames:
index.js
package.json
world.txt

Ejemplo 2: este ejemplo usa el método fs.renameSync() para demostrar un error durante el cambio de nombre del archivo.

// Node.js program to demonstrate the
// fs.renameSync() method
  
// Import the filesystem module
const fs = require('fs');
  
// List all the filenames before renaming
getCurrentFilenames();
  
// Rename a non-existent file
fs.renameSync('nonexist.txt', 'world.txt');
  
// List all the filenames after renaming
getCurrentFilenames();
  
// Function to get current filenames in directory
function getCurrentFilenames() {
  console.log("Current filenames:");
  fs.readdirSync(__dirname).forEach(file => {
    console.log(file);
  });
}

Producción:

Current filenames:
index.js
package.json
world.txt
internal/fs/utils.js:220
    throw err;
    ^

Error: ENOENT: no such file or directory, rename 'nonexist.txt' -> 'world.txt'
    at Object.renameSync (fs.js:643:3)
    at Object. (G:\tutorials\nodejs-fs-renameSync\index.js:29:4)
    at Module._compile (internal/modules/cjs/loader.js:956:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:973:10)
    at Module.load (internal/modules/cjs/loader.js:812:32)
    at Function.Module._load (internal/modules/cjs/loader.js:724:14)
    at Function.Module.runMain (internal/modules/cjs/loader.js:1025:10)
    at internal/main/run_main_module.js:17:11 {
  errno: -4058,
  syscall: 'rename',
  code: 'ENOENT',
  path: 'nonexist.txt',
  dest: 'world.txt'
}

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