GreasyForkScriptUpdate.js

Check for script updates on GreasyFork.org

1. Installation

Just @require it.

2. How to use

var GFU = new GreasyForkUpdater();GFU.checkUpdate(<integer/string>scriptID, <string>currentversion, <function>callback[, <array>args])

Arguments:

1. <integer/string> scriptID: The GreasyFork demical script id.
2. <string> currentversion: The current version of your script, you can get it from GM_info.script.version. It should just contains demical numbers(0123456789) and dots('.').
3. <function> callback: The callback function. You will get three arguments while your callback function being called: <bool>update, <string>updateurl, <object>metaData
   1. <bool> update: Whether there is an update, true/false.
   2. <string> updateurl: The url latest version script.
   3. <object> metaData: An object containing all meta info of the latest script. It should like:

      {name: "hello world",version: 0.2,grant: "GM_xmlhttpRequest",connect: ["www.example.com", "example.org"]noframes: true}

4. [<array> args]: An arguments list that will be passed to your callback function as the 4th, 5th... argument. It should be an array. Optional.

Or, you can use this simpler one:

var GFU = new GreasyForkUpdater();GFU.update(<integer/string>scriptID, <string>currentversion)

This will just check whether there is an update of your given script, and automatically (request your script user to) install the latest version if there is. If there is no update, then nothing happends.

3. More usage

Please refer to the source code. I've written the usage of each function.

4. READ THIS BEFORE YOU USE THIS!

Be aware that one of GreasyFork's rules for posted scripts is that Scripts must not check for updates at a rate higher than once per day. Note that most user script managers will handle automatic updates, so doing it in the script is unnecessary. Scripts should also not dynamically inject another Greasy Fork-hosted script into a page, as this bypasses caching in user script managers.. Make sure you won't violate the rules all the time.