fix: error throwing semantics

CONTRIBUTING.md

@@ -3,6 +3,7 @@
 To get started, download the project to your machine:
 
     git clone https://github.com/streamich/memfs
+    cd memfs
 
 Start from the `develop` branch:
 
@@ -11,7 +12,6 @@ Start from the `develop` branch:
 
 Install dependencies:
 
-    cd memfs
     npm install
 
 Also, you probably want to use the latest Node.js version and `ts-node`
@@ -29,13 +29,10 @@ extension.
 
 Run tests using this command:
 
-    npm test
-
-Also make sure that your test cases have your new code well, run coverage report
-using this command:
-
     npm run test-coverage-ts
 
+Also make sure that your test cases cover your new code well.
+
 When done, build the project:
 
     npm run build

lib/test/volume/exists.test.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var chai_1 = require("chai");
+var util_1 = require("./util");
+describe('exists(path, callback)', function () {
+    var vol = util_1.create();
+    it('Returns true if file exists', function (done) {
+        vol.exists('/foo', function (exists) {
+            chai_1.expect(exists).to.be.true;
+            done();
+        });
+    });
+    it('Returns false if file does not exist', function (done) {
+        vol.exists('/foo2', function (exists) {
+            chai_1.expect(exists).to.be.false;
+            done();
+        });
+    });
+    it('Throws correct error if callback not provided', function (done) {
+        try {
+            vol.exists('/foo', undefined);
+            throw new Error('not_this');
+        }
+        catch (err) {
+            chai_1.expect(err.message).to.equal('callback must be a function');
+            done();
+        }
+    });
+    it('invalid path type should throw', function () {
+        try {
+            vol.exists(123, function () { });
+            throw new Error('not_this');
+        }
+        catch (err) {
+            chai_1.expect(err.message !== 'not_this').to.be.true;
+        }
+    });
+});

lib/test/volume/existsSync.test.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var chai_1 = require("chai");
+var util_1 = require("./util");
+describe('existsSync(path)', function () {
+    var vol = util_1.create();
+    it('Returns true if file exists', function () {
+        var result = vol.existsSync('/foo');
+        chai_1.expect(result).to.be.true;
+    });
+    it('Returns false if file does not exist', function () {
+        var result = vol.existsSync('/foo2');
+        chai_1.expect(result).to.be.false;
+    });
+    it('invalid path type should not throw', function () {
+        chai_1.expect(vol.existsSync(123)).to.be.false;
+    });
+});

lib/volume.js

