41 lines
		
	
	
		
			938 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			41 lines
		
	
	
		
			938 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
# `patchFs(vol[, fs])`
 | 
						|
 | 
						|
Rewrites Node's filesystem module `fs` with *fs-like* object.
 | 
						|
 | 
						|
 - `vol` - fs-like object
 | 
						|
 - `fs` *(optional)* - a filesystem to patch, defaults to `require('fs')`
 | 
						|
 | 
						|
```js
 | 
						|
import {patchFs} from 'fs-monkey';
 | 
						|
 | 
						|
const myfs = {
 | 
						|
    readFileSync: () => 'hello world',
 | 
						|
};
 | 
						|
 | 
						|
patchFs(myfs);
 | 
						|
console.log(require('fs').readFileSync('/foo/bar')); // hello world
 | 
						|
```
 | 
						|
 | 
						|
You don't need to create *fs-like* objects yourself, use [`memfs`](https://github.com/streamich/memfs)
 | 
						|
to create a virtual filesystem for you:
 | 
						|
 | 
						|
```js
 | 
						|
import {vol} from 'memfs';
 | 
						|
import {patchFs} from 'fs-monkey';
 | 
						|
 | 
						|
vol.fromJSON({'/dir/foo': 'bar'});
 | 
						|
patchFs(vol);
 | 
						|
console.log(require('fs').readdirSync('/')); // [ 'dir' ]
 | 
						|
```
 | 
						|
 | 
						|
Promises API is supported as well:
 | 
						|
 | 
						|
```js
 | 
						|
import {vol} from 'memfs';
 | 
						|
import {patchFs} from 'fs-monkey';
 | 
						|
 | 
						|
vol.fromJSON({'/dir/foo': 'bar'});
 | 
						|
patchFs(vol);
 | 
						|
require('fs').promises.readFile('/dir/foo', 'UTF-8').then(console.log); // bar
 | 
						|
```
 |