ForHosting KIT · 開発者向けツール

package.json 依存差分

Q: semver 範囲をレジストリに対して解決しますか？

いいえ。 バージョン指定は完全一致の文字列として比較されます。^1.0.0 と 1.0.0 は、同じリリースを入れ得る場合でも変更として扱われます。

Q: devDependencies や peerDependencies を渡せますか？

はい。 名前→バージョンの任意のマップが使えます。dependencies、devDependencies、peerDependencies、optionalDependencies、またはご自身で結合したオブジェクトです。

package.json の依存関係を2つ比べて、本当に変わった点だけが分かります。react は ^17.0.2 から ^18.2.0 へ、axios は追加、moment は削除、lodash は変更なしです。書式やキーの順番は無視されます。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

戻り値は追加・削除・変更パッケージの構造化リストに加え、変更なしの項目と件数です。

セマンティックな依存差分が報告する内容

セマンティックな依存差分は、各パッケージ名を集合の要素、各バージョン欄をその名に付いた文字列ラベルとして扱います。after にのみ存在する名前は added に新バージョン範囲とともに報告されます。before にのみ存在する名前は removed に、当時のバージョンとともに報告されます。

両方にありバージョン文字列が異なる名前は changed に from と to 付きで現れます。同一文字列の名前は unchanged に現れ、宣言面の安定部分を棚卸しできます。各バケットの件数と両マップの合計により、ダッシュボードは配列を数え直さずにバッジを描けます。

比較は意図的に浅いものです。キャレット範囲の展開、npm レジストリ解決、^17.0.0 と 17.0.2 が同じツリーを入れるかの評価は行いません。これによりツールは決定的・オフラインのまま、宣言された依存オブジェクトが動いたかだけを知る CI ゲートに適します。

dependencies、devDependencies、またはご自身で作った結合ビューを貼り付けてください。

package.json 依存差分が役立つ場面

リリース管理者はアップグレード波の前に既知の良好な依存オブジェクトを固定し、Dependabot や Renovate の自動バッチ後に再差分して意図したバンプ集合を確認します。セキュリティレビューのパイプラインは、この構造化出力をアドバイザリ照会と組み合わせます。

ツリーの残りが不変なら、追加と変更のパッケージ名の和集合だけを CVE スキャンすれば足ります。マップを控えめに保ち、テストで並べ替え済み配列を固定すれば、完全な lockfile 解析器を立てずに CI・コードレビュー・移行チェックリスト向けの再現可能な依存変更レポートが得られます。

活用例

アップグレードと Renovate バッチの確認

自動アップグレードバッチの前後で依存マップを比較し、意図したバンプを検証し、予期しない削除を見つけます。

焦点を絞ったセキュリティ再スキャン一覧

追加・変更パッケージ名をアドバイザリスキャナに渡し、変更なしのパッケージを毎コミット再検査しないようにします。

よくある質問

semver 範囲をレジストリに対して解決しますか？

いいえ。バージョン指定は完全一致の文字列として比較されます。^1.0.0 と 1.0.0 は、同じリリースを入れ得る場合でも変更として扱われます。

devDependencies や peerDependencies を渡せますか？

はい。名前→バージョンの任意のマップが使えます。dependencies、devDependencies、peerDependencies、optionalDependencies、またはご自身で結合したオブジェクトです。

行ごとの差分で比べないのはなぜですか？

行の差分では、書式やキーの順番、関係のない項目の違いまで混ざってしまいます。ここではパッケージ名ごとにバージョンの文字列を比べるので、追加・削除・バージョン変更だけが分かります。

変更のないパッケージも表示されますか？

はい。バージョンの文字列が同じパッケージは別の一覧にまとめられ、安定した部分も把握できます。どの一覧もアルファベット順で、件数も付きます。

セキュリティの確認にどう役立ちますか？

依存関係の大部分が変わっていなければ、新たに勧告を確認すべきなのは追加されたパッケージとバージョンが変わったパッケージだけです。その名前だけをスキャナーに渡せば、毎回すべてを確認し直す必要はありません。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/dev/semantic-diff-package-json

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/dev/semantic-diff-package-json \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"before":{"react":"^17.0.2","lodash":"^4.17.21","moment":"^2.29.4"},"after":{"react":"^18.2.0","lodash":"^4.17.21","axios":"^1.6.0"}}'

