cURL を fetch や Axios に変換したあと、貼り付け前に確認すること

DevTools やチケットから動作確認済みの cURL を取り出し、アプリケーションコードへ移すのは一般的な API デバッグ手順です。変換ツールは、headers、method、body を fetch や Axios の形へ素早く写してくれます。

ただし、変換結果をそのまま貼り付けるのは危険です。cURL には shell quoting、認証情報、重複ヘッダー、環境依存の挙動が含まれることがあります。

変換ツールが得意なこと

良い変換ツールは、次の情報をかなり正確に移せます。

• HTTP method
• URL と query string
• headers
• JSON body
• form body
• basic な auth 設定

これにより、手入力のミスを減らし、再現リクエストからコードへの移動を速くできます。

人間が確認すべきこと

まず秘密情報を確認します。Authorization、cookie、API key、session token が変換結果に含まれている場合、そのままリポジトリへ貼り付けてはいけません。環境変数、secret manager、テスト専用値へ置き換える必要があります。

次に headers を見ます。同じ header が複数回指定されている、DevTools が自動で付けた browser-specific header が混ざっている、Content-Type と body が合っていない、といった問題があります。

最後に body を検証します。JSON body は整形して構文を確認し、必要なら JSON Schema で期待する形を確認します。文字列として入った JSON と、オブジェクトとして渡す JSON を混同しないことも重要です。

fetch と Axios の違い

fetch と Axios は似ていますが、完全に同じではありません。エラー時の扱い、JSON 変換、timeout、interceptor、default headers などが異なります。

変換後は「動くコード片」ではなく「レビューすべきドラフト」として扱うのが安全です。API デバッグでは、変換が終点ではなく、再現条件を明確にするための中間ステップです。