💼 腳本輔助 API

這裡提供了一些常用的 輔助功能 ，如插件註冊、輸出信息和異步接口等

他們讓你開發腳本變得更加容易而自然，避免了很多無謂的細節問題的糾纏。

💼 腳本輔助 API

下面這些API為腳本增加了必要的輔助接口

輸出信息到控制台

log(data1,data2,...)

• 參數：
  • 待輸出的變量或者數據
    可以是任意類型，參數數量可以是任意個
• 返回值：無

輸出帶顏色文本

這是樓上那位的升級版,沒錯,它支持彩色輸出

colorLog(color,data1,data2,...)

• 參數：
  • color : String
    此行輸出的顏色(代碼示例和效果如下圖)
  • data... : 待輸出的變量或者數據
    可以是任意類型，參數數量可以是任意個
• 返回值：無

效果展示：

異步輸出

此函數將輸出請求發出後即刻返回，避免同步讀寫造成的阻塞時間
底層有鎖保護，不同的fastLog之間不會出現串字符現象

fastLog(data1,data2,...)

• 參數：
  • data... : 待輸出的變量或者數據
    可以是任意類型，參數數量可以是任意個
• 返回值：無

推遲一段時間執行函數

setTimeout(func,msec)

• 參數：

  • func : Function
    待執行的函數

  • msec : Integer
    推遲執行的時間（毫秒）

• 返回值：此任務ID

• 返回值類型：Integer

  • 如果返回Null，則代表創建任務失敗

推遲一段時間執行代碼段（eval）

setTimeout(code,msec)

• 參數：

  • code : String
    待執行的代碼段

  • msec : Integer
    推遲執行的時間（毫秒）

• 返回值：此任務ID

• 返回值類型：Integer

  • 如果返回Null，則代表創建任務失敗

設置週期執行函數

setInterval(func,msec)

• 參數：

  • func : Function
    待執行的函數

  • msec : Integer
    執行間隔週期（毫秒）

• 返回值：此任務ID
• 返回值類型： Integer

設置週期執行代碼段（eval）

setInterval(code,msec)

• 參數：

  • code : String
    待執行的代碼段

  • msec : Integer
    執行間隔週期（毫秒）

• 返回值：此任務ID
• 返回值類型： Integer
  • 如果返回Null，則代表創建任務失敗

取消延時 / 週期執行項

clearInterval(taskid)

• 參數：
  • timerid : Integer
    由前幾個函數返回的任務ID
• 返回值：是否取消成功
• 返回值類型： Boolean
  • 如果返回Null，則代表取消任務失敗