cypress 4.9.0 → 4.12.1

package/types/cypress.d.ts

@@ -218,6 +218,7 @@ declare namespace Cypress {
       name: string // "config_passing_spec.coffee"
       relative: string // "cypress/integration/config_passing_spec.coffee" or "__all" if clicked all specs button
       absolute: string
+      specFilter?: string // optional spec filter used by the user
     }
 
     /**
@@ -492,6 +493,10 @@ declare namespace Cypress {
   }
 
   type CanReturnChainable = void | Chainable
+  type ThenReturn<S, R> =
+    R extends void ? Chainable<S> :
+    R extends R | undefined ? Chainable<S | Exclude<R, undefined>> :
+    Chainable<S>
 
   /**
    * Chainable interface for non-array Subjects
@@ -703,6 +708,18 @@ declare namespace Cypress {
      * This means that when you instantiate new Date in your application,
      * it will have a time of January 1st, 1970.
      *
+     * To restore the real clock call `.restore()`
+     *
+     * @example
+     *  cy.clock()
+     *  ...
+     *  // restore the application clock
+     *  cy.clock().then(clock => {
+     *    clock.restore()
+     *  })
+     *  // or use this shortcut
+     *  cy.clock().invoke('restore')
+     *
      * @see https://on.cypress.io/clock
      */
     clock(): Chainable<Clock>
