> For the complete documentation index, see [llms.txt](https://makeitrealcamp.gitbook.io/javascript-book/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://makeitrealcamp.gitbook.io/javascript-book/manipulacion-de-archivos.md).

# Manipulación de archivos

En Node.js es posible manipular archivos (crear, leer, modificar, mover, etc.). En este capítulo vamos a ver tres de estas operaciones: leer, escribir y verificar si un archivo o carpeta existe.

**Nota:** Ten en cuenta que esto sólo aplica para Node.js, desde el navegador **no** es posible manipular archivos, sería muy inseguro.

## Leer de un archivo

La forma más fácil de leer un archivo con Node.js es utilizando el método `readFile` del módulo `fs`. Para empezar crea un nuevo archivo llamado `contenido.txt` con el siguiente contenido:

```
Primera línea
Segunda línea
Tercera línea
```

Ahora crea un archivo en la misma carpeta llamado `read.js` con el siguiente contenido:

```javascript
var fs = require('fs');

fs.readFile('contenido.txt', 'utf8', function(err, data) {
  if (err) {
    return console.log(err);
  }

  console.log(data);
});
```

Ejecútalo en la consola, debería mostrar el contenido del archivo y una línea en blanco al final:

```
$ node read.js
Primera línea
Segunda línea
Tercera línea
```

El método `readFile` recibe 3 argumentos: la ruta al archivo, la codificación y una función que va a ser invocada cuando se lea el archivo (a esta función se le llama **callback**).

### Leyendo archivos grandes

El método `readFile` lee todo el archivo en memoria. El problema es que si el archivo es muy grande es posible que la máquina no tenga la suficiente memoria para leerlo.

Si el archivo es muy grande es mejor utilizar la siguiente forma:

```javascript
var fs = require('fs'),
    readline = require('readline');

var reader = readline.createInterface({
  input: fs.createReadStream('archivo-grande.txt')
});

reader.on('line', function (line) {
  console.log(line);
});
```

## Escribir a un archivo

La forma más fácil de de escribir a un archivo es con el método `writeFile` del módulo `fs`. Por ejemplo, crea un archivo llamado `write.js` y transcribe el siguiente código:

```javascript
var fs = require('fs');

fs.writeFile("nuevo.txt", "Primera línea\nSegunda línea", function(err) {
  if (err) {
    return console.log(err);
  }

  console.log("El archivo fue creado correctamente");
});
```

Ejecútalo en la consola y revisa que el archivo haya sido creado correctamente:

```
$ node write.js
El archivo fue creado correctamente
```

El método `writeFile` recibe tres argumentos: la ruta del archivo que quieres crear, el contenido y una función que se invoca cuando ha terminado de escribir el archivo o ha ocurrido un error.

### Escribiendo a un archivo línea por línea

Si necesitas escribir un archivo línea por línea puedes utilizar la siguiente forma:

```javascript
var fs = require('fs');

var stream = fs.createWriteStream("nuevo.txt");
stream.once('open', function(fd) {
  stream.write("Primera línea\n");
  stream.write("Segunda línea\n");
  stream.end();
});
```

## Verificar si un archivo o una carpeta existen

Para verificar si un archivo o carpeta existe utiliza el método `stat` del módulo `fs`:

```javascript
var fs = require("fs");

fs.stat('nuevo.txt', function(err) {
  if (err == null) {
    console.log("El archivo existe");
  } else if (err.code == 'ENOENT') {
    console.log("el archivo no existe");
  } else {
    console.log(err); // ocurrió algún error
  }
})
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://makeitrealcamp.gitbook.io/javascript-book/manipulacion-de-archivos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.