servo/tests/wpt/web-platform-tests/native-file-system/resources/test-helpers.js

// A special path component meaning "this directory."
const kCurrentDirectory = ".";

// A special path component meaning "the parent directory."
const kParentDirectory = "..";

// Array of separators used to separate components in hierarchical paths.
let kPathSeparators;
if (navigator.userAgent.includes("Windows NT")) {
    // Windows uses both '/' and '\' as path separators.
    kPathSeparators = ['/', '\\' ];
} else {
    kPathSeparators = [ '/' ];
}

async function cleanupSandboxedFileSystem() {
    const dir = await FileSystemDirectoryHandle.getSystemDirectory({ type: 'sandbox' });
    for await (let entry of dir.getEntries())
        dir.removeEntry(entry.name, { recursive: entry.isDirectory });
}

async function getFileSize(handle) {
    const file = await handle.getFile();
    return file.size;
}

async function getFileContents(handle) {
    const file = await handle.getFile();
    return new Response(file).text();
}

async function getDirectoryEntryCount(handle) {
    let result = 0;
    for await (let entry of handle.getEntries()) {
        result++;
    }
    return result;
}

async function getSortedDirectoryEntries(handle) {
    let result = [];
    for await (let entry of handle.getEntries()) {
        if (entry.isDirectory)
            result.push(entry.name + '/');
        else
            result.push(entry.name);
    }
    result.sort();
    return result;
}

async function createDirectory(test, name, parent) {
  const parent_dir_handle = parent ? parent :
      await FileSystemDirectoryHandle.getSystemDirectory({ type: 'sandbox' });

  const new_dir_handle = await parent_dir_handle.getDirectory(name, { create: true });
  test.add_cleanup(async () => {
        try {
            await parent_dir_handle.removeEntry(name, { recursive: true });
        } catch (e) {
            // Ignore any errors when removing directories, as tests might
            // have already removed the directory.
        }
  });
  return new_dir_handle;
}

async function createEmptyFile(test, name, parent) {
    const dir = parent ? parent : await FileSystemDirectoryHandle.getSystemDirectory({ type: 'sandbox' });
    const handle = await dir.getFile(name, { create: true });
    test.add_cleanup(async () => {
        try {
            await dir.removeEntry(name);
        } catch (e) {
            // Ignore any errors when removing files, as tests might already remove the file.
        }
    });
    // Make sure the file is empty.
    assert_equals(await getFileSize(handle), 0);
    return handle;
}

async function createFileWithContents(test, name, contents, parent) {
    const handle = await createEmptyFile(test, name, parent);
    const writer = await handle.createWriter();
    await writer.write(0, new Blob([contents]));
    await writer.close();
    return handle;
}

function garbageCollect() {
    // TODO(https://github.com/web-platform-tests/wpt/issues/7899): Change to
    // some sort of cross-browser GC trigger.
    if (self.gc) self.gc();
};