GM.openInTab

From GreaseSpot Wiki
Revision as of 13:56, 29 May 2015 by Arantius (talk | contribs) (open_in_background verison note)
Jump to navigationJump to 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/");