使用 JS Libraries

Apidog 的腳本引擎同時支援內建函式庫（可立即使用）與外部函式庫（透過 npm 動態載入）。

內建函式庫

你可以在腳本中直接 require 這些函式庫，無需任何設定。

編碼與解碼

Library	Version	Description
atob	v2.1.2	Base64 解碼。
btoa	v1.2.1	Base64 編碼。
crypto-js	v3.1.9-1	編碼／解碼函式庫，包含常見的編碼與解碼方法（Base64、MD5、SHA、HMAC、AES 等）。你只能 require 整個模組，不能 require 該類別函式庫的子模組。查看此處文件以取得更多詳細資訊。
jsrsasign	10.3.0	RSA 加密／解密。僅支援 Apidog 1.4.5 或更新版本。

斷言

Library	Version	Description
chai	v4.2.0	BDD / TDD 斷言函式庫。

工具

Library	Version	Description
postman-collection	v3.4.0	Postman Collection 函式庫。
cheerio	v0.22.0	jQuery 的子集。
lodash	v4.17.11	JS 工具函式庫。
moment	v2.22.2	日期函式庫（不包含 locales）。
uuid	-	產生 UUID。
xml2js	v0.4.19	將 XML 轉換為 JSON。
csv-parse/lib/sync	v1.2.4	解析 CSV。

JSONSchema 驗證器

Library	Version	Description
tv4	v1.3.0	JSONSchema 驗證器。
ajv	v6.6.2	JSONSchema 驗證器。

內建 NodeJS 模組

Library	Version	Description
path	-	用於處理檔案路徑的 Path 模組。
assert	-	斷言測試模組。
buffer	-	用於二進位資料的 Buffer 模組。
util	-	工具函式模組。
url	-	URL 解析與解析度處理模組。
punycode	-	Punycode 編碼模組。
querystring	-	查詢字串解析模組。
string-decoder	-	字串解碼器模組。
stream	-	用於串流資料的 Stream 模組。
timers	-	計時器函式模組。
events	-	事件發射器模組。

使用範例

SHA256 加密

HMAC-SHA256 加密

Base64 編碼

Base64 解碼

字串解碼：

JSON 解碼：

你可以使用 pm.response.setBody() 方法將解碼後的 JSON 資料設定為回應主體。

AES 加密

AES 解密

假設有一段使用 ECB 模式與 Pkcs7 填充的 AES 加密密文，AES 解密腳本範例如下：

RSA 加密

RSA 解密

以下是一個簡單 RSA 加密與解密的完整範例（注意：jsrsasign 版本為 10.3.0；語法可能與其他版本不相容）。此範例可在 Node.js 環境中執行，並可調整用於 Apidog 中的加密或解密操作：

TIP

使用內建函式庫時，你只能 require 整個模組；無法個別 require 子模組。

// A correct example.
var cryptoJs = require("crypto-js");
console.log(cryptoJs.SHA256("Message"));

// A wrong example.
var SHA256 = require("crypto-js/sha256");
console.log(SHA256("Message"));

外部函式庫（npm）

你可以使用 $$.liveRequire 從 npm 載入任何純 JavaScript 函式庫。

NOTE

這需要有效的網際網路連線才能下載套件。

單一函式庫：

多個函式庫：

內建函式庫#

編碼與解碼#

斷言#

工具#

JSONSchema 驗證器#

內建 NodeJS 模組#

使用範例#

SHA256 加密#

HMAC-SHA256 加密#

Base64 編碼#

Base64 解碼#

AES 加密#

AES 解密#

RSA 加密#

RSA 解密#

外部函式庫（npm）#

內建函式庫

編碼與解碼

斷言

工具

JSONSchema 驗證器

內建 NodeJS 模組

使用範例

SHA256 加密

HMAC-SHA256 加密

Base64 編碼

Base64 解碼

AES 加密

AES 解密

RSA 加密

RSA 解密

外部函式庫（npm）