remove method

Future<void> remove({ bool recursive = false, })

Requests removal of the entry represented by the handle from the underlying file system. When recursive is set to true and the entry is a directory, its contents will be removed recursively.

This allows you to remove a file or directory directly from its handle. Without this method, you would have to obtain the handle of the parent directory, then call FileSystemDirectoryHandle.removeEntry on that to remove it.

You can also call remove on the root directory of the Origin Private File System to clear its contents, after which a new empty OPFS is created.

Throws an InvalidModificationError if recursive is set to false and the entry to be removed is a directory with children. Throws a NoModificationAllowedError if the browser was not able to get an exclusive lock on the entry. Throws a NotAllowedError if the state for the handle is not PermissionState.granted. Throws a NotFoundError if the entry is not found.

Implementation

Future<void> remove({bool recursive = false}) async {
  final options = [FileSystemRemoveOptions(recursive: recursive)];

  try {
    await promiseToFuture(callMethod(this, "remove", options));
  } catch (error) {
    if (jsIsNativeError(error, "InvalidModificationError")) {
      throw InvalidModificationError();
    } else if (jsIsNativeError(error, "NoModificationAllowedError")) {
      throw NoModificationAllowedError();
    } else if (jsIsNativeError(error, "NotAllowedError")) {
      throw NotAllowedError();
    } else if (jsIsNativeError(error, "NotFoundError")) {
      throw NotFoundError();
    } else {
      rethrow;
    }
  }
}