URLエンコード・デコード ＆ HTMLエンティティ変換ツール

URLエンコードとデコードの仕組みと役割

URLエンコード（パーセントエンコーディング）は、インターネット上で送信されるURLにおいて、使用できない文字や特別な意味を持つ記号を安全に転送可能な形式に変換する処理です。Webブラウザやサーバーは、URLの構造を正しく解釈するために特定の文字を制御文字として認識します。そのため、クエリパラメータやパスの中にスペースや日本語などのノンASCII文字、または「&」や「=」といった記号を含める場合、これらをパーセント記号（%）と16進数で表されるUTF-8シーケンスに変換する必要があります。

デコードは、このパーセントエンコーディングされた文字列を元の読みやすいテキストに戻す逆の処理です。開発者、コンテンツ編集者、サポート担当者は、URLフラグメントやフォームの入力値、パスの一部を安全に埋め込んだり、既存のエンコードされたURLを解読したりするためにこれらの処理を行います。

URLコンポーネントと完全なURLの変換差異

URLを処理する際、変換の対象がURL全体（完全なURL）であるか、あるいはURLの一部（コンポーネント）であるかによって、適用すべき変換ルールが異なります。

• コンポーネント（encodeURIComponent / decodeURIComponent）: クエリの値、パスの一部、またはフォームの入力値を処理する場合に適しています。このモードでは、「:」「/」「?」「&」「=」といったURLの構造を定義する記号も含めて、すべての対象文字がエンコードされます。
• 完全なURL（encodeURI / decodeURI）: URL全体の構造を維持したまま、日本語などのノンASCII文字のみを変換したい場合に使用します。「:」「/」「?」「&」「=」などの記号はエンコードされずにそのまま残るため、URLとしての機能と可読性が保たれます。

HTMLエンティティ変換モードが選択されている場合、このURLスコープの制御オプションは画面上に表示されなくなります。

HTMLエンティティのエスケープとアンエスケープ

HTMLエンティティのエスケープは、Webページ上にテキストを安全に配置するための処理です。HTMLドキュメント内において、「<」や「>」はタグの開始と終了を意味し、「&」はエンティティの開始を意味します。これらの文字をそのまま本文や属性値に記述すると、ブラウザがHTML構造の一部として誤って解釈する原因になります。

エスケープ処理を行うことで、「<」「>」「&」、引用符、および非ASCII文字が、安全な文字実体参照（エンティティ）に変換されます。これにより、意図した通りのテキストがブラウザ上に表示されます。アンエスケープは、これらのエンティティ化された文字列を元の文字に戻す処理です。なお、この変換は文字の表記方法を置き換えるものであり、悪意あるスクリプトを無害化するセキュリティ上のサニタイズ処理とは異なります。

不完全なパーセントエンコーディングとエラー

URLのデコード処理を行う際、入力されたパーセントエンコーディングは完全なUTF-8シーケンスで構成されている必要があります。

例えば、%E0%A4%A のような途中で切れている不完全なシーケンスが入力された場合、デコーダーは正しい文字を復元することができません。このような不正な形式の入力に対しては、「このURLテキストには、不完全なパーセントエンコーディングが含まれています。」というエラーメッセージが表示され、処理が中断されます。正確なデコードを行うためには、データが途中で欠落していないことを確認する必要があります。

ツールの仕様と制限事項

本ツールは、最大2,000,000文字までのテキスト入力をサポートしています。入力サイズがこの上限を超えた場合は、「入力が長すぎます。{max}文字未満にしてください。」という警告が表示されます。

変換処理が正常に行われない場合や、特定の状況下では以下のメッセージが表示されます。

• 入力フィールドが空の状態で処理を実行しようとすると、「最初にテキストを貼り付けてください。」と表示されます。
• 変換処理の実行に過度な時間がかかる場合は、「変換処理に時間がかかりすぎています。より短い入力を試してください。」というタイムアウトメッセージが表示されます。
• その他の原因で変換に失敗した場合は、「入力を変換できませんでした。」と表示されます。

プライバシーとデータ処理について

本ツールに入力されたURLおよびHTMLテキストの変換処理は、すべて利用者のブラウザ内でローカルに実行されます。入力データや変換結果が外部のサーバーに送信されたり、BroBroGoにアップロードされることはありません。

よくある質問（FAQ）

URLコンポーネントと完全なURLのどちらを選ぶべきですか？

クエリの値、パスの一部、またはフォームの入力値を処理する場合は「コンポーネント」を選択します。「:」「/」「?」「&」「=」などの記号をそのまま残して読みやすくしたい場合は「完全なURL」を選択します。

HTMLエンティティのエスケープは何を変換しますか？

「<」「>」「&」、引用符、および非ASCII文字を、HTMLテキストや属性内に安全に貼り付けられる文字実体参照（エンティティ）に変換します。

URLのデコードが失敗することがあるのはなぜですか？

パーセントエンコーディングは、完全なUTF-8シーケンスである必要があります。「%E0%A4%A」のように途中で切れているシーケンスは、推測なしで正確にデコードすることができません。

入力データのプライバシーはどのように保護されていますか？

URLおよびHTMLテキストはブラウザ内で変換されます。BroBroGoにアップロードされることはありません。