michael@0: /* Any copyright is dedicated to the Public Domain.
michael@0:  * http://creativecommons.org/publicdomain/zero/1.0/
michael@0:  */
michael@0: 
michael@0: // This verifies that add-on update checks work
michael@0: 
michael@0: const PREF_MATCH_OS_LOCALE = "intl.locale.matchOS";
michael@0: const PREF_SELECTED_LOCALE = "general.useragent.locale";
michael@0: const PREF_GETADDONS_CACHE_ENABLED = "extensions.getAddons.cache.enabled";
michael@0: 
michael@0: // The test extension uses an insecure update url.
michael@0: Services.prefs.setBoolPref("extensions.checkUpdateSecurity", false);
michael@0: // This test requires lightweight themes update to be enabled even if the app
michael@0: // doesn't support lightweight themes.
michael@0: Services.prefs.setBoolPref("lightweightThemes.update.enabled", true);
michael@0: 
michael@0: Components.utils.import("resource://gre/modules/LightweightThemeManager.jsm");
michael@0: 
michael@0: const PARAMS = "?%REQ_VERSION%/%ITEM_ID%/%ITEM_VERSION%/%ITEM_MAXAPPVERSION%/" +
michael@0:                "%ITEM_STATUS%/%APP_ID%/%APP_VERSION%/%CURRENT_APP_VERSION%/" +
michael@0:                "%APP_OS%/%APP_ABI%/%APP_LOCALE%/%UPDATE_TYPE%";
michael@0: 
michael@0: var gInstallDate;
michael@0: 
michael@0: Components.utils.import("resource://testing-common/httpd.js");
michael@0: var testserver = new HttpServer();
michael@0: testserver.start(-1);
michael@0: gPort = testserver.identity.primaryPort;
michael@0: mapFile("/data/test_update.rdf", testserver);
michael@0: mapFile("/data/test_update.xml", testserver);
michael@0: testserver.registerDirectory("/addons/", do_get_file("addons"));
michael@0: 
michael@0: const profileDir = gProfD.clone();
michael@0: profileDir.append("extensions");
michael@0: 
michael@0: function run_test() {
michael@0:   createAppInfo("xpcshell@tests.mozilla.org", "XPCShell", "1", "1.9.2");
michael@0:   Services.prefs.setBoolPref(PREF_MATCH_OS_LOCALE, false);
michael@0:   Services.prefs.setCharPref(PREF_SELECTED_LOCALE, "fr-FR");
michael@0:   Services.prefs.setBoolPref(PREF_EM_STRICT_COMPATIBILITY, true);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon1@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 1",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon2@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "0",
michael@0:       maxVersion: "0"
michael@0:     }],
michael@0:     name: "Test Addon 2",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon3@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "5",
michael@0:       maxVersion: "5"
michael@0:     }],
michael@0:     name: "Test Addon 3",
michael@0:   }, profileDir);
michael@0: 
michael@0:   startupManager();
michael@0: 
michael@0:   do_test_pending();
michael@0:   run_test_1();
michael@0: }
michael@0: 
michael@0: function end_test() {
michael@0:   Services.prefs.clearUserPref(PREF_EM_STRICT_COMPATIBILITY);
michael@0: 
michael@0:   testserver.stop(do_test_finished);
michael@0: }
michael@0: 
michael@0: // Verify that an update is available and can be installed.
michael@0: function run_test_1() {
michael@0:   AddonManager.getAddonByID("addon1@tests.mozilla.org", function(a1) {
michael@0:     do_check_neq(a1, null);
michael@0:     do_check_eq(a1.version, "1.0");
michael@0:     do_check_eq(a1.applyBackgroundUpdates, AddonManager.AUTOUPDATE_DEFAULT);
michael@0:     do_check_eq(a1.releaseNotesURI, null);
michael@0: 
michael@0:     a1.applyBackgroundUpdates = AddonManager.AUTOUPDATE_DEFAULT;
michael@0: 
michael@0:     prepare_test({
michael@0:       "addon1@tests.mozilla.org": [
michael@0:         ["onPropertyChanged", ["applyBackgroundUpdates"]]
michael@0:       ]
michael@0:     });
michael@0:     a1.applyBackgroundUpdates = AddonManager.AUTOUPDATE_DISABLE;
michael@0:     check_test_completed();
michael@0: 
michael@0:     a1.applyBackgroundUpdates = AddonManager.AUTOUPDATE_DISABLE;
michael@0: 
michael@0:     prepare_test({}, [
michael@0:       "onNewInstall",
michael@0:     ]);
michael@0: 
michael@0:     a1.findUpdates({
michael@0:       onNoCompatibilityUpdateAvailable: function(addon) {
michael@0:         do_throw("Should not have seen onNoCompatibilityUpdateAvailable notification");
michael@0:       },
michael@0: 
michael@0:       onUpdateAvailable: function(addon, install) {
michael@0:         ensure_test_completed();
michael@0: 
michael@0:         AddonManager.getAllInstalls(function(aInstalls) {
michael@0:           do_check_eq(aInstalls.length, 1);
michael@0:           do_check_eq(aInstalls[0], install);
michael@0: 
michael@0:           do_check_eq(addon, a1);
michael@0:           do_check_eq(install.name, addon.name);
michael@0:           do_check_eq(install.version, "2.0");
michael@0:           do_check_eq(install.state, AddonManager.STATE_AVAILABLE);
michael@0:           do_check_eq(install.existingAddon, addon);
michael@0:           do_check_eq(install.releaseNotesURI.spec, "http://example.com/updateInfo.xhtml");
michael@0: 
michael@0:           // Verify that another update check returns the same AddonInstall
michael@0:           a1.findUpdates({
michael@0:             onNoCompatibilityUpdateAvailable: function(addon) {
michael@0:               do_throw("Should not have seen onNoCompatibilityUpdateAvailable notification");
michael@0:             },
michael@0: 
michael@0:             onUpdateAvailable: function(newAddon, newInstall) {
michael@0:               AddonManager.getAllInstalls(function(aInstalls) {
michael@0:                 do_check_eq(aInstalls.length, 1);
michael@0:                 do_check_eq(aInstalls[0], install);
michael@0:                 do_check_eq(newAddon, addon);
michael@0:                 do_check_eq(newInstall, install);
michael@0: 
michael@0:                 prepare_test({}, [
michael@0:                   "onDownloadStarted",
michael@0:                   "onDownloadEnded",
michael@0:                 ], check_test_1);
michael@0:                 install.install();
michael@0:               });
michael@0:             },
michael@0: 
michael@0:             onNoUpdateAvailable: function(addon) {
michael@0:               do_throw("Should not have seen onNoUpdateAvailable notification");
michael@0:             }
michael@0:           }, AddonManager.UPDATE_WHEN_USER_REQUESTED);
michael@0:         });
michael@0:       },
michael@0: 
michael@0:       onNoUpdateAvailable: function(addon) {
michael@0:         do_throw("Should not have seen onNoUpdateAvailable notification");
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_USER_REQUESTED);
michael@0:   });
michael@0: }
michael@0: 
michael@0: function check_test_1(install) {
michael@0:   ensure_test_completed();
michael@0:   do_check_eq(install.state, AddonManager.STATE_DOWNLOADED);
michael@0:   run_test_2(install);
michael@0:   return false;
michael@0: }
michael@0: 
michael@0: // Continue installing the update.
michael@0: function run_test_2(install) {
michael@0:   // Verify that another update check returns no new update
michael@0:   install.existingAddon.findUpdates({
michael@0:     onNoCompatibilityUpdateAvailable: function(addon) {
michael@0:       do_throw("Should not have seen onNoCompatibilityUpdateAvailable notification");
michael@0:     },
michael@0: 
michael@0:     onUpdateAvailable: function(addon, install) {
michael@0:       do_throw("Should find no available update when one is already downloading");
michael@0:     },
michael@0: 
michael@0:     onNoUpdateAvailable: function(addon) {
michael@0:       AddonManager.getAllInstalls(function(aInstalls) {
michael@0:         do_check_eq(aInstalls.length, 1);
michael@0:         do_check_eq(aInstalls[0], install);
michael@0: 
michael@0:         prepare_test({
michael@0:           "addon1@tests.mozilla.org": [
michael@0:             "onInstalling"
michael@0:           ]
michael@0:         }, [
michael@0:           "onInstallStarted",
michael@0:           "onInstallEnded",
michael@0:         ], check_test_2);
michael@0:         install.install();
michael@0:       });
michael@0:     }
michael@0:   }, AddonManager.UPDATE_WHEN_USER_REQUESTED);
michael@0: }
michael@0: 
michael@0: function check_test_2() {
michael@0:   ensure_test_completed();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon1@tests.mozilla.org", callback_soon(function(olda1) {
michael@0:     do_check_neq(olda1, null);
michael@0:     do_check_eq(olda1.version, "1.0");
michael@0:     do_check_true(isExtensionInAddonsList(profileDir, olda1.id));
michael@0: 
michael@0:     shutdownManager();
michael@0: 
michael@0:     startupManager();
michael@0: 
michael@0:     do_check_true(isExtensionInAddonsList(profileDir, olda1.id));
michael@0: 
michael@0:     AddonManager.getAddonByID("addon1@tests.mozilla.org", function(a1) {
michael@0:       do_check_neq(a1, null);
michael@0:       do_check_eq(a1.version, "2.0");
michael@0:       do_check_true(isExtensionInAddonsList(profileDir, a1.id));
michael@0:       do_check_eq(a1.applyBackgroundUpdates, AddonManager.AUTOUPDATE_DISABLE);
michael@0:       do_check_eq(a1.releaseNotesURI.spec, "http://example.com/updateInfo.xhtml");
michael@0: 
michael@0:       a1.uninstall();
michael@0:       do_execute_soon(run_test_3);
michael@0:     });
michael@0:   }));
michael@0: }
michael@0: 
michael@0: 
michael@0: // Check that an update check finds compatibility updates and applies them
michael@0: function run_test_3() {
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon2@tests.mozilla.org", function(a2) {
michael@0:     do_check_neq(a2, null);
michael@0:     do_check_false(a2.isActive);
michael@0:     do_check_false(a2.isCompatible);
michael@0:     do_check_true(a2.appDisabled);
michael@0:     do_check_true(a2.isCompatibleWith("0"));
michael@0: 
michael@0:     a2.findUpdates({
michael@0:       onCompatibilityUpdateAvailable: function(addon) {
michael@0:         do_check_true(a2.isCompatible);
michael@0:         do_check_false(a2.appDisabled);
michael@0:         do_check_false(a2.isActive);
michael@0:       },
michael@0: 
michael@0:       onUpdateAvailable: function(addon, install) {
michael@0:         do_throw("Should not have seen an available update");
michael@0:       },
michael@0: 
michael@0:       onNoUpdateAvailable: function(addon) {
michael@0:         do_check_eq(addon, a2);
michael@0:         do_execute_soon(check_test_3);
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_USER_REQUESTED);
michael@0:   });
michael@0: }
michael@0: 
michael@0: function check_test_3() {
michael@0:   restartManager();
michael@0:   AddonManager.getAddonByID("addon2@tests.mozilla.org", function(a2) {
michael@0:     do_check_neq(a2, null);
michael@0:     do_check_true(a2.isActive);
michael@0:     do_check_true(a2.isCompatible);
michael@0:     do_check_false(a2.appDisabled);
michael@0:     a2.uninstall();
michael@0: 
michael@0:     run_test_4();
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Checks that we see no compatibility information when there is none.
michael@0: function run_test_4() {
michael@0:   AddonManager.getAddonByID("addon3@tests.mozilla.org", function(a3) {
michael@0:     do_check_neq(a3, null);
michael@0:     do_check_false(a3.isActive);
michael@0:     do_check_false(a3.isCompatible);
michael@0:     do_check_true(a3.appDisabled);
michael@0:     do_check_true(a3.isCompatibleWith("5"));
michael@0:     do_check_false(a3.isCompatibleWith("2"));
michael@0: 
michael@0:     a3.findUpdates({
michael@0:       sawUpdate: false,
michael@0:       onCompatibilityUpdateAvailable: function(addon) {
michael@0:         do_throw("Should not have seen compatibility information");
michael@0:       },
michael@0: 
michael@0:       onNoCompatibilityUpdateAvailable: function(addon) {
michael@0:         this.sawUpdate = true;
michael@0:       },
michael@0: 
michael@0:       onUpdateAvailable: function(addon, install) {
michael@0:         do_throw("Should not have seen an available update");
michael@0:       },
michael@0: 
michael@0:       onNoUpdateAvailable: function(addon) {
michael@0:         do_check_true(this.sawUpdate);
michael@0:         run_test_5();
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_USER_REQUESTED);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Checks that compatibility info for future apps are detected but don't make
michael@0: // the item compatibile.
michael@0: function run_test_5() {
michael@0:   AddonManager.getAddonByID("addon3@tests.mozilla.org", function(a3) {
michael@0:     do_check_neq(a3, null);
michael@0:     do_check_false(a3.isActive);
michael@0:     do_check_false(a3.isCompatible);
michael@0:     do_check_true(a3.appDisabled);
michael@0:     do_check_true(a3.isCompatibleWith("5"));
michael@0:     do_check_false(a3.isCompatibleWith("2"));
michael@0: 
michael@0:     a3.findUpdates({
michael@0:       sawUpdate: false,
michael@0:       onCompatibilityUpdateAvailable: function(addon) {
michael@0:         do_check_false(a3.isCompatible);
michael@0:         do_check_true(a3.appDisabled);
michael@0:         do_check_false(a3.isActive);
michael@0:         this.sawUpdate = true;
michael@0:       },
michael@0: 
michael@0:       onNoCompatibilityUpdateAvailable: function(addon) {
michael@0:         do_throw("Should have seen some compatibility information");
michael@0:       },
michael@0: 
michael@0:       onUpdateAvailable: function(addon, install) {
michael@0:         do_throw("Should not have seen an available update");
michael@0:       },
michael@0: 
michael@0:       onNoUpdateAvailable: function(addon) {
michael@0:         do_check_true(this.sawUpdate);
michael@0:         do_execute_soon(check_test_5);
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_USER_REQUESTED, "3.0");
michael@0:   });
michael@0: }
michael@0: 
michael@0: function check_test_5() {
michael@0:   restartManager();
michael@0:   AddonManager.getAddonByID("addon3@tests.mozilla.org", function(a3) {
michael@0:     do_check_neq(a3, null);
michael@0:     do_check_false(a3.isActive);
michael@0:     do_check_false(a3.isCompatible);
michael@0:     do_check_true(a3.appDisabled);
michael@0: 
michael@0:     a3.uninstall();
michael@0:     do_execute_soon(run_test_6);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Test that background update checks work
michael@0: function run_test_6() {
michael@0:   restartManager();
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon1@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 1",
michael@0:   }, profileDir);
michael@0:   restartManager();
michael@0: 
michael@0:   prepare_test({}, [
michael@0:     "onNewInstall",
michael@0:     "onDownloadStarted",
michael@0:     "onDownloadEnded"
michael@0:   ], continue_test_6);
michael@0: 
michael@0:   // Fake a timer event to cause a background update and wait for the magic to
michael@0:   // happen
michael@0:   gInternalManager.notify(null);
michael@0: }
michael@0: 
michael@0: function continue_test_6(install) {
michael@0:   do_check_neq(install.existingAddon, null);
michael@0:   do_check_eq(install.existingAddon.id, "addon1@tests.mozilla.org");
michael@0: 
michael@0:   prepare_test({
michael@0:     "addon1@tests.mozilla.org": [
michael@0:       "onInstalling"
michael@0:     ]
michael@0:   }, [
michael@0:     "onInstallStarted",
michael@0:     "onInstallEnded",
michael@0:   ], callback_soon(check_test_6));
michael@0: }
michael@0: 
michael@0: function check_test_6(install) {
michael@0:   do_check_eq(install.existingAddon.pendingUpgrade.install, install);
michael@0: 
michael@0:   restartManager();
michael@0:   AddonManager.getAddonByID("addon1@tests.mozilla.org", function(a1) {
michael@0:     do_check_neq(a1, null);
michael@0:     do_check_eq(a1.version, "2.0");
michael@0:     do_check_eq(a1.releaseNotesURI.spec, "http://example.com/updateInfo.xhtml");
michael@0:     a1.uninstall();
michael@0:     do_execute_soon(run_test_7);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Test that background update checks work for lightweight themes
michael@0: function run_test_7() {
michael@0:   restartManager();
michael@0: 
michael@0:   LightweightThemeManager.currentTheme = {
michael@0:     id: "1",
michael@0:     version: "1",
michael@0:     name: "Test LW Theme",
michael@0:     description: "A test theme",
michael@0:     author: "Mozilla",
michael@0:     homepageURL: "http://localhost:" + gPort + "/data/index.html",
michael@0:     headerURL: "http://localhost:" + gPort + "/data/header.png",
michael@0:     footerURL: "http://localhost:" + gPort + "/data/footer.png",
michael@0:     previewURL: "http://localhost:" + gPort + "/data/preview.png",
michael@0:     iconURL: "http://localhost:" + gPort + "/data/icon.png",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/lwtheme.js"
michael@0:   };
michael@0: 
michael@0:   // XXX The lightweight theme manager strips non-https updateURLs so hack it
michael@0:   // back in.
michael@0:   let themes = JSON.parse(Services.prefs.getCharPref("lightweightThemes.usedThemes"));
michael@0:   do_check_eq(themes.length, 1);
michael@0:   themes[0].updateURL = "http://localhost:" + gPort + "/data/lwtheme.js";
michael@0:   Services.prefs.setCharPref("lightweightThemes.usedThemes", JSON.stringify(themes));
michael@0: 
michael@0:   testserver.registerPathHandler("/data/lwtheme.js", function(request, response) {
michael@0:     response.write(JSON.stringify({
michael@0:       id: "1",
michael@0:       version: "2",
michael@0:       name: "Updated Theme",
michael@0:       description: "A test theme",
michael@0:       author: "Mozilla",
michael@0:       homepageURL: "http://localhost:" + gPort + "/data/index2.html",
michael@0:       headerURL: "http://localhost:" + gPort + "/data/header.png",
michael@0:       footerURL: "http://localhost:" + gPort + "/data/footer.png",
michael@0:       previewURL: "http://localhost:" + gPort + "/data/preview.png",
michael@0:       iconURL: "http://localhost:" + gPort + "/data/icon2.png",
michael@0:       updateURL: "http://localhost:" + gPort + "/data/lwtheme.js"
michael@0:     }));
michael@0:   });
michael@0: 
michael@0:   AddonManager.getAddonByID("1@personas.mozilla.org", function(p1) {
michael@0:     do_check_neq(p1, null);
michael@0:     do_check_eq(p1.version, "1");
michael@0:     do_check_eq(p1.name, "Test LW Theme");
michael@0:     do_check_true(p1.isActive);
michael@0:     do_check_eq(p1.installDate.getTime(), p1.updateDate.getTime());
michael@0: 
michael@0:     // 5 seconds leeway seems like a lot, but tests can run slow and really if
michael@0:     // this is within 5 seconds it is fine. If it is going to be wrong then it
michael@0:     // is likely to be hours out at least
michael@0:     do_check_true((Date.now() - p1.installDate.getTime()) < 5000);
michael@0: 
michael@0:     gInstallDate = p1.installDate.getTime();
michael@0: 
michael@0:     prepare_test({
michael@0:       "1@personas.mozilla.org": [
michael@0:         ["onInstalling", false],
michael@0:         "onInstalled"
michael@0:       ]
michael@0:     }, [
michael@0:       "onExternalInstall"
michael@0:     ], check_test_7);
michael@0: 
michael@0:     // Fake a timer event to cause a background update and wait for the magic to
michael@0:     // happen
michael@0:     gInternalManager.notify(null);
michael@0:   });
michael@0: }
michael@0: 
michael@0: function check_test_7() {
michael@0:   AddonManager.getAddonByID("1@personas.mozilla.org", function(p1) {
michael@0:     do_check_neq(p1, null);
michael@0:     do_check_eq(p1.version, "2");
michael@0:     do_check_eq(p1.name, "Updated Theme");
michael@0:     do_check_eq(p1.installDate.getTime(), gInstallDate);
michael@0:     do_check_true(p1.installDate.getTime() < p1.updateDate.getTime());
michael@0: 
michael@0:     // 5 seconds leeway seems like a lot, but tests can run slow and really if
michael@0:     // this is within 5 seconds it is fine. If it is going to be wrong then it
michael@0:     // is likely to be hours out at least
michael@0:     do_check_true((Date.now() - p1.updateDate.getTime()) < 5000);
michael@0: 
michael@0:     gInstallDate = p1.installDate.getTime();
michael@0: 
michael@0:     do_execute_soon(run_test_8);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Verify the parameter escaping in update urls.
michael@0: function run_test_8() {
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon1@tests.mozilla.org",
michael@0:     version: "5.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/param_test.rdf" + PARAMS,
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "2"
michael@0:     }],
michael@0:     name: "Test Addon 1",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon2@tests.mozilla.org",
michael@0:     version: "67.0.5b1",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/param_test.rdf" + PARAMS,
michael@0:     targetApplications: [{
michael@0:       id: "toolkit@mozilla.org",
michael@0:       minVersion: "0",
michael@0:       maxVersion: "3"
michael@0:     }],
michael@0:     name: "Test Addon 2",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon3@tests.mozilla.org",
michael@0:     version: "1.3+",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/param_test.rdf" + PARAMS,
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "0",
michael@0:       maxVersion: "0"
michael@0:     }, {
michael@0:       id: "toolkit@mozilla.org",
michael@0:       minVersion: "0",
michael@0:       maxVersion: "3"
michael@0:     }],
michael@0:     name: "Test Addon 3",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon4@tests.mozilla.org",
michael@0:     version: "0.5ab6",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/param_test.rdf" + PARAMS,
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "5"
michael@0:     }],
michael@0:     name: "Test Addon 4",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon5@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/param_test.rdf" + PARAMS,
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 5",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon6@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/param_test.rdf" + PARAMS,
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 6",
michael@0:   }, profileDir);
michael@0: 
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon2@tests.mozilla.org", callback_soon(function(a2) {
michael@0:     a2.userDisabled = true;
michael@0:     restartManager();
michael@0: 
michael@0:     testserver.registerPathHandler("/data/param_test.rdf", function(request, response) {
michael@0:       do_check_neq(request.queryString, "");
michael@0:       let [req_version, item_id, item_version,
michael@0:            item_maxappversion, item_status,
michael@0:            app_id, app_version, current_app_version,
michael@0:            app_os, app_abi, app_locale, update_type] =
michael@0:            [decodeURIComponent(a) for each (a in request.queryString.split("/"))];
michael@0: 
michael@0:       do_check_eq(req_version, "2");
michael@0: 
michael@0:       switch(item_id) {
michael@0:       case "addon1@tests.mozilla.org":
michael@0:         do_check_eq(item_version, "5.0");
michael@0:         do_check_eq(item_maxappversion, "2");
michael@0:         do_check_eq(item_status, "userEnabled");
michael@0:         do_check_eq(app_version, "1");
michael@0:         do_check_eq(update_type, "97");
michael@0:         break;
michael@0:       case "addon2@tests.mozilla.org":
michael@0:         do_check_eq(item_version, "67.0.5b1");
michael@0:         do_check_eq(item_maxappversion, "3");
michael@0:         do_check_eq(item_status, "userDisabled");
michael@0:         do_check_eq(app_version, "1");
michael@0:         do_check_eq(update_type, "49");
michael@0:         break;
michael@0:       case "addon3@tests.mozilla.org":
michael@0:         do_check_eq(item_version, "1.3+");
michael@0:         do_check_eq(item_maxappversion, "0");
michael@0:         do_check_eq(item_status, "userEnabled,incompatible");
michael@0:         do_check_eq(app_version, "1");
michael@0:         do_check_eq(update_type, "112");
michael@0:         break;
michael@0:       case "addon4@tests.mozilla.org":
michael@0:         do_check_eq(item_version, "0.5ab6");
michael@0:         do_check_eq(item_maxappversion, "5");
michael@0:         do_check_eq(item_status, "userEnabled");
michael@0:         do_check_eq(app_version, "2");
michael@0:         do_check_eq(update_type, "98");
michael@0:         break;
michael@0:       case "addon5@tests.mozilla.org":
michael@0:         do_check_eq(item_version, "1.0");
michael@0:         do_check_eq(item_maxappversion, "1");
michael@0:         do_check_eq(item_status, "userEnabled");
michael@0:         do_check_eq(app_version, "1");
michael@0:         do_check_eq(update_type, "35");
michael@0:         break;
michael@0:       case "addon6@tests.mozilla.org":
michael@0:         do_check_eq(item_version, "1.0");
michael@0:         do_check_eq(item_maxappversion, "1");
michael@0:         do_check_eq(item_status, "userEnabled");
michael@0:         do_check_eq(app_version, "1");
michael@0:         do_check_eq(update_type, "99");
michael@0:         break;
michael@0:       default:
michael@0:         do_throw("Update request for unexpected add-on " + item_id);
michael@0:       }
michael@0: 
michael@0:       do_check_eq(app_id, "xpcshell@tests.mozilla.org");
michael@0:       do_check_eq(current_app_version, "1");
michael@0:       do_check_eq(app_os, "XPCShell");
michael@0:       do_check_eq(app_abi, "noarch-spidermonkey");
michael@0:       do_check_eq(app_locale, "fr-FR");
michael@0: 
michael@0:       request.setStatusLine(null, 500, "Server Error");
michael@0:     });
michael@0: 
michael@0:     AddonManager.getAddonsByIDs(["addon1@tests.mozilla.org",
michael@0:                                  "addon2@tests.mozilla.org",
michael@0:                                  "addon3@tests.mozilla.org",
michael@0:                                  "addon4@tests.mozilla.org",
michael@0:                                  "addon5@tests.mozilla.org",
michael@0:                                  "addon6@tests.mozilla.org"],
michael@0:                                  function([a1, a2, a3, a4, a5, a6]) {
michael@0:       let count = 6;
michael@0: 
michael@0:       function run_next_test() {
michael@0:         a1.uninstall();
michael@0:         a2.uninstall();
michael@0:         a3.uninstall();
michael@0:         a4.uninstall();
michael@0:         a5.uninstall();
michael@0:         a6.uninstall();
michael@0: 
michael@0:         restartManager();
michael@0:         run_test_9();
michael@0:       }
michael@0: 
michael@0:       let compatListener = {
michael@0:         onUpdateFinished: function(addon, error) {
michael@0:           if (--count == 0)
michael@0:             do_execute_soon(run_next_test);
michael@0:         }
michael@0:       };
michael@0: 
michael@0:       let updateListener = {
michael@0:         onUpdateAvailable: function(addon, update) {
michael@0:           // Dummy so the update checker knows we care about new versions
michael@0:         },
michael@0: 
michael@0:         onUpdateFinished: function(addon, error) {
michael@0:           if (--count == 0)
michael@0:             do_execute_soon(run_next_test);
michael@0:         }
michael@0:       };
michael@0: 
michael@0:       a1.findUpdates(updateListener, AddonManager.UPDATE_WHEN_USER_REQUESTED);
michael@0:       a2.findUpdates(compatListener, AddonManager.UPDATE_WHEN_ADDON_INSTALLED);
michael@0:       a3.findUpdates(updateListener, AddonManager.UPDATE_WHEN_PERIODIC_UPDATE);
michael@0:       a4.findUpdates(updateListener, AddonManager.UPDATE_WHEN_NEW_APP_DETECTED, "2");
michael@0:       a5.findUpdates(compatListener, AddonManager.UPDATE_WHEN_NEW_APP_INSTALLED);
michael@0:       a6.findUpdates(updateListener, AddonManager.UPDATE_WHEN_NEW_APP_INSTALLED);
michael@0:     });
michael@0:   }));
michael@0: }
michael@0: 
michael@0: // Tests that if an install.rdf claims compatibility then the add-on will be
michael@0: // seen as compatible regardless of what the update.rdf says.
michael@0: function run_test_9() {
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon4@tests.mozilla.org",
michael@0:     version: "5.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "0",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 1",
michael@0:   }, profileDir);
michael@0: 
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon4@tests.mozilla.org", function(a4) {
michael@0:     do_check_true(a4.isActive);
michael@0:     do_check_true(a4.isCompatible);
michael@0: 
michael@0:     run_test_10();
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Tests that a normal update check won't decrease a targetApplication's
michael@0: // maxVersion.
michael@0: function run_test_10() {
michael@0:   AddonManager.getAddonByID("addon4@tests.mozilla.org", function(a4) {
michael@0:     a4.findUpdates({
michael@0:       onUpdateFinished: function(addon) {
michael@0:         do_check_true(addon.isCompatible);
michael@0: 
michael@0:         run_test_11();
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_PERIODIC_UPDATE);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Tests that an update check for a new application will decrease a
michael@0: // targetApplication's maxVersion.
michael@0: function run_test_11() {
michael@0:   AddonManager.getAddonByID("addon4@tests.mozilla.org", function(a4) {
michael@0:     a4.findUpdates({
michael@0:       onUpdateFinished: function(addon) {
michael@0:         do_check_false(addon.isCompatible);
michael@0: 
michael@0:         do_execute_soon(run_test_12);
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_NEW_APP_INSTALLED);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Check that the decreased maxVersion applied and disables the add-on
michael@0: function run_test_12() {
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon4@tests.mozilla.org", function(a4) {
michael@0:     do_check_false(a4.isActive);
michael@0:     do_check_false(a4.isCompatible);
michael@0: 
michael@0:     a4.uninstall();
michael@0:     do_execute_soon(run_test_13);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Tests that no compatibility update is passed to the listener when there is
michael@0: // compatibility info for the current version of the app but not for the
michael@0: // version of the app that the caller requested an update check for.
michael@0: function run_test_13() {
michael@0:   restartManager();
michael@0: 
michael@0:   // Not initially compatible but the update check will make it compatible
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon7@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "0",
michael@0:       maxVersion: "0"
michael@0:     }],
michael@0:     name: "Test Addon 7",
michael@0:   }, profileDir);
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon7@tests.mozilla.org", function(a7) {
michael@0:     do_check_neq(a7, null);
michael@0:     do_check_false(a7.isActive);
michael@0:     do_check_false(a7.isCompatible);
michael@0:     do_check_true(a7.appDisabled);
michael@0:     do_check_true(a7.isCompatibleWith("0"));
michael@0: 
michael@0:     a7.findUpdates({
michael@0:       sawUpdate: false,
michael@0:       onCompatibilityUpdateAvailable: function(addon) {
michael@0:         do_throw("Should have not have seen compatibility information");
michael@0:       },
michael@0: 
michael@0:       onUpdateAvailable: function(addon, install) {
michael@0:         do_throw("Should not have seen an available update");
michael@0:       },
michael@0: 
michael@0:       onUpdateFinished: function(addon) {
michael@0:         do_check_true(addon.isCompatible);
michael@0:         do_execute_soon(check_test_13);
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_NEW_APP_DETECTED, "3.0");
michael@0:   });
michael@0: }
michael@0: 
michael@0: function check_test_13() {
michael@0:   restartManager();
michael@0:   AddonManager.getAddonByID("addon7@tests.mozilla.org", function(a7) {
michael@0:     do_check_neq(a7, null);
michael@0:     do_check_true(a7.isActive);
michael@0:     do_check_true(a7.isCompatible);
michael@0:     do_check_false(a7.appDisabled);
michael@0: 
michael@0:     a7.uninstall();
michael@0:     do_execute_soon(run_test_14);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Test that background update checks doesn't update an add-on that isn't
michael@0: // allowed to update automatically.
michael@0: function run_test_14() {
michael@0:   restartManager();
michael@0: 
michael@0:   // Have an add-on there that will be updated so we see some events from it
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon1@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 1",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon8@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 8",
michael@0:   }, profileDir);
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon8@tests.mozilla.org", function(a8) {
michael@0:     a8.applyBackgroundUpdates = AddonManager.AUTOUPDATE_DISABLE;
michael@0: 
michael@0:     // The background update check will find updates for both add-ons but only
michael@0:     // proceed to install one of them.
michael@0:     AddonManager.addInstallListener({
michael@0:       onNewInstall: function(aInstall) {
michael@0:         if (aInstall.existingAddon.id != "addon1@tests.mozilla.org" &&
michael@0:             aInstall.existingAddon.id != "addon8@tests.mozilla.org")
michael@0:           do_throw("Saw unexpected onNewInstall for " + aInstall.existingAddon.id);
michael@0:       },
michael@0: 
michael@0:       onDownloadStarted: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:       },
michael@0: 
michael@0:       onDownloadEnded: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:       },
michael@0: 
michael@0:       onDownloadFailed: function(aInstall) {
michael@0:         do_throw("Should not have seen onDownloadFailed event");
michael@0:       },
michael@0: 
michael@0:       onDownloadCancelled: function(aInstall) {
michael@0:         do_throw("Should not have seen onDownloadCancelled event");
michael@0:       },
michael@0: 
michael@0:       onInstallStarted: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:       },
michael@0: 
michael@0:       onInstallEnded: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:         do_check_eq(aInstall.existingAddon.pendingUpgrade.install, aInstall);
michael@0:         do_execute_soon(check_test_14);
michael@0:       },
michael@0: 
michael@0:       onInstallFailed: function(aInstall) {
michael@0:         do_throw("Should not have seen onInstallFailed event");
michael@0:       },
michael@0: 
michael@0:       onInstallCancelled: function(aInstall) {
michael@0:         do_throw("Should not have seen onInstallCancelled event");
michael@0:       },
michael@0:     });
michael@0: 
michael@0:     // Fake a timer event
michael@0:     gInternalManager.notify(null);
michael@0:   });
michael@0: }
michael@0: 
michael@0: function check_test_14() {
michael@0:   restartManager();
michael@0:   AddonManager.getAddonsByIDs(["addon1@tests.mozilla.org",
michael@0:                                "addon8@tests.mozilla.org"], function([a1, a8]) {
michael@0:     do_check_neq(a1, null);
michael@0:     do_check_eq(a1.version, "2.0");
michael@0:     a1.uninstall();
michael@0: 
michael@0:     do_check_neq(a8, null);
michael@0:     do_check_eq(a8.version, "1.0");
michael@0:     a8.uninstall();
michael@0: 
michael@0:     do_execute_soon(run_test_15);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Test that background update checks doesn't update an add-on that is
michael@0: // pending uninstall
michael@0: function run_test_15() {
michael@0:   restartManager();
michael@0: 
michael@0:   // Have an add-on there that will be updated so we see some events from it
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon1@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 1",
michael@0:   }, profileDir);
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon8@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "1",
michael@0:       maxVersion: "1"
michael@0:     }],
michael@0:     name: "Test Addon 8",
michael@0:   }, profileDir);
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon8@tests.mozilla.org", function(a8) {
michael@0:     a8.uninstall();
michael@0:     do_check_false(hasFlag(a8.permissions, AddonManager.PERM_CAN_UPGRADE));
michael@0: 
michael@0:     // The background update check will find updates for both add-ons but only
michael@0:     // proceed to install one of them.
michael@0:     AddonManager.addInstallListener({
michael@0:       onNewInstall: function(aInstall) {
michael@0:         if (aInstall.existingAddon.id != "addon1@tests.mozilla.org" &&
michael@0:             aInstall.existingAddon.id != "addon8@tests.mozilla.org")
michael@0:           do_throw("Saw unexpected onNewInstall for " + aInstall.existingAddon.id);
michael@0:       },
michael@0: 
michael@0:       onDownloadStarted: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:       },
michael@0: 
michael@0:       onDownloadEnded: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:       },
michael@0: 
michael@0:       onDownloadFailed: function(aInstall) {
michael@0:         do_throw("Should not have seen onDownloadFailed event");
michael@0:       },
michael@0: 
michael@0:       onDownloadCancelled: function(aInstall) {
michael@0:         do_throw("Should not have seen onDownloadCancelled event");
michael@0:       },
michael@0: 
michael@0:       onInstallStarted: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:       },
michael@0: 
michael@0:       onInstallEnded: function(aInstall) {
michael@0:         do_check_eq(aInstall.existingAddon.id, "addon1@tests.mozilla.org");
michael@0:         do_execute_soon(check_test_15);
michael@0:       },
michael@0: 
michael@0:       onInstallFailed: function(aInstall) {
michael@0:         do_throw("Should not have seen onInstallFailed event");
michael@0:       },
michael@0: 
michael@0:       onInstallCancelled: function(aInstall) {
michael@0:         do_throw("Should not have seen onInstallCancelled event");
michael@0:       },
michael@0:     });
michael@0: 
michael@0:     // Fake a timer event
michael@0:     gInternalManager.notify(null);
michael@0:   });
michael@0: }
michael@0: 
michael@0: function check_test_15() {
michael@0:   restartManager();
michael@0:   AddonManager.getAddonsByIDs(["addon1@tests.mozilla.org",
michael@0:                                "addon8@tests.mozilla.org"], function([a1, a8]) {
michael@0:     do_check_neq(a1, null);
michael@0:     do_check_eq(a1.version, "2.0");
michael@0:     a1.uninstall();
michael@0: 
michael@0:     do_check_eq(a8, null);
michael@0: 
michael@0:     do_execute_soon(run_test_16);
michael@0:   });
michael@0: }
michael@0: 
michael@0: // Test that the update check correctly observes the
michael@0: // extensions.strictCompatibility pref and compatibility overrides.
michael@0: function run_test_16() {
michael@0:   restartManager();
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon9@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "0.1",
michael@0:       maxVersion: "0.2"
michael@0:     }],
michael@0:     name: "Test Addon 9",
michael@0:   }, profileDir);
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.addInstallListener({
michael@0:     onNewInstall: function(aInstall) {
michael@0:       if (aInstall.existingAddon.id != "addon9@tests.mozilla.org")
michael@0:         do_throw("Saw unexpected onNewInstall for " + aInstall.existingAddon.id);
michael@0:       do_check_eq(aInstall.version, "2.0");
michael@0:     },
michael@0:     onDownloadFailed: function(aInstall) {
michael@0:       do_execute_soon(run_test_17);
michael@0:     }
michael@0:   });
michael@0: 
michael@0:   Services.prefs.setCharPref(PREF_GETADDONS_BYIDS_PERFORMANCE,
michael@0:                              "http://localhost:" + gPort + "/data/test_update.xml");
michael@0:   Services.prefs.setBoolPref(PREF_GETADDONS_CACHE_ENABLED, true);
michael@0:   // Fake a timer event
michael@0:   gInternalManager.notify(null);
michael@0: }
michael@0: 
michael@0: // Test that the update check correctly observes when an addon opts-in to
michael@0: // strict compatibility checking.
michael@0: function run_test_17() {
michael@0: 
michael@0:   writeInstallRDFForExtension({
michael@0:     id: "addon11@tests.mozilla.org",
michael@0:     version: "1.0",
michael@0:     updateURL: "http://localhost:" + gPort + "/data/test_update.rdf",
michael@0:     targetApplications: [{
michael@0:       id: "xpcshell@tests.mozilla.org",
michael@0:       minVersion: "0.1",
michael@0:       maxVersion: "0.2"
michael@0:     }],
michael@0:     name: "Test Addon 11",
michael@0:   }, profileDir);
michael@0:   restartManager();
michael@0: 
michael@0:   AddonManager.getAddonByID("addon11@tests.mozilla.org", function(a11) {
michael@0:     do_check_neq(a11, null);
michael@0: 
michael@0:     a11.findUpdates({
michael@0:       onCompatibilityUpdateAvailable: function() {
michael@0:         do_throw("Should have not have seen compatibility information");
michael@0:       },
michael@0: 
michael@0:       onUpdateAvailable: function() {
michael@0:         do_throw("Should not have seen an available update");
michael@0:       },
michael@0: 
michael@0:       onUpdateFinished: function() {
michael@0:         do_execute_soon(end_test);
michael@0:       }
michael@0:     }, AddonManager.UPDATE_WHEN_USER_REQUESTED);
michael@0:   });
michael@0: }