ガイド

XML から JSON への変換:属性・CDATA・RSS フィードを保持する実践ガイド

XML・RSS・SVG をブラウザメモリ内で JSON に変換し、@_ 属性や CDATA テキスト、数値型を保持したまま XML への往復変換も行えます。

読了目安 4分

クイックアンサー: XML・RSS・SVG をメタデータを落とさず JSON に変換するには、「属性を無視」をオフにし、属性プレフィックス @_ を有効にします。TxtTo はローカルで XML の行・列エラーを検証し、CDATA ブロックを通常の JSON 文字列へ展開し、タグ値パース有効時は数値・真偽値型も復元します。

XML の属性・テキストノード・CDATA が JSON と噛み合わない理由

フラットなキーと値のペアで構成される JSON オブジェクトとは異なり、XML 要素は開始タグ内の属性、内部テキスト、反復する兄弟要素、さらにエスケープされていない HTML やコードを含む CDATA セクションが混在します。

簡易な変換ツールでは XML 属性が丸ごと消えたり、RSS の item タグが配列と単一オブジェクトで揺れたりして、後続の TypeScript 型生成や API パーサーが破綻しがちです。

  • id="bk101" のような要素属性は子要素ではなく開始タグ内に記述されます。
  • RSS の複数 item 要素は一貫して JSON 配列としてまとめる必要があります。
  • CDATA ブロックは < や & を実体参照にせず HTML などをそのまま格納します。
xml
<catalog currency="USD">
  <book id="bk101">
    <title><![CDATA[Browser <em>XML</em> Guide]]></title>
    <price>39.00</price>
  </book>
</catalog>

ignoreAttributes・attributePrefix (@_)・parseTagValue の制御

TxtTo はブラウザメモリ上で fast-xml-parser を実行するため、社内フィードや SOAP レスポンスを外部へ送らずに属性保持や型解釈をその場で調整できます。

属性と子タグの衝突を防ぐには ignoreAttributes をオフ、attributePrefix を @_ に保ちます。また郵便番号や SKU 番号など 00412 のような先頭ゼロを残したい場合は、parseTagValue をオフにして文字列のまま維持してください。

json
{
  "catalog": {
    "@_currency": "USD",
    "book": {
      "@_id": "bk101",
      "title": "Browser <em>XML</em> Guide",
      "price": 39
    }
  }
}

XML・RSS・SVG をローカルで JSON に変換

不正な XML の検証と RSS・SVG ツリーの確認

パース前に XMLValidator がローカルで整形式チェックを実行し、閉じタグ漏れや属性の記述ミスを行番号と列番号単位で特定します。途中切れの RSS や破損した SVG をパイプライン投入前に弾けます。

変換後はそのまま JSON 整形・修復へ送り、ツリービューで深い階層を展開したり、キーのアルファベット順ソートや手修正後の末尾カンマ修復を行えます。

変換後の JSON ツリーを整形・検査

オプション既定値動作変更する目安
ignoreAttributesfalseすべての XML タグ属性を JSON に保持属性が不要な装飾ヒントのみの場合にオン
attributePrefix@_属性キーの先頭に @_ を付与連携先が _ や $ を期待する場合に変更
parseTagValuetrue数値や真偽値文字列をネイティブ型へ変換00412 のような先頭ゼロを保つ場合にオフ
indent2スペース 2 文字インデントで整形出力1 行に圧縮したい場合は 0 を指定

rootName と includeDeclaration で JSON を XML へ往復変換

有効な XML には単一のルート要素が必須となるため、JSON → XML 変換では最上位配列を rootName(既定値は root)内の <item> 要素として包み、includeDeclaration 有効時は <?xml version="1.0" encoding="UTF-8"?> 宣言を先頭へ付加します。

@_ プレフィックス付きのキーは自動的に元の XML 属性へ復元され、往復後の変更点はテキスト・JSON 差分比較でローカル検証できます。

JSON を整形済み XML に戻してシリアライズ

参考文献

よくある質問

XML 内の CDATA ブロックは JSON 変換時にどう扱われますか?

CDATA ラッパーのみが取り除かれ、内部の HTML タグやアンパサンドを二重エスケープせずにクリーンな JSON 文字列として出力されます。

XML → JSON 変換で郵便番号や SKU の先頭ゼロが消えるのを防ぐには?

「タグ値を型パース(parseTagValue)」をオフにしてください。02139 のような数値に見える文字列も数値化されず文字列のまま保持されます。

JSON → XML 変換で @_ 付きキーを再び XML 属性に戻せますか?

はい。JSON オブジェクト内の @_ で始まるプロパティは、シリアライズ時に親 XML 要素の属性として自動的に書き戻されます。

関連フォーマット

関連比較ページ

関連ガイド