JSON.stringify()
JSONは通常、サーバーとのデータ交換に使用されます。
サーバーにデータを送信する際は、通常は文字列です。
JSON.stringify() メソッドを使用して、JavaScript オブジェクトを文字列に変換できます。
構文
JSON.stringify(value[, replacer[, space]])
パラメータの説明:
- value:
必須。変換する JavaScript の値(通常はオブジェクトまたは配列)。
- replacer:
省略可能。変換結果に使用する関数または配列。
replacer が関数の場合、JSON.stringify はその関数を呼び出し、各メンバーのキーと値を渡します。戻り値は元の値の代わりに使用されます。この関数が undefined を返すと、メンバーは除外されます。ルートオブジェクトのキーは空文字列 "" です。
replacer が配列の場合、その配列のキーを持つメンバーのみ変換されます。メンバーの変換順序は、配列内のキーの順序と同じです。value パラメータが配列の場合も、replacer 配列は無視されます。
- space:
省略可能。テキストにインデント、空白、改行を追加します。space が数値の場合、戻り値のテキストは各レベルで指定された数の空白でインデントされます。space が 10 より大きい場合は、テキストは 10 個の空白でインデントされます。space には、\t のような数値以外も使用できます。
JavaScript オブジェクトの変換
たとえば、次のデータをサーバーに送信するとします:
上記のデータを JSON.stringify() メソッドで処理して文字列に変換します:
myJSON は文字列です。
myJSON をサーバーに送信できます:
例
試してみる »
JavaScript 配列の変換
JavaScript 配列を JSON 文字列に変換することもできます:
例
myJSON は文字列です。
myJSON をサーバーに送信できます:
例
試してみる »
例外
データの解析
JSON は Date オブジェクトを格納できません。
JSON.stringify() はすべての日付を文字列に変換します。
例
試してみる »
その後、文字列を Date オブジェクトに戻すことができます。
関数の解析
JSON は関数を含めることを許可していません。JSON.stringify() は JavaScript オブジェクトの関数を、キーと値ごと削除します。
例
試してみる »
上記の問題を回避するには、JSON.stringify() 関数を実行する前に関数を文字列に変換できます:
例
試してみる »
JSON で関数を使用することはお勧めしません。
ブラウザサポート
主要ブラウザはすべて JSON.stringify() 関数をサポートしています:
- Firefox 3.5
- Internet Explorer 8
- Chrome
- Opera 10
- Safari 4