opfs-mock

This is a pure JS in-memory implementation of the origin private file system. Its main utility is for testing OPFS-dependent code in Node.js.

Installation

npm install -save-dev opfs-mock

Usage

It replicates the behavior of origin private file system, except data is not persisted to disk.

The easiest way to use it is to import opfs-mock, which will polyfill OPFS API to global scope.

import "opfs-mock";

Alternatively, you can explicitly import storage:

import { storage } from "opfs-mock";

test('Your test', async () => {
  const root = await storage.getDirectory();
  const directoryHandle = await root.getFileHandle('test-file.txt', { create: true });
  // rest of your test
});

Vitest

To use opfs-mock in a single Vitest test suite, require opfs-mock at the beginning of the test file, as described above.

To use it on all Vitest tests without having to include it in each file, add the auto setup script to the test.setupFiles in your Vite config:

// vite.config.js

{
  ...
  test: {
    setupFiles: ['opfs-mock'],
  },
}

Alternatively you can create a new setup file which then imports this module.

// vitest-setup.ts

import "opfs-mock";

Add that file to your test.setupFiles array:

// vite.config.ts

import { defineConfig } from 'vite'

export default defineConfig({
  test: {
    setupFiles: ['vitest-setup.ts'],
  }
});

Jest

To use opfs-mock in a single Jest test suite, require opfs-mock at the beginning of the test file, as described above.

To use it on all Jest tests without having to include it in each file, add the auto setup script to the setupFiles in your Jest config:

// jest.config.js

{
  ...
  "setupFiles": [
    "opfs-mock"
  ]
}

Alternatively you can create a new setup file which then imports this module.

// jest-setup.ts

import "opfs-mock";

Add that file to your setupFiles array:

// jest.config.js

{
  ...
  "setupFiles": [
    "jest-setup"
  ]
}

Wiping/resetting the OPFS mock for a fresh state

If you are keeping your tests completely isolated you might want to "reset" the state of the mocked OPFS. You can do this by using resetMockOPFS function, which creates a completely new instance of the mock.

import { resetMockOPFS } from 'opfs-mock';

beforeEach(() => {
  resetMockOPFS();
});

test('First isolated test', async () => {
  // rest of your test
});

test('Second isolated test', async () => {
  // rest of your test
});