JavaScript JSON.stringify()
JSON.stringify() メソッドは、JavaScript 値を JSON 文字列に変換するために使用されます。
構文
JSON.stringify(value[, replacer[, space]])
引数の説明:
- value:
必須。変換する JavaScript 値(通常はオブジェクトまたは配列)。
- replacer:
省略可。変換結果に使用する関数または配列。
replacer が関数の場合、JSON.stringify はその関数を呼び出し、各メンバーのキーと値を渡します。戻り値を元の値の代わりに使用します。この関数が undefined を返す場合、メンバーは除外されます。ルートオブジェクトのキーは空文字列 "" です。
replacer が配列の場合、その配列内にキー値を持つメンバーのみが変換されます。メンバーの変換順序は、配列内のキーの順序と同じです。
- space:
省略可。テキストにインデント、スペース、改行を追加します。space が数値の場合、戻り値のテキストは各レベルで指定された数のスペースでインデントされます。space が 10 より大きい場合、テキストは 10 スペースでインデントされます。space には \t などの非数値も使用できます。
戻り値:
JSON テキストを含む文字列を返します。
例
例
var str = {"name":"サンプル", "site":"http://www.example.com"}
str_pretty1 = JSON.stringify(str)
document.write( "引数が1つの場合:" );
document.write( "<br>" );
document.write("<pre>" + str_pretty1 + "</pre>" );
document.write( "<br>" );
str_pretty2 = JSON.stringify(str, null, 4) //4つのスペースでインデントする
document.write( "引数を使用する場合:" );
document.write( "<br>" );
document.write("<pre>" + str_pretty2 + "</pre>" ); //pre は出力をフォーマットするために使用されます
試してみる »
JavaScript JSON