GM.getValue: Difference between revisions
From GreaseSpot Wiki
Jump to navigationJump to search
m Text replace - "{{Core samp" to "{{Samp" |
m Text replace - "top " to "" |
||
Line 51: | Line 51: | ||
GM_log(GM_getValue("foo")); | GM_log(GM_getValue("foo")); | ||
</pre>}} | </pre>}} | ||
== See Also == | == See Also == | ||
Line 58: | Line 56: | ||
* [[GM_deleteValue]] | * [[GM_deleteValue]] | ||
* [[GM_listValues]] | * [[GM_listValues]] | ||
== Notes == | == Notes == |
Revision as of 21:28, 3 February 2010
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.scriptvals.namespace/name.foo
".
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.