add list fixture specs (#710)

* add list fixture specs

* add array assertion

* update expected filename

examples/fundamentals__fixtures/README.md

@@ -6,5 +6,6 @@ You can load fixture data using the [`cy.fixture()`](https://on.cypress.io/fixtu
 - Load multiple files using closures in [multiple-fixtures-spec.js](cypress/integration/multiple-fixtures-spec.js)
 - Load multiple files once or before each test in [load-fixtures-spec.js](cypress/integration/load-fixtures-spec.js)
 - Require multiple JSON fixtures in [require-fixtures-spec.js](cypress/integration/require-fixtures-spec.js)
+- Iterate over a list loaded from a JSON fixture in [list-spec.js](cypress/integration/list-spec.js)
 
 For more examples see the "Fixtures" section in the [Cypress Testing Workshop](https://github.com/cypress-io/testing-workshop-cypress).

examples/fundamentals__fixtures/cypress/fixtures/users.json

@@ -0,0 +1,14 @@
+[
+  {
+    "name": "Joe Bravo",
+    "age": 20
+  },
+  {
+    "name": "Mike Smith",
+    "age": 30
+  },
+  {
+    "name": "Alicia Blue",
+    "age": 25
+  }
+]

examples/fundamentals__fixtures/cypress/integration/list-spec.js

@@ -0,0 +1,25 @@
+/// <reference types="cypress" />
+const allUsers = require('../fixtures/users.json')
+
+describe('array fixture', () => {
+  it('iterates over a list', () => {
+    cy.fixture('users').then((users) => {
+      expect(users).to.be.an('array').and.to.have.have.length(3)
+
+      users.forEach((user) => {
+        expect(user).to.have.keys(['name', 'age'])
+        expect(user.age).to.be.a('number').and.be.gt(10).and.be.lt(100)
+      })
+    })
+  })
+
+  // we can dynamically create tests from a static JSON list
+  // that we have loaded using "require" or "import" statement
+  // for more examples, see "Dynamic tests" recipes
+  allUsers.forEach((user) => {
+    it(`has user ${user.name}`, () => {
+      cy.wrap(user).should('have.property', 'name', user.name)
+      cy.wrap(user).should('have.property', 'age', user.age)
+    })
+  })
+})

examples/fundamentals__fixtures/cypress/integration/require-fixtures-spec.js

@@ -5,19 +5,6 @@
 const city = require('../fixtures/city.json')
 const country = require('../fixtures/country.json')
 
-// bundled "os" module does not have the right EOL
-// thus we need to set it based on the platform ourself
-const EOL = Cypress.platform === 'win32' ? '\\' : '/'
-
-/**
- * Joins parts of the file path using the EOL
- * @example
- *  join('cypress', 'integration')
- *    // "cypress/integration" on non-Windows
- *    // "cypress\integration" on Windows
-*/
-const join = (...paths) => paths.join(EOL)
-
 describe('requires fixtures', () => {
   it('has city', () => {
     expect(city).to.deep.equal({ name: 'Atlanta' })
@@ -26,22 +13,4 @@ describe('requires fixtures', () => {
   it('has country', () => {
     expect(country).to.deep.equal({ name: 'United States' })
   })
-
-  context('sanity JavaScript tests', () => {
-    // confirm that the spec information is present
-
-    it('has __dirname', () => {
-      expect(__dirname).to.be.a('string')
-      // on Windows OS the directory is "cypress\integration"
-      // on other operating systems it is "cypress/integration"
-      expect(__dirname).to.equal(join('cypress', 'integration'))
-    })
-
-    it('has __filename', () => {
-      expect(__filename).to.be.a('string')
-      expect(__filename).to.equal(
-        join('cypress', 'integration', 'require-fixtures-spec.js')
-      )
-    })
-  })
 })

examples/fundamentals__fixtures/cypress/integration/sanity-js-spec.js

@@ -0,0 +1,32 @@
+/// <reference types="cypress" />
+
+// bundled "os" module does not have the right EOL
+// thus we need to set it based on the platform ourself
+const EOL = Cypress.platform === 'win32' ? '\\' : '/'
+
+/**
+ * Joins parts of the file path using the EOL
+ * @example
+ *  join('cypress', 'integration')
+ *    // "cypress/integration" on non-Windows
+ *    // "cypress\integration" on Windows
+*/
+const join = (...paths) => paths.join(EOL)
+
+describe('sanity JavaScript tests', () => {
+  // confirm that the spec information is present
+
+  it('has __dirname', () => {
+    expect(__dirname).to.be.a('string')
+    // on Windows OS the directory is "cypress\integration"
+    // on other operating systems it is "cypress/integration"
+    expect(__dirname).to.equal(join('cypress', 'integration'))
+  })
+
+  it('has __filename', () => {
+    expect(__filename).to.be.a('string')
+    expect(__filename).to.equal(
+      join('cypress', 'integration', 'sanity-js-spec.js')
+    )
+  })
+})