GM.getValue: Difference between revisions
From GreaseSpot Wiki
Jump to navigationJump to search
m (reversion: Proper syntax for API needs to be maintained thruout... did include Gingerhendrix's explanation... Tobu should have read the talk page 1st referenced by bullet 1) |
m (→<code>default</code>: dupe removed) |
||
| Line 44: | Line 44: | ||
:* If [[GM_getValue#name|name]] is not found, then use this property to return a [[#default |default]] value. If [[#default |default]] is omitted JavaScript undefined is returned. | :* If [[GM_getValue#name|name]] is not found, then use this property to return a [[#default |default]] value. If [[#default |default]] is omitted JavaScript undefined is returned. | ||
: Note: Using this property does not call [[GM_setValue]] and | : Note: Using this property does not call [[GM_setValue]] and is by design. | ||
[[#top|top]] | [[#Syntax|back]] | [[#top|top]] | [[#Syntax|back]] | ||
Revision as of 08:57, 30 September 2008
Description
This API method retrieves a value that was set with GM_setValue. If nothing was set and a default value is passed, it returns that default. Failing that, it returns undefined.
Values are saved in the Firefox preferences back end and can be manually changed by typing about:config in the address bar and searching for the preference name "greasemonkey.scriptval.script-namespace/script-name".
Syntax
GM_getValue( name, default )
- Value: Function
- Returns: String, Integer, Boolean, undefined and null[1]
- Compatibility: Greasemonkey 0.3b+
- All properties are optional except name.
Properties
name
- Value: String
- Usage:
name = "PropertyName";
- Property name to retrieve.
default
- Value: String, Integer or Boolean
- Usage:
default = 5;
- Note: Using this property does not call GM_setValue and is by design.
Examples
alert(GM_getValue("foo"));
