Appending to files in Node.js - Step-by-Step Execution

Concept Flow - Appending to files

Start

↓

Open file in append mode

↓

Write new data at file end

↓

Close file

↓

End

The process opens a file in append mode, adds new data at the end, then closes the file.

Execution Sample

Node.js

import { appendFile } from 'node:fs/promises';

await appendFile('log.txt', 'New entry\n');

This code adds the text 'New entry' followed by a newline to the end of 'log.txt'.

Execution Table

Step	Action	File State Before	File State After	Result
1	Open 'log.txt' in append mode	log.txt content: 'Line1\nLine2\n'	File ready for appending	File opened successfully
2	Append 'New entry\n' to file	log.txt content: 'Line1\nLine2\n'	log.txt content: 'Line1\nLine2\nNew entry\n'	Data appended at file end
3	Close file	File open	File closed	File closed successfully
4	End	File closed	File closed	Operation complete

💡 Appending finished and file closed

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
fileContent	'Line1\nLine2\n'	'Line1\nLine2\n'	'Line1\nLine2\nNew entry\n'	'Line1\nLine2\nNew entry\n'	'Line1\nLine2\nNew entry\n'
fileStatus	closed	open	open	closed	closed

Key Moments - 3 Insights

Why does the new data appear at the end of the file instead of overwriting it?

Because the file is opened in append mode (step 1), which adds data after existing content instead of replacing it (see execution_table step 2).

What happens if the file does not exist before appending?

Node.js creates the file automatically when appending, so the operation still succeeds (not shown in this trace but default behavior).

Why is it important to close the file after appending?

Closing the file (step 3) ensures data is saved properly and resources are freed, preventing data loss or file locks.

Visual Quiz - 3 Questions

Look at the execution table, what is the file content after step 2?

A 'Line1\nLine2\n'

B 'New entry\n'

C 'Line1\nLine2\nNew entry\n'

D Empty file

💡 Hint

Check the 'File State After' column in step 2 of the execution_table.

At which step is the file closed?

A Step 3

B Step 1

C Step 2

D Step 4

💡 Hint

Look at the 'Action' column and find when the fileStatus changes to 'closed' in variable_tracker.

If we change the code to write instead of append, how would the file content after step 2 change?

A It would add new data at the end

B It would overwrite existing content with new data

C It would delete the file

D It would do nothing

💡 Hint

Appending adds data at the end; writing replaces content. Compare with execution_table step 2.

Concept Snapshot

Appending to files in Node.js:
- Use fs/promises.appendFile(path, data)
- Opens file in append mode
- Adds data at file end without overwriting
- Creates file if missing
- Always close file or use promises for safety

Full Transcript

Appending to files in Node.js means adding new data to the end of an existing file without removing what is already there. The process starts by opening the file in append mode, which prepares it to add data at the end. Then the new data is written after the existing content. Finally, the file is closed to save changes and free resources. If the file does not exist, Node.js creates it automatically. This method is useful for logs or records where you want to keep old data and add new entries. Using promises like appendFile ensures the operation completes before moving on.