GM.openInTab: Difference between revisions
From GreaseSpot Wiki
Jump to navigationJump to search
(open_in_background) |
|||
| Line 10: | Line 10: | ||
== Syntax == | == Syntax == | ||
{{Function|GM_openInTab|url}} | {{Function|GM_openInTab|url, open_in_background}} | ||
=== Arguments === | === Arguments === | ||
| Line 16: | Line 16: | ||
; <code>url</code> | ; <code>url</code> | ||
: <code>String</code> The URL to navigate the new tab to. | : <code>String</code> The URL to navigate the new tab to. | ||
; <code>open_in_background</code> | |||
: <code>Boolean</code> Optional: force tab to/to not open in a background tab. Default (unspecified) behavior honors Firefox configuration. | |||
== Returns == | == Returns == | ||
Before version 0.8.2: <code>undefined</code> | Before version 0.8.2: <code>undefined</code> | ||
As of [[Version_history#0.8.20090920.2|Greasemonkey 0.8.2]]: returns the <code>window</code> object created. | As of [[Version_history#0.8.20090920.2|Greasemonkey 0.8.2]]: returns the <code>window</code> object created. | ||
As of [[Version_history#3.0|Greasemonkey 3.0]]: <code>undefined</code>. | As of [[Version_history#3.0|Greasemonkey 3.0]]: <code>undefined</code>. | ||
Revision as of 13:44, 29 May 2015
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
urlStringThe URL to navigate the new tab to.open_in_backgroundBooleanOptional: force tab to/to not open in a background tab. Default (unspecified) behavior honors Firefox configuration.
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/");
