GM.openInTab

From GreaseSpot Wiki
Revision as of 22:52, 20 February 2009 by Marti (talk | contribs) (→‎Syntax: swap to JavaScript return type)
Jump to navigationJump to search

Template:Underscore


Greasemonkey Manual
Using Greasemonkey
Installing Scripts
Monkey Menu
Getting Help
User Script Authoring
Editing
Environment
API

Description

This API method opens the specified URL in a new background tab.

Examples | Notes

Syntax

GM_openInTab( url )

Value: Function
Returns: undefined
Compatibility: Greasemonkey 0.5b+
Parameters
Properties
url
  • All properties are optional except url.

top

Properties


url

Value: String
Usage: url = "http://www.greasespot.net/";

top | back

Examples

GM_openInTab("http://www.greasespot.net/");

top

Notes

Referrer Issue

Opening webpages by invoking this method may not be the ideal choice, because this method doesn't save the referring page, which makes webservers think that you are calling a page only by it's URL, and not from the webpage it was on. In the cases where it doesn't work, one may use window.open(url) instead, which is similar in that it opens a new tab, but it keeps the referrer and switches to the tab immediately.

top