FileSystemWritableFileStream.truncate()

Draft: This page is not complete.

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 be the specified size in bytes.

If the size specified is larger than the current file size this pads the file with null bytes, otherwise it truncates the file.

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

FileSystemWritableFileStream.truncate().then(...);

Parameters

size

An unsigned long of the amount of bytes to resize the stream to.

Return value

A Promise which returns undefined.

Exceptions

NotAllowedError

If the PermissionState is not 'granted'.

TypeError

If the size is undefined or not an unsigned long.

Examples

// todo

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
No
No
No
No
No
No
No
No
No
No

See also

© 2005–2021 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