gecko/modules/libpref/test/unit/test_libPrefs.js

413 lines
16 KiB
JavaScript
Raw Blame History

/* ***** BEGIN LICENSE BLOCK *****
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
*
* The contents of this file are subject to the Mozilla Public License Version
* 1.1 (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
* http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
* for the specific language governing rights and limitations under the
* License.
*
* The Original Code is libpref
*
* The Initial Developer of the Original Code is Collabora ltd.
* Portions created by the Initial Developer are Copyright (C) 2007
* the Initial Developer. All Rights Reserved.
*
* Contributor(s):
* Frederic Plourde <frederic.plourde@collabora.co.uk>
*
* Alternatively, the contents of this file may be used under the terms of
* either the GNU General Public License Version 2 or later (the "GPL"), or
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
* in which case the provisions of the GPL or the LGPL are applicable instead
* of those above. If you wish to allow use of your version of this file only
* under the terms of either the GPL or the LGPL, and not to allow others to
* use your version of this file under the terms of the MPL, indicate your
* decision by deleting the provisions above and replace them with the notice
* and other provisions required by the GPL or the LGPL. If you do not delete
* the provisions above, a recipient may use your version of this file under
* the terms of any one of the MPL, the GPL or the LGPL.
*
* ***** END LICENSE BLOCK ***** */
const PREF_INVALID = 0;
const PREF_BOOL = 128;
const PREF_INT = 64;
const PREF_STRING = 32;
function makeList(a)
{
var o = {};
for(var i=0; i<a.length; i++)
{
o[a[i]] = '';
}
return o;
}
function run_test() {
var ps = Cc["@mozilla.org/preferences-service;1"].
getService(Ci.nsIPrefService);
var pb2= Cc["@mozilla.org/preferences-service;1"].
getService(Ci.nsIPrefBranch2);
var pb = Cc["@mozilla.org/preferences-service;1"].
getService(Ci.nsIPrefBranch);
//**************************************************************************//
// Nullsafety
do_check_throws(function() {
pb.getPrefType(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.getBoolPref(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.setBoolPref(null, false); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.getIntPref(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.setIntPref(null, 0); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.getCharPref(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.setCharPref(null, null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.getComplexValue(null, Components.interfaces.nsISupportsString); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.setComplexValue(null, Components.interfaces.nsISupportsString, pb); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.clearUserPref(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.prefHasUserValue(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.lockPref(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.prefIsLocked(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.unlockPref(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.deleteBranch(null); }, Cr.NS_ERROR_INVALID_ARG);
do_check_throws(function() {
pb.getChildList(null); }, Cr.NS_ERROR_INVALID_ARG);
//**************************************************************************//
// Nonexisting user preferences
do_check_eq(pb.prefHasUserValue("UserPref.nonexistent.hasUserValue"), false);
do_check_throws(function() {
pb.clearUserPref("UserPref.nonexistent.clearUserPref");}, Cr.NS_ERROR_UNEXPECTED);
do_check_eq(pb.getPrefType("UserPref.nonexistent.getPrefType"), PREF_INVALID);
do_check_eq(pb.root, "");
// bool...
do_check_throws(function() {
pb.getBoolPref("UserPref.nonexistent.getBoolPref");}, Cr.NS_ERROR_UNEXPECTED);
pb.setBoolPref("UserPref.nonexistent.setBoolPref", false);
do_check_eq(pb.getBoolPref("UserPref.nonexistent.setBoolPref"), false);
// int...
do_check_throws(function() {
pb.getIntPref("UserPref.nonexistent.getIntPref");}, Cr.NS_ERROR_UNEXPECTED);
pb.setIntPref("UserPref.nonexistent.setIntPref", 5);
do_check_eq(pb.getIntPref("UserPref.nonexistent.setIntPref"), 5);
// char
do_check_throws(function() {
pb.getCharPref("UserPref.nonexistent.getCharPref");}, Cr.NS_ERROR_UNEXPECTED);
pb.setCharPref("UserPref.nonexistent.setCharPref", "_test");
do_check_eq(pb.getCharPref("UserPref.nonexistent.setCharPref"), "_test");
//**************************************************************************//
// Existing user Prefs and data integrity test (round-trip match)
pb.setBoolPref("UserPref.existing.bool", true);
pb.setIntPref("UserPref.existing.int", 23);
pb.setCharPref("UserPref.existing.char", "hey");
// getPref should return the pref value
do_check_eq(pb.getBoolPref("UserPref.existing.bool"), true);
do_check_eq(pb.getIntPref("UserPref.existing.int"), 23);
do_check_eq(pb.getCharPref("UserPref.existing.char"), "hey");
// setPref should not complain and should change the value of the pref
pb.setBoolPref("UserPref.existing.bool", false);
do_check_eq(pb.getBoolPref("UserPref.existing.bool"), false);
pb.setIntPref("UserPref.existing.int", 24);
do_check_eq(pb.getIntPref("UserPref.existing.int"), 24);
pb.setCharPref("UserPref.existing.char", "hej d<>!");
do_check_eq(pb.getCharPref("UserPref.existing.char"), "hej d<>!");
// prefHasUserValue should return true now
do_check_true(pb.prefHasUserValue("UserPref.existing.bool"));
do_check_true(pb.prefHasUserValue("UserPref.existing.int"));
do_check_true(pb.prefHasUserValue("UserPref.existing.char"));
// clearUserPref should remove the pref
pb.clearUserPref("UserPref.existing.bool");
do_check_false(pb.prefHasUserValue("UserPref.existing.bool"));
pb.clearUserPref("UserPref.existing.int");
do_check_false(pb.prefHasUserValue("UserPref.existing.int"));
pb.clearUserPref("UserPref.existing.char");
do_check_false(pb.prefHasUserValue("UserPref.existing.char"));
//**************************************************************************//
// getPrefType test
// bool...
pb.setBoolPref("UserPref.getPrefType.bool", true);
do_check_eq(pb.getPrefType("UserPref.getPrefType.bool"), PREF_BOOL);
// int...
pb.setIntPref("UserPref.getPrefType.int", -234);
do_check_eq(pb.getPrefType("UserPref.getPrefType.int"), PREF_INT);
// char...
pb.setCharPref("UserPref.getPrefType.char", "testing1..2");
do_check_eq(pb.getPrefType("UserPref.getPrefType.char"), PREF_STRING);
//**************************************************************************//
// getBranch tests
do_check_eq(ps.root, "");
// bool ...
pb.setBoolPref("UserPref.root.boolPref", true);
let pb_1 = ps.getBranch("UserPref.root.");
do_check_eq(pb_1.getBoolPref("boolPref"), true);
let pb_2 = ps.getBranch("UserPref.root.boolPref");
do_check_eq(pb_2.getBoolPref(""), true);
pb_2.setBoolPref(".anotherPref", false);
let pb_3 = ps.getBranch("UserPref.root.boolPre");
do_check_eq(pb_3.getBoolPref("f.anotherPref"), false);
// int ...
pb.setIntPref("UserPref.root.intPref", 23);
let pb_1 = ps.getBranch("UserPref.root.");
do_check_eq(pb_1.getIntPref("intPref"), 23);
let pb_2 = ps.getBranch("UserPref.root.intPref");
do_check_eq(pb_2.getIntPref(""), 23);
pb_2.setIntPref(".anotherPref", 69);
let pb_3 = ps.getBranch("UserPref.root.intPre");
do_check_eq(pb_3.getIntPref("f.anotherPref"), 69);
// char...
pb.setCharPref("UserPref.root.charPref", "_char");
let pb_1 = ps.getBranch("UserPref.root.");
do_check_eq(pb_1.getCharPref("charPref"), "_char");
let pb_2 = ps.getBranch("UserPref.root.charPref");
do_check_eq(pb_2.getCharPref(""), "_char");
pb_2.setCharPref(".anotherPref", "_another");
let pb_3 = ps.getBranch("UserPref.root.charPre");
do_check_eq(pb_3.getCharPref("f.anotherPref"), "_another");
//**************************************************************************//
// getChildlist tests
// get an already set prefBranch
pb1 = ps.getBranch("UserPref.root.");
let prefList = pb1.getChildList("");
do_check_eq(prefList.length, 6);
// check for specific prefs in the array : the order is not important
do_check_true("boolPref" in makeList(prefList));
do_check_true("intPref" in makeList(prefList));
do_check_true("charPref" in makeList(prefList));
do_check_true("boolPref.anotherPref" in makeList(prefList));
do_check_true("intPref.anotherPref" in makeList(prefList));
do_check_true("charPref.anotherPref" in makeList(prefList));
//**************************************************************************//
// Default branch tests
// bool...
pb1 = ps.getDefaultBranch("");
pb1.setBoolPref("DefaultPref.bool", true);
do_check_eq(pb1.getBoolPref("DefaultPref.bool"), true);
do_check_false(pb1.prefHasUserValue("DefaultPref.bool"));
ps.setBoolPref("DefaultPref.bool", false);
do_check_true(pb1.prefHasUserValue("DefaultPref.bool"));
do_check_eq(ps.getBoolPref("DefaultPref.bool"), false);
// int...
pb1 = ps.getDefaultBranch("");
pb1.setIntPref("DefaultPref.int", 100);
do_check_eq(pb1.getIntPref("DefaultPref.int"), 100);
do_check_false(pb1.prefHasUserValue("DefaultPref.int"));
ps.setIntPref("DefaultPref.int", 50);
do_check_true(pb1.prefHasUserValue("DefaultPref.int"));
do_check_eq(ps.getIntPref("DefaultPref.int"), 50);
// char...
pb1 = ps.getDefaultBranch("");
pb1.setCharPref("DefaultPref.char", "_default");
do_check_eq(pb1.getCharPref("DefaultPref.char"), "_default");
do_check_false(pb1.prefHasUserValue("DefaultPref.char"));
ps.setCharPref("DefaultPref.char", "_user");
do_check_true(pb1.prefHasUserValue("DefaultPref.char"));
do_check_eq(ps.getCharPref("DefaultPref.char"), "_user");
//**************************************************************************//
// pref Locking/Unlocking tests
// locking and unlocking a nonexistent pref should throw
do_check_throws(function() {
ps.lockPref("DefaultPref.nonexistent");}, Cr.NS_ERROR_UNEXPECTED);
do_check_throws(function() {
ps.unlockPref("DefaultPref.nonexistent");}, Cr.NS_ERROR_UNEXPECTED);
// getting a locked pref branch should return the "default" value
do_check_false(ps.prefIsLocked("DefaultPref.char"));
ps.lockPref("DefaultPref.char");
do_check_eq(ps.getCharPref("DefaultPref.char"), "_default");
do_check_true(ps.prefIsLocked("DefaultPref.char"));
// getting an unlocked pref branch should return the "user" value
ps.unlockPref("DefaultPref.char");
do_check_eq(ps.getCharPref("DefaultPref.char"), "_user");
do_check_false(ps.prefIsLocked("DefaultPref.char"));
// setting the "default" value to a user pref branch should
// make prefHasUserValue return false (documented behavior)
ps.setCharPref("DefaultPref.char", "_default");
do_check_false(pb1.prefHasUserValue("DefaultPref.char"));
// unlocking and locking multiple times shouldn't throw
ps.unlockPref("DefaultPref.char");
ps.lockPref("DefaultPref.char");
ps.lockPref("DefaultPref.char");
//**************************************************************************//
// resetBranch test
// NOT IMPLEMENTED YET in module/libpref. So we're not testing !
// uncomment the following if resetBranch ever gets implemented.
/*ps.resetBranch("DefaultPref");
do_check_eq(ps.getBoolPref("DefaultPref.bool"), true);
do_check_eq(ps.getIntPref("DefaultPref.int"), 100);
do_check_eq(ps.getCharPref("DefaultPref.char"), "_default");*/
//**************************************************************************//
// deleteBranch tests
// TODO : Really, this should throw!, by documentation.
// do_check_throws(function() {
// ps.deleteBranch("UserPref.nonexistent.deleteBranch");}, Cr.NS_ERROR_UNEXPECTED);
ps.deleteBranch("DefaultPref");
pb = ps.getBranch("DefaultPref");
pb1 = ps.getDefaultBranch("DefaultPref");
// getting prefs on deleted user branches should throw
do_check_throws(function() {
pb.getBoolPref("DefaultPref.bool");}, Cr.NS_ERROR_UNEXPECTED);
do_check_throws(function() {
pb.getIntPref("DefaultPref.int");}, Cr.NS_ERROR_UNEXPECTED);
do_check_throws(function() {
pb.getCharPref("DefaultPref.char");}, Cr.NS_ERROR_UNEXPECTED);
// getting prefs on deleted default branches should throw
do_check_throws(function() {
pb1.getBoolPref("DefaultPref.bool");}, Cr.NS_ERROR_UNEXPECTED);
do_check_throws(function() {
pb1.getIntPref("DefaultPref.int");}, Cr.NS_ERROR_UNEXPECTED);
do_check_throws(function() {
pb1.getCharPref("DefaultPref.char");}, Cr.NS_ERROR_UNEXPECTED);
//**************************************************************************//
// savePrefFile & readPrefFile tests
// set some prefs
ps.setBoolPref("ReadPref.bool", true);
ps.setIntPref("ReadPref.int", 230);
ps.setCharPref("ReadPref.char", "hello");
// save those prefs in a file
let savePrefFile = do_get_cwd();
savePrefFile.append("data");
savePrefFile.append("savePref.js");
if (savePrefFile.exists())
savePrefFile.remove(false);
savePrefFile.create(Ci.nsIFile.NORMAL_FILE_TYPE, 0666);
ps.savePrefFile(savePrefFile);
ps.resetPrefs();
// load a preexisting pref file
let prefFile = do_get_file("data/testPref.js");
ps.readUserPrefs(prefFile);
// former prefs should have been replaced/lost
do_check_throws(function() {
do_check_eq(pb.getBoolPref("ReadPref.bool"));}, Cr.NS_ERROR_UNEXPECTED);
do_check_throws(function() {
do_check_eq(pb.getIntPref("ReadPref.int"));}, Cr.NS_ERROR_UNEXPECTED);
do_check_throws(function() {
do_check_eq(pb.getCharPref("ReadPref.char"));}, Cr.NS_ERROR_UNEXPECTED);
// loaded prefs should read ok.
pb = ps.getBranch("testPref.");
do_check_eq(pb.getBoolPref("bool1"), true);
do_check_eq(pb.getBoolPref("bool2"), false);
do_check_eq(pb.getIntPref("int1"), 23);
do_check_eq(pb.getIntPref("int2"), -1236);
do_check_eq(pb.getCharPref("char1"), "_testPref");
do_check_eq(pb.getCharPref("char2"), "<22>lskar");
// loading our former savePrefFile should allow us to read former prefs
ps.readUserPrefs(savePrefFile);
do_check_eq(ps.getBoolPref("ReadPref.bool"), true);
do_check_eq(ps.getIntPref("ReadPref.int"), 230);
do_check_eq(ps.getCharPref("ReadPref.char"), "hello");
// ... and still be able to access "prior-to-readUserPrefs" preferences
do_check_eq(pb.getBoolPref("bool1"), true);
do_check_eq(pb.getBoolPref("bool2"), false);
do_check_eq(pb.getIntPref("int1"), 23);
//**************************************************************************//
// preference Observers
// an observer...
var observer = {
QueryInterface: function QueryInterface(aIID) {
if (aIID.equals(Ci.nsIObserver) ||
aIID.equals(Ci.nsISupports))
return this;
throw Components.results.NS_NOINTERFACE;
},
observe: function observe(aSubject, aTopic, aState) {
do_check_eq(aTopic, "nsPref:changed");
do_check_eq(aState, "ReadPref.int");
do_check_eq(ps.getIntPref(aState), 76);
ps.removeObserver("ReadPref.int", this);
// notification received, we may go on...
do_test_finished();
}
}
pb2.addObserver("ReadPref.int", observer, false);
ps.setIntPref("ReadPref.int", 76);
// test will continue upon notification...
do_test_pending();
// removed observer should not fire
pb2.removeObserver("ReadPref.int", observer);
ps.setIntPref("ReadPref.int", 32);
// let's test observers once more with a non-root prefbranch
pb2.getBranch("ReadPref.");
pb2.addObserver("int", observer, false);
ps.setIntPref("ReadPref.int", 76);
// test will complete upon notification...
do_test_pending();
}