javascript - Writing files in Node.js

ID : 502

viewed : 46

Tags : javascriptnode.jsfileexpressfsjavascript





Top 5 Answer for javascript - Writing files in Node.js

vote vote

94

There are a lot of details in the File System API. The most common way is:

const fs = require('fs');  fs.writeFile("/tmp/test", "Hey there!", function(err) {     if(err) {         return console.log(err);     }     console.log("The file was saved!"); });   // Or fs.writeFileSync('/tmp/test-sync', 'Hey there!'); 
vote vote

85

Currently there are three ways to write a file:

  1. fs.write(fd, buffer, offset, length, position, callback)

    You need to wait for the callback to ensure that the buffer is written to disk. It's not buffered.

  2. fs.writeFile(filename, data, [encoding], callback)

    All data must be stored at the same time; you cannot perform sequential writes.

  3. fs.createWriteStream(path, [options])

    Creates a WriteStream, which is convenient because you don't need to wait for a callback. But again, it's not buffered.

A WriteStream, as the name says, is a stream. A stream by definition is “a buffer” containing data which moves in one direction (source ► destination). But a writable stream is not necessarily “buffered”. A stream is “buffered” when you write n times, and at time n+1, the stream sends the buffer to the kernel (because it's full and needs to be flushed).

In other words: “A buffer” is the object. Whether or not it “is buffered” is a property of that object.

If you look at the code, the WriteStream inherits from a writable Stream object. If you pay attention, you’ll see how they flush the content; they don't have any buffering system.

If you write a string, it’s converted to a buffer, and then sent to the native layer and written to disk. When writing strings, they're not filling up any buffer. So, if you do:

write("a") write("b") write("c") 

You're doing:

fs.write(new Buffer("a")) fs.write(new Buffer("b")) fs.write(new Buffer("c")) 

That’s three calls to the I/O layer. Although you're using “buffers”, the data is not buffered. A buffered stream would do: fs.write(new Buffer ("abc")), one call to the I/O layer.

As of now, in Node.js v0.12 (stable version announced 02/06/2015) now supports two functions: cork() and uncork(). It seems that these functions will finally allow you to buffer/flush the write calls.

For example, in Java there are some classes that provide buffered streams (BufferedOutputStream, BufferedWriter...). If you write three bytes, these bytes will be stored in the buffer (memory) instead of doing an I/O call just for three bytes. When the buffer is full the content is flushed and saved to disk. This improves performance.

I'm not discovering anything, just remembering how a disk access should be done.

vote vote

75

You can of course make it a little more advanced. Non-blocking, writing bits and pieces, not writing the whole file at once:

var fs = require('fs'); var stream = fs.createWriteStream("my_file.txt"); stream.once('open', function(fd) {   stream.write("My first row\n");   stream.write("My second row\n");   stream.end(); }); 
vote vote

60

Synchronous Write

fs.writeFileSync(file, data[, options])

fs = require('fs');  fs.writeFileSync("foo.txt", "bar"); 

Asynchronous Write

fs.writeFile(file, data[, options], callback)

fs = require('fs');  fs.writeFile('foo.txt', 'bar', (err) => { if (err) throw err; }); 

Where

file <string> | <Buffer> | <URL> | <integer> filename or file descriptor data <string> | <Buffer> | <Uint8Array> options <Object> | <string> callback <Function> 

Worth reading the offical File System (fs) docs.

Update: async/await

fs = require('fs'); util = require('util'); writeFile = util.promisify(fs.writeFile);  fn = async () => { await writeFile('foo.txt', 'bar'); }  fn() 
vote vote

53

var path = 'public/uploads/file.txt', buffer = new Buffer("some content\n");  fs.open(path, 'w', function(err, fd) {     if (err) {         throw 'error opening file: ' + err;     }      fs.write(fd, buffer, 0, buffer.length, null, function(err) {         if (err) throw 'error writing file: ' + err;         fs.close(fd, function() {             console.log('file written');         })     }); }); 

Top 3 video Explaining javascript - Writing files in Node.js







Related QUESTION?