メインコンテンツまでスキップ

書き換えスクリプト

アプリが実際のサーバーへリクエストを送る前、および実際のサーバーがアプリへ応答する前に呼び出され、HTTPリクエストとレスポンスを動的に変更するのに使えます。

  • リクエストを変更するエントリ関数は async function onRequest(context, url, request) です。
  • レスポンスを変更するエントリ関数は async function onResponse(context, url, response) です。

具体的なスクリプト例はスクリプトAPIリファレンスにあります。

app ------ Call onRequest(context, url, request) --------> real server
app <----- Call onResponse(context, url, response) ------- real server

上の図のとおり、onRequest メソッドはリクエスト送信前に同期的に呼び出され(引数は context, url, request)、onResponse メソッドはレスポンスがアプリへ返る前に同期的に呼び出されます(引数は context, url, response)。

スクリプトは require('@libs/<key>') で共有コードを読み込むこともできます:組み込みライブラリ(@libs/base64、@libs/hex)はアプリに同梱されているため、書き換えスクリプトは設定なしで使えます(requireガイド 参照)。

Hodorが使うJavaScript APIはスクリプトAPIリファレンスに文書化されています。