xref: /expo/apps/test-suite/tests/FileSystem.js (revision a47a1472)

'use strict';

import { Asset } from 'expo-asset';
import * as FS from 'expo-file-system';

export const name = 'FileSystem';

export async function test(t) {
  t.describe('FileSystem', () => {
    const throws = async run => {
      let error = null;
      try {
        await run();
      } catch (e) {
        error = e;
      }
      t.expect(error).toBeTruthy();
    };

    t.it(
      'delete(idempotent) -> !exists -> download(md5, uri) -> exists ' + '-> delete -> !exists',
      async () => {
        const localUri = FS.documentDirectory + 'download1.png';

        const assertExists = async expectedToExist => {
          let { exists } = await FS.getInfoAsync(localUri);
          if (expectedToExist) {
            t.expect(exists).toBeTruthy();
          } else {
            t.expect(exists).not.toBeTruthy();
          }
        };

        await FS.deleteAsync(localUri, { idempotent: true });
        await assertExists(false);

        const { md5, headers } = await FS.downloadAsync(
          'https://s3-us-west-1.amazonaws.com/test-suite-data/avatar2.png',
          localUri,
          { md5: true }
        );
        t.expect(md5).toBe('1e02045c10b8f1145edc7c8375998f87');
        await assertExists(true);
        t.expect(headers['Content-Type']).toBe('image/png');

        await FS.deleteAsync(localUri);
        await assertExists(false);
      },
      9000
    );

    t.it('Can read/write Base64', async () => {
      const asset = await Asset.fromModule(require('../assets/icons/app.png'));
      await asset.downloadAsync();

      for (let startingPosition = 0; startingPosition < 3; startingPosition++) {
        const options = {
          encoding: FS.EncodingType.Base64,
          position: startingPosition,
          length: startingPosition + 1,
        };

        const b64 = await FS.readAsStringAsync(asset.localUri, options);
        t.expect(b64).toBeDefined();
        t.expect(typeof b64).toBe('string');
        t.expect(b64.length % 4).toBe(0);

        const localUri = FS.documentDirectory + 'b64.png';

        await FS.writeAsStringAsync(localUri, b64, { encoding: FS.EncodingType.Base64 });

        t.expect(await FS.readAsStringAsync(localUri, { encoding: FS.EncodingType.Base64 })).toBe(
          b64
        );
      }
    });

    t.it('delete(idempotent) -> delete[error]', async () => {
      const localUri = FS.documentDirectory + 'willDelete.png';

      await FS.deleteAsync(localUri, { idempotent: true });

      let error;
      try {
        await FS.deleteAsync(localUri);
      } catch (e) {
        error = e;
      }
      t.expect(error.message).toMatch(/not.*found/);
    });

    t.it(
      'download(md5, uri) -> read -> delete -> !exists -> read[error]',
      async () => {
        const localUri = FS.documentDirectory + 'download1.txt';

        const { md5 } = await FS.downloadAsync(
          'https://s3-us-west-1.amazonaws.com/test-suite-data/text-file.txt',
          localUri,
          { md5: true }
        );
        t.expect(md5).toBe('86d73d2f11e507365f7ea8e7ec3cc4cb');

        const string = await FS.readAsStringAsync(localUri);
        t.expect(string).toBe('hello, world\nthis is a test file\n');

        await FS.deleteAsync(localUri, { idempotent: true });

        let error;
        try {
          await FS.readAsStringAsync(localUri);
        } catch (e) {
          error = e;
        }
        t.expect(error).toBeTruthy();
      },
      9000
    );

    t.it('delete(idempotent) -> !exists -> write -> read -> write -> read', async () => {
      const localUri = FS.documentDirectory + 'write1.txt';

      await FS.deleteAsync(localUri, { idempotent: true });

      const { exists } = await FS.getInfoAsync(localUri);
      t.expect(exists).not.toBeTruthy();

      const writeAndVerify = async expected => {
        await FS.writeAsStringAsync(localUri, expected);
        const string = await FS.readAsStringAsync(localUri);
        t.expect(string).toBe(expected);
      };

      await writeAndVerify('hello, world');
      await writeAndVerify('hello, world!!!!!!');
    });

    t.it('delete(new) -> 2 * [write -> move -> !exists(orig) -> read(new)]', async () => {
      const from = FS.documentDirectory + 'from.txt';
      const to = FS.documentDirectory + 'to.txt';
      const contents = ['contents 1', 'contents 2'];

      await FS.deleteAsync(to, { idempotent: true });

      // Move twice to make sure we can overwrite
      for (let i = 0; i < 2; ++i) {
        await FS.writeAsStringAsync(from, contents[i]);

        await FS.moveAsync({ from, to });

        const { exists } = await FS.getInfoAsync(from);
        t.expect(exists).not.toBeTruthy();

        t.expect(await FS.readAsStringAsync(to)).toBe(contents[i]);
      }
    });

    t.it('delete(new) -> 2 * [write -> copy -> exists(orig) -> read(new)]', async () => {
      const from = FS.documentDirectory + 'from.txt';
      const to = FS.documentDirectory + 'to.txt';
      const contents = ['contents 1', 'contents 2'];

      await FS.deleteAsync(to, { idempotent: true });

      // Copy twice to make sure we can overwrite
      for (let i = 0; i < 2; ++i) {
        await FS.writeAsStringAsync(from, contents[i]);

        await FS.copyAsync({ from, to });

        const { exists } = await FS.getInfoAsync(from);
        t.expect(exists).toBeTruthy();

        t.expect(await FS.readAsStringAsync(to)).toBe(contents[i]);
      }
    });

    t.it(
      'delete(dir) -> write(dir/file)[error] -> mkdir(dir) ->' +
        'mkdir(dir)[error] -> write(dir/file) -> read',
      async () => {
        let error;
        const path = FS.documentDirectory + 'dir/file';
        const dir = FS.documentDirectory + 'dir';
        const contents = 'hello, world';

        await FS.deleteAsync(dir, { idempotent: true });

        error = null;
        try {
          await FS.writeAsStringAsync(path, contents);
        } catch (e) {
          error = e;
        }
        t.expect(error).toBeTruthy();

        await FS.makeDirectoryAsync(dir);

        error = null;
        try {
          await FS.makeDirectoryAsync(dir);
        } catch (e) {
          error = e;
        }
        t.expect(error).toBeTruthy();

        await FS.writeAsStringAsync(path, contents);

        t.expect(await FS.readAsStringAsync(path)).toBe(contents);
      }
    );

    t.it(
      'delete(dir) -> write(dir/dir2/file)[error] -> ' +
        'mkdir(dir/dir2, intermediates) -> ' +
        'mkdir(dir/dir2, intermediates) -> write(dir/dir2/file) -> read',
      async () => {
        let error;
        const path = FS.documentDirectory + 'dir/dir2/file';
        const dir = FS.documentDirectory + 'dir/dir2';
        const contents = 'hello, world';

        await FS.deleteAsync(dir, { idempotent: true });

        error = null;
        try {
          await FS.writeAsStringAsync(path, contents);
        } catch (e) {
          error = e;
        }
        t.expect(error).toBeTruthy();

        await FS.makeDirectoryAsync(dir, {
          intermediates: true,
        });

        error = null;
        try {
          await FS.makeDirectoryAsync(dir);
        } catch (e) {
          error = e;
        }
        t.expect(error).toBeTruthy();

        error = null;
        try {
          await FS.makeDirectoryAsync(dir, {
            intermediates: true,
          });
        } catch (e) {
          error = e;
        }
        t.expect(error).toBe(null);

        await FS.writeAsStringAsync(path, contents);

        t.expect(await FS.readAsStringAsync(path)).toBe(contents);
      }
    );

    /*
    This test fails in CI because of an exception being thrown by deleteAsync in the nativeModule.
    I traced it down to the FileUtils.forceDelete call here:
    https://github.com/expo/expo/blob/bcd136b096df84e0b0f72a15acbda45491de8201/packages/expo-file-system/android/src/main/java/expo/modules/filesystem/FileSystemModule.java#L294
    t.it(
      'delete(dir, idempotent) -> make tree -> check contents ' +
        '-> check directory listings' +
        '-> move -> check directory listings' +
        '-> copy -> check directory listings',
      async () => {
        let error;
        const dir = FS.documentDirectory + 'dir';

        await FS.deleteAsync(dir, { idempotent: true });

        await FS.makeDirectoryAsync(dir + '/child1', {
          intermediates: true,
        });
        await FS.makeDirectoryAsync(dir + '/child2', {
          intermediates: true,
        });

        await FS.writeAsStringAsync(dir + '/file1', 'contents1');
        await FS.writeAsStringAsync(dir + '/file2', 'contents2');

        await FS.writeAsStringAsync(dir + '/child1/file3', 'contents3');

        await FS.writeAsStringAsync(dir + '/child2/file4', 'contents4');
        await FS.writeAsStringAsync(dir + '/child2/file5', 'contents5');

        const checkContents = async (path, contents) =>
          t.expect(await FS.readAsStringAsync(path)).toBe(contents);

        await checkContents(dir + '/file1', 'contents1');
        await checkContents(dir + '/file2', 'contents2');
        await checkContents(dir + '/child1/file3', 'contents3');
        await checkContents(dir + '/child2/file4', 'contents4');
        await checkContents(dir + '/child2/file5', 'contents5');

        const checkDirectory = async (path, expected) => {
          const list = await FS.readDirectoryAsync(path);
          t.expect(list.sort()).toEqual(expected.sort());
        };

        const checkRoot = async root => {
          await checkDirectory(root, ['file1', 'file2', 'child1', 'child2']);
          await checkDirectory(root + '/child1', ['file3']);
          await checkDirectory(root + '/child2', ['file4', 'file5']);

          error = null;
          try {
            await checkDirectory(root + '/file1', ['nope']);
          } catch (e) {
            error = e;
          }
          t.expect(error).toBeTruthy();
        };

        await checkRoot(dir);

        await FS.deleteAsync(FS.documentDirectory + 'moved', {
          idempotent: true,
        });
        await FS.moveAsync({ from: dir, to: FS.documentDirectory + 'moved' });
        await checkRoot(FS.documentDirectory + 'moved');
        await FS.copyAsync({
          from: FS.documentDirectory + 'moved',
          to: FS.documentDirectory + 'copied',
        });
        await checkRoot(FS.documentDirectory + 'copied');
      }
    );
    */

    t.it(
      'delete(idempotent) -> download(md5) -> getInfo(size)',
      async () => {
        const localUri = FS.documentDirectory + 'download1.png';

        await FS.deleteAsync(localUri, { idempotent: true });

        const { md5 } = await FS.downloadAsync(
          'https://s3-us-west-1.amazonaws.com/test-suite-data/avatar2.png',
          localUri,
          { md5: true }
        );
        t.expect(md5).toBe('1e02045c10b8f1145edc7c8375998f87');

        const { size, modificationTime } = await FS.getInfoAsync(localUri);
        t.expect(size).toBe(3230);
        const nowTime = 0.001 * new Date().getTime();
        t.expect(nowTime - modificationTime).toBeLessThan(3600);

        await FS.deleteAsync(localUri);
      },
      30000
    );

    t.it('throws out-of-scope exceptions', async () => {
      const p = FS.documentDirectory;

      await throws(() => FS.getInfoAsync(p + '../hello/world'));
      await throws(() => FS.readAsStringAsync(p + '../hello/world'));
      await throws(() => FS.writeAsStringAsync(p + '../hello/world', ''));
      await throws(() => FS.deleteAsync(p + '../hello/world'));
      await throws(() => FS.deleteAsync(p));
      await throws(() => FS.deleteAsync(FS.cacheDirectory));
      await throws(() => FS.moveAsync({ from: p + '../a/b', to: 'c' }));
      await throws(() => FS.moveAsync({ from: 'c', to: p + '../a/b' }));
      await throws(() => FS.copyAsync({ from: p + '../a/b', to: 'c' }));
      await throws(() => FS.copyAsync({ from: 'c', to: p + '../a/b' }));
      await throws(() => FS.makeDirectoryAsync(p + '../hello/world'));
      await throws(() => FS.readDirectoryAsync(p + '../hello/world'));
      await throws(() => FS.downloadAsync('http://www.google.com', p + '../hello/world'));
      await throws(() => FS.readDirectoryAsync(p + '../'));
      await throws(() => FS.downloadAsync('http://www.google.com', p + '../hello/world'));
    });

    t.it('missing parameters', async () => {
      const p = FS.documentDirectory + 'test';

      await throws(() => FS.moveAsync({ from: p }));
      await throws(() => FS.moveAsync({ to: p }));
      await throws(() => FS.copyAsync({ from: p }));
      await throws(() => FS.copyAsync({ to: p }));
    });

    t.it('can read root directories', async () => {
      await FS.readDirectoryAsync(FS.documentDirectory);
      await FS.readDirectoryAsync(FS.cacheDirectory);
    });

    t.it(
      'download(network failure)',
      async () => {
        const localUri = FS.documentDirectory + 'download1.png';

        const assertExists = async expectedToExist => {
          let { exists } = await FS.getInfoAsync(localUri);
          if (expectedToExist) {
            t.expect(exists).toBeTruthy();
          } else {
            t.expect(exists).not.toBeTruthy();
          }
        };

        await FS.deleteAsync(localUri, { idempotent: true });
        await assertExists(false);

        let error;
        try {
          await FS.downloadAsync('https://nonexistent-subdomain.expo.io', localUri, { md5: true });
        } catch (e) {
          error = e;
        }
        t.expect(error).toBeTruthy();
        await assertExists(false);
        await FS.deleteAsync(localUri, { idempotent: true });
      },
      30000
    );

    t.it(
      'download(404)',
      async () => {
        const localUri = FS.documentDirectory + 'download1.png';

        const assertExists = async expectedToExist => {
          let { exists } = await FS.getInfoAsync(localUri);
          if (expectedToExist) {
            t.expect(exists).toBeTruthy();
          } else {
            t.expect(exists).not.toBeTruthy();
          }
        };

        await FS.deleteAsync(localUri, { idempotent: true });
        await assertExists(false);

        const { status } = await FS.downloadAsync('https://expo.io/404', localUri, {
          md5: true,
        });
        await assertExists(true);
        t.expect(status).toBe(404);

        await FS.deleteAsync(localUri);
        await assertExists(false);
      },
      30000
    );

    t.it(
      'download(nonexistent local path)',
      async () => {
        try {
          const remoteUrl = 'https://s3-us-west-1.amazonaws.com/test-suite-data/avatar2.png';
          const localUri = FS.documentDirectory + 'doesnt/exists/download1.png';
          await FS.downloadAsync(remoteUrl, localUri);
        } catch (err) {
          t.expect(err.message).toMatch(/Directory for .* doesn't exist/);
        }
      },
      30000
    );

    t.it(
      'mkdir(multi-level) + download(multi-level local path)',
      async () => {
        const remoteUrl = 'https://s3-us-west-1.amazonaws.com/test-suite-data/avatar2.png';
        const localDirUri = FS.documentDirectory + 'foo/bar/baz';
        const localFileUri = localDirUri + 'download1.png';

        await FS.makeDirectoryAsync(localDirUri, { intermediates: true });

        await FS.downloadAsync(remoteUrl, localFileUri);
      },
      30000
    );
  });
}