const res = await fetch("https://api.kit.forhosting.com/dev/semantic-diff-package-json", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "before": {
      "react": "^17.0.2",
      "lodash": "^4.17.21",
      "moment": "^2.29.4"
    },
    "after": {
      "react": "^18.2.0",
      "lodash": "^4.17.21",
      "axios": "^1.6.0"
    }
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/semantic-diff-package-json",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "before": {
        "react": "^17.0.2",
        "lodash": "^4.17.21",
        "moment": "^2.29.4"
    },
    "after": {
        "react": "^18.2.0",
        "lodash": "^4.17.21",
        "axios": "^1.6.0"
    }
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/semantic-diff-package-json", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"before":{"react":"^17.0.2","lodash":"^4.17.21","moment":"^2.29.4"},"after":{"react":"^18.2.0","lodash":"^4.17.21","axios":"^1.6.0"}}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"before":{"react":"^17.0.2","lodash":"^4.17.21","moment":"^2.29.4"},"after":{"react":"^18.2.0","lodash":"^4.17.21","axios":"^1.6.0"}}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/semantic-diff-package-json", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "before": {
    "react": "^17.0.2",
    "lodash": "^4.17.21",
    "moment": "^2.29.4"
  },
  "after": {
    "react": "^18.2.0",
    "lodash": "^4.17.21",
    "axios": "^1.6.0"
  }
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.semantic_diff_package_json",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

2つの package.json スナップショット間で依存ブロックを比較することは、リリースレビュー、アップグレード、プルリクエスト監査の日常作業です。生のテキスト差分や行差分は、書式・キー順・無関係なフィールドのノイズを、本当に知りたい信号（どのパッケージが現れ、どれが消え、どのバージョン範囲が動いたか）と混ぜてしまいます。この package.json 依存差分は、プレーンなオブジェクトを2つ受け取ります。それぞれパッケージ名からバージョン範囲文字列へのマップで、dependencies、devDependencies、peerDependencies、optionalDependencies と同一の形です。オブジェクトでない入力は invalid_input で失敗し、課金されません。

セマンティックな依存差分が報告する内容

基準マップは before、候補マップは after です。エンドポイントが必要とするのは、文字列値のバージョン指定オブジェクト2つだけです。

入力契約、応答形、エラー

パッケージ名はオブジェクトキーになり、バージョン範囲は文字列、またはきれいに文字列化できる単純スカラーでなければなりません。バージョン値としての入れ子オブジェクトは拒否されます。空オブジェクトは有効で、空の依存集合を意味します。成功時、本文にはパッケージ名のアルファベット順で並べた added、removed、changed、unchanged 配列が含まれます。追加または削除の各項目は name と version、変更は name・from・to、変更なしは name と version を持ちます。必須のオブジェクト欄 before（別名 left、old、previous）と after（別名 right、new、next）を持つ JSON 本体を POST してください。それぞれプレーンオブジェクトであり、配列・null・プリミティブであってはなりません。数値カウンタ added_count、removed_count、changed_count、unchanged_count、total_before、total_after は配列を反映します。いずれかのパッケージが追加・削除・バージョン変更されたとき、真偽値 has_changes は true です。before または after が欠落、配列、文字列、あるいはオブジェクトでない場合、タスクは当該欄を名指しして invalid_input で失敗し、残高は消費しません。例: before が react ^17.0.2、lodash ^4.17.21、moment ^2.29.4、after が react ^18.2.0、lodash ^4.17.21、axios ^1.6.0 のとき、moment 削除、axios 追加、react が ^17.0.2 から ^18.2.0 へ変更、lodash は変更なしとなります。

package.json 依存差分が役立つ場面

プルリクエスト用ボットは base と head の package.json から依存を抽出し、このエンドポイントを呼び、うるさい統合 diff ではなく実パッケージの移動だけを短いコメントで投稿できます。実装は純粋な parse の tier A のため、成功する呼び出しは毎回公開の基本価格 $0.002 で、モデルトークンも外向きネットワークも使いません。

連携の活用例

プルリクエスト向け依存サマリー

base と head の package.json 依存オブジェクトを差分し、PR には追加・削除・バージョン変更パッケージのみを投稿します。

技術的な質問

2つの package.json 依存オブジェクトをどう差分しますか？

パッケージ名をバージョン範囲文字列へ写すプレーンオブジェクトとして before と after を送ってください。API は並べ替え済みの added、removed、changed、unchanged リストと件数を返します。

before または after がオブジェクトでない場合は？

タスクは invalid_input で失敗します。配列、null、文字列、欠落フィールドは拒否され、課金されません。

package.json 依存差分の料金は？

ブラウザツールは無料です。API 要求は成功した呼び出しごとに $0.002 の前払い KIT 残高を使い、無効入力は課金されません。

KITの完全なドキュメントを見る →

package.json 依存差分

無料で実行

セマンティックな依存差分が報告する内容

package.json 依存差分が役立つ場面

活用例

アップグレードと Renovate バッチの確認

焦点を絞ったセキュリティ再スキャン一覧

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

セマンティックな依存差分が報告する内容

入力契約、応答形、エラー

package.json 依存差分が役立つ場面

連携の活用例

プルリクエスト向け依存サマリー

技術的な質問

ありがとう