W3cubDocs

/Web APIs

FileSystemWritableFileStream: truncate() method

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The truncate() method of the FileSystemWritableFileStream interface resizes the file associated with the stream to the specified size in bytes.

If the size specified is larger than the current file size the file is padded with null bytes.

The file cursor is also updated when truncate() is called. If the offset is smaller than the size, it remains unchanged. If the offset is larger than size, the offset is set to that size. This ensures that subsequent writes do not error.

No changes are written to the actual file on disk until the stream has been closed. Changes are typically written to a temporary file instead.

Syntax

js

truncate(size)

Parameters

size

A number specifying the number of bytes to resize the stream to.

Return value

A Promise that returns undefined.

Exceptions

NotAllowedError DOMException

Returned if PermissionStatus.state is not granted.

TypeError

Returned if size is not a number or not defined.

Examples

The following asynchronous function opens the 'Save File' picker, which returns a FileSystemFileHandle once a file is selected. From this, a writable stream is created using the FileSystemFileHandle.createWritable() method.

Next, we write to the stream:

  1. A text string is written to the stream.
  2. The truncate() method is used to resize the file to 8 bytes.
  3. A second text string is written to the start of the stream, overwriting the first write.

The stream is then closed.

js

async function saveFile() {
  try {
    // create a new handle
    const newHandle = await window.showSaveFilePicker();

    // create a FileSystemWritableFileStream to write to
    const writableStream = await newHandle.createWritable();

    // write our file
    await writableStream.write("This is my first file content");
    await writableStream.truncate(8);
    await writableStream.write("my second file content");

    // close the file and write the contents to disk.
    await writableStream.close();
  } catch (err) {
    console.error(err.name, err.message);
  }
}

If you run the above function and then open the resulting file created on disk, you should see the text "This is my second file content".

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
truncate 86 86 111 No 72 No No No 111 No No No

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/truncate