Support/Firefox Features/Clean up user profile/TestPlan

Clean up user profile

Feature	Status	Release Target	Dev Lead	QA Lead	Status
Clean up user profile	In development	Firefox 13	Matt Noorenberghe	Ioana Budnar	In progress

Summary

• This feature provides a way for users to automatically fix Firefox by creating a new profile and migrating their data.

• When the Reset Firefox command is invoked, Firefox will:
  • Confirm with the user what actions are about to be taken
  • Create a new user profile
  • Migrate the user data (bookmarks, history, saved passwords, autofill form/search data, extensions and themes)
  • Reset the toolbars and controls
  • Reset all the user preferences to Firefox defaults
  • Disable all the add-ons and switch to the default theme
  • Restart using the new profile.

• The feature can be accessed three different ways:
  • When the user attempts to re-install Firefox (same version is already installed), he is offered the option to reset Firefox. Note that the reset process is performed by Firefox, not by the installer.
  • After Firefox crashes three consecutive times at start-up, it will offer to either reset Firefox or to start in safe mode.
  • The user can open the Troubleshooting Information page (about:support) and click the Reset Firefox button.

• Since OS X and Linux don't have installers, there is no way to trigger this process for them upon re-installation. The rest of the cases are valid for them too.

References

• Feature Wiki page
• Preliminary Mockups:
  • Reset Firefox on re-installation
  • Webkit Reset Firefox after a crash
  • Reset Firefox from the Troubleshooting Information tab

Use Cases

• The user chooses to reset Firefox while re-installing it.
• After three consecutive start-up crashes, the user selects the option to reset Firefox.
• The user opens about:support, then clicks the Reset Firefox button.
• The reset process is started, then it gets cancelled.
• The user gathers a rich profile then he resets Firefox.
• Firefox is opened with a clean profile, then it gets reset.
• The user starts private browsing, then it resets Firefox.
• Firefox is opened in safe mode, then the user resets it.
• The user manually closes the Firefox process while it's being reset.
• The OS gets restarted while resetting Firefox.
• Firefox is reset multiple consecutive times.

Test Cases

• The test cases for this feature can be viewed here.

Important Bugs

• 273874 - Firefox migrator for new profiles
• 294260 - Safe Mode: Auto detect previous start-up failure and offer to start in safe mode
• 721265 - Firefox migrator: form history support
• 717070 - Create button to initiate migration to a clean Firefox profile
• 735126 - NS_ERROR_FAILURE from GetSelectedProfile if second profile added after non-default
• 721242 - After using Firefox migrator, the password manager sometimes can't decrypt passwords

Not Tested

• Clean Install

Sign off

Criteria

• All test cases were executed.
• All the major bugs have been fixed.

Sign offs

• Firefox 13.0 Aurora - 2012-03-19
  • UI from safe mode dialog and installer not implemented yet.