@@ -712,15 +729,22 @@ declare namespace Cypress {
      *
      * @see https://on.cypress.io/clock
      * @example
-     *    // your app code
+     *    // in your app code
      *    $('#date').text(new Date().toJSON())
-     *    // from spec file
-     *    const now = new Date(2017, 3, 14).getTime() // March 14, 2017 timestamp
+     *    // in the spec file
+     *    // March 14, 2017 timestamp or Date object
+     *    const now = new Date(2017, 2, 14).getTime()
      *    cy.clock(now)
      *    cy.visit('/index.html')
      *    cy.get('#date').contains('2017-03-14')
+     *    // to restore the real clock
+     *    cy.clock().then(clock => {
+     *      clock.restore()
+     *    })
+     *    // or use this shortcut
+     *    cy.clock().invoke('restore')
      */
-    clock(now: number, options?: Loggable): Chainable<Clock>
+    clock(now: number|Date, options?: Loggable): Chainable<Clock>
     /**
      * Mocks global clock but only overrides specific functions.
      *
@@ -729,7 +753,7 @@ declare namespace Cypress {
      *    // keep current date but override "setTimeout" and "clearTimeout"
      *    cy.clock(null, ['setTimeout', 'clearTimeout'])
      */
-    clock(now: number, functions?: Array<'setTimeout' | 'clearTimeout' | 'setInterval' | 'clearInterval' | 'Date'>, options?: Loggable): Chainable<Clock>
+    clock(now: number|Date, functions?: Array<'setTimeout' | 'clearTimeout' | 'setInterval' | 'clearInterval' | 'Date'>, options?: Loggable): Chainable<Clock>
     /**
      * Mocks global clock and all functions.
      *
@@ -1751,12 +1775,24 @@ declare namespace Cypress {
      * @see https://on.cypress.io/then
      */
     then<S extends object | any[] | string | number | boolean>(fn: (this: ObjectLike, currentSubject: Subject) => S): Chainable<S>
+    /**
+     * Enables you to work with the subject yielded from the previous command / promise.
+     *
+     * @see https://on.cypress.io/then
+     */
+    then<S>(fn: (this: ObjectLike, currentSubject: Subject) => S): ThenReturn<Subject, S>
     /**
      * Enables you to work with the subject yielded from the previous command / promise.
      *
      * @see https://on.cypress.io/then
      */
     then<S extends object | any[] | string | number | boolean>(options: Partial<Timeoutable>, fn: (this: ObjectLike, currentSubject: Subject) => S): Chainable<S>
+    /**
+     * Enables you to work with the subject yielded from the previous command / promise.
+     *
+     * @see https://on.cypress.io/then
+     */
+    then<S>(options: Partial<Timeoutable>, fn: (this: ObjectLike, currentSubject: Subject) => S): ThenReturn<Subject, S>
     /**
      * Enables you to work with the subject yielded from the previous command.
      *
@@ -1781,6 +1817,17 @@ declare namespace Cypress {
      * `cy.clock()` must be called before `cy.tick()`
      *
      * @see https://on.cypress.io/clock
+     * @example
+     *  cy.clock()
+     *  ...
+     *  // advance time by 10 minutes
+     *  cy.tick(600*1000)
+     *  // you can restore the real clock
+     *  cy.tick(1000).then(clock => {
+     *    clock.restore()
+     *  })
+     *  // or use this shortcut
+     *  cy.tick(5000).invoke('restore')
      */
     tick(milliseconds: number): Chainable<Clock>
 
@@ -2375,6 +2422,11 @@ declare namespace Cypress {
      * @example 1.2.3
      */
     resolvedNodeVersion: string
+    /**
+     * Whether Cypress will take a screenshot when a test fails during cypress run.
+     * @default true
+     */
+    screenshotOnRunFailure: boolean
     /**
      * Path to folder where screenshots will be saved from [cy.screenshot()](https://on.cypress.io/screenshot) command or after a headless or CI run’s test failure
      * @default "cypress/screenshots"
@@ -2480,6 +2532,10 @@ declare namespace Cypress {
     * Absolute path to the root of the project
     */
     projectRoot: string
+    /**
+     * Cypress version.
+     */
+    version: string
   }
 
   interface DebugOptions {
@@ -2591,6 +2647,12 @@ declare namespace Cypress {
      * @default 'swing'
      */
     easing: 'swing' | 'linear',
+    /**
+     * Ensure element is scrollable. Error if element is not scrollable
+     *
+     * @default true
+     */
+    ensureScrollable: boolean,
   }
 
   interface ScrollIntoViewOptions extends ScrollToOptions {
@@ -2777,7 +2839,7 @@ declare namespace Cypress {
     encoding: Encodings
   }
 
-  // Kind of onerous, but has a nice auto-complete. Also fallbacks at the end for custom stuff
+  // Kind of onerous, but has a nice auto-complete.
   /**
    * @see https://on.cypress.io/should
    *
@@ -2968,6 +3030,22 @@ declare namespace Cypress {
      * @see https://on.cypress.io/assertions
      */
     (chainer: 'be.undefined'): Chainable<Subject>
+    /**
+     * Asserts that the target is strictly (`===`) equal to null.
+     * @example
+     *    cy.wrap(null).should('be.null')
+     * @see http://chaijs.com/api/bdd/#method_null
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.null'): Chainable<Subject>
+    /**
+     * Asserts that the target is strictly (`===`) equal to NaN.
+     * @example
+     *    cy.wrap(NaN).should('be.NaN')
+     * @see http://chaijs.com/api/bdd/#method_null
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.NaN'): Chainable<Subject>
     /**
      * Asserts that the target is a number or a date greater than or equal to the given number or date `start`, and less than or equal to the given number or date `finish` respectively.
      * However, it’s often best to assert that the target is equal to its expected value.
@@ -3096,7 +3174,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_all
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.all.keys', ...value: string[]): Chainable<Subject>
+    (chainer: 'have.all.keys' | 'have.keys' | 'have.deep.keys' | 'have.all.deep.keys', ...value: string[]): Chainable<Subject>
     /**
      * Causes all `.keys` assertions that follow in the chain to only require that the target have at least one of the given keys. This is the opposite of `.all`, which requires that the target have all of the given keys.
      * @example
@@ -3104,7 +3182,15 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_any
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.any.keys', ...value: string[]): Chainable<Subject>
+    (chainer: 'have.any.keys' | 'include.any.keys', ...value: string[]): Chainable<Subject>
+    /**
+     * Causes all `.keys` assertions that follow in the chain to require the target to be a superset of the expected set, rather than an identical set.
+     * @example
+     *    cy.wrap({ a: 1, b: 2 }).should('include.all.keys', 'a', 'b')
+     * @see http://chaijs.com/api/bdd/#method_keys
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'include.all.keys', ...value: string[]): Chainable<Subject>
     /**
      * Asserts that the target has a property with the given key `name`. See the `deep-eql` project page for info on the deep equality algorithm: https://github.com/chaijs/deep-eql.
      * @example
@@ -3122,7 +3208,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length', value: number): Chainable<Subject>
+    (chainer: 'have.length' | 'have.lengthOf', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is greater than to the given number `n`.
      * @example
@@ -3131,7 +3217,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length.greaterThan', value: number): Chainable<Subject>
+    (chainer: 'have.length.greaterThan' | 'have.lengthOf.greaterThan', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is greater than to the given number `n`.
      * @example
@@ -3140,7 +3226,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length.gt', value: number): Chainable<Subject>
+    (chainer: 'have.length.gt' | 'have.lengthOf.gt' | 'have.length.above' | 'have.lengthOf.above', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is greater than or equal to the given number `n`.
      * @example
@@ -3149,7 +3235,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length.gte', value: number): Chainable<Subject>
+    (chainer: 'have.length.gte' | 'have.lengthOf.gte' | 'have.length.at.least' | 'have.lengthOf.at.least', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is less than to the given number `n`.
      * @example
@@ -3158,7 +3244,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length.lessThan', value: number): Chainable<Subject>
+    (chainer: 'have.length.lessThan' | 'have.lengthOf.lessThan', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is less than to the given number `n`.
      * @example
@@ -3167,7 +3253,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length.lt', value: number): Chainable<Subject>
+    (chainer: 'have.length.lt' | 'have.lengthOf.lt' | 'have.length.below' | 'have.lengthOf.below', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is less than or equal to the given number `n`.
      * @example
@@ -3176,7 +3262,15 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length.lte', value: number): Chainable<Subject>
+    (chainer: 'have.length.lte' | 'have.lengthOf.lte' | 'have.length.at.most' | 'have.lengthOf.at.most', value: number): Chainable<Subject>
+    /**
+     * Asserts that the target’s `length` property is within `start` and `finish`.
+     * @example
+     *    cy.wrap([1, 2, 3]).should('have.length.within', 1, 5)
+     * @see http://chaijs.com/api/bdd/#method_lengthof
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'have.length.within' | 'have.lengthOf.within', start: number, finish: number): Chainable<Subject>
     /**
      * Asserts that the target array has the same members as the given array `set`.
      * @example
@@ -3184,7 +3278,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_members
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.members', values: any[]): Chainable<Subject>
+    (chainer: 'have.members' | 'have.deep.members', values: any[]): Chainable<Subject>
     /**
      * Asserts that the target array has the same members as the given array where order matters.
      * @example
@@ -3210,7 +3304,15 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_property
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.property', property: string, value?: any): Chainable<Subject>
+    (chainer: 'have.property' | 'have.nested.property' | 'have.own.property' | 'have.a.property' | 'have.deep.property' | 'have.deep.own.property' | 'have.deep.nested.property', property: string, value?: any): Chainable<Subject>
+    /**
+     * Asserts that the target has its own property descriptor with the given key name.
+     * @example
+     *    cy.wrap({a: 1}).should('have.ownPropertyDescriptor', 'a', { value: 1 })
+     * @see http://chaijs.com/api/bdd/#method_ownpropertydescriptor
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'have.ownPropertyDescriptor' | 'haveOwnPropertyDescriptor', name: string, descriptor?: PropertyDescriptor): Chainable<Subject>
     /**
      * Asserts that the target string contains the given substring `str`.
      * @example
@@ -3226,7 +3328,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_include
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'include', value: any): Chainable<Subject>
+    (chainer: 'include' | 'deep.include' | 'nested.include' | 'own.include' | 'deep.own.include' | 'deep.nested.include', value: any): Chainable<Subject>
     /**
      * When the target is a string, `.include` asserts that the given string `val` is a substring of the target.
      * @example
@@ -3234,21 +3336,29 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_members
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'include.members', value: any[]): Chainable<Subject>
+    (chainer: 'include.members' | 'include.ordered.members' | 'include.deep.ordered.members', value: any[]): Chainable<Subject>
     /**
      * When one argument is provided, `.increase` asserts that the given function `subject` returns a greater number when it’s
      * invoked after invoking the target function compared to when it’s invoked beforehand.
      * `.increase` also causes all `.by` assertions that follow in the chain to assert how much greater of a number is returned.
      * It’s often best to assert that the return value increased by the expected amount, rather than asserting it increased by any amount.
+     *
+     * When two arguments are provided, `.increase` asserts that the value of the given object `subject`’s `prop` property is greater after
+     * invoking the target function compared to beforehand.
+     *
      * @example
      *    let val = 1
      *    function addTwo() { val += 2 }
      *    function getVal() { return val }
      *    cy.wrap(addTwo).should('increase', getVal)
+     *
+     *    const myObj = { val: 1 }
+     *    function addTwo() { myObj.val += 2 }
+     *    cy.wrap(addTwo).should('increase', myObj, 'val')
      * @see http://chaijs.com/api/bdd/#method_increase
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'increase', value: object, property: string): Chainable<Subject>
+    (chainer: 'increase', value: object, property?: string): Chainable<Subject>
     /**
      * Asserts that the target matches the given regular expression `re`.
      * @example
@@ -3301,6 +3411,50 @@ declare namespace Cypress {
      */
     // tslint:disable-next-line ban-types
     (chainer: 'throw', error: Error | Function, expected?: string | RegExp): Chainable<Subject>
+    /**
+     * Asserts that the target is a member of the given array list.
+     * @example
+     *    cy.wrap(1).should('be.oneOf', [1, 2, 3])
+     * @see http://chaijs.com/api/bdd/#method_oneof
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.oneOf', list: ReadonlyArray<any>): Chainable<Subject>
+    /**
+     * Asserts that the target is extensible, which means that new properties can be added to it.
+     * @example
+     *    cy.wrap({a: 1}).should('be.extensible')
+     * @see http://chaijs.com/api/bdd/#method_extensible
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.extensible'): Chainable<Subject>
+    /**
+     * Asserts that the target is sealed, which means that new properties can’t be added to it, and its existing properties can’t be reconfigured or deleted.
+     * @example
+     *    let sealedObject = Object.seal({})
+     *    let frozenObject = Object.freeze({})
+     *    cy.wrap(sealedObject).should('be.sealed')
+     *    cy.wrap(frozenObject).should('be.sealed')
+     * @see http://chaijs.com/api/bdd/#method_sealed
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.sealed'): Chainable<Subject>
+    /**
+     * Asserts that the target is frozen, which means that new properties can’t be added to it, and its existing properties can’t be reassigned to different values, reconfigured, or deleted.
+     * @example
+     *    let frozenObject = Object.freeze({})
+     *    cy.wrap(frozenObject).should('be.frozen')
+     * @see http://chaijs.com/api/bdd/#method_frozen
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.frozen'): Chainable<Subject>
+    /**
+     * Asserts that the target is a number, and isn’t `NaN` or positive/negative `Infinity`.
+     * @example
+     *    cy.wrap(1).should('be.finite')
+     * @see http://chaijs.com/api/bdd/#method_finite
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.finite'): Chainable<Subject>
 
     // chai.not
     /**
@@ -3485,6 +3639,22 @@ declare namespace Cypress {
      * @see https://on.cypress.io/assertions
      */
     (chainer: 'not.be.undefined'): Chainable<Subject>
+    /**
+     * Asserts that the target is strictly (`===`) equal to null.
+     * @example
+     *    cy.wrap(null).should('not.be.null')
+     * @see http://chaijs.com/api/bdd/#method_null
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.null'): Chainable<Subject>
+    /**
+     * Asserts that the target is strictly (`===`) equal to NaN.
+     * @example
+     *    cy.wrap(NaN).should('not.be.NaN')
+     * @see http://chaijs.com/api/bdd/#method_nan
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.NaN'): Chainable<Subject>
     /**
      * Asserts that the target is not a number or a date greater than or equal to the given number or date `start`, and less than or equal to the given number or date `finish` respectively.
      * However, it’s often best to assert that the target is equal to its expected value.
@@ -3596,7 +3766,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_all
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.all.keys', ...value: string[]): Chainable<Subject>
+    (chainer: 'not.have.all.keys' | 'not.have.keys' | 'not.have.deep.keys' | 'not.have.all.deep.keys', ...value: string[]): Chainable<Subject>
     /**
      * Causes all `.keys` assertions that follow in the chain to only require that the target not have at least one of the given keys. This is the opposite of `.all`, which requires that the target have all of the given keys.
      * @example
@@ -3604,7 +3774,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_any
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.any.keys', ...value: string[]): Chainable<Subject>
+    (chainer: 'not.have.any.keys' | 'not.include.any.keys', ...value: string[]): Chainable<Subject>
     /**
      * Asserts that the target does not have a property with the given key `name`. See the `deep-eql` project page for info on the deep equality algorithm: https://github.com/chaijs/deep-eql.
      * @example
@@ -3622,7 +3792,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.length', value: number): Chainable<Subject>
+    (chainer: 'not.have.length' | 'not.have.lengthOf', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is not greater than to the given number `n`.
      * @example
@@ -3631,7 +3801,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.length.greaterThan', value: number): Chainable<Subject>
+    (chainer: 'not.have.length.greaterThan' | 'not.have.lengthOf.greaterThan', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is not greater than to the given number `n`.
      * @example
@@ -3640,7 +3810,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.length.gt', value: number): Chainable<Subject>
+    (chainer: 'not.have.length.gt' | 'not.have.lengthOf.gt' | 'not.have.length.above' | 'not.have.lengthOf.above', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is not greater than or equal to the given number `n`.
      * @example
@@ -3649,7 +3819,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'have.length.gte', value: number): Chainable<Subject>
+    (chainer: 'not.have.length.gte' | 'not.have.lengthOf.gte' | 'not.have.length.at.least' | 'not.have.lengthOf.at.least', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is less than to the given number `n`.
      * @example
@@ -3658,7 +3828,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.length.lessThan', value: number): Chainable<Subject>
+    (chainer: 'not.have.length.lessThan' | 'not.have.lengthOf.lessThan', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is not less than to the given number `n`.
      * @example
@@ -3667,16 +3837,24 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.length.lt', value: number): Chainable<Subject>
+    (chainer: 'not.have.length.lt' | 'not.have.lengthOf.lt' | 'not.have.length.below' | 'not.have.lengthOf.below', value: number): Chainable<Subject>
     /**
      * Asserts that the target’s `length` property is not less than or equal to the given number `n`.
      * @example
-     *    cy.wrap([1, 2, 3]).should('not.have.length.let', 2)
+     *    cy.wrap([1, 2, 3]).should('not.have.length.lte', 2)
      *    cy.wrap('foo').should('not.have.length.lte', 2)
      * @see http://chaijs.com/api/bdd/#method_lengthof
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.length.lte', value: number): Chainable<Subject>
+    (chainer: 'not.have.length.lte' | 'not.have.lengthOf.lte' | 'not.have.length.at.most' | 'not.have.lengthOf.at.most', value: number): Chainable<Subject>
+    /**
+     * Asserts that the target’s `length` property is within `start` and `finish`.
+     * @example
+     *    cy.wrap([1, 2, 3]).should('not.have.length.within', 6, 12)
+     * @see http://chaijs.com/api/bdd/#method_lengthof
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.have.length.within' | 'not.have.lengthOf.within', start: number, finish: number): Chainable<Subject>
     /**
      * Asserts that the target array does not have the same members as the given array `set`.
      * @example
@@ -3684,7 +3862,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_members
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.members', values: any[]): Chainable<Subject>
+    (chainer: 'not.have.members' | 'not.have.deep.members', values: any[]): Chainable<Subject>
     /**
      * Asserts that the target array does not have the same members as the given array where order matters.
      * @example
@@ -3710,7 +3888,15 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_property
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.have.property', property: string, value?: any): Chainable<Subject>
+    (chainer: 'not.have.property' | 'not.have.nested.property' | 'not.have.own.property' | 'not.have.a.property' | 'not.have.deep.property' | 'not.have.deep.own.property' | 'not.have.deep.nested.property', property: string, value?: any): Chainable<Subject>
+    /**
+     * Asserts that the target has its own property descriptor with the given key name.
+     * @example
+     *    cy.wrap({a: 1}).should('not.have.ownPropertyDescriptor', 'a', { value: 2 })
+     * @see http://chaijs.com/api/bdd/#method_ownpropertydescriptor
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.have.ownPropertyDescriptor' | 'not.haveOwnPropertyDescriptor', name: string, descriptor?: PropertyDescriptor): Chainable<Subject>
     /**
      * Asserts that the target string does not contains the given substring `str`.
      * @example
@@ -3726,7 +3912,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_include
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.include', value: any): Chainable<Subject>
+    (chainer: 'not.include' | 'not.deep.include' | 'not.nested.include' | 'not.own.include' | 'not.deep.own.include' | 'not.deep.nested.include', value: any): Chainable<Subject>
     /**
      * When the target is a string, `.include` asserts that the given string `val` is not a substring of the target.
      * @example
@@ -3734,21 +3920,29 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_members
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.include.members', value: any[]): Chainable<Subject>
+    (chainer: 'not.include.members' | 'not.include.ordered.members' | 'not.include.deep.ordered.members', value: any[]): Chainable<Subject>
     /**
      * When one argument is provided, `.increase` asserts that the given function `subject` returns a greater number when it’s
      * invoked after invoking the target function compared to when it’s invoked beforehand.
      * `.increase` also causes all `.by` assertions that follow in the chain to assert how much greater of a number is returned.
      * It’s often best to assert that the return value increased by the expected amount, rather than asserting it increased by any amount.
+     *
+     * When two arguments are provided, `.increase` asserts that the value of the given object `subject`’s `prop` property is greater after
+     * invoking the target function compared to beforehand.
+     *
      * @example
      *    let val = 1
      *    function addTwo() { val += 2 }
      *    function getVal() { return val }
      *    cy.wrap(() => {}).should('not.increase', getVal)
+     *
+     *    const myObj = { val: 1 }
+     *    function addTwo() { myObj.val += 2 }
+     *    cy.wrap(addTwo).should('increase', myObj, 'val')
      * @see http://chaijs.com/api/bdd/#method_increase
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.increase', value: object, property: string): Chainable<Subject>
+    (chainer: 'not.increase', value: object, property?: string): Chainable<Subject>
     /**
      * Asserts that the target does not match the given regular expression `re`.
      * @example
@@ -3787,7 +3981,7 @@ declare namespace Cypress {
      * @see http://chaijs.com/api/bdd/#method_throw
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'throw', value?: string | RegExp): Chainable<Subject>
+    (chainer: 'not.throw', value?: string | RegExp): Chainable<Subject>
     /**
      * When no arguments are provided, `.throw` invokes the target function and asserts that no error is thrown.
      * When one argument is provided, and it’s a string, `.throw` invokes the target function and asserts that no error is thrown with a message that contains that string.
@@ -3800,7 +3994,50 @@ declare namespace Cypress {
      * @see https://on.cypress.io/assertions
      */
     // tslint:disable-next-line ban-types
-    (chainer: 'throw', error: Error | Function, expected?: string | RegExp): Chainable<Subject>
+    (chainer: 'not.throw', error: Error | Function, expected?: string | RegExp): Chainable<Subject>
+    /**
+     * Asserts that the target is a member of the given array list.
+     * @example
+     *    cy.wrap(42).should('not.be.oneOf', [1, 2, 3])
+     * @see http://chaijs.com/api/bdd/#method_oneof
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.oneOf', list: ReadonlyArray<any>): Chainable<Subject>
+    /**
+     * Asserts that the target is extensible, which means that new properties can be added to it.
+     * @example
+     *    let o = Object.seal({})
+     *    cy.wrap(o).should('not.be.extensible')
+     * @see http://chaijs.com/api/bdd/#method_extensible
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.extensible'): Chainable<Subject>
+    /**
+     * Asserts that the target is sealed, which means that new properties can’t be added to it, and its existing properties can’t be reconfigured or deleted.
+     * @example
+     *    cy.wrap({a: 1}).should('be.sealed')
+     *    cy.wrap({a: 1}).should('be.sealed')
+     * @see http://chaijs.com/api/bdd/#method_sealed
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.sealed'): Chainable<Subject>
+    /**
+     * Asserts that the target is frozen, which means that new properties can’t be added to it, and its existing properties can’t be reassigned to different values, reconfigured, or deleted.
+     * @example
+     *    cy.wrap({a: 1}).should('not.be.frozen')
+     * @see http://chaijs.com/api/bdd/#method_frozen
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.frozen'): Chainable<Subject>
+    /**
+     * Asserts that the target is a number, and isn’t `NaN` or positive/negative `Infinity`.
+     * @example
+     *    cy.wrap(NaN).should('not.be.finite')
+     *    cy.wrap(Infinity).should('not.be.finite')
+     * @see http://chaijs.com/api/bdd/#method_finite
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.finite'): Chainable<Subject>
 
     // sinon-chai
     /**
@@ -3809,80 +4046,80 @@ declare namespace Cypress {
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithnew
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.always.calledWithNew'): Chainable<Subject>
+    (chainer: 'be.always.calledWithNew' | 'always.have.been.calledWithNew'): Chainable<Subject>
     /**
      * Assert if spy was always called with matching arguments (and possibly others).
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledwithmatcharg1-arg2-
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.always.calledWithMatch', ...args: any[]): Chainable<Subject>
+    (chainer: 'be.always.calledWithMatch' | 'always.have.been.calledWithMatch', ...args: any[]): Chainable<Subject>
     /**
      * Assert spy always returned the provided value.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwaysreturnedobj
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'always.returned', value: any): Chainable<Subject>
+    (chainer: 'always.returned' | 'have.always.returned', value: any): Chainable<Subject>
     /**
      * `true` if the spy was called at least once
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalled
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.called'): Chainable<Subject>
+    (chainer: 'be.called' | 'have.been.called'): Chainable<Subject>
     /**
      * Assert spy was called after `anotherSpy`
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledafteranotherspy
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledAfter', spy: sinon.SinonSpy): Chainable<Subject>
+    (chainer: 'be.calledAfter' | 'have.been.calledAfter', spy: sinon.SinonSpy): Chainable<Subject>
     /**
      * Assert spy was called before `anotherSpy`
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledbeforeanotherspy
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledBefore', spy: sinon.SinonSpy): Chainable<Subject>
+    (chainer: 'be.calledBefore' | 'have.been.calledBefore', spy: sinon.SinonSpy): Chainable<Subject>
     /**
      * Assert spy was called at least once with `obj` as `this`. `calledOn` also accepts a matcher (see [matchers](http://sinonjs.org/releases/v4.1.3/spies/#matchers)).
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledonobj
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledOn', context: any): Chainable<Subject>
+    (chainer: 'be.calledOn' | 'have.been.calledOn', context: any): Chainable<Subject>
     /**
      * Assert spy was called exactly once
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledonce
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledOnce'): Chainable<Subject>
+    (chainer: 'be.calledOnce' | 'have.been.calledOnce'): Chainable<Subject>
     /**
      * Assert spy was called exactly three times
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledthrice
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledThrice'): Chainable<Subject>
+    (chainer: 'be.calledThrice' | 'have.been.calledThrice'): Chainable<Subject>
     /**
      * Assert spy was called exactly twice
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledtwice
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledTwice'): Chainable<Subject>
+    (chainer: 'be.calledTwice' | 'have.been.calledTwice'): Chainable<Subject>
     /**
      * Assert spy was called at least once with the provided arguments and no others.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithexactlyarg1-arg2-
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledWithExactly', ...args: any[]): Chainable<Subject>
+    (chainer: 'be.calledWithExactly' | 'have.been.calledWithExactly', ...args: any[]): Chainable<Subject>
     /**
      * Assert spy was called with matching arguments (and possibly others).
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithmatcharg1-arg2-
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledWithMatch', ...args: any[]): Chainable<Subject>
+    (chainer: 'be.calledWithMatch' | 'have.been.calledWithMatch', ...args: any[]): Chainable<Subject>
     /**
      * Assert spy/stub was called the `new` operator.
      * Beware that this is inferred based on the value of the this object and the spy function’s prototype, so it may give false positives if you actively return the right kind of object.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithnew
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'be.calledWithNew'): Chainable<Subject>
+    (chainer: 'be.calledWithNew' | 'have.been.calledWithNew'): Chainable<Subject>
     /**
      * Assert spy always threw an exception.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwaysthrew
@@ -3906,7 +4143,61 @@ declare namespace Cypress {
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyreturnedobj
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'returned', value: any): Chainable<Subject>
+    (chainer: 'returned' | 'have.returned', value: any): Chainable<Subject>
+    /**
+     * Assert spy was called before anotherSpy, and no spy calls occurred between spy and anotherSpy.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledimmediatelybeforeanotherspy
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.calledImmediatelyBefore' | 'have.been.calledImmediatelyBefore', anotherSpy: sinon.SinonSpy): Chainable<Subject>
+    /**
+     * Assert spy was called after anotherSpy, and no spy calls occurred between anotherSpy and spy.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledimmediatelyafteranotherspy
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.calledImmediatelyAfter' | 'have.been.calledImmediatelyAfter', anotherSpy: sinon.SinonSpy): Chainable<Subject>
+    /**
+     * Assert the spy was always called with obj as this
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledonobj
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.always.calledOn' | 'always.have.been.calledOn', obj: any): Chainable<Subject>
+    /**
+     * Assert spy was called at least once with the provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwitharg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.calledWith' | 'have.been.calledWith', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was always called with the provided arguments (and possibly others).
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledwitharg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.always.calledWith' | 'always.have.been.calledWith', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was called at exactly once with the provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwitharg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.calledOnceWith' | 'have.been.calledOnceWith', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was always called with the exact provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledwithexactlyarg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.always.calledWithExactly' | 'have.been.calledWithExactly', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was called at exactly once with the provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'be.calledOnceWithExactly' | 'have.been.calledOnceWithExactly', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy always returned the provided value.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'have.always.returned', obj: any): Chainable<Subject>
 
     // sinon-chai.not
     /**
@@ -3915,80 +4206,80 @@ declare namespace Cypress {
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithnew
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.always.calledWithNew'): Chainable<Subject>
+    (chainer: 'not.be.always.calledWithNew' | 'not.always.have.been.calledWithNew'): Chainable<Subject>
     /**
      * Assert if spy was not always called with matching arguments (and possibly others).
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledwithmatcharg1-arg2-
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.always.calledWithMatch', ...args: any[]): Chainable<Subject>
+    (chainer: 'not.be.always.calledWithMatch' | 'not.always.have.been.calledWithMatch', ...args: any[]): Chainable<Subject>
     /**
      * Assert spy not always returned the provided value.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwaysreturnedobj
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.always.returned', value: any): Chainable<Subject>
+    (chainer: 'not.always.returned' | 'not.have.always.returned', value: any): Chainable<Subject>
     /**
      * `true` if the spy was not called at least once
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalled
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.called'): Chainable<Subject>
+    (chainer: 'not.be.called' | 'not.have.been.called'): Chainable<Subject>
     /**
      * Assert spy was not.called after `anotherSpy`
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledafteranotherspy
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledAfter', spy: sinon.SinonSpy): Chainable<Subject>
+    (chainer: 'not.be.calledAfter' | 'not.have.been.calledAfter', spy: sinon.SinonSpy): Chainable<Subject>
     /**
      * Assert spy was not called before `anotherSpy`
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledbeforeanotherspy
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledBefore', spy: sinon.SinonSpy): Chainable<Subject>
+    (chainer: 'not.be.calledBefore' | 'not.have.been.calledBefore', spy: sinon.SinonSpy): Chainable<Subject>
     /**
      * Assert spy was not called at least once with `obj` as `this`. `calledOn` also accepts a matcher (see [matchers](http://sinonjs.org/releases/v4.1.3/spies/#matchers)).
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledonobj
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledOn', context: any): Chainable<Subject>
+    (chainer: 'not.be.calledOn' | 'not.have.been.calledOn', context: any): Chainable<Subject>
     /**
      * Assert spy was not called exactly once
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledonce
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledOnce'): Chainable<Subject>
+    (chainer: 'not.be.calledOnce' | 'not.have.been.calledOnce'): Chainable<Subject>
     /**
      * Assert spy was not called exactly three times
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledthrice
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledThrice'): Chainable<Subject>
+    (chainer: 'not.be.calledThrice' | 'not.have.been.calledThrice'): Chainable<Subject>
     /**
      * Assert spy was not called exactly twice
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledtwice
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledTwice'): Chainable<Subject>
+    (chainer: 'not.be.calledTwice' | 'not.have.been.calledTwice'): Chainable<Subject>
     /**
      * Assert spy was not called at least once with the provided arguments and no others.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithexactlyarg1-arg2-
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledWithExactly', ...args: any[]): Chainable<Subject>
+    (chainer: 'not.be.calledWithExactly' | 'not.have.been.calledWithExactly', ...args: any[]): Chainable<Subject>
     /**
      * Assert spy was not called with matching arguments (and possibly others).
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithmatcharg1-arg2-
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledWithMatch', ...args: any[]): Chainable<Subject>
+    (chainer: 'not.be.calledWithMatch' | 'not.have.been.calledWithMatch', ...args: any[]): Chainable<Subject>
     /**
      * Assert spy/stub was not called the `new` operator.
      * Beware that this is inferred based on the value of the this object and the spy function’s prototype, so it may give false positives if you actively return the right kind of object.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwithnew
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.be.calledWithNew'): Chainable<Subject>
+    (chainer: 'not.be.calledWithNew' | 'not.have.been.calledWithNew'): Chainable<Subject>
     /**
      * Assert spy did not always throw an exception.
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwaysthrew
@@ -4012,7 +4303,61 @@ declare namespace Cypress {
      * @see http://sinonjs.org/releases/v4.1.3/spies/#spyreturnedobj
      * @see https://on.cypress.io/assertions
      */
-    (chainer: 'not.returned', value: any): Chainable<Subject>
+    (chainer: 'not.returned' | 'not.have.returned', value: any): Chainable<Subject>
+    /**
+     * Assert spy was called before anotherSpy, and no spy calls occurred between spy and anotherSpy.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledimmediatelybeforeanotherspy
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.calledImmediatelyBefore' | 'not.have.been.calledImmediatelyBefore', anotherSpy: sinon.SinonSpy): Chainable<Subject>
+    /**
+     * Assert spy was called after anotherSpy, and no spy calls occurred between anotherSpy and spy.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledimmediatelyafteranotherspy
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.calledImmediatelyAfter' | 'not.have.been.calledImmediatelyAfter', anotherSpy: sinon.SinonSpy): Chainable<Subject>
+    /**
+     * Assert the spy was always called with obj as this
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledonobj
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.always.calledOn' | 'not.always.have.been.calledOn', obj: any): Chainable<Subject>
+    /**
+     * Assert spy was called at least once with the provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwitharg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.calledWith' | 'not.have.been.calledWith', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was always called with the provided arguments (and possibly others).
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledwitharg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.always.calledWith' | 'not.always.have.been.calledWith', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was called at exactly once with the provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spycalledwitharg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.calledOnceWith' | 'not.have.been.calledOnceWith', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was always called with the exact provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#spyalwayscalledwithexactlyarg1-arg2-
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.always.calledWithExactly' | 'not.have.been.calledWithExactly', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy was called at exactly once with the provided arguments.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.be.calledOnceWithExactly' | 'not.have.been.calledOnceWithExactly', ...args: any[]): Chainable<Subject>
+    /**
+     * Assert spy always returned the provided value.
+     * @see http://sinonjs.org/releases/v4.1.3/spies/#
+     * @see https://on.cypress.io/assertions
+     */
+    (chainer: 'not.have.always.returned', obj: any): Chainable<Subject>
 
     // jquery-chai
     /**
@@ -4738,10 +5083,22 @@ declare namespace Cypress {
      * Move the clock the specified number of `milliseconds`.
      * Any timers within the affected range of time will be called.
      * @param time Number in ms to advance the clock
+     * @see https://on.cypress.io/tick
      */
     tick(time: number): void
     /**
-     * Restore all overridden native functions. This is automatically called between tests, so should not generally be needed.
+     * Restore all overridden native functions.
+     * This is automatically called between tests, so should not generally be needed.
+     * @see https://on.cypress.io/clock
+     * @example
+     *   cy.clock()
+     *   cy.visit('/')
+     *   ...
+     *   cy.clock().then(clock => {
+     *     clock.restore()
+     *   })
+     *   // or use this shortcut
+     *   cy.clock().invoke('restore')
      */
     restore(): void
   }
@@ -4753,7 +5110,7 @@ declare namespace Cypress {
     domain: string
     httpOnly: boolean
     secure: boolean
-    expiry?: string
+    expiry?: number
     sameSite?: SameSiteStatus
   }