How to use stub method in Cypress

...28            assert.same(syncVersions, asyncVersions,29                "Stub prototype should contain same amount of synchronous and asynchronous methods");30        },31        "should allow overriding async behavior with sync behavior": function () {32            var stub = sinon.stub();33            var callback = sinon.spy();34            stub.callsArgAsync(1);35            stub.callsArg(1);36            stub(1, callback);37            assert(callback.called);38        },39        ".returns": {40            "returns specified value": function () {41                var stub = sinon.stub.create();42                var object = {};43                stub.returns(object);44                assert.same(stub(), object);45            },46            "returns should return stub": function () {47                var stub = sinon.stub.create();48                assert.same(stub.returns(""), stub);49            },50            "returns undefined": function () {51                var stub = sinon.stub.create();52                refute.defined(stub());53            },54            "supersedes previous throws": function () {55                var stub = sinon.stub.create();56                stub.throws().returns(1);57                refute.exception(function () {58                    stub();59                });60            }61        },62        ".returnsArg": {63            "returns argument at specified index": function () {64                var stub = sinon.stub.create();65                stub.returnsArg(0);66                var object = {};67                assert.same(stub(object), object);68            },69            "returns stub": function () {70                var stub = sinon.stub.create();71                assert.same(stub.returnsArg(0), stub);72            },73            "throws if no index is specified": function () {74                var stub = sinon.stub.create();75                assert.exception(function () {76                    stub.returnsArg();77                }, "TypeError");78            },79            "throws if index is not number": function () {80                var stub = sinon.stub.create();81                assert.exception(function () {82                    stub.returnsArg({});83                }, "TypeError");84            }85        },86        ".returnsThis": {87            "stub returns this": function () {88                var instance = {};89                instance.stub = sinon.stub.create();90                instance.stub.returnsThis();91                assert.same(instance.stub(), instance);92            },93            "stub returns undefined when detached": {94                requiresSupportFor: {95                    strictMode: (function () {96                        return this;97                    }()) === undefined98                },99                "": function () {100                    var stub = sinon.stub.create();101                    stub.returnsThis();102                    // Due to strict mode, would be `global` otherwise103                    assert.same(stub(), undefined);104                }105            },106            "stub respects call/apply": function () {107                var stub = sinon.stub.create();108                stub.returnsThis();109                var object = {};110                assert.same(stub.call(object), object);111                assert.same(stub.apply(object), object);112            },113            "returns stub": function () {114                var stub = sinon.stub.create();115                assert.same(stub.returnsThis(), stub);116            }117        },118        ".throws": {119            "throws specified exception": function () {120                var stub = sinon.stub.create();121                var error = new Error();122                stub.throws(error);123                try {124                    stub();125                    fail("Expected stub to throw");126                } catch (e) {127                    assert.same(e, error);128                }129            },130            "returns stub": function () {131                var stub = sinon.stub.create();132                assert.same(stub.throws({}), stub);133            },134            "sets type of exception to throw": function () {135                var stub = sinon.stub.create();136                var exceptionType = "TypeError";137                stub.throws(exceptionType);138                assert.exception(function () {139                    stub();140                }, exceptionType);141            },142            "specifies exception message": function () {143                var stub = sinon.stub.create();144                var message = "Oh no!";145                stub.throws("Error", message);146                try {147                    stub();148                    buster.referee.fail("Expected stub to throw");149                } catch (e) {150                    assert.equals(e.message, message);151                }152            },153            "does not specify exception message if not provided": function () {154                var stub = sinon.stub.create();155                stub.throws("Error");156                try {157                    stub();158                    buster.referee.fail("Expected stub to throw");159                } catch (e) {160                    assert.equals(e.message, "");161                }162            },163            "throws generic error": function () {164                var stub = sinon.stub.create();165                stub.throws();166                assert.exception(function () {167                    stub();168                }, "Error");169            },170            "resets 'invoking' flag": function () {171                var stub = sinon.stub.create();172                stub.throws();173                try {174                    stub();175                } catch (e) {176                    refute.defined(stub.invoking);177                }178            }179        },180        ".callsArg": {181            setUp: function () {182                this.stub = sinon.stub.create();183            },184            "calls argument at specified index": function () {185                this.stub.callsArg(2);186                var callback = sinon.stub.create();187                this.stub(1, 2, callback);188                assert(callback.called);189            },190            "returns stub": function () {191                assert.isFunction(this.stub.callsArg(2));192            },193            "throws if argument at specified index is not callable": function () {194                this.stub.callsArg(0);195                assert.exception(function () {196                    this.stub(1);197                }, "TypeError");198            },199            "throws if no index is specified": function () {200                var stub = this.stub;201                assert.exception(function () {202                    stub.callsArg();203                }, "TypeError");204            },205            "throws if index is not number": function () {206                var stub = this.stub;207                assert.exception(function () {208                    stub.callsArg({});209                }, "TypeError");210            }211        },212        ".callsArgWith": {213            setUp: function () {214                this.stub = sinon.stub.create();215            },216            "calls argument at specified index with provided args": function () {217                var object = {};218                this.stub.callsArgWith(1, object);219                var callback = sinon.stub.create();220                this.stub(1, callback);221                assert(callback.calledWith(object));222            },223            "returns function": function () {224                var stub = this.stub.callsArgWith(2, 3);225                assert.isFunction(stub);226            },227            "calls callback without args": function () {228                this.stub.callsArgWith(1);229                var callback = sinon.stub.create();230                this.stub(1, callback);231                assert(callback.calledWith());232            },233            "calls callback with multiple args": function () {234                var object = {};235                var array = [];236                this.stub.callsArgWith(1, object, array);237                var callback = sinon.stub.create();238                this.stub(1, callback);239                assert(callback.calledWith(object, array));240            },241            "throws if no index is specified": function () {242                var stub = this.stub;243                assert.exception(function () {244                    stub.callsArgWith();245                }, "TypeError");246            },247            "throws if index is not number": function () {248                var stub = this.stub;249                assert.exception(function () {250                    stub.callsArgWith({});251                }, "TypeError");252            }253        },254        ".callsArgOn": {255            setUp: function () {256                this.stub = sinon.stub.create();257                this.fakeContext = {258                    foo: "bar"259                };260            },261            "calls argument at specified index": function () {262                this.stub.callsArgOn(2, this.fakeContext);263                var callback = sinon.stub.create();264                this.stub(1, 2, callback);265                assert(callback.called);266                assert(callback.calledOn(this.fakeContext));267            },268            "returns stub": function () {269                var stub = this.stub.callsArgOn(2, this.fakeContext);270                assert.isFunction(stub);271            },272            "throws if argument at specified index is not callable": function () {273                this.stub.callsArgOn(0, this.fakeContext);274                assert.exception(function () {275                    this.stub(1);276                }, "TypeError");277            },278            "throws if no index is specified": function () {279                var stub = this.stub;280                assert.exception(function () {281                    stub.callsArgOn();282                }, "TypeError");283            },284            "throws if no context is specified": function () {285                var stub = this.stub;286                assert.exception(function () {287                    stub.callsArgOn(3);288                }, "TypeError");289            },290            "throws if index is not number": function () {291                var stub = this.stub;292                assert.exception(function () {293                    stub.callsArgOn(this.fakeContext, 2);294                }, "TypeError");295            },296            "throws if context is not an object": function () {297                var stub = this.stub;298                assert.exception(function () {299                    stub.callsArgOn(2, 2);300                }, "TypeError");301            }302        },303        ".callsArgOnWith": {304            setUp: function () {305                this.stub = sinon.stub.create();306                this.fakeContext = { foo: "bar" };307            },308            "calls argument at specified index with provided args": function () {309                var object = {};310                this.stub.callsArgOnWith(1, this.fakeContext, object);311                var callback = sinon.stub.create();312                this.stub(1, callback);313                assert(callback.calledWith(object));314                assert(callback.calledOn(this.fakeContext));315            },316            "returns function": function () {317                var stub = this.stub.callsArgOnWith(2, this.fakeContext, 3);318                assert.isFunction(stub);319            },320            "calls callback without args": function () {321                this.stub.callsArgOnWith(1, this.fakeContext);322                var callback = sinon.stub.create();323                this.stub(1, callback);324                assert(callback.calledWith());325                assert(callback.calledOn(this.fakeContext));326            },327            "calls callback with multiple args": function () {328                var object = {};329                var array = [];330                this.stub.callsArgOnWith(1, this.fakeContext, object, array);331                var callback = sinon.stub.create();332                this.stub(1, callback);333                assert(callback.calledWith(object, array));334                assert(callback.calledOn(this.fakeContext));335            },336            "throws if no index is specified": function () {337                var stub = this.stub;338                assert.exception(function () {339                    stub.callsArgOnWith();340                }, "TypeError");341            },342            "throws if no context is specified": function () {343                var stub = this.stub;344                assert.exception(function () {345                    stub.callsArgOnWith(3);346                }, "TypeError");347            },348            "throws if index is not number": function () {349                var stub = this.stub;350                assert.exception(function () {351                    stub.callsArgOnWith({});352                }, "TypeError");353            },354            "throws if context is not an object": function () {355                var stub = this.stub;356                assert.exception(function () {357                    stub.callsArgOnWith(2, 2);358                }, "TypeError");359            }360        },361        ".objectMethod": {362            setUp: function () {363                this.method = function () {};364                this.object = { method: this.method };365                this.wrapMethod = sinon.wrapMethod;366            },367            tearDown: function () {368                sinon.wrapMethod = this.wrapMethod;369            },370            "returns function from wrapMethod": function () {371                var wrapper = function () {};372                sinon.wrapMethod = function () {373                    return wrapper;374                };375                var result = sinon.stub(this.object, "method");376                assert.same(result, wrapper);377            },378            "passes object and method to wrapMethod": function () {379                var wrapper = function () {};380                var args;381                sinon.wrapMethod = function () {382                    args = arguments;383                    return wrapper;384                };385                sinon.stub(this.object, "method");386                assert.same(args[0], this.object);387                assert.same(args[1], "method");388            },389            "uses provided function as stub": function () {390                var called = false;391                var stub = sinon.stub(this.object, "method", function () {392                    called = true;393                });394                stub();395                assert(called);396            },397            "wraps provided function": function () {398                var customStub = function () {};399                var stub = sinon.stub(this.object, "method", customStub);400                refute.same(stub, customStub);401                assert.isFunction(stub.restore);402            },403            "throws if third argument is provided but not a function or proprety descriptor": function () {404                var object = this.object;405                assert.exception(function () {406                    sinon.stub(object, "method", 1);407                }, "TypeError");408            },409            "stubbed method should be proper stub": function () {410                var stub = sinon.stub(this.object, "method");411                assert.isFunction(stub.returns);412                assert.isFunction(stub.throws);413            },414            "custom stubbed method should not be proper stub": function () {415                var stub = sinon.stub(this.object, "method", function () {});416                refute.defined(stub.returns);417                refute.defined(stub.throws);418            },419            "stub should be spy": function () {420                var stub = sinon.stub(this.object, "method");421                this.object.method();422                assert(stub.called);423                assert(stub.calledOn(this.object));424            },425            "custom stubbed method should be spy": function () {426                var stub = sinon.stub(this.object, "method", function () {});427                this.object.method();428                assert(stub.called);429                assert(stub.calledOn(this.object));430            },431            "stub should affect spy": function () {432                var stub = sinon.stub(this.object, "method");433                stub.throws("TypeError");434                try {435                    this.object.method();436                }437                catch (e) {} // eslint-disable-line no-empty438                assert(stub.threw("TypeError"));439            },440            "returns standalone stub without arguments": function () {441                var stub = sinon.stub();442                assert.isFunction(stub);443                assert.isFalse(stub.called);444            },445            "throws if property is not a function": function () {446                var obj = { someProp: 42 };447                assert.exception(function () {448                    sinon.stub(obj, "someProp");449                });450                assert.equals(obj.someProp, 42);451            },452            "successfully stubs falsey properties": function () {453                var obj = { 0: function () { } };454                sinon.stub(obj, 0, function () {455                    return "stubbed value";456                });457                assert.equals(obj[0](), "stubbed value");458            },459            "does not stub function object": function () {460                assert.exception(function () {461                    sinon.stub(function () {});462                });463            }464        },465        everything: {466            "stubs all methods of object without property": function () {467                var obj = {468                    func1: function () {},469                    func2: function () {},470                    func3: function () {}471                };472                sinon.stub(obj);473                assert.isFunction(obj.func1.restore);474                assert.isFunction(obj.func2.restore);475                assert.isFunction(obj.func3.restore);476            },477            "stubs prototype methods": function () {478                function Obj() {}479                Obj.prototype.func1 = function () {};480                var obj = new Obj();481                sinon.stub(obj);482                assert.isFunction(obj.func1.restore);483            },484            "returns object": function () {485                var object = {};486                assert.same(sinon.stub(object), object);487            },488            "only stubs functions": function () {489                var object = { foo: "bar" };490                sinon.stub(object);491                assert.equals(object.foo, "bar");492            }493        },494        "stubbed function": {495            "throws if stubbing non-existent property": function () {496                var myObj = {};497                assert.exception(function () {498                    sinon.stub(myObj, "ouch");499                });500                refute.defined(myObj.ouch);501            },502            "has toString method": function () {503                var obj = { meth: function () {} };504                sinon.stub(obj, "meth");505                assert.equals(obj.meth.toString(), "meth");506            },507            "toString should say 'stub' when unable to infer name": function () {508                var stub = sinon.stub();509                assert.equals(stub.toString(), "stub");510            },511            "toString should prefer property name if possible": function () {512                var obj = {};513                obj.meth = sinon.stub();514                obj.meth();515                assert.equals(obj.meth.toString(), "meth");516            }517        },518        ".yields": {519            "invokes only argument as callback": function () {520                var stub = sinon.stub().yields();521                var spy = sinon.spy();522                stub(spy);523                assert(spy.calledOnce);524                assert.equals(spy.args[0].length, 0);525            },526            "throws understandable error if no callback is passed": function () {527                var stub = sinon.stub().yields();528                try {529                    stub();530                    throw new Error();531                } catch (e) {532                    assert.equals(e.message, "stub expected to yield, but no callback was passed.");533                }534            },535            "includes stub name and actual arguments in error": function () {536                var myObj = { somethingAwesome: function () {} };537                var stub = sinon.stub(myObj, "somethingAwesome").yields();538                try {539                    stub(23, 42);540                    throw new Error();541                } catch (e) {542                    assert.equals(e.message, "somethingAwesome expected to yield, but no callback " +543                                  "was passed. Received [23, 42]");544                }545            },546            "invokes last argument as callback": function () {547                var stub = sinon.stub().yields();548                var spy = sinon.spy();549                stub(24, {}, spy);550                assert(spy.calledOnce);551                assert.equals(spy.args[0].length, 0);552            },553            "invokes first of two callbacks": function () {554                var stub = sinon.stub().yields();555                var spy = sinon.spy();556                var spy2 = sinon.spy();557                stub(24, {}, spy, spy2);558                assert(spy.calledOnce);559                assert(!spy2.called);560            },561            "invokes callback with arguments": function () {562                var obj = { id: 42 };563                var stub = sinon.stub().yields(obj, "Crazy");564                var spy = sinon.spy();565                stub(spy);566                assert(spy.calledWith(obj, "Crazy"));567            },568            "throws if callback throws": function () {569                var obj = { id: 42 };570                var stub = sinon.stub().yields(obj, "Crazy");571                var callback = sinon.stub().throws();572                assert.exception(function () {573                    stub(callback);574                });575            },576            "plays nice with throws": function () {577                var stub = sinon.stub().throws().yields();578                var spy = sinon.spy();579                assert.exception(function () {580                    stub(spy);581                });582                assert(spy.calledOnce);583            },584            "plays nice with returns": function () {585                var obj = {};586                var stub = sinon.stub().returns(obj).yields();587                var spy = sinon.spy();588                assert.same(stub(spy), obj);589                assert(spy.calledOnce);590            },591            "plays nice with returnsArg": function () {592                var stub = sinon.stub().returnsArg(0).yields();593                var spy = sinon.spy();594                assert.same(stub(spy), spy);595                assert(spy.calledOnce);596            },597            "plays nice with returnsThis": function () {598                var obj = {};599                var stub = sinon.stub().returnsThis().yields();600                var spy = sinon.spy();601                assert.same(stub.call(obj, spy), obj);602                assert(spy.calledOnce);603            }604        },605        ".yieldsRight": {606            "invokes only argument as callback": function () {607                var stub = sinon.stub().yieldsRight();608                var spy = sinon.spy();609                stub(spy);610                assert(spy.calledOnce);611                assert.equals(spy.args[0].length, 0);612            },613            "throws understandable error if no callback is passed": function () {614                var stub = sinon.stub().yieldsRight();615                try {616                    stub();617                    throw new Error();618                } catch (e) {619                    assert.equals(e.message, "stub expected to yield, but no callback was passed.");620                }621            },622            "includes stub name and actual arguments in error": function () {623                var myObj = { somethingAwesome: function () {} };624                var stub = sinon.stub(myObj, "somethingAwesome").yieldsRight();625                try {626                    stub(23, 42);627                    throw new Error();628                } catch (e) {629                    assert.equals(e.message, "somethingAwesome expected to yield, but no callback " +630                    "was passed. Received [23, 42]");631                }632            },633            "invokes last argument as callback": function () {634                var stub = sinon.stub().yieldsRight();635                var spy = sinon.spy();636                stub(24, {}, spy);637                assert(spy.calledOnce);638                assert.equals(spy.args[0].length, 0);639            },640            "invokes the last of two callbacks": function () {641                var stub = sinon.stub().yieldsRight();642                var spy = sinon.spy();643                var spy2 = sinon.spy();644                stub(24, {}, spy, spy2);645                assert(!spy.called);646                assert(spy2.calledOnce);647            },648            "invokes callback with arguments": function () {649                var obj = { id: 42 };650                var stub = sinon.stub().yieldsRight(obj, "Crazy");651                var spy = sinon.spy();652                stub(spy);653                assert(spy.calledWith(obj, "Crazy"));654            },655            "throws if callback throws": function () {656                var obj = { id: 42 };657                var stub = sinon.stub().yieldsRight(obj, "Crazy");658                var callback = sinon.stub().throws();659                assert.exception(function () {660                    stub(callback);661                });662            },663            "plays nice with throws": function () {664                var stub = sinon.stub().throws().yieldsRight();665                var spy = sinon.spy();666                assert.exception(function () {667                    stub(spy);668                });669                assert(spy.calledOnce);670            },671            "plays nice with returns": function () {672                var obj = {};673                var stub = sinon.stub().returns(obj).yieldsRight();674                var spy = sinon.spy();675                assert.same(stub(spy), obj);676                assert(spy.calledOnce);677            },678            "plays nice with returnsArg": function () {679                var stub = sinon.stub().returnsArg(0).yieldsRight();680                var spy = sinon.spy();681                assert.same(stub(spy), spy);682                assert(spy.calledOnce);683            },684            "plays nice with returnsThis": function () {685                var obj = {};686                var stub = sinon.stub().returnsThis().yieldsRight();687                var spy = sinon.spy();688                assert.same(stub.call(obj, spy), obj);689                assert(spy.calledOnce);690            }691        },692        ".yieldsOn": {693            setUp: function () {694                this.stub = sinon.stub.create();695                this.fakeContext = { foo: "bar" };696            },697            "invokes only argument as callback": function () {698                var spy = sinon.spy();699                this.stub.yieldsOn(this.fakeContext);700                this.stub(spy);701                assert(spy.calledOnce);702                assert(spy.calledOn(this.fakeContext));703                assert.equals(spy.args[0].length, 0);704            },705            "throws if no context is specified": function () {706                assert.exception(function () {707                    this.stub.yieldsOn();708                }, "TypeError");709            },710            "throws understandable error if no callback is passed": function () {711                this.stub.yieldsOn(this.fakeContext);712                try {713                    this.stub();714                    throw new Error();715                } catch (e) {716                    assert.equals(e.message, "stub expected to yield, but no callback was passed.");717                }718            },719            "includes stub name and actual arguments in error": function () {720                var myObj = { somethingAwesome: function () {} };721                var stub = sinon.stub(myObj, "somethingAwesome").yieldsOn(this.fakeContext);722                try {723                    stub(23, 42);724                    throw new Error();725                } catch (e) {726                    assert.equals(e.message, "somethingAwesome expected to yield, but no callback " +727                                  "was passed. Received [23, 42]");728                }729            },730            "invokes last argument as callback": function () {731                var spy = sinon.spy();732                this.stub.yieldsOn(this.fakeContext);733                this.stub(24, {}, spy);734                assert(spy.calledOnce);735                assert(spy.calledOn(this.fakeContext));736                assert.equals(spy.args[0].length, 0);737            },738            "invokes first of two callbacks": function () {739                var spy = sinon.spy();740                var spy2 = sinon.spy();741                this.stub.yieldsOn(this.fakeContext);742                this.stub(24, {}, spy, spy2);743                assert(spy.calledOnce);744                assert(spy.calledOn(this.fakeContext));745                assert(!spy2.called);746            },747            "invokes callback with arguments": function () {748                var obj = { id: 42 };749                var spy = sinon.spy();750                this.stub.yieldsOn(this.fakeContext, obj, "Crazy");751                this.stub(spy);752                assert(spy.calledWith(obj, "Crazy"));753                assert(spy.calledOn(this.fakeContext));754            },755            "throws if callback throws": function () {756                var obj = { id: 42 };757                var callback = sinon.stub().throws();758                this.stub.yieldsOn(this.fakeContext, obj, "Crazy");759                assert.exception(function () {760                    this.stub(callback);761                });762            }763        },764        ".yieldsTo": {765            "yields to property of object argument": function () {766                var stub = sinon.stub().yieldsTo("success");767                var callback = sinon.spy();768                stub({ success: callback });769                assert(callback.calledOnce);770                assert.equals(callback.args[0].length, 0);771            },772            "throws understandable error if no object with callback is passed": function () {773                var stub = sinon.stub().yieldsTo("success");774                try {775                    stub();776                    throw new Error();777                } catch (e) {778                    assert.equals(e.message, "stub expected to yield to 'success', but no object " +779                                  "with such a property was passed.");780                }781            },782            "includes stub name and actual arguments in error": function () {783                var myObj = { somethingAwesome: function () {} };784                var stub = sinon.stub(myObj, "somethingAwesome").yieldsTo("success");785                try {786                    stub(23, 42);787                    throw new Error();788                } catch (e) {789                    assert.equals(e.message, "somethingAwesome expected to yield to 'success', but " +790                                  "no object with such a property was passed. " +791                                  "Received [23, 42]");792                }793            },794            "invokes property on last argument as callback": function () {795                var stub = sinon.stub().yieldsTo("success");796                var callback = sinon.spy();797                stub(24, {}, { success: callback });798                assert(callback.calledOnce);799                assert.equals(callback.args[0].length, 0);800            },801            "invokes first of two possible callbacks": function () {802                var stub = sinon.stub().yieldsTo("error");803                var callback = sinon.spy();804                var callback2 = sinon.spy();805                stub(24, {}, { error: callback }, { error: callback2 });806                assert(callback.calledOnce);807                assert(!callback2.called);808            },809            "invokes callback with arguments": function () {810                var obj = { id: 42 };811                var stub = sinon.stub().yieldsTo("success", obj, "Crazy");812                var callback = sinon.spy();813                stub({ success: callback });814                assert(callback.calledWith(obj, "Crazy"));815            },816            "throws if callback throws": function () {817                var obj = { id: 42 };818                var stub = sinon.stub().yieldsTo("error", obj, "Crazy");819                var callback = sinon.stub().throws();820                assert.exception(function () {821                    stub({ error: callback });822                });823            }824        },825        ".yieldsToOn": {826            setUp: function () {827                this.stub = sinon.stub.create();828                this.fakeContext = { foo: "bar" };829            },830            "yields to property of object argument": function () {831                this.stub.yieldsToOn("success", this.fakeContext);832                var callback = sinon.spy();833                this.stub({ success: callback });834                assert(callback.calledOnce);835                assert(callback.calledOn(this.fakeContext));836                assert.equals(callback.args[0].length, 0);837            },838            "throws if no context is specified": function () {839                assert.exception(function () {840                    this.stub.yieldsToOn("success");841                }, "TypeError");842            },843            "throws understandable error if no object with callback is passed": function () {844                this.stub.yieldsToOn("success", this.fakeContext);845                try {846                    this.stub();847                    throw new Error();848                } catch (e) {849                    assert.equals(e.message, "stub expected to yield to 'success', but no object " +850                                  "with such a property was passed.");851                }852            },853            "includes stub name and actual arguments in error": function () {854                var myObj = { somethingAwesome: function () {} };855                var stub = sinon.stub(myObj, "somethingAwesome").yieldsToOn("success", this.fakeContext);856                try {857                    stub(23, 42);858                    throw new Error();859                } catch (e) {860                    assert.equals(e.message, "somethingAwesome expected to yield to 'success', but " +861                                  "no object with such a property was passed. " +862                                  "Received [23, 42]");863                }864            },865            "invokes property on last argument as callback": function () {866                var callback = sinon.spy();867                this.stub.yieldsToOn("success", this.fakeContext);868                this.stub(24, {}, { success: callback });869                assert(callback.calledOnce);870                assert(callback.calledOn(this.fakeContext));871                assert.equals(callback.args[0].length, 0);872            },873            "invokes first of two possible callbacks": function () {874                var callback = sinon.spy();875                var callback2 = sinon.spy();876                this.stub.yieldsToOn("error", this.fakeContext);877                this.stub(24, {}, { error: callback }, { error: callback2 });878                assert(callback.calledOnce);879                assert(callback.calledOn(this.fakeContext));880                assert(!callback2.called);881            },882            "invokes callback with arguments": function () {883                var obj = { id: 42 };884                var callback = sinon.spy();885                this.stub.yieldsToOn("success", this.fakeContext, obj, "Crazy");886                this.stub({ success: callback });887                assert(callback.calledOn(this.fakeContext));888                assert(callback.calledWith(obj, "Crazy"));889            },890            "throws if callback throws": function () {891                var obj = { id: 42 };892                var callback = sinon.stub().throws();893                this.stub.yieldsToOn("error", this.fakeContext, obj, "Crazy");894                assert.exception(function () {895                    this.stub({ error: callback });896                });897            }898        },899        ".withArgs": {900            "defines withArgs method": function () {901                var stub = sinon.stub();902                assert.isFunction(stub.withArgs);903            },904            "creates filtered stub": function () {905                var stub = sinon.stub();906                var other = stub.withArgs(23);907                refute.same(other, stub);908                assert.isFunction(stub.returns);909                assert.isFunction(other.returns);910            },911            "filters return values based on arguments": function () {912                var stub = sinon.stub().returns(23);913                stub.withArgs(42).returns(99);914                assert.equals(stub(), 23);915                assert.equals(stub(42), 99);916            },917            "filters exceptions based on arguments": function () {918                var stub = sinon.stub().returns(23);919                stub.withArgs(42).throws();920                refute.exception(stub);921                assert.exception(function () {922                    stub(42);923                });924            }925        },926        ".callsArgAsync": {927            setUp: function () {928                this.stub = sinon.stub.create();929            },930            "asynchronously calls argument at specified index": function (done) {931                this.stub.callsArgAsync(2);932                var callback = sinon.spy(done);933                this.stub(1, 2, callback);934                assert(!callback.called);935            }936        },937        ".callsArgWithAsync": {938            setUp: function () {939                this.stub = sinon.stub.create();940            },941            "asynchronously calls callback at specified index with multiple args": function (done) {942                var object = {};943                var array = [];944                this.stub.callsArgWithAsync(1, object, array);945                var callback = sinon.spy(done(function () {946                    assert(callback.calledWith(object, array));947                }));948                this.stub(1, callback);949                assert(!callback.called);950            }951        },952        ".callsArgOnAsync": {953            setUp: function () {954                this.stub = sinon.stub.create();955                this.fakeContext = {956                    foo: "bar"957                };958            },959            "asynchronously calls argument at specified index with specified context": function (done) {960                var context = this.fakeContext;961                this.stub.callsArgOnAsync(2, context);962                var callback = sinon.spy(done(function () {963                    assert(callback.calledOn(context));964                }));965                this.stub(1, 2, callback);966                assert(!callback.called);967            }968        },969        ".callsArgOnWithAsync": {970            setUp: function () {971                this.stub = sinon.stub.create();972                this.fakeContext = { foo: "bar" };973            },974            "asynchronously calls argument at specified index with provided context and args": function (done) {975                var object = {};976                var context = this.fakeContext;977                this.stub.callsArgOnWithAsync(1, context, object);978                var callback = sinon.spy(done(function () {979                    assert(callback.calledOn(context));980                    assert(callback.calledWith(object));981                }));982                this.stub(1, callback);983                assert(!callback.called);984            }985        },986        ".yieldsAsync": {987            "asynchronously invokes only argument as callback": function (done) {988                var stub = sinon.stub().yieldsAsync();989                var spy = sinon.spy(done);990                stub(spy);991                assert(!spy.called);992            }993        },994        ".yieldsOnAsync": {995            setUp: function () {996                this.stub = sinon.stub.create();997                this.fakeContext = { foo: "bar" };998            },999            "asynchronously invokes only argument as callback with given context": function (done) {1000                var context = this.fakeContext;1001                this.stub.yieldsOnAsync(context);1002                var spy = sinon.spy(done(function () {1003                    assert(spy.calledOnce);1004                    assert(spy.calledOn(context));1005                    assert.equals(spy.args[0].length, 0);1006                }));1007                this.stub(spy);1008                assert(!spy.called);1009            }1010        },1011        ".yieldsToAsync": {1012            "asynchronously yields to property of object argument": function (done) {1013                var stub = sinon.stub().yieldsToAsync("success");1014                var callback = sinon.spy(done(function () {1015                    assert(callback.calledOnce);1016                    assert.equals(callback.args[0].length, 0);1017                }));1018                stub({ success: callback });1019                assert(!callback.called);1020            }1021        },1022        ".yieldsToOnAsync": {1023            setUp: function () {1024                this.stub = sinon.stub.create();1025                this.fakeContext = { foo: "bar" };1026            },1027            "asynchronously yields to property of object argument with given context": function (done) {1028                var context = this.fakeContext;1029                this.stub.yieldsToOnAsync("success", context);1030                var callback = sinon.spy(done(function () {1031                    assert(callback.calledOnce);1032                    assert(callback.calledOn(context));1033                    assert.equals(callback.args[0].length, 0);1034                }));1035                this.stub({ success: callback });1036                assert(!callback.called);1037            }1038        },1039        ".onCall": {1040            "can be used with returns to produce sequence": function () {1041                var stub = sinon.stub().returns(3);1042                stub.onFirstCall().returns(1)1043                    .onCall(2).returns(2);1044                assert.same(stub(), 1);1045                assert.same(stub(), 3);1046                assert.same(stub(), 2);1047                assert.same(stub(), 3);1048            },1049            "can be used with returnsArg to produce sequence": function () {1050                var stub = sinon.stub().returns("default");1051                stub.onSecondCall().returnsArg(0);1052                assert.same(stub(1), "default");1053                assert.same(stub(2), 2);1054                assert.same(stub(3), "default");1055            },1056            "can be used with returnsThis to produce sequence": function () {1057                var instance = {};1058                instance.stub = sinon.stub().returns("default");1059                instance.stub.onSecondCall().returnsThis();1060                assert.same(instance.stub(), "default");1061                assert.same(instance.stub(), instance);1062                assert.same(instance.stub(), "default");1063            },1064            "can be used with throwsException to produce sequence": function () {1065                var stub = sinon.stub();1066                var error = new Error();1067                stub.onSecondCall().throwsException(error);1068                stub();1069                try {1070                    stub();1071                    fail("Expected stub to throw");1072                } catch (e) {1073                    assert.same(e, error);1074                }1075            },1076            "in combination with withArgs": {1077                "can produce a sequence for a fake": function () {1078                    var stub = sinon.stub().returns(0);1079                    stub.withArgs(5).returns(-1)1080                        .onFirstCall().returns(1)1081                        .onSecondCall().returns(2);1082                    assert.same(stub(0), 0);1083                    assert.same(stub(5), 1);1084                    assert.same(stub(0), 0);1085                    assert.same(stub(5), 2);1086                    assert.same(stub(5), -1);1087                },1088                "falls back to stub default behaviour if fake does not have its own default behaviour": function () {1089                    var stub = sinon.stub().returns(0);1090                    stub.withArgs(5)1091                        .onFirstCall().returns(1);1092                    assert.same(stub(5), 1);1093                    assert.same(stub(5), 0);1094                },1095                "falls back to stub behaviour for call if fake does not have its own behaviour for call": function () {1096                    var stub = sinon.stub().returns(0);1097                    stub.withArgs(5).onFirstCall().returns(1);1098                    stub.onSecondCall().returns(2);1099                    assert.same(stub(5), 1);1100                    assert.same(stub(5), 2);1101                    assert.same(stub(4), 0);1102                },1103                "defaults to undefined behaviour once no more calls have been defined": function () {1104                    var stub = sinon.stub();1105                    stub.withArgs(5).onFirstCall().returns(1)1106                        .onSecondCall().returns(2);1107                    assert.same(stub(5), 1);1108                    assert.same(stub(5), 2);1109                    refute.defined(stub(5));1110                },1111                "does not create undefined behaviour just by calling onCall": function () {1112                    var stub = sinon.stub().returns(2);1113                    stub.onFirstCall();1114                    assert.same(stub(6), 2);1115                },1116                "works with fakes and reset": function () {1117                    var stub = sinon.stub();1118                    stub.withArgs(5).onFirstCall().returns(1);1119                    stub.withArgs(5).onSecondCall().returns(2);1120                    assert.same(stub(5), 1);1121                    assert.same(stub(5), 2);1122                    refute.defined(stub(5));1123                    stub.reset();1124                    assert.same(stub(5), 1);1125                    assert.same(stub(5), 2);1126                    refute.defined(stub(5));1127                },1128                "throws an understandable error when trying to use withArgs on behavior": function () {1129                    try {1130                        sinon.stub().onFirstCall().withArgs(1);1131                    } catch (e) {1132                        assert.match(e.message, /not supported/);1133                    }1134                }1135            },1136            "can be used with yields* to produce a sequence": function () {1137                var context = { foo: "bar" };1138                var obj = { method1: sinon.spy(), method2: sinon.spy() };1139                var obj2 = { method2: sinon.spy() };1140                var stub = sinon.stub().yieldsToOn("method2", context, 7, 8);1141                stub.onFirstCall().yields(1, 2)1142                    .onSecondCall().yieldsOn(context, 3, 4)1143                    .onThirdCall().yieldsTo("method1", 5, 6)1144                    .onCall(3).yieldsToOn("method2", context, 7, 8);1145                var spy1 = sinon.spy();1146                var spy2 = sinon.spy();1147                stub(spy1);1148                stub(spy2);1149                stub(obj);1150                stub(obj);1151                stub(obj2); // should continue with default behavior1152                assert(spy1.calledOnce);1153                assert(spy1.calledWithExactly(1, 2));1154                assert(spy2.calledOnce);1155                assert(spy2.calledAfter(spy1));1156                assert(spy2.calledOn(context));1157                assert(spy2.calledWithExactly(3, 4));1158                assert(obj.method1.calledOnce);1159                assert(obj.method1.calledAfter(spy2));1160                assert(obj.method1.calledWithExactly(5, 6));1161                assert(obj.method2.calledOnce);1162                assert(obj.method2.calledAfter(obj.method1));1163                assert(obj.method2.calledOn(context));1164                assert(obj.method2.calledWithExactly(7, 8));1165                assert(obj2.method2.calledOnce);1166                assert(obj2.method2.calledAfter(obj.method2));1167                assert(obj2.method2.calledOn(context));1168                assert(obj2.method2.calledWithExactly(7, 8));1169            },1170            "can be used with callsArg* to produce a sequence": function () {1171                var spy1 = sinon.spy();1172                var spy2 = sinon.spy();1173                var spy3 = sinon.spy();1174                var spy4 = sinon.spy();1175                var spy5 = sinon.spy();1176                var decoy = sinon.spy();1177                var context = { foo: "bar" };1178                var stub = sinon.stub().callsArgOnWith(3, context, "c", "d");1179                stub.onFirstCall().callsArg(0)1180                    .onSecondCall().callsArgWith(1, "a", "b")1181                    .onThirdCall().callsArgOn(2, context)1182                    .onCall(3).callsArgOnWith(3, context, "c", "d");1183                stub(spy1);1184                stub(decoy, spy2);1185                stub(decoy, decoy, spy3);1186                stub(decoy, decoy, decoy, spy4);1187                stub(decoy, decoy, decoy, spy5); // should continue with default behavior1188                assert(spy1.calledOnce);1189                assert(spy2.calledOnce);1190                assert(spy2.calledAfter(spy1));1191                assert(spy2.calledWithExactly("a", "b"));1192                assert(spy3.calledOnce);1193                assert(spy3.calledAfter(spy2));1194                assert(spy3.calledOn(context));1195                assert(spy4.calledOnce);1196                assert(spy4.calledAfter(spy3));1197                assert(spy4.calledOn(context));1198                assert(spy4.calledWithExactly("c", "d"));1199                assert(spy5.calledOnce);1200                assert(spy5.calledAfter(spy4));1201                assert(spy5.calledOn(context));1202                assert(spy5.calledWithExactly("c", "d"));1203                assert(decoy.notCalled);1204            },1205            "can be used with yields* and callsArg* in combination to produce a sequence": function () {1206                var stub = sinon.stub().yields(1, 2);1207                stub.onSecondCall().callsArg(1)1208                    .onThirdCall().yieldsTo("method")1209                    .onCall(3).callsArgWith(2, "a", "b");1210                var obj = { method: sinon.spy() };1211                var spy1 = sinon.spy();1212                var spy2 = sinon.spy();1213                var spy3 = sinon.spy();1214                var decoy = sinon.spy();1215                stub(spy1);1216                stub(decoy, spy2);1217                stub(obj);1218                stub(decoy, decoy, spy3);1219                assert(spy1.calledOnce);1220                assert(spy2.calledOnce);1221                assert(spy2.calledAfter(spy1));1222                assert(obj.method.calledOnce);1223                assert(obj.method.calledAfter(spy2));1224                assert(spy3.calledOnce);1225                assert(spy3.calledAfter(obj.method));1226                assert(spy3.calledWithExactly("a", "b"));1227                assert(decoy.notCalled);1228            },1229            "should interact correctly with assertions (GH-231)": function () {1230                var stub = sinon.stub();1231                var spy = sinon.spy();1232                stub.callsArgWith(0, "a");1233                stub(spy);1234                assert(spy.calledWith("a"));1235                stub(spy);1236                assert(spy.calledWith("a"));1237                stub.onThirdCall().callsArgWith(0, "b");1238                stub(spy);1239                assert(spy.calledWith("b"));1240            }1241        },1242        "reset only resets call history": function () {1243            var obj = { a: function () {} };1244            var spy = sinon.spy();1245            sinon.stub(obj, "a").callsArg(1);1246            obj.a(null, spy);1247            obj.a.reset();1248            obj.a(null, spy);1249            assert(spy.calledTwice);1250        },1251        ".resetBehavior": {1252            "clears yields* and callsArg* sequence": function () {1253                var stub = sinon.stub().yields(1);1254                stub.onFirstCall().callsArg(1);1255                stub.resetBehavior();1256                stub.yields(3);1257                var spyWanted = sinon.spy();1258                var spyNotWanted = sinon.spy();1259                stub(spyWanted, spyNotWanted);1260                assert(spyNotWanted.notCalled);1261                assert(spyWanted.calledOnce);1262                assert(spyWanted.calledWithExactly(3));1263            },1264            "cleans 'returns' behavior": function () {1265                var stub = sinon.stub().returns(1);1266                stub.resetBehavior();1267                refute.defined(stub());1268            },1269            "cleans behavior of fakes returned by withArgs": function () {1270                var stub = sinon.stub();1271                stub.withArgs("lolz").returns(2);1272                stub.resetBehavior();1273                refute.defined(stub("lolz"));1274            },1275            "does not clean parents' behavior when called on a fake returned by withArgs": function () {1276                var parentStub = sinon.stub().returns(false);1277                var childStub = parentStub.withArgs("lolz").returns(true);1278                childStub.resetBehavior();1279                assert.same(parentStub("lolz"), false);1280                assert.same(parentStub(), false);1281            },1282            "cleans 'returnsArg' behavior": function () {1283                var stub = sinon.stub().returnsArg(0);1284                stub.resetBehavior();1285                refute.defined(stub("defined"));1286            },1287            "cleans 'returnsThis' behavior": function () {1288                var instance = {};1289                instance.stub = sinon.stub.create();1290                instance.stub.returnsThis();1291                instance.stub.resetBehavior();1292                refute.defined(instance.stub());1293            },1294            "does not touch properties that are reset by 'reset'": {1295                ".calledOnce": function () {1296                    var stub = sinon.stub();1297                    stub(1);1298                    stub.resetBehavior();1299                    assert(stub.calledOnce);1300                },1301                "called multiple times": function () {1302                    var stub = sinon.stub();1303                    stub(1);1304                    stub(2);1305                    stub(3);1306                    stub.resetBehavior();1307                    assert(stub.called);1308                    assert.equals(stub.args.length, 3);1309                    assert.equals(stub.returnValues.length, 3);1310                    assert.equals(stub.exceptions.length, 3);1311                    assert.equals(stub.thisValues.length, 3);1312                    assert.defined(stub.firstCall);1313                    assert.defined(stub.secondCall);1314                    assert.defined(stub.thirdCall);1315                    assert.defined(stub.lastCall);1316                },1317                "call order state": function () {1318                    var stubs = [sinon.stub(), sinon.stub()];1319                    stubs[0]();1320                    stubs[1]();1321                    stubs[0].resetBehavior();1322                    assert(stubs[0].calledBefore(stubs[1]));1323                },1324                "fakes returned by withArgs": function () {1325                    var stub = sinon.stub();1326                    var fakeA = stub.withArgs("a");1327                    var fakeB = stub.withArgs("b");1328                    stub("a");1329                    stub("b");1330                    stub("c");1331                    var fakeC = stub.withArgs("c");1332                    stub.resetBehavior();1333                    assert(fakeA.calledOnce);1334                    assert(fakeB.calledOnce);1335                    assert(fakeC.calledOnce);1336                }1337            }1338        },1339        ".length": {1340            "is zero by default": function () {1341                var stub = sinon.stub();1342                assert.equals(stub.length, 0);1343            },1344            "matches the function length": function () {1345                var api = { someMethod: function (a, b, c) {} }; // eslint-disable-line no-unused-vars1346                var stub = sinon.stub(api, "someMethod");1347                assert.equals(stub.length, 3);1348            }1349        }1350    });...

...28            assert.same(syncVersions, asyncVersions,29                "Stub prototype should contain same amount of synchronous and asynchronous methods");30        },31        "should allow overriding async behavior with sync behavior": function () {32            var stub = sinon.stub();33            var callback = sinon.spy();34            stub.callsArgAsync(1);35            stub.callsArg(1);36            stub(1, callback);37            assert(callback.called);38        },39        ".returns": {40            "returns specified value": function () {41                var stub = sinon.stub.create();42                var object = {};43                stub.returns(object);44                assert.same(stub(), object);45            },46            "returns should return stub": function () {47                var stub = sinon.stub.create();48                assert.same(stub.returns(""), stub);49            },50            "returns undefined": function () {51                var stub = sinon.stub.create();52                refute.defined(stub());53            },54            "supersedes previous throws": function () {55                var stub = sinon.stub.create();56                stub.throws().returns(1);57                refute.exception(function () {58                    stub();59                });60            }61        },62        ".returnsArg": {63            "returns argument at specified index": function () {64                var stub = sinon.stub.create();65                stub.returnsArg(0);66                var object = {};67                assert.same(stub(object), object);68            },69            "returns stub": function () {70                var stub = sinon.stub.create();71                assert.same(stub.returnsArg(0), stub);72            },73            "throws if no index is specified": function () {74                var stub = sinon.stub.create();75                assert.exception(function () {76                    stub.returnsArg();77                }, "TypeError");78            },79            "throws if index is not number": function () {80                var stub = sinon.stub.create();81                assert.exception(function () {82                    stub.returnsArg({});83                }, "TypeError");84            }85        },86        ".returnsThis": {87            "stub returns this": function () {88                var instance = {};89                instance.stub = sinon.stub.create();90                instance.stub.returnsThis();91                assert.same(instance.stub(), instance);92            },93            "stub returns undefined when detached": {94                requiresSupportFor: {95                    strictMode: (function () {96                        return this;97                    }()) === undefined98                },99                "": function () {100                    var stub = sinon.stub.create();101                    stub.returnsThis();102                    // Due to strict mode, would be `global` otherwise103                    assert.same(stub(), undefined);104                }105            },106            "stub respects call/apply": function () {107                var stub = sinon.stub.create();108                stub.returnsThis();109                var object = {};110                assert.same(stub.call(object), object);111                assert.same(stub.apply(object), object);112            },113            "returns stub": function () {114                var stub = sinon.stub.create();115                assert.same(stub.returnsThis(), stub);116            }117        },118        ".throws": {119            "throws specified exception": function () {120                var stub = sinon.stub.create();121                var error = new Error();122                stub.throws(error);123                try {124                    stub();125                    fail("Expected stub to throw");126                } catch (e) {127                    assert.same(e, error);128                }129            },130            "returns stub": function () {131                var stub = sinon.stub.create();132                assert.same(stub.throws({}), stub);133            },134            "sets type of exception to throw": function () {135                var stub = sinon.stub.create();136                var exceptionType = "TypeError";137                stub.throws(exceptionType);138                assert.exception(function () {139                    stub();140                }, exceptionType);141            },142            "specifies exception message": function () {143                var stub = sinon.stub.create();144                var message = "Oh no!";145                stub.throws("Error", message);146                try {147                    stub();148                    buster.referee.fail("Expected stub to throw");149                } catch (e) {150                    assert.equals(e.message, message);151                }152            },153            "does not specify exception message if not provided": function () {154                var stub = sinon.stub.create();155                stub.throws("Error");156                try {157                    stub();158                    buster.referee.fail("Expected stub to throw");159                } catch (e) {160                    assert.equals(e.message, "");161                }162            },163            "throws generic error": function () {164                var stub = sinon.stub.create();165                stub.throws();166                assert.exception(function () {167                    stub();168                }, "Error");169            },170            "resets 'invoking' flag": function () {171                var stub = sinon.stub.create();172                stub.throws();173                try {174                    stub();175                } catch (e) {176                    refute.defined(stub.invoking);177                }178            }179        },180        ".callsArg": {181            setUp: function () {182                this.stub = sinon.stub.create();183            },184            "calls argument at specified index": function () {185                this.stub.callsArg(2);186                var callback = sinon.stub.create();187                this.stub(1, 2, callback);188                assert(callback.called);189            },190            "returns stub": function () {191                assert.isFunction(this.stub.callsArg(2));192            },193            "throws if argument at specified index is not callable": function () {194                this.stub.callsArg(0);195                assert.exception(function () {196                    this.stub(1);197                }, "TypeError");198            },199            "throws if no index is specified": function () {200                var stub = this.stub;201                assert.exception(function () {202                    stub.callsArg();203                }, "TypeError");204            },205            "throws if index is not number": function () {206                var stub = this.stub;207                assert.exception(function () {208                    stub.callsArg({});209                }, "TypeError");210            }211        },212        ".callsArgWith": {213            setUp: function () {214                this.stub = sinon.stub.create();215            },216            "calls argument at specified index with provided args": function () {217                var object = {};218                this.stub.callsArgWith(1, object);219                var callback = sinon.stub.create();220                this.stub(1, callback);221                assert(callback.calledWith(object));222            },223            "returns function": function () {224                var stub = this.stub.callsArgWith(2, 3);225                assert.isFunction(stub);226            },227            "calls callback without args": function () {228                this.stub.callsArgWith(1);229                var callback = sinon.stub.create();230                this.stub(1, callback);231                assert(callback.calledWith());232            },233            "calls callback with multiple args": function () {234                var object = {};235                var array = [];236                this.stub.callsArgWith(1, object, array);237                var callback = sinon.stub.create();238                this.stub(1, callback);239                assert(callback.calledWith(object, array));240            },241            "throws if no index is specified": function () {242                var stub = this.stub;243                assert.exception(function () {244                    stub.callsArgWith();245                }, "TypeError");246            },247            "throws if index is not number": function () {248                var stub = this.stub;249                assert.exception(function () {250                    stub.callsArgWith({});251                }, "TypeError");252            }253        },254        ".callsArgOn": {255            setUp: function () {256                this.stub = sinon.stub.create();257                this.fakeContext = {258                    foo: "bar"259                };260            },261            "calls argument at specified index": function () {262                this.stub.callsArgOn(2, this.fakeContext);263                var callback = sinon.stub.create();264                this.stub(1, 2, callback);265                assert(callback.called);266                assert(callback.calledOn(this.fakeContext));267            },268            "returns stub": function () {269                var stub = this.stub.callsArgOn(2, this.fakeContext);270                assert.isFunction(stub);271            },272            "throws if argument at specified index is not callable": function () {273                this.stub.callsArgOn(0, this.fakeContext);274                assert.exception(function () {275                    this.stub(1);276                }, "TypeError");277            },278            "throws if no index is specified": function () {279                var stub = this.stub;280                assert.exception(function () {281                    stub.callsArgOn();282                }, "TypeError");283            },284            "throws if no context is specified": function () {285                var stub = this.stub;286                assert.exception(function () {287                    stub.callsArgOn(3);288                }, "TypeError");289            },290            "throws if index is not number": function () {291                var stub = this.stub;292                assert.exception(function () {293                    stub.callsArgOn(this.fakeContext, 2);294                }, "TypeError");295            },296            "throws if context is not an object": function () {297                var stub = this.stub;298                assert.exception(function () {299                    stub.callsArgOn(2, 2);300                }, "TypeError");301            }302        },303        ".callsArgOnWith": {304            setUp: function () {305                this.stub = sinon.stub.create();306                this.fakeContext = { foo: "bar" };307            },308            "calls argument at specified index with provided args": function () {309                var object = {};310                this.stub.callsArgOnWith(1, this.fakeContext, object);311                var callback = sinon.stub.create();312                this.stub(1, callback);313                assert(callback.calledWith(object));314                assert(callback.calledOn(this.fakeContext));315            },316            "returns function": function () {317                var stub = this.stub.callsArgOnWith(2, this.fakeContext, 3);318                assert.isFunction(stub);319            },320            "calls callback without args": function () {321                this.stub.callsArgOnWith(1, this.fakeContext);322                var callback = sinon.stub.create();323                this.stub(1, callback);324                assert(callback.calledWith());325                assert(callback.calledOn(this.fakeContext));326            },327            "calls callback with multiple args": function () {328                var object = {};329                var array = [];330                this.stub.callsArgOnWith(1, this.fakeContext, object, array);331                var callback = sinon.stub.create();332                this.stub(1, callback);333                assert(callback.calledWith(object, array));334                assert(callback.calledOn(this.fakeContext));335            },336            "throws if no index is specified": function () {337                var stub = this.stub;338                assert.exception(function () {339                    stub.callsArgOnWith();340                }, "TypeError");341            },342            "throws if no context is specified": function () {343                var stub = this.stub;344                assert.exception(function () {345                    stub.callsArgOnWith(3);346                }, "TypeError");347            },348            "throws if index is not number": function () {349                var stub = this.stub;350                assert.exception(function () {351                    stub.callsArgOnWith({});352                }, "TypeError");353            },354            "throws if context is not an object": function () {355                var stub = this.stub;356                assert.exception(function () {357                    stub.callsArgOnWith(2, 2);358                }, "TypeError");359            }360        },361        ".objectMethod": {362            setUp: function () {363                this.method = function () {};364                this.object = { method: this.method };365                this.wrapMethod = sinon.wrapMethod;366            },367            tearDown: function () {368                sinon.wrapMethod = this.wrapMethod;369            },370            "returns function from wrapMethod": function () {371                var wrapper = function () {};372                sinon.wrapMethod = function () {373                    return wrapper;374                };375                var result = sinon.stub(this.object, "method");376                assert.same(result, wrapper);377            },378            "passes object and method to wrapMethod": function () {379                var wrapper = function () {};380                var args;381                sinon.wrapMethod = function () {382                    args = arguments;383                    return wrapper;384                };385                sinon.stub(this.object, "method");386                assert.same(args[0], this.object);387                assert.same(args[1], "method");388            },389            "uses provided function as stub": function () {390                var called = false;391                var stub = sinon.stub(this.object, "method", function () {392                    called = true;393                });394                stub();395                assert(called);396            },397            "wraps provided function": function () {398                var customStub = function () {};399                var stub = sinon.stub(this.object, "method", customStub);400                refute.same(stub, customStub);401                assert.isFunction(stub.restore);402            },403            "throws if third argument is provided but not a function or proprety descriptor": function () {404                var object = this.object;405                assert.exception(function () {406                    sinon.stub(object, "method", 1);407                }, "TypeError");408            },409            "stubbed method should be proper stub": function () {410                var stub = sinon.stub(this.object, "method");411                assert.isFunction(stub.returns);412                assert.isFunction(stub.throws);413            },414            "custom stubbed method should not be proper stub": function () {415                var stub = sinon.stub(this.object, "method", function () {});416                refute.defined(stub.returns);417                refute.defined(stub.throws);418            },419            "stub should be spy": function () {420                var stub = sinon.stub(this.object, "method");421                this.object.method();422                assert(stub.called);423                assert(stub.calledOn(this.object));424            },425            "custom stubbed method should be spy": function () {426                var stub = sinon.stub(this.object, "method", function () {});427                this.object.method();428                assert(stub.called);429                assert(stub.calledOn(this.object));430            },431            "stub should affect spy": function () {432                var stub = sinon.stub(this.object, "method");433                stub.throws("TypeError");434                try {435                    this.object.method();436                }437                catch (e) {} // eslint-disable-line no-empty438                assert(stub.threw("TypeError"));439            },440            "returns standalone stub without arguments": function () {441                var stub = sinon.stub();442                assert.isFunction(stub);443                assert.isFalse(stub.called);444            },445            "throws if property is not a function": function () {446                var obj = { someProp: 42 };447                assert.exception(function () {448                    sinon.stub(obj, "someProp");449                });450                assert.equals(obj.someProp, 42);451            },452            "successfully stubs falsey properties": function () {453                var obj = { 0: function () { } };454                sinon.stub(obj, 0, function () {455                    return "stubbed value";456                });457                assert.equals(obj[0](), "stubbed value");458            },459            "does not stub function object": function () {460                assert.exception(function () {461                    sinon.stub(function () {});462                });463            }464        },465        everything: {466            "stubs all methods of object without property": function () {467                var obj = {468                    func1: function () {},469                    func2: function () {},470                    func3: function () {}471                };472                sinon.stub(obj);473                assert.isFunction(obj.func1.restore);474                assert.isFunction(obj.func2.restore);475                assert.isFunction(obj.func3.restore);476            },477            "stubs prototype methods": function () {478                function Obj() {}479                Obj.prototype.func1 = function () {};480                var obj = new Obj();481                sinon.stub(obj);482                assert.isFunction(obj.func1.restore);483            },484            "returns object": function () {485                var object = {};486                assert.same(sinon.stub(object), object);487            },488            "only stubs functions": function () {489                var object = { foo: "bar" };490                sinon.stub(object);491                assert.equals(object.foo, "bar");492            }493        },494        "stubbed function": {495            "throws if stubbing non-existent property": function () {496                var myObj = {};497                assert.exception(function () {498                    sinon.stub(myObj, "ouch");499                });500                refute.defined(myObj.ouch);501            },502            "has toString method": function () {503                var obj = { meth: function () {} };504                sinon.stub(obj, "meth");505                assert.equals(obj.meth.toString(), "meth");506            },507            "toString should say 'stub' when unable to infer name": function () {508                var stub = sinon.stub();509                assert.equals(stub.toString(), "stub");510            },511            "toString should prefer property name if possible": function () {512                var obj = {};513                obj.meth = sinon.stub();514                obj.meth();515                assert.equals(obj.meth.toString(), "meth");516            }517        },518        ".yields": {519            "invokes only argument as callback": function () {520                var stub = sinon.stub().yields();521                var spy = sinon.spy();522                stub(spy);523                assert(spy.calledOnce);524                assert.equals(spy.args[0].length, 0);525            },526            "throws understandable error if no callback is passed": function () {527                var stub = sinon.stub().yields();528                try {529                    stub();530                    throw new Error();531                } catch (e) {532                    assert.equals(e.message, "stub expected to yield, but no callback was passed.");533                }534            },535            "includes stub name and actual arguments in error": function () {536                var myObj = { somethingAwesome: function () {} };537                var stub = sinon.stub(myObj, "somethingAwesome").yields();538                try {539                    stub(23, 42);540                    throw new Error();541                } catch (e) {542                    assert.equals(e.message, "somethingAwesome expected to yield, but no callback " +543                                  "was passed. Received [23, 42]");544                }545            },546            "invokes last argument as callback": function () {547                var stub = sinon.stub().yields();548                var spy = sinon.spy();549                stub(24, {}, spy);550                assert(spy.calledOnce);551                assert.equals(spy.args[0].length, 0);552            },553            "invokes first of two callbacks": function () {554                var stub = sinon.stub().yields();555                var spy = sinon.spy();556                var spy2 = sinon.spy();557                stub(24, {}, spy, spy2);558                assert(spy.calledOnce);559                assert(!spy2.called);560            },561            "invokes callback with arguments": function () {562                var obj = { id: 42 };563                var stub = sinon.stub().yields(obj, "Crazy");564                var spy = sinon.spy();565                stub(spy);566                assert(spy.calledWith(obj, "Crazy"));567            },568            "throws if callback throws": function () {569                var obj = { id: 42 };570                var stub = sinon.stub().yields(obj, "Crazy");571                var callback = sinon.stub().throws();572                assert.exception(function () {573                    stub(callback);574                });575            },576            "plays nice with throws": function () {577                var stub = sinon.stub().throws().yields();578                var spy = sinon.spy();579                assert.exception(function () {580                    stub(spy);581                });582                assert(spy.calledOnce);583            },584            "plays nice with returns": function () {585                var obj = {};586                var stub = sinon.stub().returns(obj).yields();587                var spy = sinon.spy();588                assert.same(stub(spy), obj);589                assert(spy.calledOnce);590            },591            "plays nice with returnsArg": function () {592                var stub = sinon.stub().returnsArg(0).yields();593                var spy = sinon.spy();594                assert.same(stub(spy), spy);595                assert(spy.calledOnce);596            },597            "plays nice with returnsThis": function () {598                var obj = {};599                var stub = sinon.stub().returnsThis().yields();600                var spy = sinon.spy();601                assert.same(stub.call(obj, spy), obj);602                assert(spy.calledOnce);603            }604        },605        ".yieldsRight": {606            "invokes only argument as callback": function () {607                var stub = sinon.stub().yieldsRight();608                var spy = sinon.spy();609                stub(spy);610                assert(spy.calledOnce);611                assert.equals(spy.args[0].length, 0);612            },613            "throws understandable error if no callback is passed": function () {614                var stub = sinon.stub().yieldsRight();615                try {616                    stub();617                    throw new Error();618                } catch (e) {619                    assert.equals(e.message, "stub expected to yield, but no callback was passed.");620                }621            },622            "includes stub name and actual arguments in error": function () {623                var myObj = { somethingAwesome: function () {} };624                var stub = sinon.stub(myObj, "somethingAwesome").yieldsRight();625                try {626                    stub(23, 42);627                    throw new Error();628                } catch (e) {629                    assert.equals(e.message, "somethingAwesome expected to yield, but no callback " +630                    "was passed. Received [23, 42]");631                }632            },633            "invokes last argument as callback": function () {634                var stub = sinon.stub().yieldsRight();635                var spy = sinon.spy();636                stub(24, {}, spy);637                assert(spy.calledOnce);638                assert.equals(spy.args[0].length, 0);639            },640            "invokes the last of two callbacks": function () {641                var stub = sinon.stub().yieldsRight();642                var spy = sinon.spy();643                var spy2 = sinon.spy();644                stub(24, {}, spy, spy2);645                assert(!spy.called);646                assert(spy2.calledOnce);647            },648            "invokes callback with arguments": function () {649                var obj = { id: 42 };650                var stub = sinon.stub().yieldsRight(obj, "Crazy");651                var spy = sinon.spy();652                stub(spy);653                assert(spy.calledWith(obj, "Crazy"));654            },655            "throws if callback throws": function () {656                var obj = { id: 42 };657                var stub = sinon.stub().yieldsRight(obj, "Crazy");658                var callback = sinon.stub().throws();659                assert.exception(function () {660                    stub(callback);661                });662            },663            "plays nice with throws": function () {664                var stub = sinon.stub().throws().yieldsRight();665                var spy = sinon.spy();666                assert.exception(function () {667                    stub(spy);668                });669                assert(spy.calledOnce);670            },671            "plays nice with returns": function () {672                var obj = {};673                var stub = sinon.stub().returns(obj).yieldsRight();674                var spy = sinon.spy();675                assert.same(stub(spy), obj);676                assert(spy.calledOnce);677            },678            "plays nice with returnsArg": function () {679                var stub = sinon.stub().returnsArg(0).yieldsRight();680                var spy = sinon.spy();681                assert.same(stub(spy), spy);682                assert(spy.calledOnce);683            },684            "plays nice with returnsThis": function () {685                var obj = {};686                var stub = sinon.stub().returnsThis().yieldsRight();687                var spy = sinon.spy();688                assert.same(stub.call(obj, spy), obj);689                assert(spy.calledOnce);690            }691        },692        ".yieldsOn": {693            setUp: function () {694                this.stub = sinon.stub.create();695                this.fakeContext = { foo: "bar" };696            },697            "invokes only argument as callback": function () {698                var spy = sinon.spy();699                this.stub.yieldsOn(this.fakeContext);700                this.stub(spy);701                assert(spy.calledOnce);702                assert(spy.calledOn(this.fakeContext));703                assert.equals(spy.args[0].length, 0);704            },705            "throws if no context is specified": function () {706                assert.exception(function () {707                    this.stub.yieldsOn();708                }, "TypeError");709            },710            "throws understandable error if no callback is passed": function () {711                this.stub.yieldsOn(this.fakeContext);712                try {713                    this.stub();714                    throw new Error();715                } catch (e) {716                    assert.equals(e.message, "stub expected to yield, but no callback was passed.");717                }718            },719            "includes stub name and actual arguments in error": function () {720                var myObj = { somethingAwesome: function () {} };721                var stub = sinon.stub(myObj, "somethingAwesome").yieldsOn(this.fakeContext);722                try {723                    stub(23, 42);724                    throw new Error();725                } catch (e) {726                    assert.equals(e.message, "somethingAwesome expected to yield, but no callback " +727                                  "was passed. Received [23, 42]");728                }729            },730            "invokes last argument as callback": function () {731                var spy = sinon.spy();732                this.stub.yieldsOn(this.fakeContext);733                this.stub(24, {}, spy);734                assert(spy.calledOnce);735                assert(spy.calledOn(this.fakeContext));736                assert.equals(spy.args[0].length, 0);737            },738            "invokes first of two callbacks": function () {739                var spy = sinon.spy();740                var spy2 = sinon.spy();741                this.stub.yieldsOn(this.fakeContext);742                this.stub(24, {}, spy, spy2);743                assert(spy.calledOnce);744                assert(spy.calledOn(this.fakeContext));745                assert(!spy2.called);746            },747            "invokes callback with arguments": function () {748                var obj = { id: 42 };749                var spy = sinon.spy();750                this.stub.yieldsOn(this.fakeContext, obj, "Crazy");751                this.stub(spy);752                assert(spy.calledWith(obj, "Crazy"));753                assert(spy.calledOn(this.fakeContext));754            },755            "throws if callback throws": function () {756                var obj = { id: 42 };757                var callback = sinon.stub().throws();758                this.stub.yieldsOn(this.fakeContext, obj, "Crazy");759                assert.exception(function () {760                    this.stub(callback);761                });762            }763        },764        ".yieldsTo": {765            "yields to property of object argument": function () {766                var stub = sinon.stub().yieldsTo("success");767                var callback = sinon.spy();768                stub({ success: callback });769                assert(callback.calledOnce);770                assert.equals(callback.args[0].length, 0);771            },772            "throws understandable error if no object with callback is passed": function () {773                var stub = sinon.stub().yieldsTo("success");774                try {775                    stub();776                    throw new Error();777                } catch (e) {778                    assert.equals(e.message, "stub expected to yield to 'success', but no object " +779                                  "with such a property was passed.");780                }781            },782            "includes stub name and actual arguments in error": function () {783                var myObj = { somethingAwesome: function () {} };784                var stub = sinon.stub(myObj, "somethingAwesome").yieldsTo("success");785                try {786                    stub(23, 42);787                    throw new Error();788                } catch (e) {789                    assert.equals(e.message, "somethingAwesome expected to yield to 'success', but " +790                                  "no object with such a property was passed. " +791                                  "Received [23, 42]");792                }793            },794            "invokes property on last argument as callback": function () {795                var stub = sinon.stub().yieldsTo("success");796                var callback = sinon.spy();797                stub(24, {}, { success: callback });798                assert(callback.calledOnce);799                assert.equals(callback.args[0].length, 0);800            },801            "invokes first of two possible callbacks": function () {802                var stub = sinon.stub().yieldsTo("error");803                var callback = sinon.spy();804                var callback2 = sinon.spy();805                stub(24, {}, { error: callback }, { error: callback2 });806                assert(callback.calledOnce);807                assert(!callback2.called);808            },809            "invokes callback with arguments": function () {810                var obj = { id: 42 };811                var stub = sinon.stub().yieldsTo("success", obj, "Crazy");812                var callback = sinon.spy();813                stub({ success: callback });814                assert(callback.calledWith(obj, "Crazy"));815            },816            "throws if callback throws": function () {817                var obj = { id: 42 };818                var stub = sinon.stub().yieldsTo("error", obj, "Crazy");819                var callback = sinon.stub().throws();820                assert.exception(function () {821                    stub({ error: callback });822                });823            }824        },825        ".yieldsToOn": {826            setUp: function () {827                this.stub = sinon.stub.create();828                this.fakeContext = { foo: "bar" };829            },830            "yields to property of object argument": function () {831                this.stub.yieldsToOn("success", this.fakeContext);832                var callback = sinon.spy();833                this.stub({ success: callback });834                assert(callback.calledOnce);835                assert(callback.calledOn(this.fakeContext));836                assert.equals(callback.args[0].length, 0);837            },838            "throws if no context is specified": function () {839                assert.exception(function () {840                    this.stub.yieldsToOn("success");841                }, "TypeError");842            },843            "throws understandable error if no object with callback is passed": function () {844                this.stub.yieldsToOn("success", this.fakeContext);845                try {846                    this.stub();847                    throw new Error();848                } catch (e) {849                    assert.equals(e.message, "stub expected to yield to 'success', but no object " +850                                  "with such a property was passed.");851                }852            },853            "includes stub name and actual arguments in error": function () {854                var myObj = { somethingAwesome: function () {} };855                var stub = sinon.stub(myObj, "somethingAwesome").yieldsToOn("success", this.fakeContext);856                try {857                    stub(23, 42);858                    throw new Error();859                } catch (e) {860                    assert.equals(e.message, "somethingAwesome expected to yield to 'success', but " +861                                  "no object with such a property was passed. " +862                                  "Received [23, 42]");863                }864            },865            "invokes property on last argument as callback": function () {866                var callback = sinon.spy();867                this.stub.yieldsToOn("success", this.fakeContext);868                this.stub(24, {}, { success: callback });869                assert(callback.calledOnce);870                assert(callback.calledOn(this.fakeContext));871                assert.equals(callback.args[0].length, 0);872            },873            "invokes first of two possible callbacks": function () {874                var callback = sinon.spy();875                var callback2 = sinon.spy();876                this.stub.yieldsToOn("error", this.fakeContext);877                this.stub(24, {}, { error: callback }, { error: callback2 });878                assert(callback.calledOnce);879                assert(callback.calledOn(this.fakeContext));880                assert(!callback2.called);881            },882            "invokes callback with arguments": function () {883                var obj = { id: 42 };884                var callback = sinon.spy();885                this.stub.yieldsToOn("success", this.fakeContext, obj, "Crazy");886                this.stub({ success: callback });887                assert(callback.calledOn(this.fakeContext));888                assert(callback.calledWith(obj, "Crazy"));889            },890            "throws if callback throws": function () {891                var obj = { id: 42 };892                var callback = sinon.stub().throws();893                this.stub.yieldsToOn("error", this.fakeContext, obj, "Crazy");894                assert.exception(function () {895                    this.stub({ error: callback });896                });897            }898        },899        ".withArgs": {900            "defines withArgs method": function () {901                var stub = sinon.stub();902                assert.isFunction(stub.withArgs);903            },904            "creates filtered stub": function () {905                var stub = sinon.stub();906                var other = stub.withArgs(23);907                refute.same(other, stub);908                assert.isFunction(stub.returns);909                assert.isFunction(other.returns);910            },911            "filters return values based on arguments": function () {912                var stub = sinon.stub().returns(23);913                stub.withArgs(42).returns(99);914                assert.equals(stub(), 23);915                assert.equals(stub(42), 99);916            },917            "filters exceptions based on arguments": function () {918                var stub = sinon.stub().returns(23);919                stub.withArgs(42).throws();920                refute.exception(stub);921                assert.exception(function () {922                    stub(42);923                });924            }925        },926        ".callsArgAsync": {927            setUp: function () {928                this.stub = sinon.stub.create();929            },930            "asynchronously calls argument at specified index": function (done) {931                this.stub.callsArgAsync(2);932                var callback = sinon.spy(done);933                this.stub(1, 2, callback);934                assert(!callback.called);935            }936        },937        ".callsArgWithAsync": {938            setUp: function () {939                this.stub = sinon.stub.create();940            },941            "asynchronously calls callback at specified index with multiple args": function (done) {942                var object = {};943                var array = [];944                this.stub.callsArgWithAsync(1, object, array);945                var callback = sinon.spy(done(function () {946                    assert(callback.calledWith(object, array));947                }));948                this.stub(1, callback);949                assert(!callback.called);950            }951        },952        ".callsArgOnAsync": {953            setUp: function () {954                this.stub = sinon.stub.create();955                this.fakeContext = {956                    foo: "bar"957                };958            },959            "asynchronously calls argument at specified index with specified context": function (done) {960                var context = this.fakeContext;961                this.stub.callsArgOnAsync(2, context);962                var callback = sinon.spy(done(function () {963                    assert(callback.calledOn(context));964                }));965                this.stub(1, 2, callback);966                assert(!callback.called);967            }968        },969        ".callsArgOnWithAsync": {970            setUp: function () {971                this.stub = sinon.stub.create();972                this.fakeContext = { foo: "bar" };973            },974            "asynchronously calls argument at specified index with provided context and args": function (done) {975                var object = {};976                var context = this.fakeContext;977                this.stub.callsArgOnWithAsync(1, context, object);978                var callback = sinon.spy(done(function () {979                    assert(callback.calledOn(context));980                    assert(callback.calledWith(object));981                }));982                this.stub(1, callback);983                assert(!callback.called);984            }985        },986        ".yieldsAsync": {987            "asynchronously invokes only argument as callback": function (done) {988                var stub = sinon.stub().yieldsAsync();989                var spy = sinon.spy(done);990                stub(spy);991                assert(!spy.called);992            }993        },994        ".yieldsOnAsync": {995            setUp: function () {996                this.stub = sinon.stub.create();997                this.fakeContext = { foo: "bar" };998            },999            "asynchronously invokes only argument as callback with given context": function (done) {1000                var context = this.fakeContext;1001                this.stub.yieldsOnAsync(context);1002                var spy = sinon.spy(done(function () {1003                    assert(spy.calledOnce);1004                    assert(spy.calledOn(context));1005                    assert.equals(spy.args[0].length, 0);1006                }));1007                this.stub(spy);1008                assert(!spy.called);1009            }1010        },1011        ".yieldsToAsync": {1012            "asynchronously yields to property of object argument": function (done) {1013                var stub = sinon.stub().yieldsToAsync("success");1014                var callback = sinon.spy(done(function () {1015                    assert(callback.calledOnce);1016                    assert.equals(callback.args[0].length, 0);1017                }));1018                stub({ success: callback });1019                assert(!callback.called);1020            }1021        },1022        ".yieldsToOnAsync": {1023            setUp: function () {1024                this.stub = sinon.stub.create();1025                this.fakeContext = { foo: "bar" };1026            },1027            "asynchronously yields to property of object argument with given context": function (done) {1028                var context = this.fakeContext;1029                this.stub.yieldsToOnAsync("success", context);1030                var callback = sinon.spy(done(function () {1031                    assert(callback.calledOnce);1032                    assert(callback.calledOn(context));1033                    assert.equals(callback.args[0].length, 0);1034                }));1035                this.stub({ success: callback });1036                assert(!callback.called);1037            }1038        },1039        ".onCall": {1040            "can be used with returns to produce sequence": function () {1041                var stub = sinon.stub().returns(3);1042                stub.onFirstCall().returns(1)1043                    .onCall(2).returns(2);1044                assert.same(stub(), 1);1045                assert.same(stub(), 3);1046                assert.same(stub(), 2);1047                assert.same(stub(), 3);1048            },1049            "can be used with returnsArg to produce sequence": function () {1050                var stub = sinon.stub().returns("default");1051                stub.onSecondCall().returnsArg(0);1052                assert.same(stub(1), "default");1053                assert.same(stub(2), 2);1054                assert.same(stub(3), "default");1055            },1056            "can be used with returnsThis to produce sequence": function () {1057                var instance = {};1058                instance.stub = sinon.stub().returns("default");1059                instance.stub.onSecondCall().returnsThis();1060                assert.same(instance.stub(), "default");1061                assert.same(instance.stub(), instance);1062                assert.same(instance.stub(), "default");1063            },1064            "can be used with throwsException to produce sequence": function () {1065                var stub = sinon.stub();1066                var error = new Error();1067                stub.onSecondCall().throwsException(error);1068                stub();1069                try {1070                    stub();1071                    fail("Expected stub to throw");1072                } catch (e) {1073                    assert.same(e, error);1074                }1075            },1076            "in combination with withArgs": {1077                "can produce a sequence for a fake": function () {1078                    var stub = sinon.stub().returns(0);1079                    stub.withArgs(5).returns(-1)1080                        .onFirstCall().returns(1)1081                        .onSecondCall().returns(2);1082                    assert.same(stub(0), 0);1083                    assert.same(stub(5), 1);1084                    assert.same(stub(0), 0);1085                    assert.same(stub(5), 2);1086                    assert.same(stub(5), -1);1087                },1088                "falls back to stub default behaviour if fake does not have its own default behaviour": function () {1089                    var stub = sinon.stub().returns(0);1090                    stub.withArgs(5)1091                        .onFirstCall().returns(1);1092                    assert.same(stub(5), 1);1093                    assert.same(stub(5), 0);1094                },1095                "falls back to stub behaviour for call if fake does not have its own behaviour for call": function () {1096                    var stub = sinon.stub().returns(0);1097                    stub.withArgs(5).onFirstCall().returns(1);1098                    stub.onSecondCall().returns(2);1099                    assert.same(stub(5), 1);1100                    assert.same(stub(5), 2);1101                    assert.same(stub(4), 0);1102                },1103                "defaults to undefined behaviour once no more calls have been defined": function () {1104                    var stub = sinon.stub();1105                    stub.withArgs(5).onFirstCall().returns(1)1106                        .onSecondCall().returns(2);1107                    assert.same(stub(5), 1);1108                    assert.same(stub(5), 2);1109                    refute.defined(stub(5));1110                },1111                "does not create undefined behaviour just by calling onCall": function () {1112                    var stub = sinon.stub().returns(2);1113                    stub.onFirstCall();1114                    assert.same(stub(6), 2);1115                },1116                "works with fakes and reset": function () {1117                    var stub = sinon.stub();1118                    stub.withArgs(5).onFirstCall().returns(1);1119                    stub.withArgs(5).onSecondCall().returns(2);1120                    assert.same(stub(5), 1);1121                    assert.same(stub(5), 2);1122                    refute.defined(stub(5));1123                    stub.reset();1124                    assert.same(stub(5), 1);1125                    assert.same(stub(5), 2);1126                    refute.defined(stub(5));1127                },1128                "throws an understandable error when trying to use withArgs on behavior": function () {1129                    try {1130                        sinon.stub().onFirstCall().withArgs(1);1131                    } catch (e) {1132                        assert.match(e.message, /not supported/);1133                    }1134                }1135            },1136            "can be used with yields* to produce a sequence": function () {1137                var context = { foo: "bar" };1138                var obj = { method1: sinon.spy(), method2: sinon.spy() };1139                var obj2 = { method2: sinon.spy() };1140                var stub = sinon.stub().yieldsToOn("method2", context, 7, 8);1141                stub.onFirstCall().yields(1, 2)1142                    .onSecondCall().yieldsOn(context, 3, 4)1143                    .onThirdCall().yieldsTo("method1", 5, 6)1144                    .onCall(3).yieldsToOn("method2", context, 7, 8);1145                var spy1 = sinon.spy();1146                var spy2 = sinon.spy();1147                stub(spy1);1148                stub(spy2);1149                stub(obj);1150                stub(obj);1151                stub(obj2); // should continue with default behavior1152                assert(spy1.calledOnce);1153                assert(spy1.calledWithExactly(1, 2));1154                assert(spy2.calledOnce);1155                assert(spy2.calledAfter(spy1));1156                assert(spy2.calledOn(context));1157                assert(spy2.calledWithExactly(3, 4));1158                assert(obj.method1.calledOnce);1159                assert(obj.method1.calledAfter(spy2));1160                assert(obj.method1.calledWithExactly(5, 6));1161                assert(obj.method2.calledOnce);1162                assert(obj.method2.calledAfter(obj.method1));1163                assert(obj.method2.calledOn(context));1164                assert(obj.method2.calledWithExactly(7, 8));1165                assert(obj2.method2.calledOnce);1166                assert(obj2.method2.calledAfter(obj.method2));1167                assert(obj2.method2.calledOn(context));1168                assert(obj2.method2.calledWithExactly(7, 8));1169            },1170            "can be used with callsArg* to produce a sequence": function () {1171                var spy1 = sinon.spy();1172                var spy2 = sinon.spy();1173                var spy3 = sinon.spy();1174                var spy4 = sinon.spy();1175                var spy5 = sinon.spy();1176                var decoy = sinon.spy();1177                var context = { foo: "bar" };1178                var stub = sinon.stub().callsArgOnWith(3, context, "c", "d");1179                stub.onFirstCall().callsArg(0)1180                    .onSecondCall().callsArgWith(1, "a", "b")1181                    .onThirdCall().callsArgOn(2, context)1182                    .onCall(3).callsArgOnWith(3, context, "c", "d");1183                stub(spy1);1184                stub(decoy, spy2);1185                stub(decoy, decoy, spy3);1186                stub(decoy, decoy, decoy, spy4);1187                stub(decoy, decoy, decoy, spy5); // should continue with default behavior1188                assert(spy1.calledOnce);1189                assert(spy2.calledOnce);1190                assert(spy2.calledAfter(spy1));1191                assert(spy2.calledWithExactly("a", "b"));1192                assert(spy3.calledOnce);1193                assert(spy3.calledAfter(spy2));1194                assert(spy3.calledOn(context));1195                assert(spy4.calledOnce);1196                assert(spy4.calledAfter(spy3));1197                assert(spy4.calledOn(context));1198                assert(spy4.calledWithExactly("c", "d"));1199                assert(spy5.calledOnce);1200                assert(spy5.calledAfter(spy4));1201                assert(spy5.calledOn(context));1202                assert(spy5.calledWithExactly("c", "d"));1203                assert(decoy.notCalled);1204            },1205            "can be used with yields* and callsArg* in combination to produce a sequence": function () {1206                var stub = sinon.stub().yields(1, 2);1207                stub.onSecondCall().callsArg(1)1208                    .onThirdCall().yieldsTo("method")1209                    .onCall(3).callsArgWith(2, "a", "b");1210                var obj = { method: sinon.spy() };1211                var spy1 = sinon.spy();1212                var spy2 = sinon.spy();1213                var spy3 = sinon.spy();1214                var decoy = sinon.spy();1215                stub(spy1);1216                stub(decoy, spy2);1217                stub(obj);1218                stub(decoy, decoy, spy3);1219                assert(spy1.calledOnce);1220                assert(spy2.calledOnce);1221                assert(spy2.calledAfter(spy1));1222                assert(obj.method.calledOnce);1223                assert(obj.method.calledAfter(spy2));1224                assert(spy3.calledOnce);1225                assert(spy3.calledAfter(obj.method));1226                assert(spy3.calledWithExactly("a", "b"));1227                assert(decoy.notCalled);1228            },1229            "should interact correctly with assertions (GH-231)": function () {1230                var stub = sinon.stub();1231                var spy = sinon.spy();1232                stub.callsArgWith(0, "a");1233                stub(spy);1234                assert(spy.calledWith("a"));1235                stub(spy);1236                assert(spy.calledWith("a"));1237                stub.onThirdCall().callsArgWith(0, "b");1238                stub(spy);1239                assert(spy.calledWith("b"));1240            }1241        },1242        "reset only resets call history": function () {1243            var obj = { a: function () {} };1244            var spy = sinon.spy();1245            sinon.stub(obj, "a").callsArg(1);1246            obj.a(null, spy);1247            obj.a.reset();1248            obj.a(null, spy);1249            assert(spy.calledTwice);1250        },1251        ".resetBehavior": {1252            "clears yields* and callsArg* sequence": function () {1253                var stub = sinon.stub().yields(1);1254                stub.onFirstCall().callsArg(1);1255                stub.resetBehavior();1256                stub.yields(3);1257                var spyWanted = sinon.spy();1258                var spyNotWanted = sinon.spy();1259                stub(spyWanted, spyNotWanted);1260                assert(spyNotWanted.notCalled);1261                assert(spyWanted.calledOnce);1262                assert(spyWanted.calledWithExactly(3));1263            },1264            "cleans 'returns' behavior": function () {1265                var stub = sinon.stub().returns(1);1266                stub.resetBehavior();1267                refute.defined(stub());1268            },1269            "cleans behavior of fakes returned by withArgs": function () {1270                var stub = sinon.stub();1271                stub.withArgs("lolz").returns(2);1272                stub.resetBehavior();1273                refute.defined(stub("lolz"));1274            },1275            "does not clean parents' behavior when called on a fake returned by withArgs": function () {1276                var parentStub = sinon.stub().returns(false);1277                var childStub = parentStub.withArgs("lolz").returns(true);1278                childStub.resetBehavior();1279                assert.same(parentStub("lolz"), false);1280                assert.same(parentStub(), false);1281            },1282            "cleans 'returnsArg' behavior": function () {1283                var stub = sinon.stub().returnsArg(0);1284                stub.resetBehavior();1285                refute.defined(stub("defined"));1286            },1287            "cleans 'returnsThis' behavior": function () {1288                var instance = {};1289                instance.stub = sinon.stub.create();1290                instance.stub.returnsThis();1291                instance.stub.resetBehavior();1292                refute.defined(instance.stub());1293            },1294            "does not touch properties that are reset by 'reset'": {1295                ".calledOnce": function () {1296                    var stub = sinon.stub();1297                    stub(1);1298                    stub.resetBehavior();1299                    assert(stub.calledOnce);1300                },1301                "called multiple times": function () {1302                    var stub = sinon.stub();1303                    stub(1);1304                    stub(2);1305                    stub(3);1306                    stub.resetBehavior();1307                    assert(stub.called);1308                    assert.equals(stub.args.length, 3);1309                    assert.equals(stub.returnValues.length, 3);1310                    assert.equals(stub.exceptions.length, 3);1311                    assert.equals(stub.thisValues.length, 3);1312                    assert.defined(stub.firstCall);1313                    assert.defined(stub.secondCall);1314                    assert.defined(stub.thirdCall);1315                    assert.defined(stub.lastCall);1316                },1317                "call order state": function () {1318                    var stubs = [sinon.stub(), sinon.stub()];1319                    stubs[0]();1320                    stubs[1]();1321                    stubs[0].resetBehavior();1322                    assert(stubs[0].calledBefore(stubs[1]));1323                },1324                "fakes returned by withArgs": function () {1325                    var stub = sinon.stub();1326                    var fakeA = stub.withArgs("a");1327                    var fakeB = stub.withArgs("b");1328                    stub("a");1329                    stub("b");1330                    stub("c");1331                    var fakeC = stub.withArgs("c");1332                    stub.resetBehavior();1333                    assert(fakeA.calledOnce);1334                    assert(fakeB.calledOnce);1335                    assert(fakeC.calledOnce);1336                }1337            }1338        },1339        ".length": {1340            "is zero by default": function () {1341                var stub = sinon.stub();1342                assert.equals(stub.length, 0);1343            },1344            "matches the function length": function () {1345                var api = { someMethod: function (a, b, c) {} }; // eslint-disable-line no-unused-vars1346                var stub = sinon.stub(api, "someMethod");1347                assert.equals(stub.length, 3);1348            }1349        }1350    });...