GM log

From GreaseSpot

The correct title of this article is GM_log. The substitution or omission of an _ is due to technical restrictions.

[edit] Description

This API method allows script authors simple access to logging informational messages in the Error Console.

If you aren't seeing your messages, make sure you navigate to about:config, and change the values of javascript.options.showInConsole and javascript.options.strict to true. This can be helpful for debugging.

Examples | GM_log and Firebug | Notes

[edit] Syntax

GM_log( message )

Value: Function

Returns: Nothing

Compatibility: Greasemonkey 0.3b+

Parameters

Properties
message

• All properties are optional except message.

top

[edit] Properties

[edit] message

Value: String, Integer^[1] or Boolean^[1]

Usage: message = "ARGHHH!";

• Message to send to the JavaScript error console.
• ^[1] While the value may be a non-string, it will convert the argument to a string. There may also be some instances of visual clipping on large numerical values during conversion. This is a feature present in Mozilla based JavaScript console logging.

top | back

[edit] Examples

 GM_log("Hello, World!");

GM_log("Warning, " + someInputField.value + "!");

top

[edit] GM_log and Firebug

Since Firebug 1.0, extensions.firebug.showChromeMessages must be set to true for GM_log messages to show up in the Firebug console.

top

[edit] Notes

top