GM_openInTab

From GreaseSpot Wiki
Jump to: navigation, search


Description

This method opens the specified URL in a new tab. As of Greasemonkey 0.8.2 it obeys the built in "When I open a link in a new tab, switch to it immediately" preference (browser.tabs.loadInBackground).

Compatibility: Greasemonkey 0.5b+

Syntax

function GM_openInTab( url, open_in_background )

Arguments

url
String The URL to navigate the new tab to.
open_in_background
Boolean Optional: force tab to/to not open in a background tab. Default (unspecified) behavior honors Firefox configuration. (As of Greasemonkey 3.2.)

Returns

Before version 0.8.2: undefined As of Greasemonkey 0.8.2: returns the window object created. As of Greasemonkey 3.0: undefined.

Examples

GM_openInTab("http://www.example.com/");