FileSystemWritableFileStream.truncate()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
FileSystemWritableFileStream インターフェイスの truncate() メソッドは、ストリームに対応するファイルのサイズを指定のバイト数にします。
指定したサイズがファイルの現在のサイズより大きい場合、ファイルの拡張部分は null のバイトで埋めます。そうでない場合、ファイルを切り詰めます。
truncate() が呼ばれると、ファイルカーソルも移動します。
オフセットがサイズより小さい場合、変化しません。
オフセットがサイズより大きい場合、オフセットがサイズに設定されます。
これにより、この後の書き込みがエラーにならないようにします。
ストリームが閉じられるまで、変更はディスク上の実際のファイルには一切書き込まれません。 通常、変更はかわりに一時ファイルに書き込まれます。
構文
js
truncate()
引数
- size
-
ストリームの新しいバイト数を表す
unsigned long値です。
返値
undefined で解決する Promise を返します。
例外
NotAllowedErrorDOMException-
PermissionStateが'granted'でないとき返されます。 TypeError-
sizeが定義されていないかunsigned longでないとき返されます。
例
js
// 未稿
仕様書
| Specification |
|---|
| File System # api-filesystemwritablefilestream-truncate |
ブラウザーの互換性
BCD tables only load in the browser