GM.openInTab: Difference between revisions

Latest revision as of 15:05, 3 November 2017

This method opens the specified URL in a new tab.

function GM.openInTab( url, open_in_background )

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.

undefined

GM.openInTab("http://www.example.com/");

@@ Line 1: / Line 1: @@
-{{DISPLAYTITLE:GM_openInTab}}
 == Description ==
 This method opens the specified URL in a new tab.
-As of [[Version history#0.8.20090920.2|Greasemonkey 0.8.2]] it obeys the built in "When I open a link in a new tab, switch to it immediately" preference (<code>browser.tabs.loadInBackground</code>).
-Compatibility: [[Version_history#0.5_beta|Greasemonkey 0.5b+]]
+== Syntax ==
-== Syntax ==
+{{Function|GM.openInTab|url, open_in_background}}
-{{Function|GM_openInTab|url, open_in_background}}
+Compatibility: [[Version_history#4.0_2|Greasemonkey 4.0+]]
 === Arguments ===
@@ Line 17: / Line 14: @@
 : <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.  (As of [[Version_history#3.2|Greasemonkey 3.2]].)
+: <code>Boolean</code> Optional: force tab to/to not open in a background tab.  Default (unspecified) behavior honors Firefox configuration.
 == Returns ==
-Before version 0.8.2: <code>undefined</code>
+<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#3.0|Greasemonkey 3.0]]: <code>undefined</code>.
 == Examples ==
 <pre class='sample'>
-GM_openInTab("http://www.example.com/");
+GM.openInTab("http://www.example.com/");
 </pre>
 [[Category:API_Reference|O]]