Tampermonkey 油候脚本官方开发文档

The hash component of the URL of @resource and @require tags can be used for this purpose.

 // @resource SRIsecured1 http://www.tampermonkey.net/favicon1.ico#md5=ad34bb...
 // @resource SRIsecured2 http://www.tampermonkey.net/favicon2.ico#md5=ac3434...,sha256=23fd34...
 // @require https://code.jquery.com/jquery-2.1.1.min.js#md5=45eef...
 // @require https://code.jquery.com/jquery-2.1.2.min.js#md5=ac56d...,sha256=6e789...

TM supports MD5 hashes as a fallback natively, all other (SHA-1, SHA-256, SHA-384 and SHA-512) depend on window.crypto. In case multiple hashes (separated by comma or semicolon) are given the last currently supported one is used by TM. If the content of the external resource doesn’t match the selected hash, then the resource is not delivered to the userscript. All hashes need to be encoded in hex or Base64
format.

Open a new tab with this url. The options object can have the following properties:

• active decides whether the new tab should be focused,
• insert that inserts the new tab after the current one and
• setParent makes the browser re-focus the current tab on close.

Otherwise the new tab is just appended. loadInBackground has the opposite meaning of active and was added to achieve Greasemonkey 3.x compatibility. If neither active nor loadInBackground is given, then the tab will not be focused. This function returns an object with the function close, the listener onclosed and a flag called closed.

Make an xmlHttpRequest.

Property of details:

• method one of GET, HEAD, POST
• url the destination URL
• headers ie. user-agent, referer, … (some special headers are not supported by Safari and Android browsers)
• data some string to send via a POST request
• binary send the data string in binary mode
• timeout a timeout in ms
• context a property which will be added to the response object
• responseType one of arraybuffer, blob, json
• overrideMimeType a MIME type for the request
• anonymous don’t send cookies with the requests (please see the fetch notes)
• fetch (beta) use a fetch instead of a xhr request
  (at Chrome this causes xhr.abort, details.timeout and xhr.onprogress to not work and makes xhr.onreadystatechange receive only readyState 4 events)
• username a username for authentication
• password a password
• onabort callback to be executed if the request was aborted
• onerror callback to be executed if the request ended up with an error
• onloadstart callback to be executed if the request started to load
• onprogress callback to be executed if the request made some progress
• onreadystatechange callback to be executed if the request’s ready state changed
• ontimeout callback to be executed if the request failed due to a timeout
• onload callback to be executed if the request was loaded.
  It gets one argument with the following attributes:
  • finalUrl – the final URL after all redirects from where the data was loaded
  • readyState – the ready state
  • status – the request status
  • statusText – the request status text
  • responseHeaders – the request response headers
  • response – the response data as object if details.responseType was set
  • responseXML – the response data as XML document
  • responseText – the response data as plain string

Returns an object with the following property:

• abort – function to be called to cancel this request

Note: the synchronous flag at details is not supported

Important: if you want to use this method then please also check the documentation about @connect.

Downloads a given URL to the local disk.

details can have the following attributes:

• url – the URL from where the data should be downloaded
• name – the filename – for security reasons the file extension needs to be whitelisted at Tampermonkey’s options page
• headers – see GM_xmlhttpRequest for more details
• saveAs – boolean value, show a saveAs dialog
• onerror callback to be executed if this download ended up with an error
• onload callback to be executed if this download finished
• onprogress callback to be executed if this download made some progress
• ontimeout callback to be executed if this download failed due to a timeout

The download argument of the onerror callback can have the following attributes:

• error – error reason
  • not_enabled – the download feature isn’t enabled by the user
  • not_whitelisted – the requested file extension is not whitelisted
  • not_permitted – the user enabled the download feature, but did not give the downloads permission
  • not_supported – the download feature isn’t supported by the browser/version
  • not_succeeded – the download wasn’t started or failed, the details attribute may provide more information
• details – detail about that error

Returns an object with the following property:

• abort – function to be called to cancel this download

Depending on the download mode GM_info provides a property called downloadMode which is set to one of the following values: native, disabled or browser.

Shows a HTML5 Desktop notification and/or highlight the current tab.

details can have the following attributes:

• text – the text of the notification (optional if highlight is set)
• title – the notificaton title (optional)
• image – the image (optional)
• highlight – a boolean flag whether to highlight the tab that sends the notfication (optional)
• timeout – the time after that the notification will be hidden (optional, 0 = disabled)
• ondone – called when the notification is closed (no matter if this was triggered by a timeout or a click) or the tab was highlighted (optional)
• onclick – called in case the user clicks the notification (optional)

All parameters do exactly the same like their corresponding details property pendant.

Get some info about the script and TM. The object might look like this:

Object+
---> script: Object+
------> author: ""
------>copyright: "2012+, You"
------>description: "enter something useful"
------>excludes: Array[0]
------>homepage: null
------>icon: null
------>icon64: null
------>includes: Array[2]
------>lastUpdated: 1338465932430
------>matches: Array[2]
------>downloadMode: 'browser'
------>name: "Local File Test"
------>namespace: "http://use.i.E.your.homepage/"
------>options: Object+
--------->awareOfChrome: true
--------->compat_arrayleft: false
--------->compat_foreach: false
--------->compat_forvarin: false
--------->compat_metadata: false
--------->compat_prototypes: false
--------->compat_uW_gmonkey: false
--------->noframes: false
--------->override: Object+
------------>excludes: false
------------>includes: false
------------>orig_excludes: Array[0]
------------>orig_includes: Array[2]
------------>use_excludes: Array[0]
------------>use_includes: Array[0]
--------->run_at: "document-end"
------>position: 1
------>resources: Array[0]
------>run-at: "document-end"
------>system: false
------>unwrap: false
------>version: "0.1"
---> scriptMetaStr: undefined
---> scriptSource: "// ==UserScript==\n// @name       Local File Test\n ...."
---> scriptUpdateURL: undefined
---> scriptWillUpdate: false
---> scriptHandler: "Tampermonkey"
---> isIncognito: false
---> version: "4.0.25"