Local storage management in Cypress - Test Execution Trace

Test Overview

This test checks if a web page correctly saves and retrieves data from the browser's local storage. It verifies that the stored value matches the expected value after setting it.

Test Code - Cypress

Cypress

describe('Local Storage Management Test', () => {
  it('should save and retrieve data from local storage', () => {
    cy.visit('https://example.cypress.io/commands/local-storage')
    cy.window().then((win) => {
      win.localStorage.setItem('myKey', 'myValue')
    })
    cy.window().its('localStorage').invoke('getItem', 'myKey').should('equal', 'myValue')
  })
})

Execution Trace - 4 Steps

Step	Action	System State	Assertion	Result
1	Test starts	Test runner initialized, no browser opened yet	—	PASS
2	Browser opens and navigates to 'https://example.cypress.io/commands/local-storage'	Page loads with local storage commands example	—	PASS
3	Access browser window object and set localStorage item 'myKey' to 'myValue'	Local storage now contains key 'myKey' with value 'myValue'	—	PASS
4	Retrieve localStorage item 'myKey' and assert it equals 'myValue'	Local storage item 'myKey' is 'myValue'	Assert localStorage.getItem('myKey') === 'myValue'	PASS

Failure Scenario

Failing Condition: Local storage key 'myKey' is missing or has a different value than 'myValue'

Execution Trace Quiz - 3 Questions

What does the test verify about local storage?

A That local storage is empty

B That local storage is cleared after page load

C That a specific key stores the expected value

D That local storage contains multiple keys

Key Result

Always verify local storage values explicitly after setting them to ensure your application stores data correctly.

Practice

1. What is the primary purpose of local storage in a web browser when testing with Cypress?

easy

A. To run JavaScript code on the server

B. To store small amounts of data persistently for a website

C. To style the webpage dynamically

D. To manage network requests

Solution

1. Step 1: Understand local storage role

   Local storage is used by browsers to save small data like user preferences or tokens persistently.

2. Step 2: Connect with Cypress testing

   Cypress can access this storage to verify or manipulate data during tests.

3. Final Answer:

   To store small amounts of data persistently for a website -> Option B

4. Quick Check:

   Local storage = persistent small data [OK]

Hint: Local storage saves small data for the site, not server tasks [OK]

Common Mistakes:

• Confusing local storage with server-side storage
• Thinking local storage runs code
• Mixing local storage with styling or network

2. Which Cypress command is used to access the browser's window object to manage local storage?

easy

A. cy.document()

B. cy.getLocalStorage()

C. cy.localStorage()

D. cy.window()

Solution

1. Step 1: Recall Cypress commands for browser objects

   To access the browser's window object, Cypress provides cy.window().

2. Step 2: Understand local storage access

   Local storage is a property of the window object, so cy.window() is used to reach it.

3. Final Answer:

   cy.window() -> Option D

4. Quick Check:

   Access window with cy.window() [OK]

Hint: Use cy.window() to reach local storage via window object [OK]

Common Mistakes:

• Using non-existent commands like cy.getLocalStorage()
• Confusing cy.document() with window object
• Assuming cy.localStorage() exists

3. What will be the output of the following Cypress code snippet?

cy.window().then(win => {
  win.localStorage.setItem('user', 'Alice');
  const user = win.localStorage.getItem('user');
  cy.wrap(user).should('equal', 'Alice');
});

medium

A. Test will fail due to syntax error in setItem usage

B. Test will fail because localStorage is not accessible

C. Test will pass because 'user' is set and retrieved correctly

D. Test will pass but 'user' will be undefined

Solution

1. Step 1: Analyze localStorage set and get

   The code sets 'user' key to 'Alice' in localStorage, then retrieves it correctly.

2. Step 2: Check assertion correctness

   The assertion checks if retrieved value equals 'Alice', which is true, so test passes.

3. Final Answer:

   Test will pass because 'user' is set and retrieved correctly -> Option C

4. Quick Check:

   Set and get localStorage works, test passes [OK]

Hint: Setting then getting localStorage key returns correct value [OK]

Common Mistakes:

• Assuming localStorage is inaccessible in Cypress
• Thinking setItem syntax is wrong
• Expecting undefined instead of stored value

4. Identify the error in this Cypress code that tries to clear local storage:

cy.window().then(win => {
  win.localStorage.clear;
});

medium

A. Missing parentheses to call clear method

B. localStorage.clear requires a key argument

C. cy.window() cannot access localStorage

D. clear is not a function of localStorage

Solution

1. Step 1: Check localStorage clear usage

   localStorage.clear is a function and must be called with parentheses: clear()

2. Step 2: Identify missing parentheses error

   The code uses clear without parentheses, so it does not execute the function.

3. Final Answer:

   Missing parentheses to call clear method -> Option A

4. Quick Check:

   Call clear() with parentheses to clear storage [OK]

Hint: Always add () to call localStorage.clear() method [OK]

Common Mistakes:

• Forgetting parentheses when calling functions
• Thinking clear needs a key argument
• Assuming cy.window() can't access localStorage

5. You want to write a Cypress test that saves a token in local storage, reloads the page, and then verifies the token is still present. Which sequence of commands correctly achieves this?

hard

A. cy.window().then(win => win.localStorage.setItem('token', 'abc123')); cy.reload(); cy.window().then(win => expect(win.localStorage.getItem('token')).to.equal('abc123'));

B. cy.setLocalStorage('token', 'abc123'); cy.reload(); cy.getLocalStorage('token').should('equal', 'abc123');

C. cy.window().then(win => win.localStorage.setItem('token', 'abc123')); cy.reload(); cy.window().its('localStorage.token').should('equal', 'abc123');

D. cy.window().then(win => win.localStorage.clear()); cy.reload(); cy.window().its('localStorage.token').should('be.null');

Solution

1. Step 1: Save token in localStorage correctly

   Using cy.window().then(win => win.localStorage.setItem('token', 'abc123')) correctly sets the token.

2. Step 2: Reload and verify token presence

   After cy.reload(), accessing localStorage via cy.window().then and asserting with expect ensures token is still 'abc123'.

3. Step 3: Evaluate other options

   cy.window().then(win => win.localStorage.setItem('token', 'abc123')); cy.reload(); cy.window().its('localStorage.token').should('equal', 'abc123'); uses incorrect property access for localStorage token; cy.setLocalStorage('token', 'abc123'); cy.reload(); cy.getLocalStorage('token').should('equal', 'abc123'); uses non-existent commands; cy.window().then(win => win.localStorage.clear()); cy.reload(); cy.window().its('localStorage.token').should('be.null'); clears storage and checks for null, which is not the goal.

4. Final Answer:

   Use cy.window() to set, reload, then check with expect -> Option A

5. Quick Check:

   Set, reload, then assert with cy.window() and expect [OK]

Hint: Set token, reload, then check with cy.window() and expect [OK]

Common Mistakes:

• Using wrong localStorage property access
• Using non-existent Cypress commands
• Clearing storage instead of verifying token