GM.openInTab: Difference between revisions
From GreaseSpot Wiki
Jump to navigationJump to search
(→Notes: add referrer issue) |
m (Added Greasemonkey Manual TOC widget) |
||
| Line 1: | Line 1: | ||
{{underscore|title=GM_openInTab}} | {{underscore|title=GM_openInTab}} | ||
__NOTOC__ | __NOTOC__ | ||
{{Greasemonkey Manual TOC}} | |||
== Description == | == Description == | ||
Revision as of 22:18, 30 December 2008
 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.
Syntax
GM_openInTab( url )
- Value: Function
- Returns: Nothing
- Compatibility: Greasemonkey 0.5b+
Parameters Properties url
- All properties are optional except url.
Properties
url
- Value: String
- Usage:
url = "http://www.greasespot.net/";
Examples
GM_openInTab("http://www.greasespot.net/");
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.
