GM getResourceText

From GreaseSpot

The correct title of this article is GM_getResourceText. The substitution or omission of an _ is due to technical restrictions.

[edit] Description

This API method loads an external resource, such as an external JavaScript routine, and returns the string for use in the DOM.

Examples | Notes

[edit] Syntax

GM_getResourceText( resourceName )

Value: Function

Returns: String

Compatibility: Greasemonkey 0.8.0+

Parameters
Properties
`resourceName`

All properties are optional except resourceName.

top

[edit] Properties

[edit] `resourceName`

Value: String

Usage: resourceName = "metadata_block_resourceName";

While the resourceName is non-semantic, it is suggested that it should be compatible with JavaScript variable naming conventions and XML/CSS naming conventions to help keep things consistent.
This value is used in retrieval of the same-named resource specified in the corresponding metadata block @resource key. After it is retrieved, no formatting on the resource will occur, and it will be returned upon completion of this API method.

top | back

[edit] Examples

// ==UserScript==
// @name          My Script
// @namespace     http://www.example.com/gmscripts/
// @description   Scripting is fun
// @include       http://www.example.com/*
// @resource      prototype http://www.example.com/prototype.js
// ==/UserScript==

(function()
{
  // some code

  var myPrototype = GM_getResourceText("prototype");

  // some code

})();

top