File upload (cy.selectFile) in Cypress - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is the purpose of cy.selectFile() in Cypress?

cy.selectFile() is used to simulate a user selecting a file for upload in a test. It helps automate file upload testing by programmatically choosing files.

beginner

How do you specify a file to upload using cy.selectFile()?

You provide the file path as a string or an object with file details inside cy.selectFile(). For example: cy.get('input[type=file]').selectFile('cypress/fixtures/sample.png').

intermediate

What option do you use with cy.selectFile() to simulate a drag-and-drop file upload?

Use the option { action: 'drag-drop' } to simulate dragging and dropping a file onto the target element.

intermediate

Why is it important to use fixtures for file upload tests in Cypress?

Fixtures store test files in a central place, making tests easier to maintain and share. Using fixtures ensures consistent file content and paths during tests.

intermediate

What assertion can you use to verify a file was uploaded successfully after using cy.selectFile()?

You can check the input element's files property or verify UI changes like file name display. For example: cy.get('input[type=file]').should('have.prop', 'files').and('have.length', 1).

Which command in Cypress is used to simulate file selection for upload?

A cy.chooseFile()

B cy.uploadFile()

C cy.fileUpload()

D cy.selectFile()

cy.selectFile() is the correct Cypress command to simulate file selection.

How do you simulate a drag-and-drop file upload with cy.selectFile()?

A Use <code>{ drag: true }</code> option

B Use <code>{ action: 'drag-drop' }</code> option

C Use <code>{ drop: true }</code> option

D Use <code>{ simulateDrag: true }</code> option

The option { action: 'drag-drop' } simulates drag-and-drop behavior.

Where should test files be stored for easy access in Cypress file upload tests?

A In the plugins folder

B In the support folder

C In the fixtures folder

D In the node_modules folder

Test files should be stored in the fixtures folder for easy access and maintenance.

What type of HTML element does cy.selectFile() usually target?

A <input type="file">

B <button>

C <textarea>

D <select>

cy.selectFile() targets file input elements (<input type="file">).

Which assertion checks that exactly one file was selected after upload?

A should('have.prop', 'files').and('have.length', 1)

B should('contain.text', '1 file')

C should('have.value', 'file1.txt')

D should('be.visible')

This assertion verifies the input's files property has exactly one file.

Explain how to use cy.selectFile() to upload a file in a Cypress test.

Think about selecting the file, how to specify it, and how to check it worked.

Describe why using fixtures is helpful for file upload testing in Cypress.

Consider how test files are managed and reused.

Practice

1. What is the primary purpose of cy.selectFile in Cypress testing?

easy

A. To simulate a user selecting a file for upload in a test

B. To download files from the server during a test

C. To delete files from the local system during a test

D. To open a file in the browser for viewing

Solution

1. Step 1: Understand the role of cy.selectFile

   This command is designed to simulate a user action of selecting a file in a file input element during automated tests.

2. Step 2: Compare options with this purpose

   Options B, C, and D describe actions unrelated to file selection for upload, such as downloading, deleting, or opening files, which cy.selectFile does not do.

3. Final Answer:

   To simulate a user selecting a file for upload in a test -> Option A

4. Quick Check:

   File selection = Simulate user upload [OK]

Hint: Remember: selectFile mimics user file selection [OK]

Common Mistakes:

• Confusing file upload with file download
• Thinking selectFile deletes files
• Assuming selectFile opens files in browser

2. Which of the following is the correct syntax to select a file named example.txt using cy.selectFile?

easy

A. cy.get('input[type=file]').selectFile('example.txt')

B. cy.get('input[type=file]').selectFile({ contents: 'example.txt' })

C. cy.get('input[type=file]').selectFile('file://example.txt')

D. cy.get('input[type=file]').selectFile('cypress/fixtures/example.txt')

Solution

1. Step 1: Understand file path usage in cy.selectFile

   The file path should point to the test fixture location, usually inside the cypress/fixtures folder.

2. Step 2: Evaluate each option's path

   cy.get('input[type=file]').selectFile('cypress/fixtures/example.txt') correctly uses the relative path to the fixture file. cy.get('input[type=file]').selectFile('example.txt') uses just the filename without path, which won't work. cy.get('input[type=file]').selectFile({ contents: 'example.txt' }) incorrectly uses an object with contents as string. cy.get('input[type=file]').selectFile('file://example.txt') uses an invalid file URI.