@@ -1135,16 +1135,16 @@ var Volume = (function () {
         this.wrapAsync(this.renameBase, [oldPathFilename, newPathFilename], callback);
     };
     Volume.prototype.existsBase = function (filename) {
+        return !!this.statBase(filename);
+    };
+    Volume.prototype.existsSync = function (path) {
         try {
-            return !!this.statBase(filename);
+            return this.existsBase(pathToFilename(path));
         }
         catch (err) {
             return false;
         }
     };
-    Volume.prototype.existsSync = function (path) {
-        return this.existsBase(pathToFilename(path));
-    };
     Volume.prototype.exists = function (path, callback) {
         var _this = this;
         var filename = pathToFilename(path);

lib/volume.test.js

@@ -682,42 +682,6 @@ describe('volume', function () {
         describe('.fstat(fd, callback)', function () {
             xit('...');
         });
-        describe('.existsSync(path)', function () {
-            var vol = volume_1.Volume.fromJSON({ '/foo': 'bar' });
-            it('Returns true if file exists', function () {
-                var result = vol.existsSync('/foo');
-                chai_1.expect(result).to.be.true;
-            });
-            it('Returns false if file does not exist', function () {
-                var result = vol.existsSync('/foo2');
-                chai_1.expect(result).to.be.false;
-            });
-        });
-        describe('.exists(path, callback)', function () {
-            var vol = volume_1.Volume.fromJSON({ '/foo': 'bar' });
-            it('Returns true if file exists', function (done) {
-                vol.exists('/foo', function (exists) {
-                    chai_1.expect(exists).to.be.true;
-                    done();
-                });
-            });
-            it('Returns false if file does not exist', function (done) {
-                vol.exists('/foo2', function (exists) {
-                    chai_1.expect(exists).to.be.false;
-                    done();
-                });
-            });
-            it('Throws correct error if callback not provided', function (done) {
-                try {
-                    vol.exists('/foo', undefined);
-                    throw new Error('not_this');
-                }
-                catch (err) {
-                    chai_1.expect(err.message).to.equal('callback must be a function');
-                    done();
-                }
-            });
-        });
         describe('.linkSync(existingPath, newPath)', function () {
             var vol = new volume_1.Volume;
             it('Create a new link', function () {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "memfs",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "In-memory file-system with Node's fs API.",
   "main": "lib/index.js",
   "keywords": [

src/test/volume/exists.test.ts

@@ -0,0 +1,36 @@
+import {expect} from 'chai';
+import {create} from "./util";
+
+
+describe('exists(path, callback)', () => {
+    const vol = create();
+    it('Returns true if file exists', done => {
+        vol.exists('/foo', exists => {
+            expect(exists).to.be.true;
+            done();
+        });
+    });
+    it('Returns false if file does not exist', done => {
+        vol.exists('/foo2', exists => {
+            expect(exists).to.be.false;
+            done();
+        });
+    });
+    it('Throws correct error if callback not provided', done => {
+        try {
+            vol.exists('/foo', undefined);
+            throw new Error('not_this');
+        } catch(err) {
+            expect(err.message).to.equal('callback must be a function');
+            done();
+        }
+    });
+    it('invalid path type should throw', () => {
+        try {
+            vol.exists(123 as any, () => {});
+            throw new Error('not_this');
+        } catch(err) {
+            expect(err.message !== 'not_this').to.be.true;
+        }
+    });
+});

src/test/volume/existsSync.test.ts

@@ -0,0 +1,18 @@
+import {expect} from 'chai';
+import {create} from "./util";
+
+
+describe('existsSync(path)', () => {
+    const vol = create();
+    it('Returns true if file exists', () => {
+        const result = vol.existsSync('/foo');
+        expect(result).to.be.true;
+    });
+    it('Returns false if file does not exist', () => {
+        const result = vol.existsSync('/foo2');
+        expect(result).to.be.false;
+    });
+    it('invalid path type should not throw', () => {
+        expect(vol.existsSync(123 as any)).to.be.false;
+    });
+});

src/volume.test.ts

@@ -687,41 +687,6 @@ describe('volume', () => {
         describe('.fstat(fd, callback)', () => {
             xit('...');
         });
-        describe('.existsSync(path)', () => {
-            const vol = Volume.fromJSON({'/foo': 'bar'});
-            it('Returns true if file exists', () => {
-                const result = vol.existsSync('/foo');
-                expect(result).to.be.true;
-            });
-            it('Returns false if file does not exist', () => {
-                const result = vol.existsSync('/foo2');
-                expect(result).to.be.false;
-            });
-        });
-        describe('.exists(path, callback)', () => {
-            const vol = Volume.fromJSON({'/foo': 'bar'});
-            it('Returns true if file exists', done => {
-                vol.exists('/foo', exists => {
-                    expect(exists).to.be.true;
-                    done();
-                });
-            });
-            it('Returns false if file does not exist', done => {
-                vol.exists('/foo2', exists => {
-                    expect(exists).to.be.false;
-                    done();
-                });
-            });
-            it('Throws correct error if callback not provided', done => {
-                try {
-                    vol.exists('/foo', undefined);
-                    throw new Error('not_this');
-                } catch(err) {
-                    expect(err.message).to.equal('callback must be a function');
-                    done();
-                }
-            });
-        });
         describe('.linkSync(existingPath, newPath)', () => {
             const vol = new Volume;
             it('Create a new link', () => {

src/volume.ts

@@ -1349,17 +1349,17 @@ export class Volume {
     }
 
     private existsBase(filename: string): boolean {
+        return !!this.statBase(filename);
+    }
+
+    existsSync(path: TFilePath): boolean {
         try {
-            return !!this.statBase(filename);
+            return this.existsBase(pathToFilename(path));
         } catch(err) {
             return false;
         }
     }
 
-    existsSync(path: TFilePath): boolean {
-        return this.existsBase(pathToFilename(path));
-    }
-
     exists(path: TFilePath, callback: (exists: boolean) => void) {
         const filename = pathToFilename(path);