File system

Install

npx expo install expo-file-system

import { FileSystem } from '@ng-native/expo/file-system';

The smallest useful example

import { Component, inject } from '@angular/core';
import { FileSystem } from '@ng-native/expo/file-system';

@Component({
  selector: 'app-notes',
  template: `<pressable (press)="save()"><text>Save</text></pressable>`,
})
export class Notes {
  private readonly files = inject(FileSystem);

  protected save(): void {
    this.files.write(this.files.document('notes.txt'), 'Buy milk');
  }
}

cache(name) and document(name)

Both return Expo's File for a name in one of the two directories an app actually chooses between:

• cache(name) - a file the system may delete under storage pressure. Use it for anything that can be rebuilt or re-downloaded.
• document(name) - a file that survives, and is included in backups. Use it for anything the user would notice losing.

Neither call touches disk; it only names where the file would live. File carries uri, exists, size, and its own text(), textSync(), bytes(), create() and delete() - use those directly for anything beyond writing.

write(file, content)

File.write() alone throws on a file that has never been created, which is the first thing everyone hits. write() creates the file first (with intermediates) if it does not already exist, then writes - text or bytes - replacing whatever was there.

this.files.write(this.files.cache('thumb.jpg'), imageBytes);

Without the module

On iOS and Android, a missing expo-file-system - never installed, or installed without the app being rebuilt since - throws a MissingModuleError when the service first reaches for it. Its message names the module and the commands that fix it; see Using a module.

On the web, and in a test that provides no fake, FileSystem still does not fall back to reporting nothing, unlike most services in this package: cache(), document() and write() throw [angular-native] expo-file-system is not installed. A file that silently failed to write is worse than an error that says why.

Reference