opfs-mock 2.1.0 → 2.1.1

package/README.md

@@ -1,6 +1,7 @@
 # opfs-mock
 
-This is a pure JS in-memory implementation of the [origin private file system](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system). Its main utility is for testing OPFS-dependent code in Node.js.
+In-memory implementation of the [origin private file system](https://developer.mozilla.org/en-US/docs/Web/API/File_System_API/Origin_private_file_system). Its main utility is for testing OPFS-dependent code in Node.js. It's tested
+on Node.js versions 20-23.
 
 ## Installation
 
@@ -8,6 +9,14 @@ This is a pure JS in-memory implementation of the [origin private file system](h
 npm install -save-dev opfs-mock
 ```
 
+## Limitations
+
+- `opfs-mock` requires **Node.js v20.0.0** or higher. It can work on Node v18.0.0 with either `--experimental-fetch` flag enabled or a global
+`File` polyfill.
+
+- `jsdom` testing environment is missing `File.prototype.text()` method, which is required for reading opfs files. Ensure your opfs-dependant tests are ran
+in `node` or `happy-dom` environment.
+
 ## Usage
 
 It replicates the behavior of origin private file system, except data is not persisted to disk.

package/dist/index.js

@@ -194,7 +194,7 @@ var fileSystemDirectoryHandleFactory = (name) => {
       }
       const fileHandle = files.get(fileName);
       if (!fileHandle) {
-        throw new Error(`File not found: ${fileName}`);
+        throw new DOMException(`File not found: ${fileName}`, "NotFoundError");
       }
       return fileHandle;
     },
@@ -204,7 +204,7 @@ var fileSystemDirectoryHandleFactory = (name) => {
       }
       const directoryHandle = directories.get(dirName);
       if (!directoryHandle) {
-        throw new Error(`Directory not found: ${dirName}`);
+        throw new DOMException(`Directory not found: ${dirName}`, "NotFoundError");
       }
       return directoryHandle;
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opfs-mock",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "type": "module",
   "description": "Mock all origin private file system APIs for your Jest or Vitest tests",
   "author": "Jure Rotar <hello@jurerotar.com>",
@@ -26,6 +26,9 @@
   "main": "dist/index.js",
   "module": "dist/index.js",
   "files": ["dist"],
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "scripts": {
     "dev": "tsup --watch",
     "build": "tsup",
@@ -34,14 +37,20 @@
     "format:check": "npx @biomejs/biome format",
     "format": "npx @biomejs/biome format --write",
     "type-check": "tsc --noEmit",
-    "test": "vitest",
+    "test": "npm run test:node && npm run test:happy-dom",
+    "test:node": "vitest --environment=node",
+    "test:jsdom": "vitest --environment=jsdom",
+    "test:happy-dom": "vitest --environment=happy-dom",
     "prepublishOnly": "npm run build",
     "release": "npm publish --access public"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
+    "@web-std/file": "3.0.3",
+    "happy-dom": "17.4.4",
+    "jsdom": "26.0.0",
     "tsup": "8.4.0",
-    "typescript": "5.7.3",
-    "vitest": "3.0.7"
+    "typescript": "5.8.2",
+    "vitest": "3.0.9"
   }
 }