3. Final Answer:

   cy.get('input[type=file]').selectFile('cypress/fixtures/example.txt') -> Option D

4. Quick Check:

   Use fixture path for selectFile [OK]

Hint: Use fixture folder path for files in selectFile [OK]

Common Mistakes:

• Using only filename without path
• Passing file contents as string instead of path
• Using invalid file URI scheme

3. Given the following Cypress code snippet, what will be the result of the test?

cy.get('input[type=file]').selectFile('cypress/fixtures/photo.png')
  .should('have.prop', 'files').then(files => {
    expect(files[0].name).to.equal('photo.png')
  })

medium

A. The test will pass because the file name matches

B. The test will fail because the file input does not have files property

C. The test will throw a syntax error due to incorrect chaining

D. The test will pass but the file name will be undefined

Solution

1. Step 1: Understand selectFile and file input properties

   After selecting a file, the input element's files property contains the selected files. Accessing files[0].name should give the file name.

2. Step 2: Analyze the assertion

   The assertion checks if the first file's name equals 'photo.png', which matches the selected file. This is valid and should pass.

3. Final Answer:

   The test will pass because the file name matches -> Option A

4. Quick Check:

   File name check = Pass [OK]

Hint: Files property holds selected files; check name to verify [OK]

Common Mistakes:

• Assuming files property is missing
• Confusing syntax chaining in Cypress
• Expecting undefined file name

4. You wrote this Cypress test to upload a file but it fails:

cy.get('#fileInput').selectFile('example.pdf')

What is the most likely reason for the failure?

medium

A. The selector '#fileInput' is invalid syntax

B. The file path is incorrect or missing the fixture folder

C. selectFile cannot be used on input elements

D. The file must be uploaded manually, not via tests

Solution

1. Step 1: Check file path requirements for selectFile

   The file path must be relative to the cypress/fixtures folder or an absolute path. Just 'example.pdf' without path likely causes failure.

2. Step 2: Verify other options

   Selector syntax '#fileInput' is valid. selectFile works on input elements. Manual upload is not required in tests.

3. Final Answer:

   The file path is incorrect or missing the fixture folder -> Option B

4. Quick Check:

   File path must include fixture folder [OK]

Hint: Always include fixture folder in file path [OK]

Common Mistakes:

• Using filename without path
• Thinking selector syntax is wrong
• Believing selectFile can't upload files

5. You want to test uploading multiple files at once using cy.selectFile. Which code snippet correctly uploads two files named doc1.pdf and image1.png located in the fixtures folder?

hard

A. cy.get('input[type=file]').selectFile({ files: ['doc1.pdf', 'image1.png'] })

B. cy.get('input[type=file]').selectFile('cypress/fixtures/doc1.pdf, cypress/fixtures/image1.png')

C. cy.get('input[type=file]').selectFile(['cypress/fixtures/doc1.pdf', 'cypress/fixtures/image1.png'])

D. cy.get('input[type=file]').selectFile(['doc1.pdf', 'image1.png'])

Solution

1. Step 1: Understand multiple file upload syntax

   cy.selectFile accepts an array of file paths to upload multiple files. Each path must be relative to the fixtures folder or absolute.

2. Step 2: Evaluate each option

   cy.get('input[type=file]').selectFile(['cypress/fixtures/doc1.pdf', 'cypress/fixtures/image1.png']) correctly provides an array with full fixture paths. cy.get('input[type=file]').selectFile('cypress/fixtures/doc1.pdf, cypress/fixtures/image1.png') uses a single string with comma-separated paths, which is invalid. cy.get('input[type=file]').selectFile({ files: ['doc1.pdf', 'image1.png'] }) uses an object with files array but missing paths. cy.get('input[type=file]').selectFile(['doc1.pdf', 'image1.png']) uses array without fixture folder path, which will fail.

3. Final Answer:

   cy.get('input[type=file]').selectFile(['cypress/fixtures/doc1.pdf', 'cypress/fixtures/image1.png']) -> Option C

4. Quick Check:

   Array of fixture paths = Correct multiple upload [OK]

Hint: Use array of full fixture paths for multiple files [OK]

Common Mistakes:

• Passing comma-separated string instead of array
• Omitting fixture folder in paths
• Using object without correct file paths