Add-ons/Webextensions Cutover/Testplan
Revision History
Date | Version | Author | Description |
---|---|---|---|
05/01/2017 | 1.0 | Krupa Raj | Created first draft |
08/17/2017 | 1.1 | Vasilica Mihasca | Updates |
Contents
Overview
In 57, Firefox Desktop Release will only support installation of Webextensions. All legacy extensions will fail to install on all channels except for Nightly. Complete themes support will also cease after 57.
This feature will be implemented in two stages :
Stage 1:
All non-mpc add-ons will be disabled on Nightly by default. This is being tracked at Bug 1352204. Users will be able to enable these disabled add-ons by going to about:config and toggling the pref extensions.allow-non-mpc-extensions to set it to "true"
Stage 2:
This feature will land in 57 and will disable all legacy add-ons on firefox desktop release channel. Users will still be able to install legacy add-ons on Nightly after toggling "extensions.legacy.enabled" pref to true. Android will be unaffected and will continue to allow install of legacy extensions. Dictionaries and Language Packs should still work as always. Support for Complete Themes will fully cease in 57.
Purpose
This document purports to detail the test approach to the Webextensions Cutover including Entry/Exit criteria, Scope for testing, links to testcases etc
Entry Criteria
- QA has access to all the PRDs, mocks and related documents
- The feature has landed on Nightly
- AMO parts has landed on dev
Exit Criteria
- All the bugs against the feature have been triaged
- All the P1/P2 bugs have been fixed
- All the resolved bugs have been verified by QA
- The find/fixed rate is going down over a predefined period of time
Acceptance Criteria
This section broadly outlines when the product is ready to ship
- QA has signed off
- All the required Telemetry is in place
- All info is localized at least for a pre-defined set of locales
- All the necessary PR/blogposts have been sent out
Scope
This section describes what parts of the feature will be tested and what parts won't be.
what's in scope?
The compat table listed below should provide all the permutations supported by Firefox and which will in turn get tested before release.
Compat. Table
The table below shows what is installable where when 57 hits the Firefox release channel. NOTE that for a while when 57 is in the Nightly channel, with the pref enabled - install of legacy extensions will fail on Nightly but will be supported on beta and release.
Type | Status | Nightly | Beta, Release |
---|---|---|---|
WebExtension | Signed by AMO | YES | YES |
Signed by Mozilla internally | YES | YES | |
Unsigned | YES with pref | NO | |
Unsigned loaded temporarily | YES | YES | |
Legacy Extension (bootstrapped, overlay, XUL etc) | Signed by AMO | YES with pref | NO |
Signed by Mozilla internally | YES | YES | |
Unsigned | YES with pref | NO | |
Unsigned loaded temporarily | YES | NO | |
WebExtension Experiment | Signed by AMO | YES | NO |
Signed by Mozilla internally | YES | YES | |
Unsigned | YES with pref | NO | |
Unsigned loaded temporarily | YES | NO | |
New style static theme | Signed by AMO | YES | YES |
Signed by Mozilla internally | YES | YES | |
Unsigned | YES | YES | |
Unsigned loaded temporarily | YES | YES | |
Telemetry Experiments | Signed by AMO | YES | YES |
Signed by Mozilla internally | YES | YES | |
Unsigned | YES with pref | YES | |
Unsigned loaded temporarily | YES | YES | |
Legacy lightweight theme | Signed by AMO | YES | YES |
Complete Themes | Any combination | YES with pref | NO |
Multiple item package | Any combination | NO | NO |
Language Pack | Any combination | YES | YES |
Dictionaries | Any combination | YES | YES |
AMO
Awaiting changelist from jorgev
Other
The other things will also get tested is
- Reverting to an older version of Firefox
- Switching channels across the same profile
- Full regression testing for Android
what's out of scope?
- Security testing
- Performance testing
- Testing for ESR
Ownership
Dev Lead: Andrew Swan; irc nick :aswan
QA Manager: Krupa Raj; irc nick :krupa
QA Lead: Victor Carciu; irc nick :victorc
Webextensions QA: Vasilica Mihasca; irc nick :vasilica_mihasca
Add-ons QA: Valentina Peleski; irc nick :ValentinaV
Requirements for testing
Environments
OSes covered: Windows, MacOSX, Linux
Channel dependent settings (configs) and environment setups
Nightly
- Stage 1: Set extensions.allow-non-mpc-extensions to false from about:config.
- Stage 2: Set extensions.legacy.enabled to false from about:config.
- Starting with 2017-08-12 this feature will be enabled by default.
- Disable check for signing if testing on AMO dev or stage
Beta
- The feature is enabled by default.
- [Unbranded build] Disable check for signing if testing on AMO dev or stage
Post Beta / Release
The feature is enabled by default.
Test Strategy
Test Objectives
This section details the progression test objectives that will be covered. Please note that this is at a high level. For large projects, a suite of test cases would be created which would reference directly back to this master. This could be documented in bullet form or in a table similar to the one below.
Ref | Function | Test Objective | Test Type | Owners |
---|---|---|---|---|
TO-1 | Installing from AMO | To verify that legacy add-ons installation is successfully blocked | Manual | Add-ons QA Team |
TO-2 | Installing from Discopane | To verify that legacy add-ons installation is successfully blocked | Manual | Add-ons QA Team |
TO-3 | Installing from Add-ons manager | To verify that legacy add-ons installation is successfully blocked | Manual | Add-ons QA Team |
TO-4 | Installing via sideloading | To verify that legacy add-ons installation is successfully blocked | Manual | Add-ons QA Team |
TO-5 | Installing from local files | To verify that legacy add-ons installation is successfully blocked | Manual | Add-ons QA Team |
TO-6 | Installing from thirdparty | To verify that legacy add-ons installation is successfully blocked | Manual | Add-ons QA Team |
TO-7 | Add-on updates | To verify that legacy add-on is successfully updated to a webextension version | Manual | Add-ons QA Team |
TO-8 | Browser upgrade | To verify that legacy add-on are successfully disabled and displayed in Legacy Extensions tab | Manual | Add-ons QA Team |
TO-9 | Browser downgrade | To verify that legacy add-on are successfully enabled and functional | Manual | Add-ons QA Team |
Builds
This section should contain links for builds with the feature -
- Nightly builds
- Beta builds
- Beta Unbranded builds:
- Release builds
- Release Unbranded builds:
Test Execution Schedule
The following table identifies the anticipated testing period available for test execution.
Project phase | Start Date | End Date |
---|---|---|
Start project | ||
Study documentation/specs received from developers | ||
QA - Test plan creation | 01-05-2017 | |
QA - Test cases/Env preparation | 01-09-2017 | |
QA - Nightly Testing | 14-06-2017 | |
QA - Beta Testing | ||
Release Date |
Testing Tools
Detail the tools to be used for testing, for example see the following table:
Process | Tool |
---|---|
Test plan creation | Mozilla wiki |
Test case creation | TestRail / Google docs / etherpad |
Test case execution | TestRail |
Bugs management | Bugzilla / Github |
Status
Overview
Track the dates and build number where feature was released to Nightly Track the dates and build number where feature was merged to Aurora Track the dates and build number where feature was merged to Release/Beta
Risk analysis
This section identified high-risk areas related to testing-
- Users reverting to an older version of Firefox: Users trying to work around the restrictions may see unexpected regressions related to <bug number>
- Mitigation strategy: Reverting to an older version/ESR builds will be tested as part of the end-to-end testing of this feature.
- Switching channels using the same profile may result in unexpected behavior.
References
* List and links for specs wiki - https://wiki.mozilla.org/Add-ons/Firefox57
* bug 1352204 - Only allow webextension and MPC=true (which=no shims) add-ons on Nightly
ID | Priority | Component | Assigned to | Summary | Status | Target milestone |
---|---|---|---|---|---|---|
1356027 | -- | Add-ons Manager | Andrew Swan [:aswan] | Add pref that disables loading any extensions without MPC=true | RESOLVED | mozilla55 |
1356462 | -- | Add-ons Manager | Andrew Swan [:aswan] | about:addons indications for disabled non-MPC extensions | RESOLVED | mozilla55 |
1358620 | P1 | Add-ons Manager | Andrew Swan [:aswan] | Add telemetry for non-MPC extensions | RESOLVED | mozilla55 |
1359476 | P1 | Add-ons Manager | Andrew Swan [:aswan] | Dictionaries are getting disabled as not multi process compatible | VERIFIED | mozilla55 |
1360169 | -- | Add-ons Manager | Incorrect error message for ZoomFox add-on in about:addons | RESOLVED | --- | |
1360172 | -- | Add-ons Manager | Multiprocess Compatible error displayed for all add-ons and webextensions from about:addons search list | RESOLVED | --- | |
1360687 | -- | Marionette | Henrik Skupin [:whimboo][⌚️UTC+1] | Update puppeteer notification class for webextension | RESOLVED | mozilla56 |
7 Total; 0 Open (0%); 6 Resolved (85.71%); 1 Verified (14.29%);
* bug 1360777 - about:addons indications for disabled legacy extensions
26 Total; 0 Open (0%); 16 Resolved (61.54%); 10 Verified (38.46%);
* bug 1335456 - (tracking) Path to 57
ID | Priority | Component | Assigned to | Summary | Status | Target milestone |
---|---|---|---|---|---|---|
1181835 | P2 | Extension Compatibility | emanuela [ux] | Provide a UI for migrating users' add-ons to webextensions | RESOLVED | --- |
1214433 | P4 | Untriaged | [Tracking] Web Extensions Development | RESOLVED | --- | |
1281274 | -- | Extension Compatibility | Deployment Tracker bug - e10s-addons | RESOLVED | --- | |
1329713 | P5 | General | [meta] Webextensions Development | RESOLVED | --- | |
1336576 | P1 | Add-ons Manager | [meta] Limit add-ons loaded into Firefox | RESOLVED | --- | |
1341333 | -- | Extension Compatibility | Compatibility with Firefox updates | RESOLVED | --- | |
1346460 | P1 | Extension Compatibility | [meta] Transition support for legacy devs and porting support for Chrome devs | RESOLVED | --- | |
1354344 | P3 | Preferences | Mark Striemer [:mstriemer] | Show if an extension has set the home page | RESOLVED | mozilla57 |
1385202 | -- | Menus | Need a way to manage context menu items. | RESOLVED | --- |
9 Total; 0 Open (0%); 9 Resolved (100%); 0 Verified (0%);
Testcases
Overview
Summary of testing scenarios
Test Areas
Test Areas | Covered | Details |
---|---|---|
Installation from AMO | ||
Installation from Discopane | ||
Installation from Add-ons Manager | ||
Installation from Third-party | ||
Add-on updates | ||
Sideloading | ||
Other |
Test suite
- Link for the Initial test planning
- Link for the Google doc tests
- Link for the TestRail tests
Bug Work
Tracking bug - bug 1360777
Bug fix verification
[Verified] Bug 1308309 - Display permissions prompt for webextensions installed using mozAddonManager
- ↳ 2017-01-10: verified fixed on 53.0a1 across platforms
[Verified] Bug 1308295 - Prompt users with permissions for third-party webextensions installs
- ↳ 2015-04-21: verified fixed on 53.0a1 across platforms
Logged bugs
Bug 1329942 - Misaligned icon and webextension name in permissions doorhanger
Sign off
Criteria
Check list
- All test cases should be executed
- Has sufficient automated test coverage (as measured by code coverage tools) - coordinate with RelMan
- All blockers, criticals must be fixed and verified or have an agreed-upon timeline for being fixed (as determined by engineering/RelMan/QA)
Results
Nightly testing
List of OSes that will be covered by testing
- Link for the tests run
- Full Test suite, use template from link
Merge to Aurora Sign-off
List of OSes that will be covered by testing
- Link for the tests run
- Full Test suite
Checklist
Exit Criteria | Status | Notes/Details |
---|---|---|
Testing Prerequisites (specs, use cases) | ||
Testing Infrastructure setup | ||
Test Plan Creation | ||
Test Cases Creation | ||
Full Functional Tests Execution | ||
Automation Coverage | ||
Performance Testing | ||
All Defects Logged | ||
Critical/Blockers Fixed and Verified | ||
Metrics/Telemetry | ||
QA Signoff - Nightly Release | Email to be sent | |
QA Aurora - Full Testing | ||
QA Signoff - Aurora Release | Email to be sent | |
QA Beta - Full Testing | ||
QA Signoff - Beta Release | Email to be sent |