** to have text **bar**, but the text was **foo**'
+ )
+ }
+
+ this.clearLogs()
+ try {
+ expect(this.$div).to.contain.text('bar')
+ } catch (error1) {
+ expect(this.logs[0].get('message')).to.eq(
+ 'expected **
** to contain text **bar**, but the text was **foo**'
+ )
+ }
+ })
+
+ it('partial match', function () {
+ expect(this.$div).to.have.text('foo')
+ expect(this.$div).to.contain.text('o')
+ expect(this.$div).to.include.text('o')
+ cy.get('div').should('contain.text', 'iv').should('contain.text', 'd')
+
+ cy.get('div').should('not.contain.text', 'fizzbuzz').should('contain.text', 'Nest')
+ })
+
+ it('throws when obj is not DOM', function (done) {
+ cy.on('fail', (err) => {
+ expect(this.logs.length).to.eq(1)
+ expect(this.logs[0].get('error').message).to.eq(
+ 'expected undefined to have text \'foo\''
+ )
+
+ expect(err.message).to.include('> text')
+ expect(err.message).to.include('> undefined')
+
+ done()
+ })
+
+ expect(undefined).to.have.text('foo')
+ })
+ })
+
+ context('value', () => {
+ beforeEach(function () {
+ this.$input = $('
')
+ this.$input.val = function () {
+ throw new Error('val called')
+ }
+ })
+
+ it('value, not value, contain value', function () {
+ expect(this.$input).to.have.value('foo') //# 1
+ expect(this.$input).not.to.have.value('bar') //# 2
+
+ expect(this.logs.length).to.eq(2)
+
+ const l1 = this.logs[0]
+ const l2 = this.logs[1]
+
+ expect(l1.get('message')).to.eq(
+ 'expected **
** to have value **foo**'
+ )
+
+ expect(l2.get('message')).to.eq(
+ 'expected **
** not to have value **bar**'
+ )
+
+ this.clearLogs()
+ expect(this.$input).to.contain.value('foo')
+ expect(this.logs[0].get('message')).to.eq(
+ 'expected **
** to contain value **foo**'
+ )
+
+ this.clearLogs()
+ expect(this.$input).not.to.contain.value('bar')
+ expect(this.logs[0].get('message')).to.eq(
+ 'expected **
** not to contain value **bar**'
+ )
+
+ this.clearLogs()
+ try {
+ expect(this.$input).to.have.value('bar')
+ } catch (error) {
+ expect(this.logs[0].get('message')).to.eq(
+ 'expected **
** to have value **bar**, but the value was **foo**'
+ )
+ }
+
+ this.clearLogs()
+ try {
+ expect(this.$input).to.contain.value('bar')
+ } catch (error1) {
+ expect(this.logs[0].get('message')).to.eq(
+ 'expected **
** to contain value **bar**, but the value was **foo**'
+ )
+ }
+ })
+
+ it('throws when obj is not DOM', function (done) {
+ cy.on('fail', (err) => {
+ expect(this.logs.length).to.eq(1)
+ expect(this.logs[0].get('error').message).to.eq(
+ 'expected {} to have value \'foo\''
+ )
+
+ expect(err.message).to.include('> value')
+ expect(err.message).to.include('> {}')
+
+ done()
+ })
+
+ expect({}).to.have.value('foo')
+ })
+
+ it('partial match', function () {
+ expect(this.$input).to.contain.value('oo')
+ expect(this.$input).to.not.contain.value('oof')
+ //# make sure "includes" is an alias of "include"
+ expect(this.$input).to.includes.value('oo')
+ cy.get('input')
+ .invoke('val', 'foobar')
+ .should('contain.value', 'bar')
+ .should('contain.value', 'foo')
+ .should('include.value', 'foo')
+
+ cy.wrap(null).then(() => {
+ cy.$$('
').prependTo(cy.$$('body'))
+
+ cy.$$('
').prependTo(cy.$$('body'))
+ })
+
+ cy.get('input').should(($els) => {
+ expect($els).to.have.value('foo2')
+ expect($els).to.contain.value('foo')
+
+ expect($els).to.include.value('foo')
+ }).should('contain.value', 'oo2')
+ })
+ })
+
+ context('descendants', () => {
+ beforeEach(function () {
+ this.$div = $('
')
+ this.$div.has = function () {
+ throw new Error('has called')
+ }
+ })
+
+ it('descendants, not descendants', function () {
+ expect(this.$div).to.have.descendants('button') //# 1
+ expect(this.$div).not.to.have.descendants('input') //# 2
+
+ expect(this.logs.length).to.eq(2)
+
+ const l1 = this.logs[0]
+ const l2 = this.logs[1]
+
+ expect(l1.get('message')).to.eq(
+ 'expected **
** to have descendants **button**'
+ )
+
+ expect(l2.get('message')).to.eq(
+ 'expected **
** not to have descendants **input**'
+ )
+ })
+
+ it('throws when obj is not DOM', function (done) {
+ cy.on('fail', (err) => {
+ expect(this.logs.length).to.eq(1)
+ expect(this.logs[0].get('error').message).to.eq(
+ 'expected {} to have descendants \'foo\''
+ )
+
+ expect(err.message).to.include('> descendants')
+ expect(err.message).to.include('> {}')
+
+ done()
+ })
+
+ expect({}).to.have.descendants('foo')
+ })
+ })
+
+ context('visible', () => {
+ beforeEach(function () {
+ this.$div = $('
div
').appendTo($('body'))
+ this.$div.is = function () {
+ throw new Error('is called')
+ }
+
+ this.$div2 = $('
div
').appendTo($('body'))
+ this.$div2.is = function () {
+ throw new Error('is called')
+ }
+ })
+
+ afterEach(function () {
+ this.$div.remove()
+
+ this.$div2.remove()
+ })
+
+ it('visible, not visible, adds to error', function () {
+ expect(this.$div).to.be.visible //# 1
+ expect(this.$div2).not.to.be.visible //# 2
+
+ expect(this.logs.length).to.eq(2)
+
+ const l1 = this.logs[0]
+ const l2 = this.logs[1]
+
+ expect(l1.get('message')).to.eq(
+ 'expected **
** to be **visible**'
+ )
+
+ expect(l2.get('message')).to.eq(
+ 'expected **
** not to be **visible**'
+ )
+
+ try {
+ expect(this.$div2).to.be.visible
+ } catch (err) {
+ const l6 = this.logs[5]
+
+ //# the error on this log should have this message appended to it
+ expect(l6.get('error').message).to.eq(
+ `\
+expected '
' to be 'visible'
+
+This element '
' is not visible because it has CSS property: 'display: none'\
+`
+ )
+ }
+ })
+
+ it('throws when obj is not DOM', function (done) {
+ cy.on('fail', (err) => {
+ expect(this.logs.length).to.eq(1)
+ expect(this.logs[0].get('error').message).to.eq(
+ 'expected {} to be \'visible\''
+ )
+
+ expect(err.message).to.include('> visible')
+ expect(err.message).to.include('> {}')
+
+ done()
+ })
+
+ expect({}).to.be.visible
+ })
+ })
+
+ context('hidden', () => {
+ beforeEach(function () {
+ this.$div = $('
div
').appendTo($('body'))
+ this.$div.is = function () {
+ throw new Error('is called')
+ }
+
+ this.$div2 = $('
div
').appendTo($('body'))
+ this.$div2.is = function () {
+ throw new Error('is called')
+ }
+ })
+
+ afterEach(function () {
+ this.$div.remove()
+
+ this.$div2.remove()
+ })
+
+ it('hidden, not hidden, adds to error', function () {
+ expect(this.$div).to.be.hidden //# 1
+ expect(this.$div2).not.to.be.hidden //# 2
+
+ expect(this.logs.length).to.eq(2)
+
+ const l1 = this.logs[0]
+ const l2 = this.logs[1]
+
+ expect(l1.get('message')).to.eq(
+ 'expected **
** to be **hidden**'
+ )
+
+ expect(l2.get('message')).to.eq(
+ 'expected **
** not to be **hidden**'
+ )
+
+ try {
+ expect(this.$div2).to.be.hidden
+ } catch (err) {
+ const l6 = this.logs[5]
+
+ //# the error on this log should have this message appended to it
+ expect(l6.get('error').message).to.eq('expected \'
\' to be \'hidden\'')
+ }
+ })
+
+ it('throws when obj is not DOM', function (done) {
+ cy.on('fail', (err) => {
+ expect(this.logs.length).to.eq(1)
+ expect(this.logs[0].get('error').message).to.eq(
+ 'expected {} to be \'hidden\''
+ )
+
+ expect(err.message).to.include('> hidden')
+ expect(err.message).to.include('> {}')
+
+ done()
+ })
+
+ expect({}).to.be.hidden
+ })
+ })
+
+ context('selected', () => {
+ beforeEach(function () {
+ this.$option = $('
')
+ this.$option.is = function () {
+ throw new Error('is called')
+ }
+
+ this.$option2 = $('
')
+ this.$option2.is = function () {
+ throw new Error('is called')
+ }
+ })
+
+ it('selected, not selected', function () {
+ expect(this.$option).to.be.selected //# 1
+ expect(this.$option2).not.to.be.selected //# 2
+
+ expect(this.logs.length).to.eq(2)
+
+ const l1 = this.logs[0]
+ const l2 = this.logs[1]
+
+ expect(l1.get('message')).to.eq(
+ 'expected **