# Change Log

## 5.5.0

- Add test and fix exists behaviour for relative symlinks (thanks @timvahlbrock, see #415)
- Add test showing `fs.createWriteStream()` with append (see #412)
- encoding utf8 strings in node 20 (thanks @everett1992, see #409)

- bump semver from 7.6.3 to 7.7.0 (see #413)
- bump eslint-config-tschaub from 14.1.2 to 15.2.0 (see #408)
- bump mocha from 11.0.1 to 11.1.0 (see #410)
- bump mocha from 10.8.2 to 11.0.1 (see #407)
- bump mocha from 10.7.3 to 10.8.2 (see #402)

## 5.4.1

- Avoid errors in `fs.existsSync` (see #401)

## 5.4.0

- Use setImmediate instead of process.nextTick (thanks @regseb, see #360)

- bump chai from 4.3.4 to 4.5.0
- bump eslint from 8.21.0 to 8.57.1

## 5.3.0

- Remove conditions for untested versions
- Remove disabled tests for mock.fs (thanks @everett1992, see #391)
- Fix tests on node 20 (thanks @everett1992, see #387)
- Fix timeout in failing test (thanks @everett1992, see #390)
- Stop testing on Node 12 and 14

- chore(deps-dev): bump rimraf from 3.0.2 to 6.0.1
- chore(deps): bump actions/checkout from 2 to 4
- chore(deps-dev): bump mocha from 9.2.2 to 10.7.3
- chore(deps-dev): bump braces from 3.0.2 to 3.0.3
- chore(deps-dev): bump word-wrap from 1.2.3 to 1.2.4
- chore(deps): bump json5 from 1.0.1 to 1.0.2

## 5.2.0

- Fix EACCES error on access by root user (thanks @danielkatz, see #369)
- Fix bug on utimes and futimes; add support of lutimes (thanks @3cp, see #366)

## 5.1.4

- Fix for BigInt stats in Node 16.7 (thanks @ahippler, see #363)

## 5.1.3

- Fix for BigInt stats in Node 18.7 (thanks @3cp, see #361)

## 5.1.2

- Avoid open `FSREQCALLBACK` file handles (thanks @jloleysens, see #342)

## 5.1.1

- Added `engines` to `package.json` to clarify that Node >= 12 is required (thanks @tillig, see #337)

## 5.1.0

- Added support for Node >= 16.3 (thanks @Rugvip, see #335)

## 5.0.0

Breaking change:

- Remove support for Node < 12. If you want to use mock-fs to test on Node 10 or lower, stick with mock-fs@4.

New features:

- Support for BigInt file stats - required for Node 15+ (thanks @3cp, see #325)

## 4.14.0

- Attempt to fix logging when using `mock-fs` with `tape` (see #322)
- Minor fix for `bypass()` (thanks @3cp, see #320)

## 4.13.0

- Make `process.chdir()`, `process.cwd()`, and `fs.createWriteStream()` work with `bypass()` (thanks @3cp, see #307)
- Fix memory leak associated with Node 10 (thanks @3cp, see #303)
- Async function handling in `bypass()` (see #306)
- Big new feature! Temporarily bypass the mocked filesystem with the `bypass()` function (thanks @nonara, see #304)

## 4.12.0

- Check permissions in `readdir` and `readdirSync` (thanks @warpdesign, see #295)
- Add support for `Buffer` arg on many `fs` functions (thanks @3cp, see #293)
- Fix checks for read permission (thanks @3cp, see #289)
- Correct error code for `readFile` on a directory (thanks @3cp, see #286)

## 4.11.0

- Support `withFileTypes` when reading directories (thanks @mrmlnc, see #287)

## 4.10.4

- Throw ENOTDIR when trying to open an incorrect path (thanks @niieani, see #282)
- Fix maybeCallback return (thanks @3cp, see #281)

## 4.10.3

- Fix bad promise rejection on some fs.promises methods (thanks @3cp, see #279)

## 4.10.2

- Fix timestamps for Node > 12.10 (thanks @3cp, see #277)

## 4.10.1

- Fix for `fs.mkdir` with the `recursive` option on existing directories (thanks @3cp, see #271)

## 4.10.0

- Support the `recursive` option for `fs.mkdir` (thanks @3cp, see #268)

## 4.9.0

- Improve `readFile` support for Node 10+ (thanks @huochunpeng, see #265)
- Updated dev dependencies (see #267)

## 4.8.0

- Fix compatibility issues with Node 10 and 11 (thanks @huochunpeng #260)
- Support experimental `fs.promises` (thanks @huochunpeng #260)

## 4.7.0

- Fix for readdir on Node 10.10 (thanks @maxwellgerber #251)
- Fix for reading and writing using Uint8Array (thanks @maxwellgerber #249)
- Document how to properly restore the fs with Jest snapshot testing (thanks @tricoder42 #247)
- More informative error when opening a directory (thanks @maxwellgerber #242)

## 4.6.0

Note that the mocked fs.createReadStream and fs.createWriteStream are not working properly with Node 10.5+.

- Implement binding.copyFile (#243)
- Stat fixes for Node 10.5 (thanks @tomhughes, see [#241][#241])

## 4.5.0

- Updates for Node 10 compatibility (#237)
- Throw ENOENT in readlink when item is missing (thanks @deployable, see #232)
- Add path to errors when it exists (thanks @deployable, see #230)

## 4.4.2

- Throw if item content is invalid in config (thanks @mutantcornholio, see #221)
- Use const in readme (thanks @denar90, see #222)

## 4.4.1

- Document that tests are run on Node 8.x as well.

## 4.4.0

- Fix stat issue with Node 8 (thanks @AGrzes, see #209)
- Make code prettier (see #210)

## 4.3.0

- Add support for fs.mkdtemp() and fs.mkdtempSync (see #207)

## 4.2.0

- Update fs.stat(), fs.lstat(), and fs.fstat() for Node 7.7+ (thanks @not-an-aardvark, see #198)

## 4.1.0

- Correctly follow a symlink chain in `binding.open()` (thanks @vlindhol, see #195)

## 4.0.0

In earlier versions of `mock-fs`, a monkey-patched version of the `fs` module was used to provide an in-memory filesystem. With each major release of Node, the `mock-fs` package needed to include a modified copy of the `fs` module. With the `mock-fs@4` release, this package no longer includes a modified copy of the `fs` module. Instead, this package overrides `process.binding('fs')`. While this is not part of Node's stable API, it has proven to be a more stable interface than the `fs` module itself (based on experience implementing it with Node 0.8 through 7.0).

Upgrading from 3.x to 4.0 should be straightforward for most applications. There are several breaking changes that may be restored in future releases:

- The `mock.fs()` function has been removed.
- The object created by `fs.stat()` and friends is no longer an instance of `fs.Stats` (though it behaves as one).
- Lazy `require()` calls do not work consistently.

Detailed changes:

- Only override `process.binding('fs')` (#182)
- Expose the root of the mocked filesystem (thanks @ciaranj, see #194)

## 3.12.1

- Revert the require cache clearing behavior (#181).

## 3.12.0

- Support for Node 7.x (thanks @goliney, see #174).
- Remove calls to `printDeprecation` (#175).
- Break early when checking version (thanks @isiahmeadows, see #157).
- Add a note about restoring `fs` (thanks @matheuss, see #147).
- Clear the require cache before overriding fs functions (#141)

## 3.11.0

- Make `require()` calls use the real filesystem (#139).
- Reduce the manual `fs` module patching (#140).

## 3.10.0

- Fixes for Node 6.3 (#138).
- Fix permissions issues on directories (thanks @as3richa, see #105).

## 3.9.0

- Support for Node 6.x (thanks @tmcw, see #107).

## 3.8.0

- Implement `binding.writeBuffers()` (see #94).

## 3.7.0

- Add support for `fs.access()` and `fs.accessSync()` (thanks @shyiko, see #78 and #80).

## 3.6.0

- Add `createCwd` and `createTmp` options to control the creation of `process.cwd()` and `os.tmpdir()` directories in the mocked filesystem (see #72).
- Update Travis and AppVeyor configurations (see #73)
- Remove unused dev dependency (see #75)

## 3.5.0

- Support for Node 5.x (thanks @tmcw, see #69).

## 3.4.0

- Support for Node 4.x (thanks @AlexMeah, see #65).

## 3.3.0

- Traverse symlinks recursively (thanks @caitp, see #57).
- Upgrade to rewire@2.3.4 (thanks @mbarlock, see #60).

## 3.2.0

- Support for io.js 3.0 (thanks @JustBlackBird, see #61).

## 3.1.0

- Follow symlinks in `readdir()` and `readdirSync()` (thanks @caitp, see #56).

## 3.0.0

- Override `process.cwd()` and `process.chdir()` to work with mocked filesystem (thanks @timkendrick, see #41).
- Add note about known incompatibilities (thanks @psalaets, see #45).

## 2.7.0

- Support for io.js 2.0 (thanks @jwilsson, see #38).

## 2.6.0

- Add `birthtime` to `Stats` objects (thanks @meandmycode, see #33).

## 2.5.0

- Support for io.js 1.1 (thanks @andrewblond, see #21).
- Testing on Windows with AppVeyor (thanks @andrewblond, see #22).

## 2.4.0

- Support for Node 0.12 (thanks @mlegenhausen, see #18).

## 2.3.1

- Preserve arity of callbacks (see #11).

## 2.3.0

- Fixes for Node 0.11.13 (see #9).

## 2.2.0

- Respect file mode on POSIX-compliant systems (see #7).
- Add benchmarks comparing mock-fs and fs modules (see #6).

## 2.1.2

- Added more complete license text.
- Test on Node 0.9 and 0.11 in addition to 0.8 and 0.10.

## 2.1.1

- Added this changelog.
- Removed unused gruntfile.js.

## 2.1.0

- Directory mtime is now updated when items are added, removed, or modified (#2).
- Fixed several issues on Windows (see #3). One issue remains on Windows with Node 0.8 (see #4).
- Swapped out Grunt with a single script to run tasks (see #5).

## 2.0.0

- Simplified API (see #1).