URLエンコーダーガイド：URL全体か値1つか、どちらも壊さない変換 – AI人間化ツール

1. URLエンコードとは何か URLが安全に運べる文字には限りがあります。英字、数字、そして - _ . ~ といった少しの記号はそのまま通りますが、それ以外——スペース、アクセント記号、日本語やアラビア語の文字、絵文字、そしてアドレス自体の中で役割を持つ句読点——は、ブラウザやサーバーが混乱せず運べるよう、事前に書き換える必要があります。パーセントエンコードが、その書き換えです。安全でない文字はUTF-8バイトに変え、各バイトを % と16進数2桁で書きます。スペースは %20、& は %26 になります。日本語の1文字は、UTF-8で3バイト必要なので、%XX のグループが3つになります。 ここに秘密も小細工もありません。壊れやすい荷物を標準の段ボールに入れるようなものです。中身は変わらず、外側だけが運搬に安全になります。デコードはその逆で、%XX のグループをバイトに戻し、元のテキストを組み立て直します。このツールは、ブラウザがすべてのウェブサイトに提供している関数そのものを使って双方向に変換します。エンコードには encodeURI と encodeURIComponent、デコードには decodeURI と decodeURIComponent です。ここで試すのは、本番で自分のコードが示す挙動そのものであり、似せて作った実装ではありません。 2. たった一つの大事な判断：URL全体か、値1つか これまでクリックしてきた壊れたエンコード済みリンクは、すべて一つの判断ミスに帰着します。URLには構造があります。スキームの後の ://、パスの区切りの /、クエリを開く ?、パラメータの間の &、名前と値の間の = です。これらはアドレス言語の句読点です。すでに組み上がった完全なリンクをエンコードするなら、その句読点は働き続けなければならず、書き換えるのは中にある安全でない文字だけです。それがURL全体モード、encodeURI の系統です。スペースとラテン文字以外を直し、骨組みは立たせたままにします。 値1つは逆の問題です。ユーザーのテキスト——検索フレーズ、メールアドレス、ファイル名——をURLの中に入れるとき、その文字自体が句読点の役を演じてはいけません。フレーズに & が含まれていれば、エンコードしていないリンクは、値がそこで終わって新しいパラメータが始まったふりをします。そこで1つの値モード、encodeURIComponent の系統は、構造文字もエンコードします。& は %26、= は %3D、? は %3F、/ は %2F になります。値は大きなリンクの中に安全に収まり、サーバーはそれをデコードして、訪問者が打った通りの文字を取り戻します。リンク全体はこちらのモード、値1つはあちらのモード。混ぜること、それがバグのすべてです。 3. このツールの使い方、手順 まずモード切替から始めてください。他のすべての操作の意味がここで決まります。スペースや英語以外の文字を含む完全なリンクがすでにあるなら「URL全体」を、検索フレーズ1つ、パラメータ値1つ、リダイレクト先1つ——リンクそのものではなくリンクの一部になるものなら「1つの値」を選びます。その下には、今回の変換で使うブラウザ関数が静かに表示されます。ツールはそのまま、自分のコードが呼ぶべき関数の正直なラベルにもなります。 次に入力ボックスへ貼り付け、方向を選びます。エンコードは読みやすいテキストを %XX の形に、デコードは %XX の形を読みやすいテキストに戻します。探し回る変換ボタンはありません。入力、モード切替、方向の反転に合わせて、下の結果がライブで更新されます。デバッグではこの即時性が効きます。値が1文字ずつ変わるのを見て、& が句読点でなくなる正確な瞬間を確認できるからです。まず試したいときは「サンプルを試す」、終わったら「クリア」を使ってください。 結果が正しそうなら、「結果をコピー」でコピーします。もっと面白いのが「入れ替えて反転」です。出力を入力に戻し、エンコードとデコードを切り替えるので、往復ができます。自分の文字列をエンコードしてからデコードすれば、元の通りに戻るはずです。戻らないなら、上流の何か——フレームワーク、リダイレクト、フォーム——が黙ってエンコードやデコードをしています。それは本番に触らずバグを見つけたということです。このページのすべてと同じく、変換はこのブラウザタブの中だけで行われ、貼ったものがどこかへアップロードされることはありません。 4. 解いてみる例：& = ? が値を壊す仕組み ツールの下のパネルでは、1つのフレーズを両モードに通すので、違いを想像する必要がありません。訪問者が実際に打ちそうな検索値を考えます。cookies & cream = best? です。URL全体モードでは cookies%20&%20cream%20=%20best? になり、スペースは直りますが、& と = は生きたままです。これをリンクに組み立てると ?q=cookies%20&%20cream%20=%20best? となり、サーバーはごく合理的に q を cookies という単語だけだと読み、cream を別の何かの始まりとして扱い、訪問者が本当に尋ねた質問を見ません。リンクが悪意を持っているわけではありません。始まる前に壊れているだけです。 1つの値モードでは、同じフレーズが cookies%20%26%20cream%20%3D%20best%3F になります。見た目は悪くなりますが、これが正確に正しい姿です。サーバーはパラメータ1つをデコードし、&、=、? を含むフレーズ全体を取り戻します。この対比こそがこのツールのレッスンのすべてであり、モード切替が設定の奥ではなく入力の上にある理由です。値にメールアドレス（@ も構造側の客です）、リダイレクトURL（: / ? & を自前で含みます）、スペースや括弧入りのファイル名が入り得るなら、それはいつでも1つの値モードの担当です。 5. デコードの困りごと：不正な並び、プラス記号、二重エンコード デコードは、このツールが丁寧で曖昧な態度を拒む場面です。パーセントエンコードには文法があります。すべての % の後には16進数ちょうど2桁が続き、得られたバイトは正しいUTF-8テキストを構成しなければなりません。末尾の %、短い %2、%ZZ、あるいはそもそもUTF-8でなかったバイトをデコーダーに渡すと、JavaScriptはエラーを投げます。このページはそれを捕まえ、分かりやすく伝えます。デコードは止まった、壊れたパーセント記号が中にある、途中で推測はしていない、と。その正直さは本物のデバッグ時間を節約します。無言の空結果は、ツールがリンクを食べてしまったのかと悩ませますが、明確なエラーは直すべき文字を正確に指し示します。 もう二つ、静かな落とし穴にも光を当てます。まずプラス記号です。古いフォーム形式のデータでは + がスペースを意味することがありますが、正しいパーセントエンコードではスペースは %20 で、+ は文字通りのプラスです。映し取るブラウザ関数と同じく、このデコーダーは + を + のままにするため、フォームデータからデコードした値のスペースが消えてプラスが増えたように見えたら、壊れたツールではなくその食い違いを見ています。次に二重エンコードです。すでにエンコード済みの文字列をエンコードすると、% 自身がエンコードされて %20 が %2520 になります。サーバーは一度デコードして %20 を文字通りのテキストとして受け取り、リンクは、エンコードの呼び出し回数を数えるまで幽霊のように失敗します。呼び出しは、URLを組み立てる境界でちょうど一度だけです。 6. エンコードではないもの：暗号化でも、安全性でも、隠し場所でもない 一度言って、信じてください。パーセントエンコードは何も隠しません。公開された可逆の書き換えであり、誰でも——このツールのコピーでも——一瞬で元に戻せます。エンコードしたパスワード、APIキー、セッショントークン、個人的なメールをURLに入れても、何の保護にもなりません。むしろURLはログに残り、ブックマークされ、撮影され、チャットに貼られる性質があるため、その中の秘密は、誰かがデコードする前から広く旅してしまう傾向があります。秘密にしなければならないものは、URLの中に置くものではありません。ヘッダー、HTTPS越しのリクエストボディ、正しいトークンの仕組みに置き、エンコードには文字を運べるようにするという一つの正直な仕事をさせてください。 同じ正直さは逆向きにも当てはまります。クリック前にリンクをデコードするのは良い習慣です。%XX に覆われたアドレスが実際どこへ行くか読めるからです。しかしデコードしたリンクがそれで安全になるわけではなく、エンコードされたリンクがそれで怪しくなるわけでもありません。エンコードは文字の書かれ方を表すだけで、行き先が信頼に値するかどうかは決して表しません。ドメインとパスは、エンコードされて届いても平文で届いても、同じ注意で判断してください。このガイドとツールがこの区別を繰り返すのは、URLエンコードの害のほとんどが仕組みそのものではなく、仕組みに誤った意味を期待することから生まれるからです。 7. ポケットチェックリストと正直な限界 リンクを出す前に、このページが作られた短いチェックリストを通してください。一：リンクか値かを決め、合うモードを選ぶ。URL全体を1つの値モードで、値1つをURL全体モードでエンコードしない。二：エンコードはURLを組み立てる場所でちょうど一度。三：スペース、&、=、?、そして英語以外の単語を含む醜いケースを、訪問者に先に見つけられる前に、自分でわざと試す。四：デコードでエラーが出たら、エラーを文字通り読む。壊れた % はテキストの中にあり、推測で回避すればバグは移るだけです。五：秘密は、エンコードの有無にかかわらず、URLに一切入れない。 限界を率直に述べます。このツールはJavaScriptのURI関数を使うため、エンコード先はUTF-8であり、デコードもUTF-8を前提にします。別の文字コードでエンコードされた古い文字列は、ブラウザと同じく、ここでも置換文字に化けることがあります。変換はファイルの一括処理ではなく、表示された50,000文字までを一度に1つの貼り付けずつ行います。作業中の素早い正しい変換がこのツールの仕事だからです。そして処理はすべてタブの中でローカルに行われます。タブを閉じれば、テキストは記録されず一緒に消えます。正しいモードを選んで一度だけエンコードすれば、地味な % がリンクを壊すことは二度とありません。