puter.fs.write() Writes data to a specified file path.
This method is useful for creating new files or modifying existing ones in the Puter cloud storage.
puter.fs.write(path)
puter.fs.write(path, data)
puter.fs.write(path, data, options)
puter.fs.write(file)
path (String) (required)
The path to the file to write to. If path is not absolute, it will be resolved relative to the app's root directory.
data (String|File|Blob|ArrayBuffer|TypedArray) (optional)
The data to write to the file. If omitted, an empty file is created.
options (Object)
The options for the write operation. The following options are supported:
| Option | Type | Description |
|---|---|---|
createMissingParents |
Boolean |
Whether to create missing parent directories. Defaults to false. |
overwrite |
Boolean |
Whether to overwrite the file if it already exists. Defaults to true. |
dedupeName |
Boolean |
Whether to deduplicate the file name if it already exists. Defaults to false. |
file (File)
An alternative to path and data. A File object to write directly, where the file path will be derived from the file's name.
Returns a Promise that resolves to the FSItem object of the written file.
The promise rejects with { message, code }. These codes mean the name is already taken:
| Code | Meaning |
|---|---|
item_with_same_name_exists |
A file with this name exists, and overwrite and dedupeName are both false. |
cannot_overwrite_a_directory |
A folder with this name exists. |
conflict |
The name differs from an existing file or folder's name only by accents or emoji, such as 😁.txt next to 😀.txt. The existing item is never replaced, even with overwrite: true. To write the file under a new name instead, set overwrite: false and dedupeName: true. |
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
// Create a new file called "hello.txt" containing "Hello, world!"
puter.fs.write('hello.txt', 'Hello, world!').then(() => {
puter.print('File written successfully');
})
</script>
</body>
</html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<input type="file" id="file-input">
<script>
// Example: Writing a file with input coming from a file input
document.getElementById('file-input').addEventListener('change', (event) => {
puter.fs.write('hello.txt', event.target.files[0]).then(() => {
puter.print('File written successfully');
}).catch((error) => {
puter.print('Error writing file:', error);
});
});
</script>
</body>
</html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
(async () => {
// create a file named 'hello.txt'
let file_1 = await puter.fs.write('hello.txt', 'Hello, world!');
puter.print(`File 1: ${file_1.name}<br>`);
// create a file named 'hello.txt' again, it should be automatically renamed to 'hello (n).txt' where n is the next available number
let file_2 = await puter.fs.write('hello.txt', 'Hello, world!', { dedupeName: true });
puter.print(`File 2: ${file_2.name}<br>`);
})();
</script>
</body>
</html>
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
(async () => {
// create a file named 'hello.txt' in a directory that does not exist
let file = await puter.fs.write('my-directory/another-directory/hello.txt', 'Hello, world!', { createMissingParents: true });
puter.print(`File created at: ${file.path}<br>`);
})();
</script>
</body>
</html>